Inmemoriam Media Gallery - Install Document

Last Modified: Nov 26, 2005
E-mail: ajdeeley@summitpages.ca
Web site: http://summitpages.ca

Inmemoriam Media Gallery 1.0

Introduction This is the Inmemoriam Media Gallery plugin for Geeklog 1.4. See public_html/inmemoriam/docs/usage.html for more information and a list of features.
License This GeekLog Plug-in, like GeekLog is released under the GNU General Public License. It is a bona fide Open Source / Free Software project. Like all good open source projects, GeekLog and this Plug-in both depend on the community. Thanks for your continued support, and let us know what we can do to make GeekLog and the plugin even better.
Installation It is recommended that you read and reference the Plugin Installation Overview documentation located on the GeekLog Documentation Project site. There is a lot more detail on how to install plugins including annotated images. The Plugin installation requires that you manually create the plugin program directories and copy the program files into their appropriate directories.

Database backup
Make a backup of your current GeekLog database using the built-in admin feature. Verify your backup feature is configured correctly and backup file is not 0 bytes (This is worth a check)
Copy plugin files into their required directories
- Need to create these directories as noted below:
uncompress the archive files into your $_CONF['path']/plugins/ directory. It will create an inmemoriam/ directory and associated subdirectories for the files. You will need to move the files in the admin and public_html subdirectories to their appropriate directory as indicated below. If you are already confused, check out this GL post.

public_html/
- Main program files
The contents of the public_html directory under your new plugins/inmemoriam/ folder need to be moved to $_CONF['path_html']/inmemoriam/ directory. You will need to first create the: $_CONF['path_html']/inmemoriam/ directory.
admin/
-Plugin Install and Main admin program files
The files in the admin directory under your new plugins/inmemoriam/ folder need to be moved to $_CONF['path_html']/admin/plugins/inmemoriam/ directory. You will need to first create the: $_CONF['path_html']/admin/plugins/inmemoriam/ directory.
pear/
-Pear image manipulation package, etc.
The contents of the pear directory under your new plugins/inmemoriam/ folder need to be moved to $_CONF['path']/system/pear/ directory. This directory already exists.
Directory and File Permissions
Directory and File owner should be same as web server.
All the files and directories should have Read permissions and directories need execute. Setting all plugin files and directories to have read + execute should not be a security issue but PHP files only need read access to execute. The directories need execute rights in order for them to be searched or accessed.
The following directories must be made writable, e.g., chmod 777:

Logged in as admin
In your browser, go to http://your_geeklog_url/admin/plugins/inmemoriam/install.php
Note: The installer is designed to back out any database changes if there should be an error. You can monitor the installer by viewing the error.log, file $_CONF['path']/logs/error.log.
Verify successful operation
Did you get a successful completion message that your database tables have been created--this message is found in your error log.
There should now be an Inmemoriam link visible leading to the album creation page.
As admin, you should see the Inmemoriam menu item in the Admin Block.
Check the install logging in the $_CONF['path']/logs/error.log file
Note: in order to accommodate the upgrade script, the option to disable the menu item makes no difference. However, once you have successfully upgraded to or installed version 1.0, go to the function plugin_getmenuitems_inmemoriam() in the functions.inc file and follow the instructions therein in order to enable this frivolous feature.

Step 1: Always backup your stuff!
Step 2: Copy the files from the 1.0 archive into their appropriate directories as outlined above. Most of the files have changed so the old files will have to be overwritten or deleted.
Step 3: Log in to your site and make your way to http://yoursite.com/admin/plugins.php. Find Inmemoriam in the list of installed plugins and take note of the version numbers. You should read "0.8.5/1.0 respectively if you have properly copied over your new files.
Step 4: Click on the list item "inmemoriam" and you will come to the plugin editor page where you have a selection of actions to choose from. Click the "update" button. You should be redirected to your site's main page with a success/error message.
Step 5: Confirm a successful upgrade by reviewing your error log file for processing messages.
One last thing: in order to accommodate the upgrade script, the new option to disable the menu item makes no difference. However, once you have successfully upgraded to or installed version 1.0, go to the function plugin_getmenuitems_inmemoriam() in the functions.inc file and follow the instructions therein in order to enable this frivolous feature.

Same as above with the exception of Step 3 where you should read "0.9.0/1.0" or 1.0cvs/1.0 respectively in the admin's plugin list prior to upgrading.

Go to Admin Block/Plugins
Find the plugin in the list of plugins, click the number, then press Delete, confirm (or not) deletion, this will remove all the plugin data from your database.
Delete the three plugin directories created in the install process: $_CONF['path']/plugins/inmemoriam/; $_CONF['path_html']/inmemoriam/; and $_CONF['path_html']/admin/plugins/inmemoriam/. This process will also remove any media submitted to Inmemoriam.