Installation

This page walks you through getting Customer Cloud Gallery onto your WordPress site. It covers the three install paths (WordPress.org search, ZIP upload, WP-CLI), what the first-run welcome screen does, and how to recover if activation fails. Aimed at photographers and studio admins who can install plugins on their own WordPress site.

What you’ll learn

• The three ways to install the plugin and which one fits your workflow
• How to activate the plugin and what the welcome wizard checks
• Where to find the settings page once activation is done
• How to verify your server meets the minimum requirements
• What to do next once the plugin is live

Prerequisites

• A self-hosted WordPress site, version 6.2 or newer
• PHP 7.4 or newer (PHP 8.1+ recommended for best performance — not enforced by the plugin)
• PHP extensions: curl, openssl, and gd or imagick
• A WordPress user with the Administrator role (you need manage_options to install plugins and complete OAuth)
• Either a Google account or a Dropbox account where your photos already live (you can connect both later — no commitment to one provider yet)

Tutorial video

Video coming soon.

Step-by-step

Path A — Install from WordPress.org (recommended)

1. In the WordPress admin sidebar, go to Plugins → Add New.

2. In the search box, type Customer Cloud Gallery.

3. On the plugin card, click Install Now.

4. When the button changes to Activate, click it.

   

Path B — Upload the ZIP

Use this if you bought the Pro version from the website and have the ZIP file, or if your host blocks the WordPress.org connection.

1. Download the plugin ZIP. Do not unzip it.

2. Go to Plugins → Add New → Upload Plugin at the top of the page.

3. Click Choose File, select the ZIP, then Install Now.

4. Click Activate Plugin.

   

Path C — WP-CLI

If you manage your site over SSH:

wp plugin install customer-cloud-gallery --activate

For the Pro ZIP:

wp plugin install /path/to/customer-cloud-gallery.zip --activate

After activation: the welcome wizard

On first activation the plugin redirects you once to Customer Cloud Gallery → Settings. You’ll see a two-step Quick-Start panel:

1. Connect Google Drive or Dropbox — collapsed step-by-step guides for each provider, with the exact OAuth redirect URI you need to paste into the cloud console.
2. Create your first gallery — appears once at least one cloud is connected.

The panel disappears automatically once both steps are done. You can leave the page at any time and resume later — nothing is lost.

Common mistakes

Welcome page shows “Sorry, you are not allowed to access this page.” You activated the plugin while logged in as an Editor or lower role. Switch to an Administrator account and visit Customer Cloud Gallery → Settings manually — the plugin re-renders the same wizard there.

The plugin activated but I don’t see a sidebar entry. Look for Customer Cloud Gallery in the left admin menu (it has its own top-level entry). On some hosts the menu cache is stale for a minute — reload the admin once.

WP-CLI says “Could not open file” on a fresh ZIP. Make sure you’re pointing WP-CLI at the ZIP file itself, not the unpacked folder. WP-CLI accepts a path to a .zip or a public URL.

Next step

Connect your cloud storage so galleries have somewhere to read photos from: Google Drive setup or Dropbox setup.