[!WARNING]
Updates in the google photos API taking effect march 2025 will break the basic functionality of this plugin.
We will no longer be supporting it and recommend finding an alternative.
OctoberCMS plugin for displaying a gallery from Google Photos (Picasa) through the use of a CMS component or a RainLab.Pages snippet.
This plugin comes with an OAuth client application that will only work on localhost
to allow you to test the plugin.
Before deploying it on any hostname other than localhost
, you must create your own OAuth app credentials or use existing credentials for the hostname in question (i.e. example.com
). Follow these steps to get your credentials: Google documentation.
The documentation will say that "the Authorized redirect URI does not require a value", but it is required for this use case. You will need to set the Authorized redirect URI to https://example.com/backend/inetis/googlephotos/oauth/callback
, replacing example.com/backend
with your domain name and backend URL.
When done, you will be given a Client ID
and a Client Secret
, which you will need to provide to the plugin by overriding the configuration file. See the official documentation on doing this. Basically, just copy the file /plugins/inetis/googlephotos/config/config.php
to /config/inetis/googlephotos/config.php
and put your app credentials inside.
Finally, you need to enable enable the Photos Library API for your project.
You need to create two CMS pages
For this one you need an additional :albumId
routing parameter in the URL of the page.
Add the Google Photos album component and in the component settings set the Album ID
property to the name of the routing parameter you setup for this page (i.e. :albumID
).
Add the Google Photos albums list component to this page, setting the Album Page
parameter to the page you created for the albums of a single gallery.
By default, Google Photos shows all albums related to your Google account or Google+ profile including automatically generated ones like "Auto Backup" and "Profile Photos". You can hide these albums from the plugin settings by adding as many albums as you want to the "Hidden albums" section. Just click on "Add new item" and fill the field with either an album ID or an album name.
inetis is a webdesign agency in Vufflens-la-Ville, Switzerland. We love coding and creating powerful apps and sites see our website.