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.

Grigory Metlenko

<p>Shortcode that lets you display your public Google Albums as a photo gallery on your website</p>


Grisha's GPlus Gallery Shortcode

Shortcode that lets you display your public Google Albums as a photo gallery on your website

Album Importer for Google Photos vs Grisha's GPlus Gallery Shortcode