Gallery2 Image Chooser README.HTML

Gallery 2 Image Chooser

Version 2.1 - See CHANGELOG.HTML for change history
Author: Kirk Steffensen
Information Page: g2image.steffensenfamily.com
Support Forum: www.galleryembedded.com/forums/
Live Demo: demo.steffensenfamily.com
Live Blog Demo: demo.steffensenfamily.com
See CREDITS.HTML for inspiration/code credits

WordPress Users and Joomla! JCE Users STOP!!!

WordPress Users should install WPG2 2.11, which includes G2Image in it's entirety. See this note for a longer explanation.
Joomla JCE Users should use the JCE installer instead of this file.

I - REQUIREMENTS

To use the "Gallery 2 Image Chooser" plugin, you must have Gallery2 installed and properly configured:
- You must have Gallery2 2.1
- NOTE: This version WILL NOT WORK with Gallery2 version 2.0.x.
  - Use version 1.3.x of the plugin if you need to use Gallery2 version 2.0.x.
- You must also have the Gallery2 ImageBlock module installed and activated.
  - The ImageBlock module does not come with the "minimum" Gallery2 installation and must be downloaded from the Gallery2 download page and installed separately.
The plugin was designed to be used with TinyMCE
- Tested with TinyMCE version 2.0.1 and with the modified TinyMCE that is included with WordPress 2.0
- To use the plugin without TinyMCE (in an application other than WordPress), please see the G2Image Developers Notes Page.
Tested with IE 6.0 and Firefox 1.5.

II - INSTALLATION

Unzip the files.
If you are NOT using WordPress with the WPG2 plugin, check config.php to make sure that $g2ic_gallery2_path is pointing to your Gallery2 directory. 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.
FTP the "tinymce_plugin/g2image/" directory structure to a new folder called /g2image/ in your TinyMCE plugins directory.
- If you are not using G2Image with TinyMCE (as documented on the G2Image Developers Notes Page), you can install the /g2image/ directory wherever it makes the most sense for your installation.
- If you are using TinyMCE version 2.0.3 or greater, overwrite /g2image/editor_plugin.js and /g2image/editor_plugin_src.js with the files in the /TinyMCE_version_2.0.3_files/ directory.
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.)
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.
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.
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.
Language Support:
- Version 2.0 shipped with support for English (en), Chinese Traditional (zh_TW), Italian (it), and German (de).
- If you translate /g2image/langs/en.js and en.php, you can use them by changing the language settings in /g2image/config.php and editor_plugin.js.
  - For /g2image/config.php, set $g2ic_language to the corresponding letters. (For WordPress, this is handled by WPLANG in wp-config.php)
  - For /g2image/editor_plugin.php add your language to the second line with a preceding comma after the "de_DE". For example Russian (ru_RU) is added here:
    - tinyMCE.importPluginLanguagePack('g2image', 'en, zh_TW, it, de, de_DE, ru_RU');
- For WordPress: If you use poEdit to create po and mo files from wp-content/plugins/g2image/locale/g2image.pot you can localize the WordPress G2Image Admin panel. Place the resulting g2image-xx.mo file in the /locale/ folder (where xx is the locale language). It should be the same language and encoding as your WPLANG in wp-config.php.
  - Version 2.0 shipped with support for Chinese Traditional (g2image-zh_TW.mo)

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