cmsplugin-filer 1.0.1

Dependencies

• django-filer >= 0.9

• Django >= 1.4

• django-cms >= 3.0

• django-sekizai >= 0.4.2

• easy_thumbnails >= 1.0

• django-appconf

Installation

To get started using cmsplugin-filer:

• install it with pip:

  $ pip install cmsplugin-filer

• configure django-filer as documented in http://django-filer.readthedocs.org/en/latest/installation.html#configuration

• add the plugins to INSTALLED_APPS:

  INSTALLED_APPS = (
      ...
      'cmsplugin_filer_file',
      'cmsplugin_filer_folder',
      'cmsplugin_filer_link',
      'cmsplugin_filer_image',
      'cmsplugin_filer_teaser',
      'cmsplugin_filer_video',
      ...
  )

• for Django 1.7 users, you need to add the following to your MIGRATION_MODULES settings:

  MIGRATION_MODULES = {
      ...
      'cmsplugin_filer_file': 'cmsplugin_filer_file.migrations_django',
      'cmsplugin_filer_folder': 'cmsplugin_filer_folder.migrations_django',
      'cmsplugin_filer_link': 'cmsplugin_filer_link.migrations_django',
      'cmsplugin_filer_image': 'cmsplugin_filer_image.migrations_django',
      'cmsplugin_filer_teaser': 'cmsplugin_filer_teaser.migrations_django',
      'cmsplugin_filer_video': 'cmsplugin_filer_video.migrations_django',
      ...
  }
  
  NOTE: For Django 1.7, you **must** also be using the latest commits to the CMS Support 3.0.x branch and the latest develop branch of django-filer.

• run migrate.

You can also set FILER_IMAGE_USE_ICON in your settings.py to configure cmsplugin_filer_image plugin to use 32x32 icons for representing plugin instances.

The default template in cmsplugin_filer_image expects the subject location functionality to be enabled. Follow: http://django-filer.readthedocs.org/en/0.9.2/installation.html#subject-location-aware-cropping

Upgrading

Please note that current develop version moved plugin packages from src directory to project root. This may break your installation if upgrading. Uninstall any previous cmsplugin_filer installation (either from Pypi or from github repository) and reinstall it.

Integrations

TEXT_SAVE_IMAGE_FUNCTION='cmsplugin_filer_image.integrations.ckeditor.create_image_plugin'

CMSPLUGIN_FILER_IMAGE_STYLE_CHOICES = (
    ('default', 'Default'),
    ('boxed', 'Boxed'),
)
CMSPLUGIN_FILER_IMAGE_DEFAULT_STYLE = 'boxed'