Logo Links Plugin - Install Document
Logo Links Plugin Version 0.6
by Alford Deeley aka machinari
Last Modified: May 1, 2004
E-mail: ajdeeley@summitpages.ca
Web site: http://summitpages.ca
Logo Links Plugin 0.6
- Introduction
- License
- Installation
- Uninstall
- Introduction
This is the Logo Links plugin using the GL Plugin API calls--some of them.
It's most basic function displays a page of logos, which are linked to some
web address that you specify. A random logo PHP block is also available.
- 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 <geeklog_dir>/plugins
directory. It will create a logos/ directory and associated subdirectories
for the files. You will need to move the files in the admin and public subdirectories
to their appropriate directory as indicated below.
- public_html/
- Main program files
The files in the public directory under your new plugins/logos/ folder need
to be moved to <geeklog_dir>/public_html/logos/ directory. You will need to
first create the: <geeklog_dir>/public_html/logos/ directory.
- admin/
-Plugin Install and Main admin program files
The files in the admin directory under your new plugins/logos/ folder need to be
moved to <geeklog_dir>/public_html/admin/plugins/logos/ directory. You will need
to first create the: <geeklog_dir>/public_html/admin/plugins/logos/ directory.
- Directory and File Permissions
Directory and File owner should be same as web server (server takes care of this).
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 images/ dir, <pubilc_html>/logos/images/, must be writable.
- Run the install program
- Logged in as admin
In your browser, go to http://your_geeklog_url/admin/plugins/logos/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 <geeklog_dir>/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 a Logo Links link in your top header. If not, refresh the page.
As admin, you should see the Logo Links menu item in the Admin Block.
- Check the install logging in the <geeklog_dir>/logs/error.log file
- One last step:
You should now see a <public_html>/logos/images/ directory. This directory must be
made writable if you plan to upload any logos images. If you do not see this directory
then it will have to be created.
- Uninstall:
- 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: <geeklog-dir>/plugins/logos/;
<public_html>/logos/; and <admin>/plugins/logos/.