cmsplugin-filer, Django 针对 Django cms的cms插件

分享于 

7分钟阅读

GitHub

  繁體 雙語
django-filer cms plugins for django-cms
  • 源代码名称:cmsplugin-filer
  • 源代码网址:http://www.github.com/divio/cmsplugin-filer
  • cmsplugin-filer源代码文档
  • cmsplugin-filer源代码下载
  • Git URL:
    git://www.github.com/divio/cmsplugin-filer.git
    Git Clone代码到本地:
    git clone http://www.github.com/divio/cmsplugin-filer
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/divio/cmsplugin-filer
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    cmsplugin

    一组cms插件取代了 django cms附带的插件和使用django过滤器中的文件字段的版本。

    警告:

    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.

    依赖项

    • 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

    安装

    要开始使用 cmsplugin-filer:

    • 使用 pip 安装它:

      $ pip install cmsplugin-filer
    • https://django-filer.readthedocs.io/en/latest/installation.html#configuration 中将 django-filer 配置为文档。

    • 将插件添加到 INSTALLED_APPS:

      INSTALLED_APPS = (
      . . .
       'cmsplugin_filer_file',
       'cmsplugin_filer_folder',
       'cmsplugin_filer_link',
       'cmsplugin_filer_image',
       'cmsplugin_filer_teaser',
       'cmsplugin_filer_video',
      . . .
      )
    • 运行 migrate

    你还可以在 settings.py 中设置 FILER_IMAGE_USE_ICON 来配置 cmsplugin_filer_image 插件,以使用 32个x32图标来表示插件实例。

    cmsplugin_filer_image 中的默认模板需要启用主题位置功能。 跟踪:https://django-filer.readthedocs.io/en/latest/installation.html#subject-location-aware-cropping

    升级到版本 1.1

    在版本 1.1中,有两个向后不兼容的更改:

    迁移布局

    迁移已经移回标准位置。 cmsplugin_filer相关的MIGRATION_MODULE 设置项目必须删除 1.1才能工作"

    删除 ThumbnailOption 模型

    已经将 ThumbnailOption 移动到 filer (。自 filer 1.2 )。 你需要更新你的模型和迁移引用以实现这里工作。

    升级过程涉及更新模型和迁移。

    model.py

    添加:

    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'

    如果使用字符串语法( 比如,则为: thumb_field = models.ForeignKey('cmsplugin_filer_image.ThumbnailOption') ) 使用 thumbnail_model 字符串作为定义的上面 ( 比如: thumb_field = models.ForeignKey(thumbnail_model) 如果直接使用模型,则不必更改字段的定义

    Django + 迁移

    对于引用 ThumbnailOption的每个迁移文件,添加以下导入:

    from myapp.models import thumbnail_model

    改变一切 'cmsplugin_filer_image.ThumbnailOption'thumbnail_model

    South

    在每个迁移文件中添加以下导入:

    from myapp.models import thumbnail_model

    改变一切 'cmsplugin_filer_image.ThumbnailOption'thumbnail_modelu"orm['cmsplugin_filer_image.ThumbnailOption']"u"orm['%s']" % thumbnail_model

    cmsplugin_filer_image 中的默认模板需要启用主题位置功能。 跟踪:http://django-filer.readthedocs.org/en/0.9.2/installation.html#subject-location-aware-cropping

    请注意,当前开发版本将插件包从src目录移到项目 root。 如果升级,这可能会破坏你的安装。 卸载以前的cmsplugin_filer安装( 来自PyPI或者github知识库) 并重新安装它。

    插件集成

    djangocms-text-ckeditor

    cmsplugin_filer_image 提供与 djangocms-text-ckeditor的集成。 添加这里设置以启用它:

    TEXT_SAVE_IMAGE_FUNCTION='cmsplugin_filer_image.integrations.ckeditor.create_image_plugin'

    这允许将图像拖到 Firefox 和较新版本的IE 中的文本编辑器中。

    定制

    大多数插件(。文件,文件夹,图像和注释) 支持配置定制的"样式"( 模板)。

    e.g 为图像插件添加以下设置:

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

    现在,如果模板存在于 cmsplugin_filer_image/plugins/image/boxed.html 它会被使用如果没有的话它会回到 cmsplugin_filer_image/plugins/image/default.html 如果默认模板中的css类足够,则可以在模板中将它的用作 {{ instance.style }}

    为了向后兼容,插件将始终使用 cmsplugin_filer_image/image.html 如果它存在。 迁移到新结构后删除该模板。

    在你自己的项目中,插件给出了类似 leftcenterrightimg-responsive的类。


    相关文章