; $Id: README.txt,v 1.4.4.3 2010/05/08 14:02:30 justintime Exp $

NODE GALLERY MODULE
-------------------


CONTENTS
-------- 
 * Description
 * Features
 * Requirements
 * Contributed Modules
 * Un-Install Notes
 * Items Created at Install
 * Installation
 * Create a Gallery
 * Edit a Gallery
 * Additional Configurations
 * Edit a Gallery Relationship and Configurations
 * Create a Gallery Relationship
 * Handbook Links
 * Drupal Links
 * Credits
 

DESCRIPTION
-----------
  The node gallery image management system provides administrators with a
  flexible and powerful image gallery. Administrators can designate the content
  type to be used for the "Gallery" node, and the content type to be used for
  the "Image" node.  Since the "Image" and the "Gallery" are both node or
  content types, they can use many of Drupal's contributed modules to enhance
  the galleries.  Upon installation, the required settings are automatically
  created so users can start posting galleries right away. Website users can
  upload "Images" into a "Gallery", edit them within the "Gallery" and delete
  them if needed.


FEATURES
--------
 - Naturally integrated with Drupal Taxonomy, Comments, Path, Pathauto, 
   Views, Token, VotingApi, Fivestar, CCK(Content Construction Kit),
	 Custom breadcrumbs, ImageCache, ImageAPI, Nodewords
	 and many other contributed modules.
 - Use Drupal's core batch system to do operations such as uploading, editing
   etc.
 - Theme or customize galleries with CSS and tpl.php files included with the
   system. 
 - Everything you can do with nodes you can do to your gallery and images.
 - Unlimited user albums
 - Set image size, maximum number of images and upload limits for each Drupal
   role.
 - Set image storage location and use custom tokens to help if desired. 
 - 4 custom tokens included to enhance and control the galleries.
 - Lightbox2 contributed module integration with lighbox2 slide show.
 - Titles, Descriptions, Captions and Image counts.
 - Drag handle image sorting and field sorting for submission forms.
 - Previous/Next pagers


REQUIREMENTS
------------
 * ImageCache module	http://drupal.org/project/ImageCache
 * ImageAPI module	http://drupal.org/project/ImageAPI


CONTRIBUTED MODULES
-------------------
 * Lightbox2 module	http://drupal.org/project/lightbox2
	 
ADD-ON MODULES
-------------------
 * Node_gallery_access module http://drupal.org/project/node_gallery_access
	 Control gallery access to public, private or password.
	

IMPORTANT UN-INSTALL NOTES
--------------------------
  The three ImageCache presets created by the Node Gallery module
  will be deleted if you disable the Node Gallery module, so it is recommended
  that you only use these presets with Node Gallery. However, if you modify the
  Node Gallery presets, they will be saved into the system and continue to exist
  without regard to the Node Gallery module being enabled.


ITEMS CREATED AT INSTALL TIME
-----------------------------
  1. Two node types; one for galleries and one for gallery images.
  
  2. Three ImageCache presets; for cover, display, and thumbnail.
  
  3. One node gallery relationship; linking the gallery node with the
     gallery image nodes.


INSTALLATION
------------
  1. Download node_gallery, ImageAPI, and ImageCache.
  
  2. Unzip or unpack the modules on your computer.
  
  3. Upload the module folders with all the contents (as is) to the
  sites/all/modules folder.
  
  4. Goto: Administer > Site configuration > Clean URLs
  Enable clean URLs (required for ImageCache to work).
  
  5. Goto: Administer > Site building > Modules
  Enable Node Gallery, ImageAPI, ImageAPI GD2, ImageCache, ImageCache UI,
  Node Gallery Lightbox2 Integration (if needed), and Node Gallery Access (if
  needed).
  
  6. Save the settings to install (updates the database).
  
  7. Goto: Administer > User management > Permissions
  Configure the Permissions for:
  -ImageCache module- 
      view ImageCache node-gallery-cover 
      view ImageCache node-gallery-display 
      view ImageCache node-gallery-thumbnail
  -node module-
      access content 
      administer nodes(use with caution) 
      create node_gallery_gallery content 
      create node_gallery_image content 
      delete any node_gallery_gallery content 
      delete any node_gallery_image content 
      delete own node_gallery_gallery content 
      delete own node_gallery_image content 
      edit any node_gallery_gallery content 
      edit any node_gallery_image content 
      edit own node_gallery_gallery content 
      edit own node_gallery_image content
  - node_gallery module -
      view node gallery  
  
  At this point, users can create galleries.


