# 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`
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/thelabnyc/wagtailcloudinary",
"name": "wagtailcloudinary",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "thelab",
"author_email": "thelabdev@thelab.co",
"download_url": "https://files.pythonhosted.org/packages/37/f7/88278cab1cac77c6ee795257cda8b8864e6c8dea8cd5e72ee9c0f5ef82ee/wagtailcloudinary-2.2.0.tar.gz",
"platform": null,
"description": "# Use cloudinary within wagtail\n\nThis project is still maintained, but I prefer this approach instead now https://gitlab.com/thelabnyc/wagtail-cloudinary-image\n\n## About\n\nThis package adds Cloudinary support to Wagtail CMS\n\n![cloudinary images in wagtail admin](./wagtailcloudinary.png)\n\n## Installation\n\n`pip install wagtailcloudinary`\n\nWagtail 2.4 and Django 2.1 are supported.\n\n## Configuration\n\nAdd app wagtailcloudinary in your INSTALLED_APPS list. Also add cloudinary if not already done.\n\n```\nINSTALLED_APPS = [\n ...\n 'cloudinary',\n 'wagtailcloudinary',\n ...\n]\n```\n\nin settings.py put your cloud_name, api_key and apy_secret into cloudinary configuration\n\n```\nimport cloudinary\n\ncloudinary.config(\n cloud_name=<YOUR_CLOUDINARY_CLOUD_NAME>,\n api_key=<YOUR_CLOUDINARY_API_KEY>,\n api_secret=<YOUR_CLOUDINARY_API_SECRET>,\n)\n```\n\nNext edit your urls.py like this:\n\n```\nfrom wagtailcloudinary import site\n\nurlpatterns = [\n ...\n url(r'^wagtailcloudinary', include(site.urls, namespace=\"wagtailcloudinary\")),\n ...\n]\n```\n\n## Usage\n\nin models.py\n\n```\nfrom wagtail.wagtailadmin.edit_handlers import FieldPanel\nfrom wagtail.wagtailcore.models import Page\nfrom wagtailcloudinary.fields import CloudinaryField\nfrom wagtailcloudinary.widgets import AdminCloudinaryChooser\n\nclass SomePage(Page):\n image = CloudinaryField()\n\n content_panels = Page.content_panels + [\n FieldPanel('image', widget=AdminCloudinaryChooser),\n ]\n```\n\nOr use in a streamfield\n\n`from wagtailcloudinary.blocks import CloudinaryImageBlock`\n\n",
"bugtrack_url": null,
"license": "ISC",
"summary": "Cloudinary support for Wagtail CMS",
"version": "2.2.0",
"project_urls": {
"Homepage": "https://gitlab.com/thelabnyc/wagtailcloudinary",
"Repository": "https://gitlab.com/thelabnyc/wagtailcloudinary"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d775abd24dc62c0a0e2718aba94e7d31c793714342ac11938dd0f2c660bff1e7",
"md5": "19b2cf05122037cc329628343defe869",
"sha256": "bf91f626d9bbaad4a5a67372853cf196f258463bdfb0939c9e73636780a13e8c"
},
"downloads": -1,
"filename": "wagtailcloudinary-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19b2cf05122037cc329628343defe869",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 18076,
"upload_time": "2024-11-01T18:47:47",
"upload_time_iso_8601": "2024-11-01T18:47:47.828150Z",
"url": "https://files.pythonhosted.org/packages/d7/75/abd24dc62c0a0e2718aba94e7d31c793714342ac11938dd0f2c660bff1e7/wagtailcloudinary-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "37f788278cab1cac77c6ee795257cda8b8864e6c8dea8cd5e72ee9c0f5ef82ee",
"md5": "fa2e2d0010578e21f02e9f21e911c4e8",
"sha256": "9a8cce1633f7d4509af4e042cf0290982a7f2b75eb781c25dba0575d837ffbff"
},
"downloads": -1,
"filename": "wagtailcloudinary-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "fa2e2d0010578e21f02e9f21e911c4e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 12112,
"upload_time": "2024-11-01T18:47:49",
"upload_time_iso_8601": "2024-11-01T18:47:49.420728Z",
"url": "https://files.pythonhosted.org/packages/37/f7/88278cab1cac77c6ee795257cda8b8864e6c8dea8cd5e72ee9c0f5ef82ee/wagtailcloudinary-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-01 18:47:49",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "thelabnyc",
"gitlab_project": "wagtailcloudinary",
"lcname": "wagtailcloudinary"
}