WP Manifestindependent plugin directory
manifest / media / wp-gcs-media-plugin

WP GCS Media

This is a wordpress plugin in php. It is used to store/sync wordpress media files from gcs cloud storage bucket

by Aravind · github.com/aravindbalasundaram/wp-gcs-media-plugin

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/aravindbalasundaram/wp-gcs-media-plugin/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/aravindbalasundaram/wp-gcs-media-plugin ↗

A WordPress plugin written in PHP to store, sync, and serve media files (images, videos, documents, etc.) from a Google Cloud Storage (GCS) bucket instead of the local WordPress uploads directory.

This helps reduce server storage usage, improve media delivery performance, and centralize file storage on Google Cloud.

🚀 Features

  • Automatically uploads WordPress media files to Google Cloud Storage.
  • Syncs existing WordPress media library with GCS.
  • Serves media directly from GCS public URLs or via a custom CDN domain.
  • Supports all WordPress media types (images, videos, PDFs, etc.).
  • Works seamlessly with the WordPress Media Library.
  • Simple admin settings page for configuration.

📦 Installation

1. Manual Upload

  1. Download or clone this repository:

    git clone https://github.com/aravindbalasundaram/wp-gcs-media-plugin.git

  2. Copy the folder wp-gcs-media-plugin into your WordPress wp-content/plugins/ directory.

  3. Activate the plugin from WordPress Admin → Plugins.

2. Zip Install (Optional)

  1. Zip the folder:

cd wp-gcs-media-plugin zip -r wp-gcs-media-plugin.zip .

  1. Go to WordPress Admin → Plugins → Add New → Upload Plugin.

  2. Upload the wp-gcs-media-plugin.zip file and activate.

====

⚙️ Configuration

  1. Create a Google Cloud Storage (GCS) Bucket
  • Go to the Google Cloud Console
  • Create a new bucket (or use an existing one).
  • Make sure the bucket has the correct permissions for read/write access.
  1. Create a Service Account & Key
  • In Google Cloud Console, go to IAM & Admin → Service Accounts.
  • Create a new service account with the role:
    • Storage Object Admin
    • Storage Object Viewer
  • Generate a JSON key file and download it.
  • Place this file inside your WordPress server, e.g.: /var/www/html/wp-content/gcs-key.json
  1. Configure Plugin Settings

In your wp-config.php, define the following:

define('GCS_BUCKET', 'your-gcs-bucket-name'); define('GCS_KEY_FILE', DIR . '/gcs-key.json'); // Service Account JSON define('GCS_PROXY_DOMAIN', 'https://your-proxy-domain.com'); // Change to your proxy domain

If you don’t provide CGM_PROXY_DOMAIN, files will be served from the default GCS bucket URL.

📂 How It Works

  1. When you upload a file via WordPress Media Library:

    • The file is uploaded to GCS.
    • The local file can optionally be deleted (to save server space).
    • The WordPress attachment URL points to the GCS public URL.

  2. When accessing the media file:

    • WordPress rewrites the URL to point to your GCS bucket or CDN domain.

🔧 Usage

  1. Upload media as usual via Media → Add New in WordPress.

  2. Uploaded files will automatically sync to Google Cloud Storage.

  3. Access files directly from:

✅ Requirements

PHP 7.4+ (recommended 8.x)

WordPress 5.0+

Google Cloud Project with a valid service account & GCS bucket

google/cloud-storage PHP SDK (installed via composer)

Install dependencies (if not bundled):

bash command : composer require google/cloud-storage