README

Use Vagrant to download and configure a LAMP stack for WordPress development. The environment is downloaded into a guest virtual machine on your local computer.

Installation

After installing this repository and running vagrant up use the vagrant ssh command to login to the guest machine. The guest machine's shared folder, /vagrant, should reflect all of the files in this repository.

Before installing this repository, download the Vagrant VM environment at https://www.vagrantup.com/downloads.html. Once installed, you can use Vagrant command line tools - especially vagrant up -- to complete the installation. The vagrant up command retrieves configuration settings from the Vagrantfile to download Virtual Box; then Composer can be used to complete the WordPress installation.

Command-line installation

Clone this repository then run the vagrant up --provision command.

Vagrant configuration

Configurations are listed as YML files. Default.yml is responsible for configuring environment variables; various playbooks are responsible for installing and configuring additional software. Playbooks are loaded in using the playbooks/playbooks.yml file.

Other programs installed as part of this environment are:

Apache2, The Apache web server.
MySQL, The MySQL database server.
PHP, The PHP CLI and Apache2 modules.
WordPress, The popular open-source CMS/blog software.
Composer, The PHP package manager.

Installation - Guest/Host

Vagrant and the vagrant up command will install a guest machine on your local computer (the host machine.) Guest and host machines communicate through one or more shared folders - typically /vagrant folder or any additional shared folders specified in the Vagrantfile.

Installation - Apache

WORKFLOW

Clone this repo
Install WordPress (into this repo directory)
- Optionally require WordPress in composer.json file
Run composer install
- Should install plugins
- Should install wireframe theme
- Optionally installs child theme as well

@TODO COMPOSER: REQUIRE

composer/installers
custom-sidebars
my-social-widget
wordpress-importer
wp-packagist/wireframe (clickpdx/wireframe in GitHub)

COMPOSER: REQUIRE-DEV

php
phpunit
wpackagist-plugin/fg-drupal-to-wp

Initial Project Setup

Download vagrant
Download virtualbox
Install both
Run vagrant up
Edit host name
Edit IP
Edit Host file in Win32/Drivers
Change host file to correspond with the virtualbox
Install wordpress
Add composer file to wordpress directory
Run vagrant ssh on root directory in powershell
Run composer update on wordpress directory to add plugins and the wireframe repo to file directory
Create a child theme folder with Functions.php and Styles.css in it, in wp-content/themes
Write header of styles.css to connect to the wireframe theme
Enque the styles in functions.php
Activate Child theme
Install plugins downloaded from the composer file to the child theme
Import content if rebuilding a site
Get content from xml file
Import/Export menus

Update database prompt url http://dev.ocdla.org/wp-admin/upgrade.php?_wp_http_referer=%2Fwp-admin%2F

plugin error messages: The plugin create-and-assign-categories-for-pages/create-and-assign-categories-for-pages.php has been deactivated due to an error: Plugin file does not exist.

The plugin custom-post-widget/custom-post-widget.php has been deactivated due to an error: Plugin file does not exist.

The plugin modal/modal.php has been deactivated due to an error: Plugin file does not exist.

The plugin wp-media-manager-lite/wp-media-manager-lite.php has been deactivated due to an error: Plugin file does not exist.

Username: admin@ocdla.org Password: password

clickpdx / devenv

Maintainers

Details