Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/szepeviktor/composer-managed-wordpress
Install and manage WordPress with Composer 👨🚀
https://github.com/szepeviktor/composer-managed-wordpress
composer install manage packagist wordpress wordpress-development wordpress-site
Last synced: 4 months ago
JSON representation
Install and manage WordPress with Composer 👨🚀
- Host: GitHub
- URL: https://github.com/szepeviktor/composer-managed-wordpress
- Owner: szepeviktor
- License: mit
- Created: 2022-06-06T11:18:14.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-26T04:41:08.000Z (4 months ago)
- Last Synced: 2024-09-27T14:41:14.454Z (4 months ago)
- Topics: composer, install, manage, packagist, wordpress, wordpress-development, wordpress-site
- Language: Shell
- Homepage: https://github.com/szepeviktor/wordpress-website-lifecycle
- Size: 87.9 KB
- Stars: 25
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Composer managed WordPress
You may learn how I install WordPress.
Almost everything will come from Composer packages, the rest is under version control (git).
Thus the repository of a WordPress installation should barely contain files.
## Support my work
Please consider sponsoring me monthly if you use my packages in an agency.
[](https://github.com/sponsors/szepeviktor)
## Directory structure
Most of these files are excluded from this repository as they are installed by Composer!
- `/`: root directory with configuration files and documents
- `vendor/`: dependencies (packages)
- `public/`: webserver's document [root](https://github.com/szepeviktor/RootFiles) with `index.php`, `wp-config.php`, `favicon.ico`
- `public/$PROJECT_NAME/`: WordPress core
- `public/wp-content/`: `wp-content` directory
```
vendor/
UPGRADE.md
composer.json
composer.lock
wp-cli.yml
public/─┬─index.php (modified)
├─wp-config.php
├─PROJECT_NAME/─┬─index.php
│ ├─wp-load.php
│ ├─wp-login.php
│ ├─wp-admin/
│ └─wp-includes/
└─wp-content/
```
## Package types
- Themes from WordPress.org's theme directory through wpackagist
- Your [custom theme](https://github.com/szepeviktor/starter-theme) should be developed as a separate package in a repository of its own
- Plugins from WordPress.org's plugin directory through wpackagist
- Your [custom plugins](https://github.com/szepeviktor/starter-plugin) should be developed as separate packages
- Purchased plugins can be installed by `ffraenz/private-composer-installer`
- Must-use plugins and dropins can be installed by `koodimonni/composer-dropin-installer`
All other files - except `public/wp-config.php` - should be kept under version control.
## Usage
1. Run WordPress core, plugins and theme on PHP 7.4
([as of 2023](https://johnbillion.github.io/wp-stats/php.html))
1. Change the directory name "project" in `.gitignore`, `composer.json`, `public/index.php`, `wp-cli.yml`
1. Customize `composer.json` and create documents
1. Create `.env` if you have purchased plugins
1. Add [MU plugins](https://github.com/szepeviktor/wordpress-website-lifecycle/tree/master/mu-plugins)
1. Set GitHub OAuth token if you develop a private theme or plugins
`composer config github-oauth.github.com "$YOUR_GITHUB_TOKEN"`
1. Create [`public/wp-config.php`](https://github.com/szepeviktor/wordpress-website-lifecycle/blob/master/wp-config/wp-config.php)
including `WP_CONTENT_DIR` and `WP_CONTENT_URL` pointing to `public/wp-content`, and loading `vendor/autoload.php`
1. Set `WP_ENVIRONMENT_TYPE` environment variable
(in [PHP-FPM configuration](https://github.com/szepeviktor/debian-server-tools/blob/master/webserver/phpfpm-pools/Skeleton-pool.conf)
or in `public/wp-config.php`)
1. Issue `composer update --no-dev`
1. Administer your WordPress installation with [WP-CLI](https://make.wordpress.org/cli/handbook/guides/installing/)
```bash
wp core install --title="WP" --admin_user="myname" --admin_email="[email protected]" --admin_password="12345"
wp option update home "https://example.com"
wp option update siteurl "https://example.com/project"
```
## WordPress core installation
These are possible variations.
- **`roots/wordpress-no-content` + `johnpbloch/wordpress-core-installer`**
- `johnpbloch/wordpress`
- `repositories.package` with current ZIP file from wordpress.org
- `roots/wordpress`
Packages provided by Roots point to wordpress.org ZIP files and git repositories.