Srevilak: intial revision

2015-04-05T17:36:20Z

intial revision

New page

This is a brief description of how to set up a development environment
for Mass Pirate's crew site. Crew is based on Drupal an CiviCRM.

First, you'll need a copy of drupal 7. I'll assume you have it set up
in a directory structure like this:

0 sunny:www$ ls -ld drupal7
0 lrwxrwxrwx 1 srevilak users 11 Apr 5 12:10 drupal7 -> drupal-7.36/

where <tt>drupal-7.36</tt> is a directory containing a current drupal
release (available from drupal.org).

Set up your site files:

mkdir -p masspirates.org/crew
cd masspirates.org/crew
ln -s ../../drupal7/* .
rm sites
git init
git remote add origin ssh://masspiratesweb@rose.mayfirst.org/home/members/masspirateparty/sites/masspirates.org/users/masspiratesweb/masspirates.org/include/git/crew.git
git remote update
git checkout -b master origin/master

You'll need to create a mysql (or mariadb) database and database user.
Something like this should work:

create database mapp_drupal default character set utf8;
create user 'mapp_drupal'@'localhost' identified by 'some-password';
grant all privileges on mapp_drupal.* to 'mapp_drupal'@'localhost';

You'll also need a web server configuration. Here's what I'm using
(for an apache2 web server).

<Directory "/path/to/masspirates.org">
Options All
AllowOverride all
Require all granted
</Directory>

<VirtualHost localhost:80>
ServerName mapp.local
DocumentRoot /path/to/masspirates.org
RewriteEngine on
<Directory /path/to/masspirates.org>
AllowOverride all
</Directory>
</VirtualHost>

Don't forget the /etc/hosts entry for `mapp.local'.

At this point, http://mapp.local/crew should show you a drupal
installation screen. Go through the installation process.

Once you've gone through the installation process:

* login
* click Appearance (a menu item)
* Find the "Masspirates Drupal Theme". Click "Enable and set default"

* Click "Modules" menu item
* Enable: CiviCRM, CiviCRM Contact Reference Field, CiviCRM Theme, CiviMember Roles Sync, and Webform CiviCRM integration
* Drupal will tell you that a few additional modules need to be enabled. Let drupal enable them

Next: use
http://mapp.local/crew/sites/all/modules/civicrm/install/index.php to
start the CiviCRM installer.

Use the same connection information for both CiviCRM and Drupal
databases (i.e., they should be served out of the same database).

From here, complete the CiviCRM installation.

At this point, you have a skeletal installation of Civicrm and drupal.
Both applications rely heavily on the database for configuration;
although you've got a copy of all the site code (via git), you don't
have a copy of the database configuration. (These databases also have
supporter PII, so not having copies is probably a good thing).
However, you'll still be able to test out configuration changes, theme
work, etc.

To work on the sites theme, change the files in
<tt>crew/sites/all/themes/mapp</tt>. Create a new git branch, if you
feel that's appropriate for your work.

Crew Development Environment - Revision history

Srevilak: intial revision