django-cms plugins for django-filer
Project description
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.
Dependencies
django-filer >= 1.2
Django >= 1.8
django-cms >= 3.1
django-sekizai >= 0.4.2
easy_thumbnails >= 1.0
django-appconf
djangocms-attributes-field
Installation
To get started using cmsplugin-filer:
install it with pip:
$ pip install cmsplugin-filer
configure django-filer as documented in https://django-filer.readthedocs.io/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', ... )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: https://django-filer.readthedocs.io/en/latest/installation.html#subject-location-aware-cropping
Upgrading to version 1.1
In version 1.1 there are two backward incompatible changes:
Migrations layout
Migrations have been moved back to the standard location. cmsplugin_filer related MIGRATION_MODULE setting items must be removed for cmsplugin_filer 1.1 to work
Removal of ThumbnailOption model
ThumbnailOption has been moved to filer (since filer 1.2). You must update your models and migrations referencing ThumbnailOption for this to work.
Upgrade process involves updating your models and migrations.
model.py
Add:
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')) use thumbnail_model string as defined above (e.g.: thumb_field = models.ForeignKey(thumbnail_model) If using the model directly you don’t have to change the fields definition
Django 1.7+ migrations
For every migration file that references ThumbnailOption add the following import:
from myapp.models import thumbnail_model
and change all 'cmsplugin_filer_image.ThumbnailOption' to thumbnail_model
South migrations
In every migration file add the following import:
from myapp.models import thumbnail_model
and change all 'cmsplugin_filer_image.ThumbnailOption' to thumbnail_model and u"orm['cmsplugin_filer_image.ThumbnailOption']" to u"orm['%s']" % thumbnail_model.
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
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
djangocms-text-ckeditor
cmsplugin_filer_image provides integration with djangocms-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.
Customisation
Most 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 at cmsplugin_filer_image/plugins/image/boxed.html it will be used. If not, it will fall back to cmsplugin_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 use cmsplugin_filer_image/image.html if it exists. Remove that template after migrating to the new structure.
Classes
Classes like left, center, right and img-responsive are given by the plugin to use in your own projects.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file cmsplugin-filer-1.1.1.tar.gz.
File metadata
- Download URL: cmsplugin-filer-1.1.1.tar.gz
- Upload date:
- Size: 86.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a9a433053ce7e29147e0e08e3442407352a2b7bbcb25efc154a8552e67836ad2 |
|
| MD5 | f66f4c82d76306574dfcce6f6be8bbe5 |
|
| BLAKE2b-256 | bfe75481569f256fe6acadaa08887498ef8434480bdd6a35b154cfeb0d4c899d |
Provenance
File details
Details for the file cmsplugin_filer-1.1.1-py2.py3-none-any.whl.
File metadata
- Download URL: cmsplugin_filer-1.1.1-py2.py3-none-any.whl
- Upload date:
- Size: 289.0 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 728bcde3854e9930fae4a289fce4f53adca63c1c56bce71b092c694765d36394 |
|
| MD5 | 77c4973e3394a2f7e220c9e590547467 |
|
| BLAKE2b-256 | e66b097eb805a29243cac9567543f3a9a055b71b89ac62d6d0bd2a03d336b369 |