CREATE A GALLERY
----------------
   1. Goto: Create content > Gallery

   2. Name the gallery

   3. Provide a description for the gallery if desired.

   4. Click "Save"

   5. Click "Upload some images!"

   6. Browse and choose images.

   7. Click "Submit Files"

   8. Add a caption to each image if desired.

   9. Choose a cover image using the radio buttons on the right.

  10. Drag sort the order of images.

  11. Click "Submit"

  12. View your gallery.


EDIT A GALLERY
--------------
   1. Login and Goto: your gallery

   2. Click: Edit gallery, Upload images, Manage images or Delete Gallery


ADDITIONAL CONFIGURATIONS
-------------------------
   Configurations for a gallery relationship.
	(See the next section below, Edit a gallery relationship.)
	
   Configure the number of Albums on gallery list pages and the
 	number of images on each thumbnail page.
	Goto: Administer > Site configuration > Node gallery > Common settings

   Configure Gallery or Album submission form.
	Goto: Administer > Content management > Content types > Edit gallery

   Configure Gallery Image submission form.
	Goto: Administer > Content management > Content types > Edit gallery image

   Configure node gallery access.
	Goto: Administer > Site building > Modules > List
	Enable Node Gallery Access module to use this function.
		
   Customize galleries with css, views or tpl.php files.
	The node gallery handbook has more information about views and css.

   Customize paths and/or URLs with 4 custom node_gallery Tokens.
	[parent-node-gallery-path]	The path of the parent Gallery. 
	[parent-node-gallery-path-raw]	Unfiltered path of the parent Gallery.
	[parent-node-gallery-title]	The title of the parent Gallery. 
	[parent-node-gallery-title-raw]	Unfiltered title of the parent Gallery.
		
   Customize the ImageCache presets.
	Goto: Administer > Site building > ImageCache > List

	Add new, Configure, Edit and/or Delete the Presets as desired for
 	each part of the gallery. Add new presets or reuse existing
 	presets when Adding Gallery Relationships.

   Customize Lightbox settings.
	Goto: Administer > Site configuration > Lightbox2	

   GD2 image quality setting.
	Goto: Administer > Site configuration > ImageAPI > Configure


