Gallery 2 Image Chooser

Version 3.0.3 - See CHANGELOG.HTML for change history
Author: Kirk Steffensen
Information Page: g2image.steffensenfamily.com
Support Forum: gallery.menalto.com/forum/94
Live Demo: demo.steffensenfamily.com
Live Blog Demo: demo.steffensenfamily.com/wordpress/
See CREDITS.HTML for inspiration/code credits

WordPress Users STOP!!!

• WordPress Users should install WPG2 3.0.5, which includes G2Image in it's entirety. See this note for a longer explanation.
• G2Image 3.0.3 is not backwards compatible with WPG2 2.3 or earlier.

I - REQUIREMENTS

1. To use the "Gallery 2 Image Chooser" plugin, you must have Gallery2 installed and properly configured:
   • You must have Gallery2 2.1.x or higher.
   • NOTE: This version WILL NOT WORK with Gallery2 version 2.0.x
2. The plugin was designed to be used with TinyMCE.
   • You must have TinyMCE version 3.0 or higher.
   • Tested with TinyMCE included with WordPress 2.5 and Joomla's JCE 1.5.0.
   • Tested with JCE 1.5.0 (includes TinyMCE) for Joomla.
3. The plugin was also designed to be used with FCKEditor.
   • Tested with FCKEditor version 2.4.3 in WordPress and Drupal..
4. Finally, the plugin was also designed to be used in a standalone mode without a visual editor like TinyMCE or FCKEditor.
   • To use the plugin without TinyMCE (in an application other than WordPress), please see the G2Image Developers Notes Page.
5. Tested with IE 7.0 and Firefox 2.0.

II - INSTALLATION

1. Unzip the files.
2. Check config.php to make sure that $g2ic_gallery2_path is pointing to your Gallery2 directory. ($g2ic_gallery2_path is relative to the server root, unless $g2ic_use_full_path is set to TRUE, in which case it is the full server path to Gallery2.) If you are using an embedded application (other than WordPress) match the embedded paths, etc., at the bottom of config.php with the settings in your embedded application.
3. FTP the "g2image/" directory structure to a new folder called g2image in your TinyMCE or FCKEditor plugins directory.
   • If you are not using G2Image with TinyMCE or FCKEditor (as documented on the G2Image Developers Notes Page), you can install the /g2image/ directory wherever it makes the most sense for your installation.
4. Please see the appropriate online page for platform-specific installation information. (This information changes more frequently than this README file is updated. The list is alphabetical, not a suggested order of preference.)
   • Drupal
   • Joomla!
   • WordPress
   • FCKEditor
   • Other Platforms
5. After everything is installed, force a reload (for FireFox) or a refresh (for IE). This forces the TinyMCE javascript to reload and display the button.
6. There are several options that you can set in config.php, such as default view, default number of images, default class, and more. There are notes for each configuration option in the config.php file.
7. CSS for the alignment options:
   • If you want to use the built-in alignment options, you'll need to add these three classes to your CSS. You can also add upto four custom classes and add them to the config.php file. Custom classes will be available in the alignment selector.
   • You'll need to customize these to fit into your site design. This is how they're implemented in the CSS for www.steffensenfamily.com:

     .g2image_normal
     {
     	margin: 4px;
     }
     
     .g2image_float_left
     {
     	float: left;
     	clear: left;
     	margin: 4px;
     }
     
     .g2image_float_right
     {
     	float: right;
     	clear: right;
     	margin: 4px;
     }
     
     .g2image_centered
     {
     	display: block;
     	margin-left: auto;
     	margin-right: auto;
     	text-align: center;
     }
     

   • Note: The alignment classes only apply to HTML thumbnails, WPG2/WPG2ID tags, and Drupal G2 Filter tags - not the text links.
8. Language Support:
   • Version 3.0.1 shipped with support for de, en, es, fr, hu, it, ko, nb, nl, pl, zh_TW.
   • Set your language by changing $g2ic_language in config.php.
   • For information on updating existing translations or creating new translations, please see the G2Image Internationalization Page.

III - ABOUT THE LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, in the LICENSE.HTML file.

If you have not received a copy of this file along with this program, write to:
The Free Software Foundation, Inc.
59 Temple Place - Suite 330
Boston, MA 02111-1307
USA