PHPackages                             kodansha/wack-cloudinary - 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. kodansha/wack-cloudinary

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

kodansha/wack-cloudinary
========================

Uploads the uploaded media files to Cloudinary

v0.1.0(2mo ago)067GPL-3.0-or-laterPHPPHP >=8.2

Since Feb 8Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/kodansha/wack-cloudinary)[ Packagist](https://packagist.org/packages/kodansha/wack-cloudinary)[ Docs](https://github.com/kodansha/wack-cloudinary)[ RSS](/packages/kodansha-wack-cloudinary/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

WACK Cloudinary
===============

[](#wack-cloudinary)

**WACK Cloudinary** is a WordPress plugin to upload the media files to Cloudinary.

It hooks into the WordPress [`wp_handle_upload`](https://developer.wordpress.org/reference/hooks/wp_handle_upload/)and when a media file is uploaded, it also uploads the file to Cloudinary.

It is created with the intention of being used with the WACK Stack, but it can also be used with other WordPress installations.

Important

This plugin does **NOT** replaces neither the media URLs in the content nor the URLs in the media library. This means you have to manually replace the URLs when displaying the media to users.

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

[](#installation)

- Requires PHP 8.2 or later
- Requires WordPress 6.0 or later
- Requires Composer

### Using Composer

[](#using-composer)

```
composer require kodansha/wack-cloudinary
```

Note

This plugin is not available on the WordPress.org plugin repository. For the moment, the only way to install it is to use Composer.

How to use
----------

[](#how-to-use)

### Pre-requisites

[](#pre-requisites)

You need to set up the Cloudinary account and [set the credentials in the environment variables](https://cloudinary.com/documentation/php_integration#setting_the_cloudinary_url_environment_variable).

```
export CLOUDINARY_URL=cloudinary://:@
```

Tip

It strongly recommended to use the `.env` file to set the environment variables, especially in the local development environment.

### Configuration

[](#configuration)

You might want to define settings through the `WACK_CLOUDINARY_SETTINGS` constant:

```
define('WACK_CLOUDINARY_SETTINGS', [
    // Optional: The type of the Cloudinary media access. Possible values are 'authenticated', 'upload', 'private'
    // Default: 'upload'
    'type' => 'private',

    // Optional: The Cloudinary root folder to upload the media files.
    // Default: none
    'root_folder' => 'my-root-folder',

    // Optional: The notification URL endpoint to receive the Cloudinary notifications.
    // Default: none
    'notification_url' => 'https://example.com/cloudinary-notification',

    // Optional: The username and password for the basic authentication.
    // If your WordPress is behind the basic authentication, you need to set this to work the async requests.
    // Default: none
    'basic_auth' => [
        'username' => 'example-user',
        'password' => 'example-password',
    ]
]);
```

### Upload media files

[](#upload-media-files)

After setting the above pre-requisites and configuration, when you upload a media file to the WordPres, the file is also uploaded to Cloudinary.

TODO
----

[](#todo)

- Support video upload
- Support eager transformation
- Support upload presets

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance86

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~374 days

Total

3

Last Release

73d ago

PHP version history (2 changes)v0.0.1PHP >=8.1

v0.1.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/19324b7c1443d7275e10ceb66dd9004cba4a09640900791eb5c5040080ab4096?d=identicon)[kodansha](/maintainers/kodansha)

---

Top Contributors

[![5t111111](https://avatars.githubusercontent.com/u/333180?v=4)](https://github.com/5t111111 "5t111111 (5 commits)")

---

Tags

pluginwordpress

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/kodansha-wack-cloudinary/health.svg)

```
[![Health](https://phpackages.com/badges/kodansha-wack-cloudinary/health.svg)](https://phpackages.com/packages/kodansha-wack-cloudinary)
```

###  Alternatives

[kartik-v/yii2-widget-fileinput

An enhanced FileInput widget for Bootstrap 3.x, 4.x & 5.x with file preview, multiple selection, and more features (sub repo split from yii2-widgets)

2286.8M94](/packages/kartik-v-yii2-widget-fileinput)[humanmade/network-media-library

Network Media Library provides a central media library that's shared across all sites on the Multisite network.

29644.8k](/packages/humanmade-network-media-library)[ilab/ilab-media-tools

Tools for cropping, uploading to S3, serving through Imgix

119102.7k1](/packages/ilab-ilab-media-tools)[mcguffin/acf-dropzone

Drag and drop file upload for ACF-Fields.

339.2k](/packages/mcguffin-acf-dropzone)[sistemi-etime/flysystem-plugin-aws-s3-v3

AWS S3 plugin for Flysystem.

11154.2k1](/packages/sistemi-etime-flysystem-plugin-aws-s3-v3)

PHPackages © 2026

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