Difference between revisions of "Integration:Geeklog" - Gallery Codex
Personal tools

Difference between revisions of "Integration:Geeklog"

From Gallery Codex

(Replacing page with '[http://www.flashyourweb.com/staticpages/index.php?page=g2bridge_readme Docs moved]')
 
Line 1: Line 1:
<h3>Description</h3>
+
[http://www.flashyourweb.com/staticpages/index.php?page=g2bridge_readme Docs moved]
 
+
[http://www.flashyourweb.com/filemgmt/index.php?id=8 G2Bridge] is a [http://www.geeklog.net Geeklog] plugin which allows integration of the [http://gallery.menalto.com/ 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.<br>
+
The control block is explained on the G2Bridge admin page.<br>
+
<small>*In order for the random photo block to work, you must have the 'Image Block' module installed.<br>
+
You can find the 'Image Block' module on the G2 [http://codex.gallery2.org/Gallery2:Download#Modules downloads] page or check your G2's admin its probably already there.</small>
+
 
+
<span style="color:red;">Note that although G2Bridge maps users from one app to the other, it does not map group permissions.</span>
+
<br>
+
<h3>Version History</h3>
+
 
+
<ul>
+
<li>v2.0 [5 Aug 2007]
+
<ul>
+
<li><span style="color:blue;">[fix]</span> Updated GL detection of anon user for 1.4.1. Minor cleanup of other functions.
+
<li><span style="color:blue;">[fix]</span> Gallery2 sidebar now displays properly in rightblocks.
+
<li><span style="color:red;">[new]</span> Added option for displaying [http://www.flashyourweb.com/dokuwiki/doku.php?id=xmlmini Flash XML MiniSlideShow] in blocks.
+
</ul>
+
</li>
+
<li>v1.1 [5 Apr 2006]
+
<ul>
+
<li><span style="color:red;">[new]</span> Added option for displaying left and right blocks in <b>config.php</b></li>
+
<li><span style="color:blue;">[fix]</span> Now correctly maps users that pre-exsist in both apps, no more collisions.
+
<li><span style="color:blue;">[fix]</span> Gallery2 sidebar now displays properly.
+
</ul>
+
</li>
+
<li>v1.0 [18 Mar 2006] Forked to G2Bridge from GL_Gallery2 for compatibility with Gallery 2.1+ by [mailto:suprsidr@gmail.com suprsidr] [http://www.flashyourweb.com/ flashyourweb.com]
+
<ul>
+
<li><span style="color:red;">[new]</span> Fully updated Gallery 2.1 API
+
<li><span style="color:red;">[new]</span> Added option for My Gallery link (for use with User Album Module) as apposed to Gallery2 link in User Menu
+
<li><span style="color:red;">[new]</span> Added option for alternate login redirect in <b>config.php </b>
+
<li><span style="color:blue;">[fix]</span> Now adds installing user to G2 Admin Group instead of mapping user to G2 admin user
+
<li><span style="color:blue;">[fix]</span> <b>No More Path Confusion</b> :)
+
</ul>
+
</ul>
+
<br>
+
<h3>Installing The Plugin</h3>
+
+
A note on paths:
+
<ul>
+
<li>a path beginning with ./ is where the plugin's config.php may be found</li>
+
<li>&lt;public_html&gt; is where your lib-common.php file may be found</li>
+
<li>&lt;geeklog_dir&gt; is where your config.php file for geeklog may be found</li>
+
</ul>
+
<ol>
+
<li>First off, make sure you have a working Gallery2 installation and a working Geeklog installation.</li>
+
<li>If you have G2's <b>URL Rewrite module</b> installed, deactivate and remove it.  Re-install it <b>through the
+
embedded version</b> 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.</li>
+
<li>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.</li>
+
<li>Uncompress the G2Bridge plugin archive while in the &lt;geeklog_dir&gt;/plugins directory.
+
The archive will create a directory called G2Bridge.</li>
+
<li>In your &lt;public_html&gt;/admin/plugins/ directory create a directory called G2Bridge.</li>
+
<li>In your &lt;public_html&gt; directory, create a directory called G2Bridge.</li>
+
<li>Copy the files in the ./admin directory to the &lt;public_html&gt;/admin/plugins/G2Bridge/ directory you created in step 5.</li>
+
<li>Copy the files and directories in the ./public_html directory to the &lt;public_html&gt;/G2Bridge/
+
directory you created in step 6.</li>
+
<li>Configure your plugin by setting paths and options in the <b>./config.php</b> file.</li>
+
<li>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 &lt;geeklog_dir&gt;/logs to see
+
what the problem was.  Fix it and re-install.</li>
+
<li>Install will map installing user as G2 admin, others can be added through normal G2 admin.
+
<li><b>Note:</b> 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.</li>
+
</ol>
+
<br>
+
<h3>Configuring The Plugin</h3>
+
+
The only thing you <i>must</i> do is configure your paths  in your G2Bridge <b>config.php</b>.  These are explained in the  file.<br>
+
 
+
<b>$_G2B_CONF['public_dir']</b> allows you to name the public_html portion of the G2Bridge plugin whatever you want.
+
 
+
<b>$_G2B_CONF['random_photo_fields']</b> allows you to specify what data should be displayed in the random photo block.
+
 
+
<b>$_G2B_CONF['allow_anon_access_random_photo']</b> and
+
+
<b>$_G2B_CONF['allow_anon_access_gallery']</b> specify what should be visible to anonymous users.
+
 
+
<b>$_G2B_CONF['user_albums']</b> lets you select what type of link will appear in the user menu. &quot;My Gallery&quot; or  &quot;Gallery2&quot;
+
 
+
<b>$_G2B_CONF['login_redirect']</b> can be set if you use a custom login page for your geeklog site.
+
 
+
<b>Note:</b> if you are experiencing unresolvable redirects in your browser set this to ' '.
+
 
+
All other configuration is done through your Gallery2 admin page.
+
<br>
+
<h3>The Admin Section</h3>
+
<ul>
+
<li>Within the admin page &lt;site_admin_url&gt;/plugins/G2Bridge/index.php there are a few option for your control.
+
<li>Control the Gallery2 SideBar Block's visibility.
+
<li>Sync your Geeklog&amp; Gallery2 users should they ever fall out of sync.
+
<li><span style="color:red;">[new]</span>Create Blocks containing my Flash XML MiniSlideShow to display your albums like the random photo block.</ul>
+
<br>
+
<h3>Upgrading The Plugin</h3>
+
+
Upgrading G2Bridge is very similar to installation:
+
<ol>
+
<li>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.</li>
+
<li>Disable G2Bridge using the admin interface's plugin editor [Admin->Plugins->G2Bridge]</li>
+
<li>Uncompress the G2Bridge plugin and copy the new files over the old ones as if it were a new installation.</li>
+
<li>Enable G2Bridge using the admin interface [Admin->Plugins->G2Bridge]</li>
+
<li>Go back to the plugin editor for G2Bridge [Admin->Plugins->G2Bridge] and click the 'Update' button.</li>
+
</ol>
+
<br>
+
<h3>Removing The Plugin</h3>
+
<ol>
+
<li>Because the plugin modifies several database tables, it should <b>always</b> 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.</li>
+
<li>Delete the three plugin directories created in the install process:
+
<ul>
+
<li>&lt;geeklog-dir&gt;/plugins/G2Bridge/</li>
+
<li>&lt;public_html&gt;/G2Bridge/ [OR whatever you changed the name to in your config.php]</li>
+
<li>&lt;public_html&gt;/admin/plugins/G2Bridge/</li>
+
</ul>
+
</li>
+
<li>There is no step three.</li>
+
</ol>
+
<h3>Questions/Comments</h3>
+
[mailto://suprsidr@gmail.com mail suprsidr]<br>
+
[http://www.flashyourweb.com visit mysite]<br>
+
 
+
[[Category:Integration|Geeklog]]
+
[[Category:Integration:Geeklog]]
+

Latest revision as of 06:45, 15 November 2008

Docs moved

advertisements