EDIT A GALLERY RELATIONSHIP AND/OR CONFIGURATIONS
-------------------------------------------------
  1. Goto: Site configuration > Node gallery > List
  	Click "Edit" next to the gallery relationship which will open the
 	first configuration page.

  2. The first configuration page has the content type settings.
	Select the content types to be used for the "Gallery" and the
 	"Image" types. 

	To edit the gallery configurations, go to the
	bottom of the page and click next. Clicking "Next" will
	open the second configuration page.
	
  3. The second configuration page has the detailed gallery
 	configurations.
	
	Gallery Type Name:
		The name to show on create content page.
	
	Gallery Directory:
		Set the directory to hold images inside sites/default/files
		 - sites/default/files/[name or token]/[name or token] -

	Default Cover Image:
    		Specify a default cover image to show when there
		 are no images in the gallery.
	
	Number of uploads:
    		Select the number of upload buttons(fields)
		for images on each upload page. Use caution when
		adding more than 4 or 5 as php.ini settings may
		need to be changed.

	Fields:
    		Specify the fields to show(check boxes).
    		Title, caption, revision info, comment settings, path settings.

	Choose the content you want to display:
    		Specify the description text to be used when displaying image pages.
    		Choose gallery description (or) image description.

	Image Comment Setting:
    		Specify the comment setting to use. (Image or gallery)
		 as per setting in the content type.

	Images Sizes:
    		Select which ImageCache Preset to use for each
		 image display(cover, thumbnail, display).
	
	Original Image Display:
    		Set the option to allow viewing full sized image
		 disabled, with a link or lightbox2 pop-up.

	Teaser setting:
    		Specify how to display the gallery and image
		 when viewing the node as a teaser.
	
	Gallery Landing Page Setting:
    		Choose thumbnails or thumbnails that open a lightbox2 gallery.
	
    -- Image Upload Limitation Default Settings: --

	Default permitted file extensions:
    		Specify allowed file types ( jpg jpeg png )
		 (do not use a dot, just a space between each)

	Maximum resolution for uploaded images:
    		Specify (width x height) in pixels. (use 0 for no limit,
		 if there is trouble with uploads check this)

	Default maximum file size per upload:
    		Specify a number in MB (calculated after 
		ImageCache Preset re-sizes the files)

	Default total file size per user:
    		Specify a number in MB (combined total size of all
		 files a user is allowed to have in the system)

	Default total file number per user:
    		Specify a number. (combined total number of files
	  	each user is allowed to have in the system)

   -- Image Upload Limitation Settings for user roles: --
		note: This will not be visible until permissions have been set.
		Each user role will have the following settings.

       Default maximum file size per upload:
          	Specify a number in MB (calculated after ImageCache
		 Preset resize's the files)

       Default total file size per user:
          	Specify number in MB (combined total size of all files
		 a user is allowed to have in the system)

       Default total file number per user:
          	Specify a number (combined total number of files each user
		is allowed to have in the system) 	
	

	SUBMIT AFTER CHANGING SETTINGS


CREATE A NEW GALLERY RELATIONSHIP
---------------------------------
  1. Create a content type for the gallery 
	 	WARNING: do not re-use a gallery content type,
	 	as it will over write the relationship that uses it.

  2. Create an image content type -or- plan to re-use an existing one.

  3. Create 3 image cache presets or plan on re-using existing ones.
	 	one for cover, thumbnail and image.

  4. Set permissions for the new and/or re-used content types.

  5. Set permissions for the 3 new and/or re-used ImageCache presets.

  6. Goto: Administer > Site configuration > Node Gallery > Add a
 	Gallery Relationship

  7. Select the gallery and image content types. Click "Next"

  8. Configure the new gallery relationship. (as in the above section)

  9. The Image content type needs to be removed from the create content list.
	Goto: Administer > Site building > Menus
	Click on the Navigation menu to open it.
	Locate the Image content type and un-check it and "Save" 
 
   A new custom made node gallery has been created.


HANDBOOK LINKS
--------------
 Node Gallery Handbook		http://drupal.org/node/544050

 Install Node Gallery		http://drupal.org/node/544242

 Create & Edit a Gallery	http://drupal.org/node/544530

 Configure Node Gallery		http://drupal.org/node/544642

 Add a Gallery Relationship	http://drupal.org/node/544710

 Style, Views & Theming		http://drupal.org/node/544748

 FAQ for Node Gallery		http://drupal.org/node/544760

 Trouble shooting node_gallery	http://drupal.org/node/584170

 Websites Using Node Gallery	http://drupal.org/node/547788


DRUPAL LINKS
------------
 Project Page	http://drupal.org/project/node_gallery

 Drupal Forum	http://drupal.org/forum/22

 Issue Queue	http://drupal.org/project/issues/node_gallery 


CREDITS
-------
 Authored by Wilson Wu(wilson98); < martic98@gmail.com >

 Co-maintained by Kevin Montgomery(Kmonty); New Eon Media < http://neweonmedia.com >


END OF FILE
-----------