Integration:Geeklog - Gallery Codex
Personal tools

Integration:Geeklog

From Gallery Codex

Revision as of 19:50, 13 August 2007 by Suprsidr (Talk | contribs) (page creation)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Description

G2Bridge is a Geeklog plugin which allows integration of the Gallery2 image gallery into your Geeklog site.

By default, the bridge installs a random photo block, which is enabled, and a Gallery2 control block [the G2 sidebar], which is disabled.
The control block is explained on the G2Bridge admin page.
*In order for the random photo block to work, you must have the 'Image Block' module installed.
You can find the 'Image Block' module on the G2 downloads page or check your G2's admin its probably already there.

Note that although G2Bridge maps users from one app to the other, it does not map group permissions.

Version History

  • v2.0 [5 Aug 2007]
    • [fix] Updated GL detection of anon user for 1.4.1. Minor cleanup of other functions.
    • [fix] Gallery2 sidebar now displays properly in rightblocks.
    • [new] Added option for displaying Flash XML MiniSlideShow in blocks.
  • v1.1 [5 Apr 2006]
    • [new] Added option for displaying left and right blocks in config.php
    • [fix] Now correctly maps users that pre-exsist in both apps, no more collisions.
    • [fix] Gallery2 sidebar now displays properly.
  • v1.0 [18 Mar 2006] Forked to G2Bridge from GL_Gallery2 for compatibility with Gallery 2.1+ by suprsidr flashyourweb.com
    • [new] Fully updated Gallery 2.1 API
    • [new] Added option for My Gallery link (for use with User Album Module) as apposed to Gallery2 link in User Menu
    • [new] Added option for alternate login redirect in config.php
    • [fix] Now adds installing user to G2 Admin Group instead of mapping user to G2 admin user
    • [fix] No More Path Confusion :)


Installing The Plugin

A note on paths:

  • a path beginning with ./ is where the plugin's config.php may be found
  • <public_html> is where your lib-common.php file may be found
  • <geeklog_dir> is where your config.php file for geeklog may be found
  1. First off, make sure you have a working Gallery2 installation and a working Geeklog installation.
  2. If you have G2's URL Rewrite module installed, deactivate and remove it. Re-install it through the embedded version after you've completed the installation of the plugin and verified that the installation works properly. This will ensure that the correct paths are used for rewriting.
  3. Backup your Geeklog database because the G2Bridge plugin adds and modifies tables. You can do this with the built in database backup facility in the Admin menu.
  4. Uncompress the G2Bridge plugin archive while in the <geeklog_dir>/plugins directory. The archive will create a directory called G2Bridge.
  5. In your <public_html>/admin/plugins/ directory create a directory called G2Bridge.
  6. In your <public_html> directory, create a directory called G2Bridge.
  7. Copy the files in the ./admin directory to the <public_html>/admin/plugins/G2Bridge/ directory you created in step 5.
  8. Copy the files and directories in the ./public_html directory to the <public_html>/G2Bridge/ directory you created in step 6.
  9. Configure your plugin by setting paths and options in the ./config.php file.
  10. Login as the user who will be the admin for the G2 installation. Go to the plugin administration page. The G2Bridge plugin should show up with a link to install it. Click it. The install page will tell you if the install was successful or not. If not, examine the Geeklog system errorlog in <geeklog_dir>/logs to see what the problem was. Fix it and re-install.
  11. Install will map installing user as G2 admin, others can be added through normal G2 admin.
  12. Note: This plugin creates blocks which you should not remove manually. It is fine to disable them, but the plugin expects them to exist. They will be removed if you choose to remove the plugin.


Configuring The Plugin

The only thing you must do is configure your paths in your G2Bridge config.php. These are explained in the file.

$_G2B_CONF['public_dir'] allows you to name the public_html portion of the G2Bridge plugin whatever you want.

$_G2B_CONF['random_photo_fields'] allows you to specify what data should be displayed in the random photo block.

$_G2B_CONF['allow_anon_access_random_photo'] and

$_G2B_CONF['allow_anon_access_gallery'] specify what should be visible to anonymous users.

$_G2B_CONF['user_albums'] lets you select what type of link will appear in the user menu. "My Gallery" or "Gallery2"

$_G2B_CONF['login_redirect'] can be set if you use a custom login page for your geeklog site.

Note: if you are experiencing unresolvable redirects in your browser set this to ' '.

All other configuration is done through your Gallery2 admin page.

The Admin Section

  • Within the admin page <site_admin_url>/plugins/G2Bridge/index.php there are a few option for your control.
  • Control the Gallery2 SideBar Block's visibility.
  • Sync your Geeklog& Gallery2 users should they ever fall out of sync.
  • [new]Create Blocks containing my Flash XML MiniSlideShow to display your albums like the random photo block.


Upgrading The Plugin

Upgrading G2Bridge is very similar to installation:

  1. Backup your Geeklog database because upgrading may add or modify database tables. You can do this with the built in database backup facility in the Admin menu.
  2. Disable G2Bridge using the admin interface's plugin editor [Admin->Plugins->G2Bridge]
  3. Uncompress the G2Bridge plugin and copy the new files over the old ones as if it were a new installation.
  4. Enable G2Bridge using the admin interface [Admin->Plugins->G2Bridge]
  5. Go back to the plugin editor for G2Bridge [Admin->Plugins->G2Bridge] and click the 'Update' button.


Removing The Plugin

  1. Because the plugin modifies several database tables, it should always be removed through the interface provided. Log in to your Geeklog as a root user and go to the plugin administration page. Click the 'G2Bridge' link and then click the 'Delete' button. It will ask you to confirm it. Confirm it.
  2. Delete the three plugin directories created in the install process:
    • <geeklog-dir>/plugins/G2Bridge/
    • <public_html>/G2Bridge/ [OR whatever you changed the name to in your config.php]
    • <public_html>/admin/plugins/G2Bridge/
  3. There is no step three.

Questions/Comments

mail suprsidr
visit mysite

advertisements