PHPackages                             seravo/wordpress - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. seravo/wordpress

ActiveProject[DevOps &amp; Deployment](/categories/devops)

seravo/wordpress
================

Seravo WordPress project template

v2.2.0(7mo ago)105455[32 issues](https://github.com/Seravo/wordpress/issues)[8 PRs](https://github.com/Seravo/wordpress/pulls)GPL-3.0-or-laterPHPPHP &gt;=8.0CI passing

Since Mar 19Pushed 1mo ago10 watchersCompare

[ Source](https://github.com/Seravo/wordpress)[ Packagist](https://packagist.org/packages/seravo/wordpress)[ Docs](https://seravo.com/)[ RSS](/packages/seravo-wordpress/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (10)Versions (53)Used By (0)

[![Seravo.com](https://camo.githubusercontent.com/2d637581f5ef4c21cb3b6ed7d4db1f3a2a1ebaf2b25f08080da4a725dd15f4da/68747470733a2f2f73657261766f2e636f6d2f77702d636f6e74656e742f7468656d65732f73657261766f2f696d616765732f73657261766f2d62616e6e65722d383038783330302e706e67)](https://camo.githubusercontent.com/2d637581f5ef4c21cb3b6ed7d4db1f3a2a1ebaf2b25f08080da4a725dd15f4da/68747470733a2f2f73657261766f2e636f6d2f77702d636f6e74656e742f7468656d65732f73657261766f2f696d616765732f73657261766f2d62616e6e65722d383038783330302e706e67)

Seravo WordPress project template
=================================

[](#seravo-wordpress-project-template)

Brought to you by [Seravo.com](https://seravo.com).

A WordPress project layout for use with Git, Composer and Nginx. It also includes a config a Vagrant box and Docker image for local development.

This same project layout is used by default on all [Seravo.com](https://seravo.com) instances for easy deployment workflow. Contents of this repository equals to what you would have on the server in the directory `/data/wordpress/`.

Documentation
-------------

[](#documentation)

Please see our documentation at  on general information about git workflow with this project template.

Installation
------------

[](#installation)

> Please see our documentation at  on how to install Vagrant and its dependencies.

Features
--------

[](#features)

- Includes Nginx, MariaDB, PHP7, PHP8, Redis and Git for running WordPress in modern stack.
- Git hooks to test your code to make sure that only high quality code is committed into git
- Advanced WordPress acceptance tests with Codeception and headless Chrome
- [PHP Codesniffer](https://github.com/squizlabs/PHP_CodeSniffer) code style and quality analyzer
- Includes self-signed certs (and trust them automatically in OS X) to test https:// locally
- [Xdebug](http://xdebug.org/) and [Webgrind](https://code.google.com/p/webgrind/) for debugging and profiling your application
- [Mailcatcher](http://mailcatcher.me/) to imitate as SMTP server to debug mails
- [Adminer](http://www.adminer.org/) for a graphical interface to manage your database
- [BrowserSync](http://browsersync.io) as automatic testing middleware for WordPress

### Credentials for vagrant

[](#credentials-for-vagrant)

WordPress:

```
user:     vagrant
password: vagrant

```

MariaDB (MySQL):

```
user:     root
password: root

```

Development
-----------

[](#development)

The layout of this repo is designed in a way which allows storing the site in version control without exposing any confidential data. By default all sensitive data is ignored by git.

All plugins are handled by Composer so they are ignored by git. If you create custom plugins, force add them to git so that they are tracked or add new lines into `.gitignore` to not ignore.

Example of not ignore line in `.gitignore`:

```
!htdocs/wp-content/plugins/your-plugin/

```

If you create custom themes, they are automatically tracked in git.

Best way to develop custom plugins and themes is to add them into their own repositories and install them by composer. You can do this by adding `composer.json` for your plugin/theme and then requiring them in your project like:

```
"repositories": [
  {
      "type": "vcs",
      "url": "https://github.com/your-name/custom-plugin.git"
  }
],
"require": {
    "your-name/custom-plugin": "*"
}
```

Updates
-------

[](#updates)

Vagrant will let you know as soon as a new version of the Vagrant box is available. However, site environment will not be updated automatically to newer one.

To download and update your Vagrant box to use the newest image run:

```
vagrant box update
vagrant destroy
vagrant up

```

Configuration
-------------

[](#configuration)

### config.yml

[](#configyml)

Change `name` in config.yml to change your site name. This is used in quite some places in development environment.

Add `production => domain` and `production => ssh_port` to sync with your production instance.

Add new domains under `development => domains` before first vagrant up to have extra domains.

See `config-sample.yml` for more.

The Layout
----------

[](#the-layout)

The root of this repository equals the contents of the directory `/data/wordpress` in the Seravo.com instance.

```
├── config.yml # Project name, domains and other configuration
├── composer.json # Composer definition, used to pull in WordPress and plugins
├── composer.lock # Composer lock file. This is safe to delete and ignore as detailed dependency control is not relevant in WordPress.
├── gulpfile.js # Gulp example with correct paths
├── Vagrantfile # Vagrantfile for Seravo/WordPress Vagrant box
│
├── nginx # Custom modifications to Nginx which are also used in production
│   └── examples.conf # Some examples to get started
│   └── anything.conf # Your own config files can be named anything *.conf
│
├── scripts
│   ├── hooks # Git hooks for your project
│   │   ├── pre-commit # Run after every git commit
│   │   └── post-receive # Run after every git pull/push
│   │
│   ├── WordPress
│   │   └── Installer.php # Composer helper for WordPress installation
│   │
│   └── run-tests # Bash script as an interface for your tests in Seravo's production and development environments
│
├── vendor # Composer packages go here
└── htdocs # The web root of your site
    ├── wp-content # Directory moved out of WordPress core for git compatibility
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── languages
    ├── wp-config.php
    ├── wp-load.php
    ├── index.php
    └── wordpress # WordPress core
        ├── wp-admin
        ├── index.php
        └── ...

```

Credits
-------

[](#credits)

- Directory layout heavily inspired by [roots/bedrock](https://github.com/roots/bedrock)
- Development stack inspired by [VVV](https://github.com/Varying-Vagrant-Vagrants/VVV)

Copyright Seravo Oy, 2015–2023 and contributors. Available under the GPLv3 license.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance72

Regular maintenance activity

Popularity22

Limited adoption so far

Community27

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 52.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~193 days

Recently: every ~150 days

Total

21

Last Release

215d ago

Major Versions

0.8.3 → 1.02015-04-07

1.3 → v2.0.02024-02-21

PHP version history (2 changes)0.8.3PHP &gt;=5.3.2

v2.0.0PHP &gt;=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/c8f6762f3f88e0fd935c325980505195229a4f2fc7e4aa6fb1858d00a8117423?d=identicon)[Seravo](/maintainers/Seravo)

---

Top Contributors

[![ottok](https://avatars.githubusercontent.com/u/668724?v=4)](https://github.com/ottok "ottok (141 commits)")[![onnimonni](https://avatars.githubusercontent.com/u/5691777?v=4)](https://github.com/onnimonni "onnimonni (64 commits)")[![frimro](https://avatars.githubusercontent.com/u/78087609?v=4)](https://github.com/frimro "frimro (18 commits)")[![ypcs](https://avatars.githubusercontent.com/u/97568?v=4)](https://github.com/ypcs "ypcs (17 commits)")[![JoosuaKoskinen](https://avatars.githubusercontent.com/u/42264063?v=4)](https://github.com/JoosuaKoskinen "JoosuaKoskinen (12 commits)")[![k1sul1](https://avatars.githubusercontent.com/u/2719615?v=4)](https://github.com/k1sul1 "k1sul1 (4 commits)")[![spktklr](https://avatars.githubusercontent.com/u/5723744?v=4)](https://github.com/spktklr "spktklr (3 commits)")[![runomarsista](https://avatars.githubusercontent.com/u/19798954?v=4)](https://github.com/runomarsista "runomarsista (2 commits)")[![samikeijonen](https://avatars.githubusercontent.com/u/1820415?v=4)](https://github.com/samikeijonen "samikeijonen (1 commits)")[![sjaks](https://avatars.githubusercontent.com/u/44066308?v=4)](https://github.com/sjaks "sjaks (1 commits)")[![pekkakortelainen](https://avatars.githubusercontent.com/u/61181862?v=4)](https://github.com/pekkakortelainen "pekkakortelainen (1 commits)")[![ssaarikangas](https://avatars.githubusercontent.com/u/11611887?v=4)](https://github.com/ssaarikangas "ssaarikangas (1 commits)")[![tnottu](https://avatars.githubusercontent.com/u/4559075?v=4)](https://github.com/tnottu "tnottu (1 commits)")[![luuptekman](https://avatars.githubusercontent.com/u/31472433?v=4)](https://github.com/luuptekman "luuptekman (1 commits)")[![zArubaru](https://avatars.githubusercontent.com/u/16328509?v=4)](https://github.com/zArubaru "zArubaru (1 commits)")

---

Tags

composerphpseravovagrantvirtualboxwordpresscomposerwordpressdockerwpvagrantwp-palveluseravo

### Embed Badge

![Health badge](/badges/seravo-wordpress/health.svg)

```
[![Health](https://phpackages.com/badges/seravo-wordpress/health.svg)](https://phpackages.com/packages/seravo-wordpress)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[ronilaukkarinen/dudestack

A modern WordPress stack

1131.2k](/packages/ronilaukkarinen-dudestack)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
