wagtail-bynder


Namewagtail-bynder JSON
Version 0.4.0 PyPI version JSON
download
home_pageNone
SummaryWagtail integration with Bynder, a Digital Asset Management System
upload_time2024-04-25 15:27:57
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords wagtail django bynder dams digital asset management
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # Bynder integration for Wagtail

[![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD--3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![PyPI version](https://img.shields.io/pypi/v/wagtail-bynder.svg?style=flat)](https://pypi.org/project/wagtail-bynder)
[![Build status](https://img.shields.io/github/actions/workflow/status/torchbox/wagtail-bynder/test.yml?branch=main)](https://github.com/torchbox/wagtail-bynder/actions)

## Links

- [Documentation](https://github.com/torchbox/wagtail-bynder/blob/main/README.md)
- [Changelog](https://github.com/torchbox/wagtail-bynder/blob/main/CHANGELOG.md)
- [Contributing](https://github.com/torchbox/wagtail-bynder/blob/main/CONTRIBUTING.md)
- [Discussions](https://github.com/torchbox/wagtail-bynder/discussions)
- [Security](https://github.com/torchbox/wagtail-bynder/security)

[Bynder](https://www.bynder.com) is a Digital Asset Management System (DAMS) and platform that allows organisations
to manage their digital assets, which includes the images and documents used in Wagtail content.

The data flow is one way: Bynder assets are always treated as the source of truth, and Wagtail uses read-only API access
to create copies of assets and keep them up-to-date.

## How it works

The main points of integration are Wagtail's image and document chooser views, which are patched by this app to show an
asset selection UI for Bynder instead of a list of Wagtail images or documents.

When an asset is selected, Wagtail silently downloads the file and related metadata, and saves it as an `Image` or
`Document` object, allowing it to be used in a typical way. The ID of the selected asset (as well as a few other bits of data)
are saved on the object when this happens, helping Wagtail to recognise when it already has a copy of an asset,
and to help keep them up-to-date with changes made in Bynder.

Currently, changes are synced from Bynder back to Wagtail via a few well-optimised management commands,
intended to be run regularly (via a cron job):

- `python manage.py update_stale_images`
- `python manage.py update_stale_documents`
- `python manage.py update_stale_videos`

By default, these commands only fetch data for assets updated within the last 24 hours. However, you can use the `minutes`, `hours` or `days` options to narrow or widen this timespan. For example:

To sync images updated within the last 30 minutes only:

```sh
$ python manage.py update_stale_images --minutes=30
```

To sync images updated within the last three hours only:

```sh
$ python manage.py update_stale_images --hours=3
```

To sync images updated within the last three days:

```sh
$ python manage.py update_stale_images --days=3
```

## What to ask of Bynder

When communicating with Bynder about configuring a new instance for compatibility with Wagtail, there are a few things you'll want to be clear about:

1. Document assets should be fully enabled
2. A custom derivative must to be configured for image assets
3. A couple of custom derivatives must be configured for video assets


### Why are custom derivatives needed?

It is common for assets to be uploaded to a DAMS in formats that preserve as much quality as possible. For example, high-resolution uncompressed TIFF images are common for digital photography. While great for print and other media, such formats are simply overkill for most websites. Not only are images likely to be shown at much smaller dimensions in a web browser, but they are also likely to be converted to more web-friendly formats like AVIF or WebP by Wagtail, where the image quality of an uncompressed TIFF is unlikely to shine through.

Over time, unnecessarily large source images will have a compounding impact on website performance. Editors will need to wait longer for Wagtail to download the images from Bynder. And, every time a new rendition is needed, the original must be loaded into memory from wherever it is stored, consuming more precious system memory than necessary, and blocking system I/O operations for longer whilst the file is read from storage.

#### 'WagtailSource' derivative for images

What Wagtail really needs is a reliable, high quality derivative, which it can use as a 'source' to generate renditions from. This should strike the right balance between:

- Being large enough to use in most website contexts (Think full-width hero images that need to look decent on a large high-resolution display). A maximum width or height of **3500 pixels** is usually enough for this.
- Retaining as much visual quality as possible, whilst keeping file sizes reasonable. Individual images will naturally vary, but somewhere **between 4MB and 6MB** is a reasonable target.

In most cases, `JPG` will probably the best option. But, for fine art images with lots of uniform colour and sharp edges, `PNG` might be a better fit.

Once configured, URLs for the new derivative should appear under `"thumbnails"` in the API representation for image assets, like so:

```json
"thumbnails": {
  "mini": "https://orgname.bynder.com/m/3ece125489f192fa/YourGroovyImage.png",
  "thul": "https://orgname.bynder.com/m/3ece125489f192fa/thul-YourGroovyImage.png",
  "webimage": "https://orgname.bynder.com/m/3ece125489f192fa/webimage-YourGroovyImage.png",
  "WagtailSource": "https://orgname.bynder.com/m/3ece125489f192fa/WagtailSource-YourGroovyImage.jpg",
}
```

### 'WebPrimary' and 'WebFallback' derivatives for videos

The goal here is to ensure video can be seen by the widest possibly audience (Wagtail doesn't take a copy of video media like it does for image - as it isn't well equipped for re-encoding it).

Support for media container formats, video and audio codecs has become more consistant over the years. The general consensus is that video on the web should be provided in two different formats in order to work for the widest audience. So, we recommend that Bynder generate **two** custom derivatives for videos:

**WebPrimary**: A derivative using a WebM container, the VP9 codec for video and the Opus codec for audio. These are all open, royalty-free formats which are generally well-supported, although only in quite recent browsers, which is why a fallback is a good idea.

**WebFallback**: A derivative using an MP4 container and the AVC (H.264) video codec, ideally with the AAC codec for audio. This combination has great support in every major browser, and the quality is typically good for most use cases.

Once configured, URLs for the new derivatives should appear under `"videoPreviewURLs"` in the API representation for video assets, like so:

```json
"videoPreviewURLs": [
  "https://orgname.bynder.com/asset/52477218-06f5-4e55-ad55-049bf33b105f/WebPrimary/WebPrimary-YourGroovyVideo.web",
  "https://orgname.bynder.com/asset/52477218-06f5-4e55-ad55-049bf33b105f/WebFallback/WebFallback-YourGroovyVideo.mp4",
]
```

NOTE: The proposed 'WebPrimary' and 'WebFallback' names do not include 'Wagtail' in the name, because there really isn't anything Wagtail-specific about them. They should be useful in any 'web' context.

## Installation

In your project's Django settings, add the app your `INSTALLED_APPS` list (at the end is fine):

```python
INSTALLED_APPS = [
  # ...
  "wagtail_bynder",
]
```

Then add the following to the `MIDDLEWARE` list (at the end is fine):

```python
MIDDLEWARE = [
  #...
  "wagtail_bynder.middleware.PatchWagtailURLsMiddleware",
]
```

Import the abstract `BynderSyncedImage` model and have your project's custom image model definition subclass it instead
of `wagtail.images.models.AbstractImage`. For example

```python
# yourproject/images/models.py
from wagtail_bynder.models import BynderSyncedImage


class CustomImage(BynderSyncedImage):
    pass
```

Import the abstract `BynderSyncedDocument` model and have your project's custom document model definition subclass it instead of
`wagtail.documents.models.AbstractDocument`. For example:

```python
# yourproject/documents/models.py
from wagtail_bynder.models import BynderSyncedDocument


class CustomDocument(BynderSyncedDocument):
    pass
```

Finally, run Django's `makemigrations` and `migrate` commands to apply any model field changes to your project

```sh
$ python manage.py makemigrations
$ python manage.py migrate
```

### Optional: To use videos from Bynder

To use videos from Bynder in content across the site, this app includes a specialised model to help store relevant data for videos,
plus blocks and chooser widgets to help use them in your project. However, because not all projects use video,
and project-specific requirements around video usage can be a little more custom,
the model is `abstract` - you need to subclass it in order to use the functionality.

First, ensure you have `wagtail.snippets` in your project's `INSTALLED_APPS`:

```python: highlight-line=7
INSTALLED_APPS = [
  # ...
  "wagtail.users",
  "wagtail.admin",
  "wagtail.documents",
  "wagtail.images",
  "wagtail.snippets",
  "wagtail",
   # ...
]
```

Next, import the abstract `BynderSyncedVideo` model and subclass it within your project to create a concrete model.
For example:

```python
# yourproject/videos/models.py
from wagtail_bynder.models import BynderSyncedVideo


class Video(BynderSyncedVideo):
    pass
```

Then, in your project's Django settings, add a `BYNDER_VIDEO_MODEL` item to establish your custom model as the 'official'
video model. The value should be a string in the format `"app_label.Model"`. For example:

```python
BYNDER_VIDEO_MODEL = "videos.Video"
```

Finally, run Django's `makemigrations` and `migrate` commands to create and apply the model changes in your project.

```sh
$ python manage.py makemigrations
$ python manage.py migrate
```

## Configuration

You can use the following settings to configure the integration:

### `BYNDER_DOMAIN`

Example: `"your-org.bynder.com"`

Default: `None`

The Bynder instance you want the environment to use.

### `BYNDER_API_TOKEN`

Example: `"60ae04f68460cfed1b289c4c1db4c9b273b238dx2030c51298dcad245b5ff1f8"`

Default: `None`

An API token for the back end to use when talking to the Bynder API.
NOTE: This could be more permissive than `BYNDER_COMPACTVIEW_API_TOKEN`, so should be kept separate to avoid surfacing to Wagtail users.

### `BYNDER_COMPACTVIEW_API_TOKEN`

Example: `"64ae04f71460cfed1b289c4c1db4c9b273b238dx2030c51298dcad245b5ff1f8"`

Default: `None`

An API token for Bynder's JavaScript 'compact view' to use. The value is injected into the `admin_base.html` template for Wagtail
for the JavaScript to pick up, exposing it to Wagtail users. Because of this, it should be different to `BYNDER_API_TOKEN`
and only needs to have basic read permissions.

### `BYNDER_IMAGE_SOURCE_THUMBNAIL_NAME`

Default: `"WagtailSource"`

The name of the automatically generated derivative that should be downloaded and used as the `file` value for the
representative Wagtail image (as it appears in `thumbnails` in the API representation).

WARNING: It's important to get this right, because if the specified derivative is NOT present in the response for an
image for any reason, the ORIGINAL will be downloaded - which will lead to slow chooser response times and higher memory
usage when generating renditions.

### `BYNDER_VIDEO_MODEL`

Example: `"video.Video"`

Default: `None`

### `BYNDER_VIDEO_PRIMARY_DERIVATIVE_NAME`

Default: `"WebPrimary"`

### `BYNDER_VIDEO_FALLBACK_DERIVATIVE_NAME`

Default: `"WebFallback"`

### `BYNDER_VIDEO_POSTER_IMAGE_DERIVATIVE_NAME`

Default: `"webimage"`

### `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`

Example: `True`

Default: `False`

When `True`, local copies of images will be refreshed from the Bynder API representation whenever they are selected in
the chooser interface. This slows down the chooser experience slightly, but can be useful for seeing up-to-date data in
environments that might not be using the management commands or other means to keep images up-to-date with their Bynder counterparts.

### `BYNDER_SYNC_EXISTING_DOCUMENTS_ON_CHOOSE`

Example: `True`

Default: `False`

As `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`, but for documents.

### `BYNDER_SYNC_EXISTING_VIDEOS_ON_CHOOSE`

Example: `True`

Default: `False`

As `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`, but for videos.

### `BYNDER_DISABLE_WAGTAIL_EDITING_FOR_ASSETS`

Example: `True`

Default: `False`

When `True`, hitting Wagtail's built-in edit view for an image or document will result in a redirect to the asset
detail view in the Bynder interface.

The default is value is `False`, because it can be useful to use the Wagtail representation to check that file, metadata
and focal points are being accurately reflected.

## Contributing

All contributions are welcome! See [CONTRIBUTING.md](https://github.com/torchbox/wagtail-bynder/blob/main/CONTRIBUTING.md)

Supported versions:

- Python 3.11, 3.12
- Django 3.2, 4.2, 5.0
- Wagtail 4.1 (LTS), 5.1, 5.2 (LTS)


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "wagtail-bynder",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": "Andy Babic <andy.babic@torchbox.com>, Dan Braghis <dan.braghis@torchbox.com>",
    "keywords": "Wagtail, Django, Bynder, DAMS, digital asset management",
    "author": null,
    "author_email": "Andy Babic  <andy.babic@torchbox.com>",
    "download_url": "https://files.pythonhosted.org/packages/d5/05/2dc2e5618a89b55cb376ef592f17d7df2d2f7e74fda433c1060734400499/wagtail_bynder-0.4.0.tar.gz",
    "platform": null,
    "description": "# Bynder integration for Wagtail\n\n[![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD--3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![PyPI version](https://img.shields.io/pypi/v/wagtail-bynder.svg?style=flat)](https://pypi.org/project/wagtail-bynder)\n[![Build status](https://img.shields.io/github/actions/workflow/status/torchbox/wagtail-bynder/test.yml?branch=main)](https://github.com/torchbox/wagtail-bynder/actions)\n\n## Links\n\n- [Documentation](https://github.com/torchbox/wagtail-bynder/blob/main/README.md)\n- [Changelog](https://github.com/torchbox/wagtail-bynder/blob/main/CHANGELOG.md)\n- [Contributing](https://github.com/torchbox/wagtail-bynder/blob/main/CONTRIBUTING.md)\n- [Discussions](https://github.com/torchbox/wagtail-bynder/discussions)\n- [Security](https://github.com/torchbox/wagtail-bynder/security)\n\n[Bynder](https://www.bynder.com) is a Digital Asset Management System (DAMS) and platform that allows organisations\nto manage their digital assets, which includes the images and documents used in Wagtail content.\n\nThe data flow is one way: Bynder assets are always treated as the source of truth, and Wagtail uses read-only API access\nto create copies of assets and keep them up-to-date.\n\n## How it works\n\nThe main points of integration are Wagtail's image and document chooser views, which are patched by this app to show an\nasset selection UI for Bynder instead of a list of Wagtail images or documents.\n\nWhen an asset is selected, Wagtail silently downloads the file and related metadata, and saves it as an `Image` or\n`Document` object, allowing it to be used in a typical way. The ID of the selected asset (as well as a few other bits of data)\nare saved on the object when this happens, helping Wagtail to recognise when it already has a copy of an asset,\nand to help keep them up-to-date with changes made in Bynder.\n\nCurrently, changes are synced from Bynder back to Wagtail via a few well-optimised management commands,\nintended to be run regularly (via a cron job):\n\n- `python manage.py update_stale_images`\n- `python manage.py update_stale_documents`\n- `python manage.py update_stale_videos`\n\nBy default, these commands only fetch data for assets updated within the last 24 hours. However, you can use the `minutes`, `hours` or `days` options to narrow or widen this timespan. For example:\n\nTo sync images updated within the last 30 minutes only:\n\n```sh\n$ python manage.py update_stale_images --minutes=30\n```\n\nTo sync images updated within the last three hours only:\n\n```sh\n$ python manage.py update_stale_images --hours=3\n```\n\nTo sync images updated within the last three days:\n\n```sh\n$ python manage.py update_stale_images --days=3\n```\n\n## What to ask of Bynder\n\nWhen communicating with Bynder about configuring a new instance for compatibility with Wagtail, there are a few things you'll want to be clear about:\n\n1. Document assets should be fully enabled\n2. A custom derivative must to be configured for image assets\n3. A couple of custom derivatives must be configured for video assets\n\n\n### Why are custom derivatives needed?\n\nIt is common for assets to be uploaded to a DAMS in formats that preserve as much quality as possible. For example, high-resolution uncompressed TIFF images are common for digital photography. While great for print and other media, such formats are simply overkill for most websites. Not only are images likely to be shown at much smaller dimensions in a web browser, but they are also likely to be converted to more web-friendly formats like AVIF or WebP by Wagtail, where the image quality of an uncompressed TIFF is unlikely to shine through.\n\nOver time, unnecessarily large source images will have a compounding impact on website performance. Editors will need to wait longer for Wagtail to download the images from Bynder. And, every time a new rendition is needed, the original must be loaded into memory from wherever it is stored, consuming more precious system memory than necessary, and blocking system I/O operations for longer whilst the file is read from storage.\n\n#### 'WagtailSource' derivative for images\n\nWhat Wagtail really needs is a reliable, high quality derivative, which it can use as a 'source' to generate renditions from. This should strike the right balance between:\n\n- Being large enough to use in most website contexts (Think full-width hero images that need to look decent on a large high-resolution display). A maximum width or height of **3500 pixels** is usually enough for this.\n- Retaining as much visual quality as possible, whilst keeping file sizes reasonable. Individual images will naturally vary, but somewhere **between 4MB and 6MB** is a reasonable target.\n\nIn most cases, `JPG` will probably the best option. But, for fine art images with lots of uniform colour and sharp edges, `PNG` might be a better fit.\n\nOnce configured, URLs for the new derivative should appear under `\"thumbnails\"` in the API representation for image assets, like so:\n\n```json\n\"thumbnails\": {\n  \"mini\": \"https://orgname.bynder.com/m/3ece125489f192fa/YourGroovyImage.png\",\n  \"thul\": \"https://orgname.bynder.com/m/3ece125489f192fa/thul-YourGroovyImage.png\",\n  \"webimage\": \"https://orgname.bynder.com/m/3ece125489f192fa/webimage-YourGroovyImage.png\",\n  \"WagtailSource\": \"https://orgname.bynder.com/m/3ece125489f192fa/WagtailSource-YourGroovyImage.jpg\",\n}\n```\n\n### 'WebPrimary' and 'WebFallback' derivatives for videos\n\nThe goal here is to ensure video can be seen by the widest possibly audience (Wagtail doesn't take a copy of video media like it does for image - as it isn't well equipped for re-encoding it).\n\nSupport for media container formats, video and audio codecs has become more consistant over the years. The general consensus is that video on the web should be provided in two different formats in order to work for the widest audience. So, we recommend that Bynder generate **two** custom derivatives for videos:\n\n**WebPrimary**: A derivative using a WebM container, the VP9 codec for video and the Opus codec for audio. These are all open, royalty-free formats which are generally well-supported, although only in quite recent browsers, which is why a fallback is a good idea.\n\n**WebFallback**: A derivative using an MP4 container and the AVC (H.264) video codec, ideally with the AAC codec for audio. This combination has great support in every major browser, and the quality is typically good for most use cases.\n\nOnce configured, URLs for the new derivatives should appear under `\"videoPreviewURLs\"` in the API representation for video assets, like so:\n\n```json\n\"videoPreviewURLs\": [\n  \"https://orgname.bynder.com/asset/52477218-06f5-4e55-ad55-049bf33b105f/WebPrimary/WebPrimary-YourGroovyVideo.web\",\n  \"https://orgname.bynder.com/asset/52477218-06f5-4e55-ad55-049bf33b105f/WebFallback/WebFallback-YourGroovyVideo.mp4\",\n]\n```\n\nNOTE: The proposed 'WebPrimary' and 'WebFallback' names do not include 'Wagtail' in the name, because there really isn't anything Wagtail-specific about them. They should be useful in any 'web' context.\n\n## Installation\n\nIn your project's Django settings, add the app your `INSTALLED_APPS` list (at the end is fine):\n\n```python\nINSTALLED_APPS = [\n  # ...\n  \"wagtail_bynder\",\n]\n```\n\nThen add the following to the `MIDDLEWARE` list (at the end is fine):\n\n```python\nMIDDLEWARE = [\n  #...\n  \"wagtail_bynder.middleware.PatchWagtailURLsMiddleware\",\n]\n```\n\nImport the abstract `BynderSyncedImage` model and have your project's custom image model definition subclass it instead\nof `wagtail.images.models.AbstractImage`. For example\n\n```python\n# yourproject/images/models.py\nfrom wagtail_bynder.models import BynderSyncedImage\n\n\nclass CustomImage(BynderSyncedImage):\n    pass\n```\n\nImport the abstract `BynderSyncedDocument` model and have your project's custom document model definition subclass it instead of\n`wagtail.documents.models.AbstractDocument`. For example:\n\n```python\n# yourproject/documents/models.py\nfrom wagtail_bynder.models import BynderSyncedDocument\n\n\nclass CustomDocument(BynderSyncedDocument):\n    pass\n```\n\nFinally, run Django's `makemigrations` and `migrate` commands to apply any model field changes to your project\n\n```sh\n$ python manage.py makemigrations\n$ python manage.py migrate\n```\n\n### Optional: To use videos from Bynder\n\nTo use videos from Bynder in content across the site, this app includes a specialised model to help store relevant data for videos,\nplus blocks and chooser widgets to help use them in your project. However, because not all projects use video,\nand project-specific requirements around video usage can be a little more custom,\nthe model is `abstract` - you need to subclass it in order to use the functionality.\n\nFirst, ensure you have `wagtail.snippets` in your project's `INSTALLED_APPS`:\n\n```python: highlight-line=7\nINSTALLED_APPS = [\n  # ...\n  \"wagtail.users\",\n  \"wagtail.admin\",\n  \"wagtail.documents\",\n  \"wagtail.images\",\n  \"wagtail.snippets\",\n  \"wagtail\",\n   # ...\n]\n```\n\nNext, import the abstract `BynderSyncedVideo` model and subclass it within your project to create a concrete model.\nFor example:\n\n```python\n# yourproject/videos/models.py\nfrom wagtail_bynder.models import BynderSyncedVideo\n\n\nclass Video(BynderSyncedVideo):\n    pass\n```\n\nThen, in your project's Django settings, add a `BYNDER_VIDEO_MODEL` item to establish your custom model as the 'official'\nvideo model. The value should be a string in the format `\"app_label.Model\"`. For example:\n\n```python\nBYNDER_VIDEO_MODEL = \"videos.Video\"\n```\n\nFinally, run Django's `makemigrations` and `migrate` commands to create and apply the model changes in your project.\n\n```sh\n$ python manage.py makemigrations\n$ python manage.py migrate\n```\n\n## Configuration\n\nYou can use the following settings to configure the integration:\n\n### `BYNDER_DOMAIN`\n\nExample: `\"your-org.bynder.com\"`\n\nDefault: `None`\n\nThe Bynder instance you want the environment to use.\n\n### `BYNDER_API_TOKEN`\n\nExample: `\"60ae04f68460cfed1b289c4c1db4c9b273b238dx2030c51298dcad245b5ff1f8\"`\n\nDefault: `None`\n\nAn API token for the back end to use when talking to the Bynder API.\nNOTE: This could be more permissive than `BYNDER_COMPACTVIEW_API_TOKEN`, so should be kept separate to avoid surfacing to Wagtail users.\n\n### `BYNDER_COMPACTVIEW_API_TOKEN`\n\nExample: `\"64ae04f71460cfed1b289c4c1db4c9b273b238dx2030c51298dcad245b5ff1f8\"`\n\nDefault: `None`\n\nAn API token for Bynder's JavaScript 'compact view' to use. The value is injected into the `admin_base.html` template for Wagtail\nfor the JavaScript to pick up, exposing it to Wagtail users. Because of this, it should be different to `BYNDER_API_TOKEN`\nand only needs to have basic read permissions.\n\n### `BYNDER_IMAGE_SOURCE_THUMBNAIL_NAME`\n\nDefault: `\"WagtailSource\"`\n\nThe name of the automatically generated derivative that should be downloaded and used as the `file` value for the\nrepresentative Wagtail image (as it appears in `thumbnails` in the API representation).\n\nWARNING: It's important to get this right, because if the specified derivative is NOT present in the response for an\nimage for any reason, the ORIGINAL will be downloaded - which will lead to slow chooser response times and higher memory\nusage when generating renditions.\n\n### `BYNDER_VIDEO_MODEL`\n\nExample: `\"video.Video\"`\n\nDefault: `None`\n\n### `BYNDER_VIDEO_PRIMARY_DERIVATIVE_NAME`\n\nDefault: `\"WebPrimary\"`\n\n### `BYNDER_VIDEO_FALLBACK_DERIVATIVE_NAME`\n\nDefault: `\"WebFallback\"`\n\n### `BYNDER_VIDEO_POSTER_IMAGE_DERIVATIVE_NAME`\n\nDefault: `\"webimage\"`\n\n### `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`\n\nExample: `True`\n\nDefault: `False`\n\nWhen `True`, local copies of images will be refreshed from the Bynder API representation whenever they are selected in\nthe chooser interface. This slows down the chooser experience slightly, but can be useful for seeing up-to-date data in\nenvironments that might not be using the management commands or other means to keep images up-to-date with their Bynder counterparts.\n\n### `BYNDER_SYNC_EXISTING_DOCUMENTS_ON_CHOOSE`\n\nExample: `True`\n\nDefault: `False`\n\nAs `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`, but for documents.\n\n### `BYNDER_SYNC_EXISTING_VIDEOS_ON_CHOOSE`\n\nExample: `True`\n\nDefault: `False`\n\nAs `BYNDER_SYNC_EXISTING_IMAGES_ON_CHOOSE`, but for videos.\n\n### `BYNDER_DISABLE_WAGTAIL_EDITING_FOR_ASSETS`\n\nExample: `True`\n\nDefault: `False`\n\nWhen `True`, hitting Wagtail's built-in edit view for an image or document will result in a redirect to the asset\ndetail view in the Bynder interface.\n\nThe default is value is `False`, because it can be useful to use the Wagtail representation to check that file, metadata\nand focal points are being accurately reflected.\n\n## Contributing\n\nAll contributions are welcome! See [CONTRIBUTING.md](https://github.com/torchbox/wagtail-bynder/blob/main/CONTRIBUTING.md)\n\nSupported versions:\n\n- Python 3.11, 3.12\n- Django 3.2, 4.2, 5.0\n- Wagtail 4.1 (LTS), 5.1, 5.2 (LTS)\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Wagtail integration with Bynder, a Digital Asset Management System",
    "version": "0.4.0",
    "project_urls": {
        "Changelog": "https://github.com/torchbox/wagtail-bynder/blob/main/CHANGELOG.md",
        "Source": "https://github.com/torchbox/wagtail-bynder"
    },
    "split_keywords": [
        "wagtail",
        " django",
        " bynder",
        " dams",
        " digital asset management"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba8824ac8cdce38dc74b1784cf64eb18e5b651a81c47eab3945a21607cd82993",
                "md5": "ebe9e673564cde2802fcf3afea3d340b",
                "sha256": "2dad5dba6b558f3444addcd5e891880b3f085649b45310b9095bfc906a19eb54"
            },
            "downloads": -1,
            "filename": "wagtail_bynder-0.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ebe9e673564cde2802fcf3afea3d340b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 316147,
            "upload_time": "2024-04-25T15:27:56",
            "upload_time_iso_8601": "2024-04-25T15:27:56.242247Z",
            "url": "https://files.pythonhosted.org/packages/ba/88/24ac8cdce38dc74b1784cf64eb18e5b651a81c47eab3945a21607cd82993/wagtail_bynder-0.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d5052dc2e5618a89b55cb376ef592f17d7df2d2f7e74fda433c1060734400499",
                "md5": "5db4d27031fc8143513bd5ec8d01dc5e",
                "sha256": "a68640ed951cff0974c1aa69a9b96f4a703b8004204978321b90807bc5ec9f4b"
            },
            "downloads": -1,
            "filename": "wagtail_bynder-0.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "5db4d27031fc8143513bd5ec8d01dc5e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 310313,
            "upload_time": "2024-04-25T15:27:57",
            "upload_time_iso_8601": "2024-04-25T15:27:57.545976Z",
            "url": "https://files.pythonhosted.org/packages/d5/05/2dc2e5618a89b55cb376ef592f17d7df2d2f7e74fda433c1060734400499/wagtail_bynder-0.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-25 15:27:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "torchbox",
    "github_project": "wagtail-bynder",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "wagtail-bynder"
}
        
Elapsed time: 0.24649s