PHPackages                             hexcss/wp-cloud-upload - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. hexcss/wp-cloud-upload

ActiveWordpress-plugin[File & Storage](/categories/file-storage)

hexcss/wp-cloud-upload
======================

A WordPress plugin to upload media files to Google Cloud Storage.

v1.0.1(1y ago)2561↓16.7%[1 issues](https://github.com/Hexcss/wordpress-cloud-upload-plugin/issues)MITPHPPHP >=7.4

Since Sep 2Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/Hexcss/wordpress-cloud-upload-plugin)[ Packagist](https://packagist.org/packages/hexcss/wp-cloud-upload)[ RSS](/packages/hexcss-wp-cloud-upload/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (4)Used By (0)

Cloud Upload Plugin
===================

[](#cloud-upload-plugin)

**Version**: 1.0.0 **Author**: Javier Cáder Suay

Overview
--------

[](#overview)

The **Cloud Upload Plugin** allows you to seamlessly upload WordPress media files to Google Cloud Storage, eliminating the need for local storage. This plugin automatically uploads files to a specified Google Cloud Storage bucket, organizes them by year and month, and replaces the local file URLs with public URLs from Google Cloud. Additionally, when media files are deleted from the WordPress media library, they are also removed from Google Cloud Storage.

Features
--------

[](#features)

- Uploads media files to Google Cloud Storage.
- Organizes uploaded files in a `year/month` directory structure within the bucket.
- Replaces local file URLs with public URLs from Google Cloud Storage.
- Automatically deletes media files from Google Cloud Storage when removed from WordPress.

Requirements
------------

[](#requirements)

- WordPress 5.0 or higher
- PHP 7.4 or higher
- Google Cloud Platform (GCP) account
- Google Cloud Storage bucket with Uniform Bucket-Level Access enabled

Installation
------------

[](#installation)

1. **Clone the Repository:**

    ```
    git clone https://github.com/Hexcss/wordpress-cloud-upload-plugin.git wp-content/plugins/cloud-upload-plugin
    ```
2. **Navigate to the Plugin Directory:**

    ```
    cd wp-content/plugins/cloud-upload-plugin
    ```
3. **Install Composer Dependencies:**

    Ensure you have [Composer](https://getcomposer.org/) installed on your system. Then, run:

    ```
    composer install
    ```
4. **Activate the Plugin:**

Configuration
-------------

[](#configuration)

1. **Google Cloud Setup:**

    - Create a Google Cloud Storage bucket with Uniform Bucket-Level Access enabled.
    - Create a service account with Storage Admin permissions.
    - Download the service account key in JSON format.
2. **Plugin Configuration:**

    - In the WordPress admin dashboard, go to **Settings > Cloud Upload.**
    - Paste the contents of your Google Cloud service account JSON into the **Service Account JSON** field.
    - Enter the name of your Google Cloud Storage bucket in the **Bucket Name** field.
    - Save the settings.

Usage
-----

[](#usage)

### Uploading Media Files

[](#uploading-media-files)

```
- When you upload a file through the WordPress media library, it will automatically be uploaded to Google Cloud Storage.
- The file will be stored in a year/month directory structure within your bucket.
- The URL of the file in WordPress will be replaced with the public URL from Google Cloud Storage.

```

### Deleting Media Files

[](#deleting-media-files)

```
- When you delete a media file from the WordPress media library, the plugin will automatically delete the corresponding file from Google Cloud Storage.

```

### Troubleshooting

[](#troubleshooting)

```
- File Not Found: Ensure the Google Cloud Storage bucket is publicly accessible.
- Permissions Issues: Double-check the service account permissions and that the service account JSON is correctly configured in the plugin setting

```

Contributing
------------

[](#contributing)

Contributions are welcome! If you find a bug or have an idea for an improvement, please open an issue or submit a pull request

Future Features and Roadmap
---------------------------

[](#future-features-and-roadmap)

Learn more about upcoming features and development plans in the following documents:

- [Future Features](./docs/FUTURE_FEATURES.md)
- [Roadmap](./docs/ROADMAP.md)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

668d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/98705767?v=4)[Javier Cader Suay](/maintainers/Hexcss)[@Hexcss](https://github.com/Hexcss)

---

Top Contributors

[![Hexcss](https://avatars.githubusercontent.com/u/98705767?v=4)](https://github.com/Hexcss "Hexcss (7 commits)")[![JavierCader](https://avatars.githubusercontent.com/u/113170731?v=4)](https://github.com/JavierCader "JavierCader (4 commits)")

### Embed Badge

![Health badge](/badges/hexcss-wp-cloud-upload/health.svg)

```
[![Health](https://phpackages.com/badges/hexcss-wp-cloud-upload/health.svg)](https://phpackages.com/packages/hexcss-wp-cloud-upload)
```

###  Alternatives

[superbalist/flysystem-google-storage

Flysystem adapter for Google Cloud Storage

26620.8M30](/packages/superbalist-flysystem-google-storage)[league/flysystem-google-cloud-storage

Google Cloud Storage adapter for Flysystem.

2319.4M70](/packages/league-flysystem-google-cloud-storage)[spatie/flysystem-google-cloud-storage

Flysystem adapter for Google Cloud Storage

24618.3k](/packages/spatie-flysystem-google-cloud-storage)[keboola/storage-api-client

Keboola Storage API PHP Client

10405.9k40](/packages/keboola-storage-api-client)[jeansouzak/duf

DUF (Download and Upload Files) - Fetch URL file, download and upload to a service

101.1k](/packages/jeansouzak-duf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)