Gallery2:Modules:joomg2 - Gallery Codex
Personal tools

Gallery2:Modules:joomg2

From Gallery Codex

JoomG2: Joomla! Integration Module
Integrates Gallery2 and Joomla! CMS
Version: 1.0.5
Author: Dayo Akanji
Download the module files here.
Visit the Support Site for enquiries and support requests.


Contents

Requirements

  • Gallery 2.3.0+
  • Joomla! 1.5, 1.6, 1.7, 2.5
  • Both Gallery2 and Joomla! must be installed under the same document root.

Description

The JoomG2 Module allows users to organize their photos and other multimedia files in Gallery2 while managing other content using Jooma!.

  • The module runs within the Gallery2 Framework resulting in a single set of normal Gallery2 URLs. This removes the usual setup of having a separate gallery address from the embedded address. Users can now maintain search engine rankings and can provide direct links to gallery pages.
  • The module is called just before output is displayed after all the normal Gallery2 process have been run (using a new manually added event) . It then connects to Joomla! and retrieves Joomla! html output which is then wrapped around the Gallery2 html and this combined output is then displayed.
    A benefit of this is that previously cached pages would have been sent to the user before the module is called resulting in faster speeds and lower resource usage.

Other features are:

  • The Joomla! and Gallery2 folders can be located at any offset relative to the other as long as they lie under the same document root.
  • Unified login from Joomla! (users logged into Joomla are automatically logged into Gallery2).
  • Unified registration via Joomla!
  • Auto points Gallery2 login, logout, account settings and registration links to Joomla! when user integration is activated

Package Contents:

The package comes in two folders as follows:

  • Gallery2: Contains the following files to be installed in gallery2
    • joomg2.zip: This contains the Gallery module files.
    • events.zip: This contains required additional events as files for inclusion into main.php.
  • Joomla: Contains the following files files to be installed in Joomla!
    • com_joomg2.zip: This contains the Joomla! component files.
    • gallery2_auth.zip: This contains the Gallery2 Authentication Plugin that logs users into Joomla! if registered in Gallery2.

The files for Joomla! are packaged for different versions as follows:

  • Joomla! 1.5 -> Set_01
  • Joomla! 1.6 -> Set_02
  • Joomla! 1.7 -> Set_02
  • Joomla! 2.5 -> Set_02

Notes

  • Install and post bug notifications to the support site. Subscribe to the announcement forum there to receive notifications. You can also subscribe to the forum post here but this may generate additional emails.
  • Carry out the following steps to upgrade from module version <= 0.9.2:
    • Deactivate, uninstall and delete the module from the gallery2 admin interface
    • Delete the lines added for the "Gallery::BeforeProcess" and "Gallery::BeforeOutput" events in main.php if present
    • Delete the "gallery2/lib/events/Gallery_BeforeProcess.event" and "gallery2/lib/events/Gallery::BeforeOutput" files if present
    • Follow the installation guide below
  • Implement the Gallery 2 Performance Tips to improve performance. Similar issues should also be considered on the Joomla! side.
  • Version 0.9.0+ no longer bypasses the G2 caching system and no longer require the RefineHTML Module.
    The module cannot be activated while either of the RefineHTMl or G2Drupal modules are active
  • Make sure you have the Site Administrator registered with the same details on both applications before activating the plugin.
  • The Gallery2 session is subordinate to the Joomla! session. If a user is not logged into Joomla!, they will be logged out of Gallery2 by the module. Similarly, they will be logged into Gallery2 by the module if logged into Joomla!.
  • You can create a full community site by using a similar Fudla Bridge for FUDforum written by the same author.

Installation

Important

  • Make sure you have read and applied the instructions in the "Notes" section above if upgrading from module version <= 0.9.2.

Joomla!

  • Make sure the Joomla! Administrator has the same User Name, Full Name and Email as the Gallery2 Administrator.
  • Install the Joomg2 component (com_joomg2.zip).
  • Create a menu item as an external url pointing to your gallery2 installation from the Joomla! Administration interface.
    Note the item id of the menu item as it will be needed later
  • Install, configure and enable the Gallery2 Authentication Plugin (gallery2_auth.zip).
    You will need to provide the full server path to the Gallery2 folder

Gallery2

  • Make sure the Gallery2 Administrator has the same User Name, Full Name and Email as the Joomla! Administrator.
  • Make sure the elements required to the installed in Joomla! have been completed.
  • Make sure both the RefineHTML and G2Drupal modules are not active
  • Unpack the module file (joomg2.zip) to the "gallery2/modules/" folder.
  • Install, configure and activate.
    You will need the item id of Joomla External Menu item from earlier
  • Unpack events.zip into the "gallery2/lib/" folder
  • Around Line 528 of gallery2/main.php is ...

/*
* Session: Find out whether we need to send a cookie & need a new session (only if
* we don't have one yet)
*/
$session =& $gallery->getSession();
$ret = $session->start();
if ($ret) {
return array($ret, null);
}

list ($ret, $shouldCache) = GalleryDataCache::shouldCache('write', 'full');
if ($ret) {
return array($ret, null);
}


Add the following lines after:

/* Added Event: BeforeOutput */
include(dirname(__FILE__) . '/lib/events/Gallery_BeforeOutput.event');

Troubleshooting

Problem Solution
I cannot configure the joomg2 component in Joomla!. The joomg2 component does not need configuration.
I get a message saying my username/email is associated with multiple Joomla accounts. You probably bridged an existing instance of the module to a new Joomla! installation. You will need to manually disable the module, login into G2 and then uninstall and reinstall the module.
Some javascript functionality doesn't work anymore. Do a search online for "JQuery Conflict" and apply the solutions to your conflicting JQuery code or contact the JQuery code author and ask them to consider using the non conflicting jquery syntax.
My site is dog slow when using this module. The notes above offers the suggestion of using the G2 Performance Tips ... read and apply these.
My site is messed up visually when the module is installed. This means you have css conflicts. You will have to manually resolve these.
Retrieved from "http://codex.gallery2.org/index.php?title=Gallery2:Modules:joomg2&oldid=25273"
advertisements