Metadata-Version: 2.1
Name: wagtailcloudinary
Version: 2.1.1
Summary: Cloudinary support for Wagtail CMS
Home-page: https://gitlab.com/thelabnyc/wagtailcloudinary
License: ISC
Author: thelab
Author-email: thelabdev@thelab.co
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: cloudinary (>=1.40.0,<1.41.0)
Requires-Dist: python-dateutil (>=2.9.0.post0)
Requires-Dist: wagtail (>=5.2.5,<6.0)
Project-URL: Repository, https://gitlab.com/thelabnyc/wagtailcloudinary
Description-Content-Type: text/markdown

# Use cloudinary within wagtail

This project is still maintained, but I prefer this approach instead now https://gitlab.com/thelabnyc/wagtail-cloudinary-image

## About

This package adds Cloudinary support to Wagtail CMS

![cloudinary images in wagtail admin](./wagtailcloudinary.png)

## Installation

`pip install wagtailcloudinary`

Wagtail 2.4 and Django 2.1 are supported.

## Configuration

Add app wagtailcloudinary in your INSTALLED_APPS list. Also add cloudinary if not already done.

```
INSTALLED_APPS = [
    ...
    'cloudinary',
    'wagtailcloudinary',
    ...
]
```

in settings.py put your cloud_name, api_key and apy_secret into cloudinary configuration

```
import cloudinary

cloudinary.config(
    cloud_name=<YOUR_CLOUDINARY_CLOUD_NAME>,
    api_key=<YOUR_CLOUDINARY_API_KEY>,
    api_secret=<YOUR_CLOUDINARY_API_SECRET>,
)
```

Next edit your urls.py like this:

```
from wagtailcloudinary import site

urlpatterns = [
    ...
    url(r'^wagtailcloudinary', include(site.urls, namespace="wagtailcloudinary")),
    ...
]
```

## Usage

in models.py

```
from wagtail.wagtailadmin.edit_handlers import FieldPanel
from wagtail.wagtailcore.models import Page
from wagtailcloudinary.fields import CloudinaryField
from wagtailcloudinary.widgets import AdminCloudinaryChooser

class SomePage(Page):
    image = CloudinaryField()

    content_panels = Page.content_panels + [
        FieldPanel('image', widget=AdminCloudinaryChooser),
    ]
```

Or use in a streamfield

`from wagtailcloudinary.blocks import CloudinaryImageBlock`

