Title: Auto Cloudinary
Author: Junaid Bhura
Published: <strong>Ноябрь 14, 2017-ж.</strong>
Last modified: Сентябрь 19, 2025-ж.

---

Плагиндерди издөө

![](https://ps.w.org/auto-cloudinary/assets/banner-772x250.png?rev=1765596)

![](https://ps.w.org/auto-cloudinary/assets/icon.svg?rev=1765596)

# Auto Cloudinary

 Автору [Junaid Bhura](https://profiles.wordpress.org/junaidbhura/)

[Жүктөө](https://downloads.wordpress.org/plugin/auto-cloudinary.1.3.1.zip)

 * [Кенен маалымат](https://kir.wordpress.org/plugins/auto-cloudinary/#description)
 * [Сын-пикирлер](https://kir.wordpress.org/plugins/auto-cloudinary/#reviews)
 *  [Орнотуу](https://kir.wordpress.org/plugins/auto-cloudinary/#installation)
 * [Development](https://kir.wordpress.org/plugins/auto-cloudinary/#developers)

 [Колдоо](https://wordpress.org/support/plugin/auto-cloudinary/)

## Сүрөттөө

[Check out the Github Repository ♥](https://github.com/junaidbhura/auto-cloudinary)

This plugin provides a **super simple** [Cloudinary auto-upload](https://cloudinary.com/documentation/fetch_remote_images#auto_upload_remote_resources)
implementation for WordPress.

It is inspired by [Photon](https://developer.wordpress.com/docs/photon/) and [Tachyon](https://github.com/humanmade/tachyon-plugin).

Cloudinary will **automatically fetch and serve the images** from your media library
like a **CDN**, without you having to worry about the complicated upload API! Just
[set up auto-upload](https://github.com/junaidbhura/auto-cloudinary/wiki/Setup) 
in your Cloudinary settings, enter the details in the plugin’s options, and you’re
all set!

Easy peasy 😎

### Important

This plugin is **incompatible with the official Cloudinary plugin**. You’d need 
to disable that plugin before using this one.

### Quick Links

[Setup](https://github.com/junaidbhura/auto-cloudinary/wiki/Setup) | [Issues](https://github.com/junaidbhura/auto-cloudinary/issues)
| [Functions](https://github.com/junaidbhura/auto-cloudinary/wiki/Functions) | [Filters](https://github.com/junaidbhura/auto-cloudinary/wiki/Filters)
| [Best Practices](https://github.com/junaidbhura/auto-cloudinary/wiki/Best-Practices)

### Why did you build this plugin?

There already is an **official Cloudinary plugin** available. But in my opinion,
it’s a bit of an overkill and takes over the admin UI. This plugin aims to be:

 * **Super simple** and light-weight
 * Totally seamless and **out of the way**
 * A flexible tool for **WordPress developers**

### What is Cloudinary Auto-Upload?

Cloudinary gives you two options to upload files to it’s servers:

 1. The complicated **Upload API** 😱
 2. The super easy and magical **Fetch API** 🎩

#### Upload API

_TL;DR: Too complicated and in the way_ 👎

Cloudinary gives you an API, using which, you can manually upload the images to 
Cloudinary. So you’d need an **API key**, etc. The **official plugin** uses this
method. When you upload an image to the media library, it in turn, uploads it to
Cloudinary. This could be a problem if you have thousands of **existing images**,
and might not be flexible enough to support **custom architecture**.

#### Fetch API

_TL;DR: Magical_ 👍

This plugin uses the super easy **Auto-Upload** feature in the **Fetch API**. We
just tell Cloudinary where to find the files on our server (or on S3 or anywhere
on the Internet), and it **automatically downloads** it from there and saves it 
on to it’s servers the **first time you ask for it**, like a CDN would!

### What does this plugin do?

This plugin does two main things:

 1. Provides a simple function `cloudinary_url()` to get a Cloudinary auto-upload URL
    for any image in your media library, with all the Cloudinary transformations, so
    you can **dynamically manipulate an image on the fly**.
 2. Attempts to automatically convert all image URLs on the front-end into a Cloudinary
    auto-upload URL, so you can **use Cloudinary as an image CDN**.

### The magical function 🎩

**`cloudinary_url( $identifier, $args )`**

This function returns a Cloudinary Auto Upload URL for an image. Please read the
[Best Practices](https://github.com/junaidbhura/auto-cloudinary/wiki/Best-Practices)
page before using this.

#### Parameters

 * **identifier** (integer/string)(required) : Either the ID of the attachment, 
   or a full image URL.
 * **args** (array)(optional) : Arguments to manipulate the image.

#### Return Value

Returns a URL (string):

    ```
    'https://res.cloudinary.com/cloud-name/auto-mapping-folder/2017/12/your-image.jpg'
    ```

#### Arguments

You can optionally send an array of arguments which can transform the image, and
set a dynamic file name. Ex:

    ```
    array(
        'transform' => array( // Optional. All transformations go here.
            'width'   => 300,
            'height'  => 200,
            'crop'    => 'fill',
            'quality' => '80',
            'gravity' => 'face',
        ),
        'file_name' => 'whatever-file-name-you-want', // Optional. If you want to use a dynamic file name for SEO. Don't use the file extension!
    );
    ```

Here’s a [full list of transformations](https://cloudinary.com/documentation/image_transformations)
you can achieve with Cloudinary.

### Examples

    ```
    <?php
    $url_1 = cloudinary_url( 123, array(
        'transform' => array(
            'width'   => 300,
            'height'  => 200,
            'crop'    => 'fill',
            'quality' => '80',
            'gravity' => 'face',
        ),
        'file_name' => 'dynamic-file-name',
    ) );

    $url_2 = cloudinary_url( 'https://www.yourwebsite.com/wp-content/uploads/2017/12/my-image.jpg', array(
        'transform' => array(
            'width'   => 100,
            'height'  => 100,
        ),
    ) );

    // $url_1 : https://res.cloudinary.com/cloud-name/images/w_300,h_200,c_fill,q_80,g_face/auto-mapping-folder/2017/12/my-image/dynamic-file-name.jpg
    // $url_2 : https://res.cloudinary.com/cloud-name/w_100,h_100/auto-mapping-folder/2017/12/my-image.jpg
    ?>

    <img src="<?php echo esc_url( $url_1 ); ?>" width="300" height="200" alt="">
    <img src="<?php echo esc_url( $url_2 ); ?>" width="100" height="100" alt="">
    ```

## Скриншоттор

 * [[
 * WordPress Options
 * [[
 * Cloudinary Cloud Name
 * [[
 * Cloudinary Auto Upload Setup

## Орнотуу

Upload ‘auto-cloudinary’ to the ‘/wp-content/plugins/’ directory.

Activate the plugin through the ‘Plugins’ menu in WordPress.

## Сын-пикирлер

![](https://secure.gravatar.com/avatar/7eb40a64a17ff9e8b0eab07beb672f95acacd430280828d5b27b88644212ff08?
s=60&d=retro&r=g)

### 󠀁[Amazing for Automatically Optimizing Images](https://wordpress.org/support/topic/amazing-for-automatically-optimizing-images/)󠁿

 [MCD Diseño Web](https://profiles.wordpress.org/tmacarreras/) Февраль 19, 2025-
ж.

Auto Cloudinary has been an incredible tool for automatically optimizing and delivering
my images quickly and efficiently on my WordPress site. Since I installed it, it’s
not only handled the automatic compression but also improved my page loading speed
by delivering images via Cloudinary. The setup is pretty straightforward, and the
plugin integrates seamlessly with my workflow. I love that it automatically handles
all image transformations, saving me time and effort. Plus, the image quality remains
intact, which is crucial for the visual design of my site. If you need to optimize
images and boost your site’s performance without any hassle, this plugin is an excellent
choice. —————————————————- Spanish Auto Cloudinary ha sido una herramienta increíble
para optimizar y entregar mis imágenes de manera rápida y eficiente en mi sitio 
de WordPress. Desde que lo instalé, no solo se ha encargado de la compresión automática,
sino que también ha mejorado la velocidad de carga de mi página al entregar las 
imágenes a través de Cloudinary. La configuración es bastante sencilla, y el plugin
se integra perfectamente con mi flujo de trabajo. Me encanta que el plugin maneje
todas las transformaciones de imágenes automáticamente, ahorrándome tiempo y esfuerzo.
Además, la calidad de las imágenes se mantiene intacta, lo que es crucial para el
diseño visual de mi sitio. Si necesitas optimizar imágenes y mejorar el rendimiento
de tu web sin complicarte, este plugin es una excelente opción.

![](https://secure.gravatar.com/avatar/0c0c654c7d5349c184056fadfe9fc9816c7e0b2e1bc14856529ee41ad2f3845d?
s=60&d=retro&r=g)

### 󠀁[Insta-crashed my site](https://wordpress.org/support/topic/insta-crashed-my-site/)󠁿

 [lsbmarketing](https://profiles.wordpress.org/lsbmarketing/) Декабрь 20, 2019-ж.
1 reply

Insta crashed my site as soon as it was activated. Just renamed the folder and was
able to regain admin access and uninstall it, but obviously doesn’t work for me 
for some reason. Fatal error: Cannot redeclare cloudinary_url() (previously declared
in /home1/sceniccoachtours/public_html/wp-content/plugins/auto-cloudinary/inc/helpers.
php:11) in /home1/sceniccoachtours/public_html/wp-content/plugins/cloudinary-image-
management-and-manipulation-in-the-cloud-cdn/lib/Helpers.php on line 414 There has
been a critical error on your website. Please check your site admin email inbox 
for instructions.

![](https://secure.gravatar.com/avatar/a33b83c456cb0208f526724c4f5a86faf26d7a668898b9fafe24bb707c4a54dc?
s=60&d=retro&r=g)

### 󠀁[Great plugin for developers.](https://wordpress.org/support/topic/great-plugin-for-developers-8/)󠁿

 [Adam Laita](https://profiles.wordpress.org/thealuminium/) Июль 26, 2019-ж.

Thanks for that, it works well.

![](https://secure.gravatar.com/avatar/42c4c07ae4f6765f194f1e641e9d8a503206f182244312bf6a00aba85a7a69f5?
s=60&d=retro&r=g)

### 󠀁[Cheaper than Imgix](https://wordpress.org/support/topic/cheaper-than-imgix/)󠁿

 [ginsengkimchi](https://profiles.wordpress.org/filmarelu/) Февраль 24, 2019-ж.

Cloudinary give you free and the lowest latency because of Akamai.

![](https://secure.gravatar.com/avatar/145b4ba6da41fd67865b5ec3e5ea004ee197c9f45f4b32036b5847562ea79ec0?
s=60&d=retro&r=g)

### 󠀁[(free) Image Optimization & CDN in 10 Minutes](https://wordpress.org/support/topic/free-image-optimization-cdn-in-10-minutes/)󠁿

 [Maurice](https://profiles.wordpress.org/mohaftig/) Февраль 15, 2019-ж.

If you are using the Screenshots as instructions, it takes just 10 Minutes to make
it work. Works for me out of the box with: + GeneratePress + WP Rocket Cache – Lazy
Loader – HTML, CSS & JavaScript Combine + Minification + Foo Gallery & Foobox – 
Only the “visible” Images/Thumbnails. + Yuzo Related Post Thumbnails

![](https://secure.gravatar.com/avatar/df7e023a33b339c25325b1d8bdba42db8a3c64d75b2b127ece0b9ed202d3834a?
s=60&d=retro&r=g)

### 󠀁[Could not get it to work. 🙁](https://wordpress.org/support/topic/could-not-get-it-to-work-14/)󠁿

 [bantanaaudio](https://profiles.wordpress.org/bantanaaudio/) Февраль 11, 2019-ж.
1 reply

Images return with the error “cannot be displayed because this image contains errors”
bummer would love to use this!

 [ Read all 14 reviews ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/)

## Contributors & Developers

“Auto Cloudinary” is open source software. The following people have contributed
to this plugin.

Мүчөлөрү

 *   [ Junaid Bhura ](https://profiles.wordpress.org/junaidbhura/)

[Translate “Auto Cloudinary” into your language.](https://translate.wordpress.org/projects/wp-plugins/auto-cloudinary)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/auto-cloudinary/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/auto-cloudinary/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/auto-cloudinary/)
by [RSS](https://plugins.trac.wordpress.org/log/auto-cloudinary/?limit=100&mode=stop_on_copy&format=rss).

## Өзгөртүүлөр

#### 1.3.0

 * Better handling of soft crops [#41](https://github.com/junaidbhura/auto-cloudinary/issues/41)

#### 1.2.3

 * Fixed missing admin settings page [#32](https://github.com/junaidbhura/auto-cloudinary/issues/32)

#### 1.2.2

 * Re-opened and fixed “Fix images sizes in block editor” [#25](https://github.com/junaidbhura/auto-cloudinary/issues/25)

#### 1.2.1

 * Fix images sizes in block editor [#25](https://github.com/junaidbhura/auto-cloudinary/issues/25)

#### 1.2.0

 * Turn off Cloudinary URLs for REST API calls [#18](https://github.com/junaidbhura/auto-cloudinary/issues/18)
 * Added progressive image loading parameter [#20](https://github.com/junaidbhura/auto-cloudinary/issues/20)
 * Full release details: [https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.2.0](https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.2.0)

#### 1.1.1

 * Better AJAX support [#13](https://github.com/junaidbhura/auto-cloudinary/issues/13)

#### 1.1.0

 * Added default crop options to the WP Admin [#10](https://github.com/junaidbhura/auto-cloudinary/issues/10)
 * Full release details: [https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.1.0](https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.1.0)

#### 1.0.3

 * New filters for default hard and soft crops [#2](https://github.com/junaidbhura/auto-cloudinary/issues/2).
   Props [@petersplugins](https://github.com/petersplugins)
 * Performance improvements
 * Full release details: [https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.0.3](https://github.com/junaidbhura/auto-cloudinary/releases/tag/1.0.3)

#### 1.0.2

 * Remove empty width and height from URL [#1](https://github.com/junaidbhura/auto-cloudinary/issues/1)

#### 1.0.1

 * Add default crop to replaced content images.

#### 1.0.0

 * First stable release.

## Мета

 *  Нуска **1.3.1**
 *  Акыркы жаңыртуу **7 ай мурун**
 *  Активдүү орнотуулар **200+**
 *  WordPress нускасы ** 4.4 же андан жогору **
 *  Tested up to **6.8.5**
 *  PHP нускасы ** 5.6 же андан жогору **
 *  Тил
 * [English (US)](https://wordpress.org/plugins/auto-cloudinary/)
 * Тег:
 * [cdn](https://kir.wordpress.org/plugins/tags/cdn/)[cloudinary](https://kir.wordpress.org/plugins/tags/cloudinary/)
   [dynamic images](https://kir.wordpress.org/plugins/tags/dynamic-images/)[image manipulation](https://kir.wordpress.org/plugins/tags/image-manipulation/)
   [image optimization](https://kir.wordpress.org/plugins/tags/image-optimization/)
 *  [Advanced View](https://kir.wordpress.org/plugins/auto-cloudinary/advanced/)

## Рейтинг

 4.4 out of 5 stars.

 *  [  11 5-star reviews     ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/auto-cloudinary/reviews/?filter=1)

[Менин сын-пикиримди кошуу](https://wordpress.org/support/plugin/auto-cloudinary/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/auto-cloudinary/reviews/)

## Мүчөлөрү

 *   [ Junaid Bhura ](https://profiles.wordpress.org/junaidbhura/)

## Колдоо

Комментарийлер барбы? Жардам керекпи?

 [Колдоо форумун көрүү](https://wordpress.org/support/plugin/auto-cloudinary/)