django-image-assets 1.0.0

Django application for image assets management

django-image-assets

Django application for image assets management.

Use case

• There are several content types on a web site
• Each of them has a set of required or additional image assets
• Every asset of same asset type must satisfy custom constraints on dimensions, format and file size.
• The most important thing: these constraints and required asset type sets are updated often, along with web design evolves and more platforms are added.

Installation

pip install django-image-assets

Working example is in testproject.testapp.

1. Add image_assets application to installed apps in django settings:

   INSTALLED_APPS.append('image_assets')
   

2. Add generic relation to your content models:

   from django.contrib.contenttypes.fields import GenericRelation
   from django.db import models
   
   from image_assets.models import Asset
   
   
   class Video(models.Model):
       assets = GenericRelation(Asset, blank=True)
   

3. Setup inlines for assets

   from django.contrib import admin
   
   from image_assets.admin import AssetsInline
   from testproject.testapp import models
   
   
   @admin.register(models.Video)
   class VideoAdmin(admin.ModelAdmin):
       inlines = (AssetsInline,)
   

Usage

1. Create new asset type (i.e. "thumbnail")
2. Add Video to allowed_for set: now you can add a thumbnail to a video. Or you may skip this asset.
3. Add Article to required_for set: now you will able to create or edit an article with valid "thumbnail" asset only.
4. When an asset is deleted, it's file is owned by DeletedAsset object and may be wiped later by manual or automatic cleanup.

Advanced

If you need to alter model fields i.e. for AssetType, you may subclass existing model and than change image_assets application settings.

1. Subclass AssetType model

   from django.db import models
   from image_assets.models import AssetType
   
   
   class MyAssetType(AssetType):
       some_feature_flag = models.BooleanField(default=False)
   

2. Change a reference to an asset type model in settings:

   IMAGE_ASSETS_CONFIG = {
       'ASSET_TYPE_MODEL': 'my_app.MyAssetType',
       'ASSET_MODEL': 'image_assets.Asset',
       'DELETED_ASSET_MODEL': 'image_assets.DeletedAsset'
   }
   

3. image_assets.AssetType will be declared as abstract and MyAssetType will be returned as result of image_assets.models.get_asset_type_model()