Donna Peplinskie (a11n)

Chuck Grimmett

Kim Clow

Fernando Fernandes

Dave Whitley

Automattic Special Projects

oh_hello

Kathryn Presner

Vegard S.

racheleliza

luisasacchetto

<p>Album Importer for Google Photos lets you quickly import images from a public Google Photos album into your WordPress site and show them as a gallery. Add the block to any post or page, paste a Google Photos album URL, and start the import — the images are added to your Media Library and displayed automatically.</p>
<h4>Basic Usage</h4>
<ol>
<li>Create or edit a post/page where you want the gallery.</li>
<li>Add the “Google Photos Album” block.</li>
<li>From Google Photos, share your album and copy the public link.</li>
<li>Paste the album URL into the block.</li>
<li>Click Start Import.</li>
<li>Wait for completion — the gallery is created automatically.</li>
</ol>
<h4>Album URL Format</h4>
<p>Use a publicly shared Google Photos album URL, for example:</p>
<pre><code>https://photos.app.goo.gl/XXXXXXXXXXXXXXXXX
</code></pre>
<h3>External services</h3>
<p>This plugin relies on Google Photos (a third-party service operated by Google LLC) to read and import publicly shared album content. No data is sent to any external service unless an authorized user explicitly provides a Google Photos album URL to the plugin. There are two entry points that trigger requests to Google:</p>
<ol>
<li>The “Album Importer for Google Photos” block in the post/page editor — pasting an album URL and clicking “Start Import”.</li>
<li>The “Import from Google Photos” button that the plugin adds to the media-selection modal of core Image, Gallery, Cover, and Media & Text blocks — pasting an album URL into the modal and clicking “Load album”.</li>
</ol>
<h4>Google Photos</h4>
<p>What it is and what it is used for: Google Photos is Google’s photo hosting and sharing service. The plugin uses it to fetch the contents of a publicly shared album so the images can be saved into the WordPress media library and rendered as a gallery.</p>
<p>What data is sent and when:</p>
<ul>
<li><strong>Verify the album (server -> Google).</strong> When an authorized editor pastes an album URL and triggers verification (clicking “Start Import” in the block, or “Load album” in the media-library modal), the plugin makes a server-side HTTP GET request to the album URL on <code>photos.google.com</code> or <code>photos.app.goo.gl</code> to retrieve the album’s public HTML page and parse the list of image URLs.</li>
<li><strong>Render thumbnail previews (browser -> Google).</strong> After verification returns the list of images, the plugin renders thumbnails directly in the editor by setting each image URL as the <code>src</code> of an <code><img></code> tag. This causes the editor user’s browser to make HTTP GET requests to <code>lh3.googleusercontent.com</code> for each thumbnail.</li>
<li><strong>Filename inference (server -> Google).</strong> For each image to be imported, the plugin makes a server-side HTTP HEAD request to <code>lh3.googleusercontent.com</code> to read the <code>Content-Disposition</code> header (the import continues even if this request fails).</li>
<li><strong>Image download (server -> Google).</strong> For each image, the plugin issues a server-side HTTP GET request to <code>lh3.googleusercontent.com</code> to download the image bytes and store them as a WordPress media attachment.</li>
<li>No user credentials, account information, or telemetry are collected or transmitted by the plugin. The only data the plugin sends is the album URL the editor pastes (and the derived image URLs from that album).</li>
</ul>
<p>Use of Google’s services is subject to Google’s terms:</p>
<ul>
<li><a href="https://policies.google.com/terms" rel="nofollow ugc">Google Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>
<h3>Source Code</h3>
<p>The full, unminified source code for this plugin — including the JavaScript and CSS sources used to generate the compiled files in <code>assets/js/build/</code> and <code>blocks/build/</code> — is publicly available on <a href="https://github.com/a8cteam51/importer-google-photos" rel="nofollow ugc">GitHub</a>.</p>
<p>Build tools and instructions:</p>
<ul>
<li>JavaScript and CSS are built with <code>@wordpress/scripts</code> (webpack) via npm.</li>
<li>PHP dependencies are managed with Composer.</li>
<li>To build the plugin from source, clone the repository and run:
<ol>
<li><code>npm ci</code></li>
<li><code>npm run build</code></li>
<li><code>composer install --no-dev --optimize-autoloader</code></li>
</ol>
</li>
<li>A <code>build.sh</code> script in the repository produces a distributable ZIP that mirrors the version published here.</li>
<li>JavaScript and SCSS sources are located in <code>assets/js/src/</code> (e.g. <code>style.scss</code>) and <code>blocks/src/album/</code> (e.g. <code>editor.scss</code>). They are compiled by <code>@wordpress/scripts</code> into the <code>assets/js/build/</code> and <code>blocks/build/</code> directories.</li>
</ul>


Album Importer for Google Photos

Import Google Photos albums into your WordPress media library and display them in a beautiful gallery block.

pavex

