===WPG2===
Contributors: ozgreg, capt_kirk,
Donate link: http://www.dreamhost.com/donate.cgi?id=8473
Tags: gallery2, wpg2, photos, photo albums, images, video, widget, lightbox
Requires at least: 2.2.0
Tested up to: 2.3
Stable tag: 3.0

WPG2 is a Wordpress Plug-in that embeds Gallery2 within Wordpress to share photos, videos and any other Gallery2 content seamlessly into Wordpress.

== Description ==

WPG2 is a Wordpress Plug-in that embeds Gallery2 within Wordpress to share photos, videos and any other Gallery2 content seamlessly into the Wordpress Sidebar and Blog entries.

###WPG2 Features###

* G2Image insertion tool in your Edit Toolbar to help you select one or more Gallery 2 Images, Videos, Albums (displays the Album Highlight Image) in your Blog Posts or Wordpress Pages
* Random, Recent, Daily, Weekly, Popular Images and/or Albums can be displayed as widgets in the Wordpress Sidebar
* Single Signon of Wordpress Users into Gallery2, with the ability to restrict Gallery2 Sign on through Wordpress User Roles and Capabilities
* Display your Gallery2 Page(s) from within the automatically created Wordpress Page.
* Add Lightbox Effects for your Gallery2 Images

== Installation ==

###File Installation###

1. Unzip the files.
2. FTP the contents of the "/wpg2/" directory to a new folder called /wpg2/ (in lowercase) in your WordPress plugins directory, /wordpress/wp-content/plugins/
3. Activate & Validate the WPG2 plugin (See below).

###Requirements###

1. To use the "WPG2" plugin, you must have Wordpress & Gallery2 installed and properly configured
2. Running at least Wordpress 2.2 and Gallery2 2.2
3. Wordpress & Gallery2 may be on different subdomains but NOT on different servers.
4. Wordpress & Gallery2 should be installed on the same database but can be different databases
5. Only one WordPress Blog tied to one Gallery2 Gallery
  * Unless you only have one identical user on multiple blogs, tying multiple blogs to one gallery will cause user errors because there is no way to currently distinguish one blog's users from another blog's users within Gallery2.
6. PHP memory limit of 16MB or better.
7. Browser that supports Javascript
8. Gallery2 Imageblock and ImageFrame Plugins installed & Activated.

###Upgrading###

NOTE: If you are upgrading from any WPG2 version deactivate WPG2 on the WordPress Plugins Management Panel, prior to upgrading.

* If you are upgrading from WPG2 version 1.0, delete all of the files in the wp-content/plugins/wp-gallery2/ directory.
* If you are upgrading from WPG2 version 2.0, delete all of the files in the wp-includes/js/tinymce/plugins/g2image/ directory.
* If you are upgrading from any previous version, delete wp-gallery2.php from same directory that wp-config.php is in.

== Getting Started ==

###Activation##

Activate WPG2 in the WordPress Plugins Management Panel.

###Validatation###

* You will now have a "WPG2" options tab on the main WordPress Admin Menu Bar.
* Select it. The first tab is a WPG2 validation tab.  Validaton should occur automatically.
* If you have any errors, follow the directions in the error message to resolve any issues.
	* First try going to the G2 Paths tab, and enter your Gallery2 URL in the "Auto Configuration of Embedded Paths - Gallery2 URL" text field and press the "Auto Configure" button. This should result in a valid setup.
	* If you cannot get the auto configuration to work, go to the G2 Paths tab and enter the path information manually in the "Manually Configure/Adjust Embedded Paths" section. Guidance on each field is provided immediately below the field.
	This will happen in the rare case of using Gallery2 on a different subdomain on a clustered server arrangement where the computer hosting your site has a different IP address than the IP used in the HTTP request.

###Verify Gallery2 User Account Setup###

* Once WPG2 is validated, there will be a "Gallery2 Users" tab under the WordPress "Users" tab.
* Verify that all of the users who should have Gallery2 Admin privileges through the embedded page (wp-gallery2.php) are in the list of Gallery2 Admin Users.
* Verify that any other users who should be logged in as a Gallery2 user (but not admin) through the embedded page are in the list of WordPress users without Gallery2 admin accounts.
* Any Wordpress users who do not have a corresponding Gallery2 account will appear in the list of WordPress users without Gallery2 user accounts.
	These lists will only appear if there is one or more user in them.
* See the online documentation and the WPG2 support forum for more information.

###Additional Language Support###

* Version 3.0 onwards has shipped with support for English (en), German (de), Spanish (es), French (fr), Hungarian (hu), Italian (it), Korean (ko), Norwegian Bokmal (nb), Dutch (nl), Polish (pl), and Chinese Traditional (zh_TW) for the G2Image popup windows. Check the WPG2 support forum and the G2Image homepage for more translations.
* WPG2 Admin Tabs: If you use poEdit to translate /wpg2/locale/wpg2.pot into your language's wpg2-xx.po and wpg2-xx.mo files, you can use them by placing them in the /locale/ folder. They must have the same encoding and name as the WordPress locale file as set by WPLANG in wp-config.php.
    Example: The WordPress Traditional Chinese localization is encoded in UTF-8 and are named zh_TW.po and zh_TW.mo. The corresponding WPG2 localizations are also in UTF-8 and are named wpg2-zh_TW.po and wpg2-zh_TW.mo.
* G2Image Pop-Up Windows: Please see the G2Image Internationization page for information on G2Image language support - http://g2image.steffensenfamily.com/index.php?title=Internationalization/Languages_Page
* Please help translate WPG2 core files and G2Image on Launchpad: https://translations.launchpad.net/wpg2/trunk/+pots/wpg2 and https://translations.launchpad.net/g2image/trunk/+pots/g2image
* Please share your translations by posting them on the WPG2 support forum.

== Help ==

[Codex / Documentation](http://codex.gallery2.org/Integration:WPG2)

[Support Forums](http://gallery.menalto.com/forum/83)

[Support FAQ](http://codex.gallery2.org/Category:Integration:WPG2)

== Frequently Asked Questions ==

####Q:Help! Fatal error: Call to a member function on a non-object in gallery/modules/rewrite/classes/RewriteApi.class####
If you are getting this error during WPG2 and if you have installed Gallery2 via the Fantastico script then you need to deactivate (you may have to activate the module first) the g2 rewrite module via Gallery2 Site Admin Panel. Unfortunately the Fantastico installation script leaves the Gallery2 rewrite module in a partly activated state thus causing this error.

####Q:How come the WPG2 Output page just returns blank?####
Most common cause of this problem is you do not have enough php memory allocated.  Gallery2 requires 16MB to run and you can increase the memory allocation by adding the following line to your .htaccess in your wordpress directory
`php_value memory_limit 16M`


== Screenshots ==

[Embedded Album](http://wpg2.galleryembedded.com/index.php?title=WPG2:Screenshots_of_a_Gallery2_Embedded_Page_1)

[Gallery2 Main Page](http://wpg2.galleryembedded.com/index.php?title=WPG2:Screenshots_of_a_Gallery2_Embedded_Page_2)

[Wordpress Page](http://wpg2.galleryembedded.com/index.php?title=WPG2:Screenshots_of_a_Gallery2_Embedded_Page_3)

[Blog Entry](http://wpg2.galleryembedded.com/index.php?title=WPG2:Screenshots_of_a_Gallery2_Embedded_Page_4)