Browse and select photos from any public or private Google+ album and add them to your posts/pages. This is an unofficial
fork of "Picasa and Goo
|Author:||thhake (profile at wordpress.org)|
|WordPress version required:||3.7|
|WordPress version tested:||4.2.4|
|Added to WordPress repository:||26-05-2015|
|Total downloads:||17 168|
|Active installs:||3 000+|
Click to start download
Browse your Google+/Picasa Web albums and select images or whole albums to insert into your posts/pages. This is an unofficial fork of Picasa Express 2.
The fork has been necessary because the authentication for private photo albums of "Picasa and Google Plus Express" has been broken since April 2015 due to changes to the authentication protocol. This is the first release after a major change to the code. Please be so kind and test this version before putting it into production.
This fork supports OAUTH authentication with Google, so you can access private photos and albums again! Currently this only works on a blog-wide mode (Google+ Express access level: blog). I am working on a solution for a per user authentication.
Upgrade notice: * The plugin requires at least PHP 5.4. Using a version before PHP 5.4 leads to parse errors. * If you have shortcodes for single images that have been generated using a prior version of "Photo Express for Google" (0.1) or "Picasa and Google Plus Express" (all versions), you'll have to update them to make photoswipe work correctly. Please have a look into the FAQ. * The prefix for all CSS classes has changed from "pe2" to "peg". Please consider this when upgrading from "Picasa and Google Plus Express". * The function to store authentication data on a user basis has been removed. The use case for storing it on a per user basis was not clear. If you rely on this function, please post a feature request with your particular use case.
- Use your Google user to access your photos and albums
- Private album access after granting access via Google auth service
- Select albums / images from GUI listing by album cover and name
- Mobile gallery display support with PhotoSwipe
- Google+ style phototile gallery display or standard gallery utilizing native WordPress image thumbnail size
- Create a gallery of a subset of photos from an album by filtering the album with tags
- Gallery and image shortcodes for display of entire album or selected images
- WordPress MU support - sitewide activation, users, roles
- Image link:
- Mobile gallery with PhotoSwipe - in desktop browsers PhotoSwipe is clean and works nicely. On a mobile device, swiping between photos is supported
- Custom thickbox with plugin - including keyboard navigation and Google+ view link
- WordPress thickbox - using the integrated thickbox provided by WordPress
- 3rd-party thickbox - setup the thickbox class/rel, but rely on external library
- 3rd-party lightbox - setup the lightbox class/rel, but rely on an external library
- 3rd-party highslide - setup the highslide class/rel, but rely on an external library
- Google+ image page - a direct link to the Google+ image page for the photo
- direct - a direct link to the large photo
- none - just the image thumbnails are displayed with no link
- CSS / style customizations for most tags created in galleries, photos & captions
- Caption under image and/or in image/link title and gallery display
- Alignment for images and gallery using standard CSS classes
- Define Roles who are allowed to use the plugin
- Switch from blog to user level for storing the user and private access token
- Settings for single-image thumbnail size, single-video thumbnail size and large image size limit
- Forcing SSL connection to the Google photo APIs
- Optional caching of the Google photo API results
And by design:
- Shortcodes inserted for both albums and photos in anticipation of changes forthcoming in Picasaweb to Google+ migration.
- Support native WordPress image and link dialog for album image thumbnail size
- Support native WordPress gallery captions
- Multilanguage support
Photoswipe does not work anymore for single images
With version 0.2 of Photo Express for Google the internal photowsipe library has been updated to version 4. The newest version of photoswipe needs to know the size in pixel of the image that should be displayed in photoswipe. Therefore you’ll need to add the “image_size” attribute to your old
[peg-image] shorttags. It should contain a value describing the images size in the format “x” (i.e. “1920×1080” for full HD). This manual step is not needed for any single picture that has been added with Photo Express for Google version 0.2 or later. All shortcodes generated by Photo Express for Google version 0.2 include the “image_size” attribute. So an alternative way of updating old shortcodes is to delete them and insert them again with the current version of Photo Express for Google.
Tag searches in albums returns inconsistent results
Google+ / Picasaweb tag searching currently contains a bug that causes images
to slowly start dropping out of tag search results, causing fewer than
expected images to be returned.
I have posted several issues and am following threads like the following:
Google Groups: Picasa Data API
Hopefully Google will discover the cause of the problem soon.
Username validation fails
If when in the options and configuring the username, the “Checking user:” test
returns an error, it could be related to changes Google has been making when
migrating from picasaweb to Google+.
The error message provided should give you a URL you can click, which will
then provide you with Google’s error message. In most cases, the error
appears to be related to older “short username” values that Google no longer
Simply change the username you are using to your Google email address and save
If this still doesn’t work, check your hosting provider’s PHP preferences – some hosting companies disable connect functions and WordPress can not request data from other sites.
Error with media-upload.js
When attempting to insert an image into a post and receive the error:
“Error: Cannot insert image(s) due to incorrect or missing /wp-admin/js/media-upload.js”
There are several possible causes for this:
1 – if you attempt to open the selection dialog before the page has
yet. Refresh the page and wait for it to load completely, then try again.
2 – it is known that the “CKEditor for WP” plugin conflicts with the
media-upload.js file. Disable this plugin and try again.
How can I select several images to insert at a time?
When browsing the album’s images you may click on multiple photos to insert at once. These images will be inserted into the post as using the thumbnail size you have defined in “Single image thumbnail size” in settings.
If you have selected the option to “Relate all of a post’s images” and you are
using a link type of one of the thickbox, lightbox or highslide libraries, all
of the photos within the post will be related for next/prev navigation within
the display window.
How can I select several images for “Gallery” display?
There are two options to filter images in a “Gallery” display:
#1 – Use tags to filter photos in an album so that only photos with a specific
tag are displayed.
This is done by inserting an “Album” shortcode, but in the “Options” prior to inserting populate the “Photo tag options” to select photos with the “Featured” tag, or a customized tag name typed into the text box.
NOTE – filtering by tags requires private album access. This is a
#2 – Manually select the photos (and optionally their sort order).
This is done while browsing an album’s photos, click the “Image” button.
After clicking the “Image” button, it will switch to “Gallery” indicating that
any photos selected this time will be inserted into the post in “Gallery”
format using the default blog thumbnail size.
I want private albums browsing
On the settings page press the link titled “Click here to configure private access to Google Photo”. You will be guided through a multi step setup process and be redirected to Google and asked to grant access. If you press the “Grant access” button on Google, you will be returned to settings page and access will now be granted.
After successfully authorizing the access for the blog, the next time you open
the album / image selection dialog, you will see all of your photos and
albums, including any private ones.
I revoked access to my server on Google’s site, and now the plugin doesn’t work
On revoking access through Google instead of this plugin, Google will not inform your server. If you revoke access on Google’s side, you have to click the “Click here to revoke the token” link on the settings page.
Caption widths aren’t determined correctly
If you’re using a single-image thumbnail width dimension of “Height” or “Any”, the width is dynamically based on aspect ratio. Thus the value generated for the caption is not terribly accurate, causing strange caption wrapping sometimes.
The best solution here is to change the single-image thumbnail dimension to “Width”, because then the width of the caption can be determined precisely.
Another option would be to try a “Caption container style” setting of “width: auto;”, although this isn’t ideal either because it will scale the container to fit any size of caption text, and the text will never wrap. The recommended solution is using a thumbnail dimension of “Width”.
Plugin has a bug. How can I fix it?
Open a support thread in the support forum:
I want another feature
Open a support thread in the support forum:
- Embedded video support (currently doesn’t appear to be allowed by Google)
- Add the button to Visual toolbar of Tiny editor in full screen mode
- Work with Google to correct tag searching index issues which cause tag searches to return unexpected results.
- Fixed another issue while uninstalling
- Fixed image browser not showing new albums when caching is activated.
- Fixed issue while uninstalling the plugin
- Fixed issues when upgrading the plugin
- Fixed filename captions
- Added a error msg when trying to activate the plugin with a not supported PHP version
- Caching of Google Photo API requests has been implemented. It is enabled by default and can be deactivated in the settings. For more information about how caching works, please have a look at the “Advanced” section on the settings page.
- SSL communication with the Google Photo API can now be enforced. This is enabled by default in order to improve security.
- Fixed not displayed captions
- Multisite installation has been tested
- Photoswipe has been upgraded to version 4. If you rely on Photoswipe, please make sure that you add a “image_size” attribute to each peg-image shortcode. Otherwise Photoswipe won’t work for this particular image. The “image_size” attribute should contain the size of the image in pixel in the format “x” (i.e. “1920×1080”).
- Fixed error on the settings side when trying to change the “Large Image Size” limitation
- Fixed errors in the navigation flow of the settings page
- Fixed an error that lead to albums only having one picture if being sorted by a criteria that has duplicate entries.
- The function to store authentication data on a user basis has been removed. The use case for storing it on a per user basis was not clear. If you rely on this function, please post a feature request with your particular use case.
- First version after the fork of Picasa Express 2 (Version 2.2.10)
- Introduced Google OAuth authentication protocol for private albums. This does currently only work if you want to have
one google account authorized for the whole blog. If you want to authorize a google account per user, you have to wait
for the next release.
- Revoking tokens after deactivation
- Migrating settings automatically from Picasa Express 2
- Now all settings will be deleted after un-installation.
- Refactored code to be more modularized