<p>This plugin requires a shared Google Photos album link to view photos using gallery/player or carousel. This widget is free to use for WordPress users.</p>
<p>It is very easy to use. Just write a <strong>shortcode</strong> to your post and include a link of shared Google Photos album as a parameter. Instead of shortcode, html code with links to the photo will be inserted and it will be decorated using Public album javascript.</p>
<h3>Example</h3>
<pre><code>[embed-google-photos-album link="https://photos.app.goo.gl/CSV7NDstShTUwUZq5"]

[embed-google-photos-album link="https://photos.app.goo.gl/CSV7NDstShTUwUZq5" mode="carousel"]

[embed-google-photos-album link="https://photos.app.goo.gl/CSV7NDstShTUwUZq5" mediaitems-cover="true"]

[embed-google-photos-album link="https://photos.app.goo.gl/CSV7NDstShTUwUZq5" background-color="#007acc"]
</code></pre>
<ul>
<li><strong>link</strong> – [string] public link of Google Photos album</li>
<li><strong>mode</strong> – [carousel | gallery-player] setup decorator mode, default id <code>gallery-player</code></li>
<li><strong>width</strong> – [int | ‘auto’] set widget width in pixel or “auto” to stretch to 100%</li>
<li><strong>height</strong> – [int | ‘auto’] set widget height in pixels or “auto” to stretch to 100%</li>
<li><strong>image-width</strong> – [int] image max-width in pixels, default is 1920</li>
<li><strong>image-height</strong> – [int] image max-height in pixels, default is 1080</li>
<li><strong>autoplay</strong> – [true | false] start slideshow in normal view (currently not allowed by decorator)</li>
<li><strong>delay</strong> – [true | false] slideshow delay in seconds, default is 5 seconds.</li>
<li><strong>repeat</strong> – [true | false] Enable or disable repeat slideshow, delfault is <code>true</code></li>
<li><strong>mediaitems-aspectration</strong> – [true | false], Keep asspect ration of images delfault is <code>true</code></li>
<li><strong>mediaitems-enlarge</strong> – [true | false], Turn on/off image enlarge, delfault is <code>true</code></li>
<li><strong>mediaitems-stretch</strong> – [true | false], Tunr on/off image stretch, delfault is <code>true</code></li>
<li><strong>mediaitems-cover</strong> – [true | false], Cover full canvas. Combine with aspect ratio parameter. Delfault is <code>false</code></li>
<li><strong>background-color</strong> – [#RRGGBB | transparent], Setup background color to RGB or transparent. Default is <code>#000000</code></li>
<li><strong>expiration</strong> – [int] setup expiration timeout in secons; default is 0; min. custom value is 86400s (experimental property)</li>
</ul>
<p>This widget, unsupported some features like a picture’s timestamp and captions. For a more detailed description of the component, go to <a href="https://www.publicalbum.org/blog/wordpress-google-photos-album-plugin" rel="nofollow ugc">WordPress Google Photos album plugin</a>.</p>
<p>In some cases, it may be better to use the following code directly in the template.</p>
<pre><code><?php
    echo (new Pavex_embed_google_photos_album()) -> getcode(
        'https://photos.app.goo.gl/CSV7NDstShTUwUZq5', 0, 480, 1920, 1080
    );
?>
</code></pre>
<h3>How do I update my album?</h3>
<p>The album will update automatically as soon as you save or update your post.</p>
<h3>Javascript decorator</h3>
<p>External javascript decorator is stored on CDN and loading and running of them is <strong>optimized for performance</strong>.</p>
<p>Javascript widget can be used without photos from Google photos. Detailed information on how to use javascript is available in one of older posts about <a href="https://www.publicalbum.org/blog/carousel-slideshow-gallery-widget-july-update" rel="nofollow ugc">carusel slideshow</a> on my blog.</p>
<h3>About Public album photo sharing website</h3>
<p><strong>Public album</strong> is now a <a href="https://www.publicalbum.org/blog/photo-sharing-website" rel="nofollow ugc">photo sharing website</a> and service for sharing short photosets available in single user profile.</p>
<p>The service can also be used as an alternative to <a href="https://www.publicalbum.org/blog/public-google-photos" rel="nofollow ugc">public Google Photos</a>. It is very suitable for the blogs focused mainly on photos. For example, a <strong>photoblog</strong> or a <a href="https://www.reabr.com" rel="nofollow ugc"><strong>online bookmark manager</strong></a>.</p>
<h3>Important links</h3>
<ul>
<li><strong>Public album sharing website</strong> <a href="https://www.publicalbum.org" rel="nofollow ugc">https://www.publicalbum.org</a></li>
<li><strong>Blog</strong> <a href="https://www.publicalbum.org/blog" rel="nofollow ugc">https://www.publicalbum.org/blog</a></li>
<li><strong>Facebook</strong> <a href="https://www.facebook.com/publicalbumapp" rel="nofollow ugc">https://www.facebook.com/publicalbumapp</a></li>
<li><strong>Reabr.com</strong> <a href="https://www.reabr.com" rel="nofollow ugc">online bookmark manager</a></li>
</ul>


Embed Google Photos album


Followed instruction to the tee but there were no images created for me!



Was hopeful, but expected it would not live up to my anticipation!


No images - Does not work

Embed Google Photos album using Player widget.

Album Importer for Google Photos vs Embed Google Photos album