Package: cmsplugin-filer
A set of cms plugins that replace the plugins shipped with django-cms with
versions that use file fields from django-filer.Warning:Starting with version 1.1.0, support for Python 2.6, Django 1.7 or lower
and django CMS 3.0.x and lower was dropped. Please pin your dependencies
to ``cmsplugin-filer<1.1.0`` for older projects.

Starting with version 0.10 support for django CMS 2.x was dropped
(table renaming magic removal). Pin your dependencies to
``cmsplugin-filer<0.10`` for django-cms 2.x projects.Dependenciesdjango-filer >= 1.2Django >= 1.8django-cms >= 3.1django-sekizai >= 0.4.2easy_thumbnails >= 1.0django-appconfdjangocms-attributes-fieldInstallationTo get started usingcmsplugin-filer:install it withpip:$ pip install cmsplugin-filerconfiguredjango-fileras documented inhttps://django-filer.readthedocs.io/en/latest/installation.html#configurationadd the plugins toINSTALLED_APPS:INSTALLED_APPS = (
    ...
    'cmsplugin_filer_file',
    'cmsplugin_filer_folder',
    'cmsplugin_filer_link',
    'cmsplugin_filer_image',
    'cmsplugin_filer_teaser',
    'cmsplugin_filer_video',
    ...
)runmigrate.You can also setFILER_IMAGE_USE_ICONin yoursettings.pyto configurecmsplugin_filer_imageplugin to use 32x32 icons for representing
plugin instances.The default template incmsplugin_filer_imageexpects the subject location functionality to be enabled.
Follow:https://django-filer.readthedocs.io/en/latest/installation.html#subject-location-aware-croppingUpgrading to version 1.1In version 1.1 there are two backward incompatible changes:Migrations layoutMigrations have been moved back to the standard location. cmsplugin_filer relatedMIGRATION_MODULEsetting itemsmustbe removed for cmsplugin_filer 1.1 to workRemoval ofThumbnailOptionmodelThumbnailOptionhas been moved tofiler(since filer 1.2).
Youmustupdate your models and migrations referencingThumbnailOptionfor this to work.Upgrade process involves updating your models and migrations.model.pyAdd:try:
    from filer.models import ThumbnailOption
    thumbnail_model = 'filer.ThumbnailOption'
except ImportError:
    from cmsplugin_filer_image.models import ThumbnailOption
    thumbnail_model = 'cmsplugin_filer_image.ThumbnailOption'If you use the string syntax (e.g.:thumb_field =models.ForeignKey('cmsplugin_filer_image.ThumbnailOption'))
usethumbnail_modelstring as defined above (e.g.:thumb_field = models.ForeignKey(thumbnail_model)If using the model directly you don’t have to change the fields definitionDjango 1.7+ migrationsFor every migration file that referencesThumbnailOptionadd the following import:from myapp.models import thumbnail_modeland change all'cmsplugin_filer_image.ThumbnailOption'tothumbnail_modelSouth migrationsIn every migration file add the following import:from myapp.models import thumbnail_modeland change all'cmsplugin_filer_image.ThumbnailOption'tothumbnail_modelandu"orm['cmsplugin_filer_image.ThumbnailOption']"tou"orm['%s']"% thumbnail_model.The default template incmsplugin_filer_imageexpects the subject location
functionality to be enabled.
Follow:http://django-filer.readthedocs.org/en/0.9.2/installation.html#subject-location-aware-croppingPlease note that current develop version moved plugin packages fromsrcdirectory to project root. This may break your installation if upgrading.
Uninstall any previouscmsplugin_filerinstallation (either from PyPI or
from github repository) and reinstall it.Integrationsdjangocms-text-ckeditorcmsplugin_filer_imageprovides integration withdjangocms-text-ckeditor.
Add this setting to enable it:TEXT_SAVE_IMAGE_FUNCTION='cmsplugin_filer_image.integrations.ckeditor.create_image_plugin'This allows dragging images into the text editor in Firefox and newer versions
of IE.CustomisationMost plugins (file, folder, image and teaser) support configuring custom
“styles” (templates).e.g add the following settings for the image plugin:CMSPLUGIN_FILER_IMAGE_STYLE_CHOICES = (
    ('default', 'Default'),
    ('boxed', 'Boxed'),
)
CMSPLUGIN_FILER_IMAGE_DEFAULT_STYLE = 'boxed'Now, if a template exists atcmsplugin_filer_image/plugins/image/boxed.htmlit will be used. If not, it will fall back tocmsplugin_filer_image/plugins/image/default.html.
If a css class in the default template is enough, it can be used in the
template as{{ instance.style }}.For backwards compatibility the plugin will always usecmsplugin_filer_image/image.htmlif it exists. Remove that
template after migrating to the new structure.ClassesClasses likeleft,center,rightandimg-responsiveare given by the plugin to use in your own projects.