Updating instructions.

[project/gallery.git] / INSTALL.txt

$Id$

HELP
----
For more help, check out: http://drupal.galleryembedded.com

Requirements
------------
Gallery2.1 (or above) installed and working (see http://gallery.menalto.com)
Image Block module installed and activated in Gallery2
Image Frame module installed and activated in Gallery2
Drupal 4.7
gallery.module

Note that this module does not provide any photo/album functions itelf, but uses
Gallery2 (http://gallery.menalto.com) to provide this functionality.

Installation Instructions
-------------------------

1. Install Gallery 2.1 and Drupal 4.7 (see their respective installation
   documents).  
   
   ***Warning*** - Do not name your Gallery2 directory "gallery", call it something else 
   (eg "gallery2"). Calling it "gallery" will cause a conflict with the Drupal gallery.module 
   as Drupal assumes that http://www.example.com/gallery refers to the Drupal module.

2. Ensure that "Image Block" and "Image Frame" modules are installed and activated in Gallery2.
   Check them in the non-embedded Gallery. See 
   http://codex.gallery2.org/index.php/Gallery2:Download for instructions to download it 
   if it was not included in your installation.

3. Log out of Gallery2 (non-embedded) - people have reported errors relating to sessions if this 
   is not done.

4. Copy the entire gallery module directory to your drupal modules/ directory.

5. Enable the gallery module in administer -> modules in your drupal
   installation.

6. Go to administer -> settings -> gallery and enter the URI of Gallery2. 
   Leave "autodetect" selected and click "Save configuration". A series of tests will run to check
   if everything is OK. There is a HELP link.

7. Enable the "Gallery Block" in administer -> blocks, and optionally the "Gallery Navigation"
   block and the "Gallery Grid Block".

Optional Steps
--------------
                       
 1. Sidebar.     Go to your Gallery2 site admin and include the blocks you want in the sidebar
                 (under Themes). I use "Item Actions" and "Album Quick Links (DHTML)". To use 
                 the latter you need to have installed the Album Select module.

 2. URL Rewrite. 
 
 3. g2image. If you install g2image http://g2image.steffensenfamily.com as either a standalone or
             TinyMCE plugin you will have an excellent image chooser for Drupal/Gallery2. The
             configuration is automatic when you hit the "Save configuration' button on the gallery
             settings page.

Troubleshooting
---------------
See http://drupal.galleryembedded.com