Installation Directions

back

1. You will need php, mysql, GD and freetype.
2. Download the compressed file from Activist in a Box.
3. Unzip the file. The folder 'contacts' should contain everything you need to make the contact form work.
4. Create a database and install the table using this sql:
   
   CREATE TABLE IF NOT EXISTS `box_contact_us` ( `cid` int(4) NOT NULL auto_increment, `nameFirst` varchar(20) NOT NULL default '', `nameMiddle` varchar(20) default NULL, `nameLast` varchar(20) default NULL, `title` varchar(200) default NULL, `photo` varchar(200) default NULL, `email` varchar(200) NOT NULL default '', `phone` varchar(20) default NULL, `allow` tinyint(1) default '0', `sortOrder` int(4) default '0', `dateCreate` int(16) NOT NULL default '0', `dateMod` int(16) NOT NULL default '0', PRIMARY KEY (`cid`) ) ENGINE=MyISAM DEFAULT CHARSET=latin1 COMMENT='GRRN Contacts' AUTO_INCREMENT=10 ; -- -- Dumping data for table `box_contact_us` -- INSERT INTO `box_contact_us` (`cid`, `nameFirst`, `nameMiddle`, `nameLast`, `title`, `photo`, `email`, `phone`, `allow`, `sortOrder`, `dateCreate`, `dateMod`) VALUES (1, 'Ted', 'T.', 'Tasco', 'Lemon Zester', '/contact/images/frog2.jpg', 'noreply@domain.com', NULL, 1, NULL, 1155102687, 1232233927), (2, 'Jed', 'J.', 'Jolly', 'Court Jester', '/contact/images/frog.jpg', 'noreply@yourdomain.com', NULL, 1, NULL, 1155113794, 1232233950), (3, 'Mel', 'M.', 'Foo', 'Mallet Tester', NULL, 'noreply@anotherdomain.com', '914-555-1212', 1, NULL, 1155113897, 1232233974), (7, 'John', NULL, 'Smith', 'Webmaster', NULL, 'you@yourdomain.com', NULL, 1, NULL, 1155113897, 1232233993);
5. Edit config file /contacts/assets/box.php to include your database settings.
   1. $hostname_box: whereever your database is hosted. Often 'localhost'. Sometimes something like mysql.domain.com.
   2. $database_box: the name of the database
   3. $username_box: the user name
   4. $password_box: the password
      
6. Edit config file /contacts/assets/config.php to include your preferred information:
   1. $BAS_mode: for testing purposes - see the config file. Otherwise leave blank.
   2. $BASnumimgchars: number of characters to use in the image.
   3. $BASaddimgnoise: add some random lines to the image.
   4. $BAS_companyname: Change this to your actual company name.
   5. $BAS_fromemail: Change this to the email that will be in the 'From' field for the 'Thanks' auto reply. Usually this will be something like 'noreply@domain.com'. This address either doesn't exist or is set to send all replies to the recycle bin.
   6. $BAS_colorscheme: You have a choice of green, sea, blue, red, purple or brown.
   7. $BAS_chars: You can choose between numbers, lower-case letters, uppercase letters or numbers with lower-case letters.
7. Upload the entire contact folder to your webroot.
8. Apache password protection method:
   There are two files at "/contact/admin/temp/". We'll use those to protect the admininstrative area with a user name and password.
   1. The .htaccess file should actually go to /contact/admin/.htaccess
      Edit this file so that the first line reads (most likely) thus:
      "AuthUserFile /home/gr33nman/.htpasswd".
      
   2. The .htpasswd file should to /home/<path to file>/.htpasswd, most likely here:
      /home/gr33nman
   3. Remove the temp folder.
   4. If you do not use this password protection scheme, please be sure to find another method to protect the administrative folder from prying eyes.
   5. Username: activistinabox
   6. Password: mintyfresh
   7. Change the user password by generating an apache password as appropriate.
9. In a browser, go to http://www.yourdomain.com/contact/
   Everything should work.
10. DO NOT leave the administrative area unprotected. If you can't protect it immediately, edit the database until you're happy with the contacts you need, and delete the administrative interface temporarily until you have time to figure it out.