Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/docksal/boilerplate-bedrock
Bedrock (Wordpress with Composer) boilerplate powered by Docksal
https://github.com/docksal/boilerplate-bedrock
Last synced: 7 days ago
JSON representation
Bedrock (Wordpress with Composer) boilerplate powered by Docksal
- Host: GitHub
- URL: https://github.com/docksal/boilerplate-bedrock
- Owner: docksal
- License: mit
- Created: 2018-07-04T05:43:44.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-04-23T04:45:51.000Z (over 2 years ago)
- Last Synced: 2024-04-13T21:54:55.950Z (7 months ago)
- Language: PHP
- Homepage: https://docksal.io
- Size: 25.4 KB
- Stars: 10
- Watchers: 5
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Docksal Powered Bedrock (Wordpress Composer Version)
Features:
- WordPress w/ Composer
## Setup instructions
1. Clone this repo into your Projects directory
```
git clone https://github.com/docksal/bedrock.git
cd bedrock
```
1. Initialize the site
This will run composer install, initialize local settings, and install the site via wp-cli
```
fin init
```
1. Point your browser to
```
http://bedrock.docksal
```
-------------
# [Bedrock](https://roots.io/bedrock/)
[](https://packagist.org/packages/roots/bedrock)
[](https://travis-ci.org/roots/bedrock)
Bedrock is a modern WordPress stack that helps you get started with the best development tools and project structure.
Much of the philosophy behind Bedrock is inspired by the [Twelve-Factor App](http://12factor.net/) methodology including the [WordPress specific version](https://roots.io/twelve-factor-wordpress/).
## Features
* Better folder structure
* Dependency management with [Composer](http://getcomposer.org)
* Easy WordPress configuration with environment specific files
* Environment variables with [Dotenv](https://github.com/vlucas/phpdotenv)
* Autoloader for mu-plugins (use regular plugins as mu-plugins)
* Enhanced security (separated web root and secure passwords with [wp-password-bcrypt](https://github.com/roots/wp-password-bcrypt))
Use [Trellis](https://github.com/roots/trellis) for additional features:
* Easy development environments with [Vagrant](http://www.vagrantup.com/)
* Easy server provisioning with [Ansible](http://www.ansible.com/) (Ubuntu 16.04, PHP 7.1, MariaDB)
* One-command deploys
See a complete working example in the [roots-example-project.com repo](https://github.com/roots/roots-example-project.com).
## Requirements
* PHP >= 5.6
* Composer - [Install](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx)
## Installation
1. Create a new project in a new folder for your project:
`composer create-project roots/bedrock your-project-folder-name`
2. Update environment variables in `.env` file:
* `DB_NAME` - Database name
* `DB_USER` - Database user
* `DB_PASSWORD` - Database password
* `DB_HOST` - Database host
* `WP_ENV` - Set to environment (`development`, `staging`, `production`)
* `WP_HOME` - Full URL to WordPress home (http://example.com)
* `WP_SITEURL` - Full URL to WordPress including subdirectory (http://example.com/wp)
* `AUTH_KEY`, `SECURE_AUTH_KEY`, `LOGGED_IN_KEY`, `NONCE_KEY`, `AUTH_SALT`, `SECURE_AUTH_SALT`, `LOGGED_IN_SALT`, `NONCE_SALT`
If you want to automatically generate the security keys (assuming you have wp-cli installed locally) you can use the very handy [wp-cli-dotenv-command][wp-cli-dotenv]:
wp package install aaemnnosttv/wp-cli-dotenv-command
wp dotenv salts regenerate
Or, you can cut and paste from the [Roots WordPress Salt Generator][roots-wp-salt].
3. Add theme(s) in `web/app/themes` as you would for a normal WordPress site.
4. Set your site vhost document root to `/path/to/site/web/` (`/path/to/site/current/web/` if using deploys)
5. Access WP admin at `http://example.com/wp/wp-admin`
## Deploys
There are two methods to deploy Bedrock sites out of the box:
* [Trellis](https://github.com/roots/trellis)
* [bedrock-capistrano](https://github.com/roots/bedrock-capistrano)
Any other deployment method can be used as well with one requirement:
`composer install` must be run as part of the deploy process.
## Documentation
Bedrock documentation is available at [https://roots.io/bedrock/docs/](https://roots.io/bedrock/docs/).
## Contributing
Contributions are welcome from everyone. We have [contributing guidelines](https://github.com/roots/guidelines/blob/master/CONTRIBUTING.md) to help you get started.
## Community
Keep track of development and community news.
* Participate on the [Roots Discourse](https://discourse.roots.io/)
* Follow [@rootswp on Twitter](https://twitter.com/rootswp)
* Read and subscribe to the [Roots Blog](https://roots.io/blog/)
* Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)
* Listen to the [Roots Radio podcast](https://roots.io/podcast/)
[roots-wp-salt]:https://roots.io/salts.html
[wp-cli-dotenv]:https://github.com/aaemnnosttv/wp-cli-dotenv-command