PHPackages                             wordpress/skeleton - 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. wordpress/skeleton

ActiveLibrary

wordpress/skeleton
==================

Composer based WordPress project skeleton.

0.5.2(8y ago)461.7k↓100%8[1 issues](https://github.com/ttskch/WordPress.Skeleton/issues)GPL-2.0PHPPHP >=5.3

Since Aug 2Pushed 8y ago3 watchersCompare

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

READMEChangelogDependencies (4)Versions (28)Used By (0)

WordPress.Skeleton
==================

[](#wordpressskeleton)

[![image](https://cloud.githubusercontent.com/assets/4360663/15803328/f4f2f660-2b12-11e6-8d4e-59461e223640.png)](https://cloud.githubusercontent.com/assets/4360663/15803328/f4f2f660-2b12-11e6-8d4e-59461e223640.png)

[![Latest Stable Version](https://camo.githubusercontent.com/8e9e0c64f7a2736e37dcb2b3a5f0260ce9eb8caa34a75571ee111a148335a4e7/68747470733a2f2f706f7365722e707567782e6f72672f776f726470726573732f736b656c65746f6e2f762f737461626c652e737667)](https://packagist.org/packages/wordpress/skeleton)[![Total Downloads](https://camo.githubusercontent.com/7585e315649255ebee2b87c460ad047de15e773812f3cbb37e4e197598475d7b/68747470733a2f2f706f7365722e707567782e6f72672f776f726470726573732f736b656c65746f6e2f646f776e6c6f6164732e737667)](https://packagist.org/packages/wordpress/skeleton)

WordPress project skeleton to focus only your own source codes because of composer-friendly design. Inspired by [markjaquith/WordPress-Skeleton](https://github.com/markjaquith/WordPress-Skeleton).

Advantages compared to WordPress-Skeleton:

- You can install via `composer create-project`.
- You can add plugins via `composer require/install`.
- You don't need to do `git submodule init/update`. (so installing is very fast)
- You can set `/wp/` as DocumentRoot. (in other words, **you can hide "/wp/" from url**)
- It works even on descendant directory of DocumentRoot. (you can get it to work casually ,without vhost settings, for local development)
- All languages will be installed by default.

Requirements
------------

[](#requirements)

- PHP 5.3+

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

[](#installation)

```
$ composer create-project wordpress/skeleton {project-name}
$ cd {project-name}
$ cp local-config-sample.php local-config.php
$ vi local-config.php # tailor to your environment
```

You can use Japanese or English environment as you like.

### Note: For Windows

[](#note-for-windows)

On Windows environment, maybe you need to use console (like cmd.exe) as an administrator user for creating symlink.

If you still have any symlink related problem, please create-project in following way 🙇

```
$ composer create-project wordpress/skeleton {project-name} --no-scripts
$ cd {project-name}
$ mklink /D wp\wp-content\my-themes ..\..\wp-content\themes # or create symlink in some way
$ mklink /D wp\wp-content\uploads ..\..\wp-content\uploads # or create symlink in some way
$ rm -rf wp/wp-content/plugins
$ mklink /D wp\wp-content\plugins ..\..\wp-content\plugins # or create symlink in some way
$ cp local-config-sample.php local-config.php
$ vi local-config.php # tailor to your environment
```

Usage
-----

[](#usage)

WordPress core will be installed in `/wp/` so root directory of your website will be `/wp/`. (e.g. "")

If you want to hide `/wp/` from URL you should set DocumentRoot to `/path/to/project/wp/`.

Now you can create your own theme in `/wp-content/themes/` and install some plugins into `/wp-content/plugins/` via composer (as described in the next chapter). And your git repository doesn't manage `/wp/` so **you can focus only your own source codes** in `/wp-content/themes`.

Installing plugins via composer
-------------------------------

[](#installing-plugins-via-composer)

### Using WordPress Packagist

[](#using-wordpress-packagist)

You can use [WordPress Packagist](http://wpackagist.org) to install plugins (or themes) via composer like below:

```
{
    "require": {
        "wpackagist-plugin/akismet": "dev-trunk",
        "wpackagist-plugin/captcha": ">=3.9",
        "wpackagist-theme/hueman": "*"
    }
}
```

### Installing plugins form GitHub or zip file

[](#installing-plugins-form-github-or-zip-file)

You can also install some plugins (which isn't on WordPress.org) from GitHub repository, zip file, and so on. To do that you should add package with `"type": "wordpress-plugin"` and require it like below:

```
{
    "repositories": [
        {
            "type": "package",
            "package": {
                "name": "something-on-github",
                "type": "wordpress-plugin",
                "version": "dev-master",
                "source": {
                    "type": "git",
                    "url": "git@github.com:someone/something.git",
                    "reference": "master"
                }
            }
        },
        {
            "type": "package",
            "package": {
                "name": "something-of-zip",
                "type": "wordpress-plugin",
                "version": "1.0",
                "dist": {
                    "type": "zip",
                    "url": "http://something.com/download/1.0.zip"
                }
            }
        }
    ],
    "require": {
        "something-on-github": "dev-master",
        "something-of-zip": "1.0"
    }
}
```

Backing up database and uploaded files
--------------------------------------

[](#backing-up-database-and-uploaded-files)

`/backup/` directory is just for saving (and version-managing) database and uploaded files. If you need, you can save them here like below:

```
$ mysqldump -u[user] -p [database] > backup/dump.sql
```

```
$ zip -r backup/uploads.zip wp/wp-content/uploads
```

Mechanism, FYI
--------------

[](#mechanism-fyi)

After install/update "wordpress" package, a symlink will be created in `/wp/` environment as shown below:

- `/wp/wp-content/my-themes` -> `/wp-content/themes`

And on WordPress's booting process, `/wp/wp-content/my-theme` will be enabled as an additional theme directory by following process:

1. `WPMU_PLUGIN_DIR` points `/wp-content/mu-plugins` because of customizing in `/wp-config.php`.
2. In `/wp-content/mu-plugins/add-skeleton-theme-directory.php`, theme directory is added with `register_theme_directory()` function.

Just to tell you, `/wp-config.php` (and `/local-config.php`) need not be symlinked into `/wp/` because they will loaded from `/wp/wp-load.php` during WordPress' normal booting process.

Commonly-used plugins
---------------------

[](#commonly-used-plugins)

- [TinyMCE Advanced](https://wordpress.org/plugins/tinymce-advanced/)
- [Google XML Sitemaps](https://wordpress.org/plugins/google-sitemap-generator/)
- [Acunetix Secure WordPress](https://wordpress.org/plugins/secure-wordpress/)
- [Simple Local Avatars](https://wordpress.org/plugins/simple-local-avatars/)
- [User Role Editor](https://wordpress.org/plugins/user-role-editor/)
- [jyokyoku/wp-ogp-customized](https://github.com/jyokyoku/wp-ogp-customized)
    - Doesn't work on PHP 7. Use [ttskch/wp-ogp-customized](https://github.com/ttskch/wp-ogp-customized) instead.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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 ~39 days

Recently: every ~54 days

Total

27

Last Release

3274d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/169f04c4d89617edd84f1aa4fd7949e12fe93cba573430964916ff67e12afe4e?d=identicon)[ttskch](/maintainers/ttskch)

---

Top Contributors

[![ttskch](https://avatars.githubusercontent.com/u/4360663?v=4)](https://github.com/ttskch "ttskch (5 commits)")[![kouhei-fuji](https://avatars.githubusercontent.com/u/4433646?v=4)](https://github.com/kouhei-fuji "kouhei-fuji (2 commits)")[![solidpeat](https://avatars.githubusercontent.com/u/1122219?v=4)](https://github.com/solidpeat "solidpeat (2 commits)")[![gelbehexe](https://avatars.githubusercontent.com/u/11911831?v=4)](https://github.com/gelbehexe "gelbehexe (1 commits)")

---

Tags

wordpresswordpress-packagistwordpress-skeletoncomposerwordpressSkeletonwpackagist

### Embed Badge

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

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

###  Alternatives

[ronilaukkarinen/dudestack

A modern WordPress stack

1131.2k](/packages/ronilaukkarinen-dudestack)

PHPackages © 2026

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