Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ttskch/wordpress.skeleton
Composer based WordPress project skeleton.
https://github.com/ttskch/wordpress.skeleton
wordpress wordpress-packagist wordpress-skeleton
Last synced: 16 days ago
JSON representation
Composer based WordPress project skeleton.
- Host: GitHub
- URL: https://github.com/ttskch/wordpress.skeleton
- Owner: ttskch
- License: gpl-2.0
- Created: 2014-08-02T11:14:17.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-05-22T07:41:03.000Z (over 7 years ago)
- Last Synced: 2024-08-23T18:34:36.815Z (3 months ago)
- Topics: wordpress, wordpress-packagist, wordpress-skeleton
- Language: PHP
- Homepage: http://ttskch.github.io/WordPress.Skeleton/
- Size: 229 KB
- Stars: 46
- Watchers: 5
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WordPress.Skeleton
[](https://packagist.org/packages/wordpress/skeleton)
[](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
* PHP 5.3+
## Installation
```sh
$ 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
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 :bow:
```sh
$ 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
WordPress core will be installed in `/wp/` so root directory of your website will be `/wp/`. (e.g. "http://example.com/project-name/wp/")
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
### Using WordPress Packagist
You can use [WordPress Packagist](http://wpackagist.org) to install plugins (or themes) via composer like below:
```json
{
"require": {
"wpackagist-plugin/akismet": "dev-trunk",
"wpackagist-plugin/captcha": ">=3.9",
"wpackagist-theme/hueman": "*"
}
}
```
### 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:
```json
{
"repositories": [
{
"type": "package",
"package": {
"name": "something-on-github",
"type": "wordpress-plugin",
"version": "dev-master",
"source": {
"type": "git",
"url": "[email protected]: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
`/backup/` directory is just for saving (and version-managing) database and uploaded files. If you need, you can save them here like below:
```sh
$ mysqldump -u[user] -p [database] > backup/dump.sql
```
```sh
$ zip -r backup/uploads.zip wp/wp-content/uploads
```
## 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
* [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.