Node_Gallery 3, photo gallery management for Drupal.

This is a hack or *work in progress* handbook for node_gallery 3.x

As this takes shape, we will see if it can be rolled into the NG2 handbook
last update, July 26th, 2010

If you thought node_gallery 2 was cool, try node_gallery 3

Features

• Quick and Easy install
• Unlimited user galleries
• Drag-n-drop sorting using JQuery, seamlessly degrades to Drupal-table-drag
• Sorting uses it's own admin-imagecache preset
• Bulk uploading with image_fupload(cck)
• Fully integrated with views, with pre-configured views ready for use.

Dependencies

• ImageCache
• Transliteration required by imagecache
• Views
• ImageAPI
• CCK, Content
• FileField
• ImageField
  
   

Optional add-on modules

• http://drupal.org/project/node_gallery_access
  * coming soon for NG3
• http://drupal.org/project/jquery_ui
  provides drag-n-drop sorting of images
• http://drupal.org/project/image_fupload
  provides bulk uploading of images to node_gallery
  for this to work, enable image_fupload(cck)
• http://drupal.org/project/Views_bulk_operations
• http://drupal.org/project/ImageField_import
  provides for import of images from server directory to node_gallery

Other usefull modules
The optional modules are not included in this documentation, but may provide some usefull functions for your galleries.

• http://drupal.org/project/user_quota
• http://drupal.org/project/node_limit
• http://drupal.org/project/node_limitnumber
• http://drupal.org/project/subpath_alias
• http://drupal.org/project/filefield_paths

Known issues

• conflict with Node Images
  http://drupal.org/node/857552
  effects the management of the images

Installation for Node_Gallery 3

• Installs like all contributed modules
• download from Drupal.org, unpack the zip, upload the module and enable each one.
• upload dependent modules and node_gallery to sites/all/modules
• enable ImageCache, ImageField, Views, ImageAPI, ImageAPI GD2, Content and FileField modules
• enable node_gallery
• set permissions for your users

Securing Node Gallery, Permissions Explained

More stuff to go here

Close the backdoor to imagecache images.

• Protect the viewing of the images held in the image cache directories, when viewing galleries is not permitted. Goto: administration > user management > permissions ,,un-check the view_imagecache permissions.
• Node_gallery may not be visible, due to permissions, but the image cache images can still be accessed using a direct URL --example from this web site--
  http://www.davebeall.com/sites/default/files/imagecache/node-gallery-display/notme2/IM003044_0.JPG

Permissions at install time (default)

• image cache presets are viewable by anonymous and authenticated users.
  view imagecache node-gallery-cover
  view imagecache node-gallery-display
  view imagecache node-gallery-thumbnail
• view node_gallery is disabled and must be set by the administrator.
• access all views is disabled and must be set by the administrator if needed.

Permissions available

• view node_gallery
   
• create gallery
• create gallery_image
• edit gallery
• edit gallery_image
• delete gallery
• delete gallery_image
   
• access all views

Upgrading from Node_gallery 2 to Node_gallery 3

To upgrade from 2.x to 3.x (this is the same basic procedure for upgrading any module):

1. Put the site in maintenance mode.
2. Backup your db (backup_migrate module makes this easy)
3. Extract all NG3 'dependent' modules to sites/all/modules and enable them.
4. Remove the entire old node_gallery directory from your sites/all/modules/ directory.
5. Extract the new node_gallery into the sites/all/modules/ directory.
6. Run update.php
7. Take your site out of maintenance mode.

          All your galleries will be automatically updated to 3.x.

oh, yes there will be much more,, views and stuff too