Creating a occupyboston.org Development Environment

= Creating a occupyboston.org (wordpress) development environment =

Obtaining the Source
mkdir occupyboston.org cd occupyboston.org git init git remote add origin occubos@boggs.mayfirst.org:/home/members/occupyboston/sites/occupyboston.org/users/occubos/occupyboston.org/include/site_hub git fetch origin git merge origin/master

The "occupyboston.org" directory will be your document root.

Setup a Virtual Host
Add an IP/hostname mapping to your hosts file (e.g., /etc/hosts). For example:

127.0.0.1    occupyboston.local

Add a virtualhost to your web server. For example:

 ServerName occupyboston.local DocumentRoot /PATH/TO/occupyboston.org/ 

Create a Database
Run

$ mysql -uUSERNAME -p mysql> create database occubos_wp; mysql> grant all privileges on occubos_wp.* to 'occubos_wp'@'localhost' identified by 'secret-password'; mysql> exit

Configuration Setup
cd occupyboston.org  # this is the document root cp wp-config-sample.php wp-config.php

Configuration Changes
Edit wp-config.php; focus on the below lines.

define('DB_NAME', 'database_name_here');

/** MySQL database username */ define('DB_USER', 'username_here');

/** MySQL database password */ define('DB_PASSWORD', 'password_here');

Modify 'database_name_here', 'username_here', 'password_here' to the correct values above.

Web Based Installation
Start up a web browser and enter the following URL: http://occupyboston.local/. If all has gone well, you'll be redirected to http://occupyboston.local/wp-admin/install.php. Follow the instructions to finish the installation.

Afterwards, log into your development site via http://occupyboston.local/wp-login.php.

At this point, you'll have a wordpress installation, containing all of the plug-ins used by occupyboston.org. It won't look anything like occupyboston.org, yet.

Theme Setup
Theme. Go to http://occupyboston.local/wp-admin/themes.php. Activate theme "OccupyBoston 1.1.1".

News Banner. Click "Widgets" option for the OccupyBoston 1.1.1 theme. Put a text widget into "Widget area 2". Give a title of "LATEST NEWS" and body of "Latest news". This will become news bar content at the top of the site. If you don't perform this step, you'll see the text "Disabled" where the news banner would normally be.

Logo. occupyboston.org's logo is not version controlled. To get a local copy:

cd DOCUMENT_ROOT/wp-content mkdir -m 777 uploads cd uploads wget URL -O logo.png

DOCUMENT_ROOT represents the document root of your wordpress installation. URL represents the url of occupyboston.org's logo. ( http://www.occupyboston.org/wp-content/uploads/2011/10/Occupy-Boston-Header2.png, or something along those lines)

Once you've done this, http://occupyboston.local/wp-content/uploads/logo.png should display a logo. In the Themes section, click "CP Minimal settings", and provide the URL of your logo image.

Menus. occupyboston.org menus are provided by the jquery-mega-menu plugin. This plugin will be present (but not activiated) in a new development environment. (TODO: menu setup instructions).

General Options. Go to http://occupyboston.local/wp-admin/options-general.php, and set whatever options you'd like. For example, you might want to give a Site Title of "Occupy Boston Dev".

On http://occupyboston.local/wp-admin/options-permalink.php, select the "Day and name" option.

TODO: additional plugin setup?

Miscellaneous Notes
The live apache configuration is ~occubos/occupyboston.org/.red/apache2. There's not much to it. (from git) contains the bulk of the apache configuration.