markburgess.us

Instructions

1. Make sure the requirements listed on the main page are met.
2. Copy the ShokadoWeb folder to your Sites folder
3. Edit the config.php file***
4. Point your browser to http://computername/~username/ShokadoWeb, where computer name is your computer's name and username is your short name.
5. Read "Configuring Permissions"
6. Read the documents Readme.rtf and Upgrade.rtf included in the distribution. They may contain important updated instructions or information.

Configuring Permissions

If you receive errors, check that your web sharing process (i.e. Apache or HTTPD) has permission to the Bento database. There are two ways to accomplish this:

1. Modify /etc/apache2/httpd.conf so that Apache runs as your user account. Look for two lines in the file starting with "User" and "Group". Change the User to be joe if that is your user name.
2. Modify the file permissions on the directory where the Bento database is. If your Apache server is running as "www", according to the httpd.conf file, and your short name is "joe" then go to the Terminal and type:

   chmod -R +a "www allow read" /Users/joe/Library

   chmod -R +a "www allow execute" /Users/joe/Library

3. It may be necessary to ensure that web sharing has write access to your sites folder, in order for images to display and for media item support. Use the following terminal command:

   chmod -R +a "www allow write" /Users/joe/Sites

** Enabling PHP

1. Open /etc/apache2/httpd.conf with an editor (e.g. sudo pico /etc/apache2/httpd.conf)
2. Make sure the following line is not commented out:

   LoadModule php5_module libexec/apache2/libphp5.so

3. Once the line is uncommented, save the file and start or restart web sharing

*** Editing the config.php file

1. Open the file in TextEdit or some other plain text editor.
2. Look for the following line:
• $bentoDB = "sqlite:/Users/markb/Library/Application Support/Bento/bento.bentodb/Contents/Resources/Database";

You should just have to change the user name (from markb to your shortname) after sqlite:/Users/ and before /Library/Application Support/Bento/bento.bentodb/Contents/Resources/Database

3. Look for the following line:
• $abDB="sqlite:/Users/markb/Library/Application Support/AddressBook/AddressBook-v22.abcddb";

You should just have to change the user name (from markb to your shortname) after sqlite:/Users/ and before /Library/Application Support/AddressBook/AddressBook-v22.abcddb

4. Look for the following line:
• $bentoApp = "/Applications/Bento.app";

If you have installed Bento in your Applications folder (which would be normal) you should not have to change this setting. If you have, then change it accordingly.

5. Set $allowShowDetails=1 to allow users to access record details, or to 0 to prevent this.
6. (Version prior to 2.04 only) Set $alwaysTryIcons=1 if you want to try to load library icons. This will most likely not work if you are not using Safari, because other browsers can't render inline TIFF images.
7. Save the file.

A japanese translation of the instructions, kindly written by Atsushi Yago, is available on his blog here: http://fx-gp.seesaa.net/article/116188430.html