Creating a occupyboston.org Development Environment: Difference between revisions

From wiki.occupyboston.org
Jump to navigation Jump to search
(worked through instructions. Added additional details)
(→‎Theme Setup: another TODO)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Creating a occupyboston.org development environment =  
= Creating a occupyboston.org (wordpress) development environment =  


== Obtaining the Source ==
== Obtaining the Source ==
Line 71: Line 71:
Afterwards, log into your development site via http://occupyboston.local/wp-login.php.
Afterwards, log into your development site via http://occupyboston.local/wp-login.php.


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


('''TODO:''' this wordpress installation will look nothing like the occupyboston.org; need to add additional instructions for setting up themeing, etc).
=== 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.
(<nowiki>http://www.occupyboston.org/wp-content/uploads/2011/10/Occupy-Boston-Header2.png</nowiki>, or something along those lines)
 
Once you've done this,
<nowiki>http://occupyboston.local/wp-content/uploads/logo.png</nowiki> 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 ==
== Miscellaneous Notes ==


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

Latest revision as of 14:46, 13 May 2012

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:

 <VirtualHost localhost:80>
   ServerName occupyboston.local
   DocumentRoot /PATH/TO/occupyboston.org/
 </VirtualHost>

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. .htaccess (from git) contains the bulk of the apache configuration.