Django CMS Приступая к работе - Использование плагинов

2 September 2013 г. 10:58:32

5.1. File

Позволяет Вам загружать файлы. Пиктограмма для файла будет выбрана на основании расширения файла.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.file',
    # ...
)

Вы должны позаботиться о том, чтобы директорий CMS_PAGE_MEDIA_PATH определенный в конфигурационном файле (по умолчанию cms_page_media указывает на MEDIA_ROOT) доступен для записи для пользователя, от имени которого будет запущен проект Django<

Возможно, Вы предпочтете использовать django-filer в django CMS plugin вместо  cmsplugin_filer_file

 

Предупреждение

Встроенный плагин работает только для локальных хранилищ. Если Вам необходимо более продвинутое решение, пожалуйста, воспользуйтесь альтернативными плагинами для django, например django-filer.

 

  ~cut~

 5.2. Flash

Позволяет Вам загружать и отображать SWF файлы на Вашей странице.

Для установки убедитесь что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

 

INSTALLED_APPS = (
    # ...
    'cms.plugins.flash',
    # ...
)

5.3. GoogleMap

Отображает на Вашей странице карту в соответствии с введенным адресом.

Адрес и координаты используются для центрирования карты. Масштаб и планирование маршрутов может быть указано при добавлении или редактировании плагина в панели администратора.

Новое в версии 2.3.2: Добавлены параметры высота и ширина, поэтому больше нет необходимости указывать для плагина размер контейнера в CSS или шаблоне.

Изменения в версии 2.3.2. Масштаб указывается в поле выбора которое следит за корректностью ввода значений.

 

Замечание

В соответствии с этими изменениями, поле масштаба не может быть NULL, и при миграции данных изменяются существующие плагины googlemap чтобы задать значение масштаба для полей значение которых NULL

  

Для установки убедитесь что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

 

INSTALLED_APPS = (
    # ...
    'cms.plugins.googlemap',
    # ...
)

5.4. Link

Отображает на странице ссылку на указанный URL. Если страница перемещается URL остается корректным.

Для установки убедитесь ,что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

 

INSTALLED_APPS = (
    # ...
    'cms.plugins.link',
    # ...
)

  

Замечание

С версии 2.2, данный плагин больше не проверяет, существует ли указанная ссылка

5.5. Picture

Отображает на странице изображение.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

 

INSTALLED_APPS = (
    # ...
    'cms.plugins.picture',
    # ...
)

Существует несколько решений для Python и Django чтобы автоматически менять размены изображений. Вы можете найти  некоторые плагниы на странице Django Packages и сравнить их.

В директории шаблонов Вашего проекта создайте директорий cms/plugins и создайте файл с названием picture.html. Вот пример файла picture.html использующий easy-thumbnails:

{% load thumbnail %}
 
{% if link %}<a href="{{ link }}">{% endif %}
{% if placeholder == "content" %}
    <img src="{% thumbnail picture.image 300x600 %}"{% if picture.alt %} alt="{{ picture.alt }}"{% endif %} />
{% else %}
    {% if placeholder == "teaser" %}
        <img src="{% thumbnail picture.image 150x150 %}"{% if picture.alt %} alt="{{ picture.alt }}"{% endif %} />
    {% endif %}
{% endif %}
{% if link %}</a>{% endif %}

В этом шаблоне изображение масштабируется в зависимости от того в какой плейсхолдер было помещено.

Вы должны позаботиться о том, чтобы директорий CMS_PAGE_MEDIA_PATH определённый в конфигурационном файле (по умолчанию cms_page_media указывает на MEDIA_ROOT) доступен для записи для пользователя, от имени которого будет запущен проект Django.

 

 

Замечание

Чтобы код был более понятным, некоторые поля изображения были пропущены

 

Замечание

Для более сложных случаев, где Вы бы хотели загружать ваши изображения, выравнивая по центру, попробуйте воспользоваться django-filer и его плагином cmsplugin_filer_image

 

5.6. Snippet

Отображает HTML сниппет из HTML файла из директории шаблонов или непосредственно введенный сниппет.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (

    # ...

    'cms.plugins.snippet',

    # ...

)

 

Замечание

Этот плагин предназначен для использования при разработке, для быстрой визуализации HTML сниппетов.

 

Предупреждение

Это плагин несет потенциальную угрозу безопасности, так как позволяет администраторам помещать произвольные джаваскрипты на страницу. Это может позволить администраторам с правом добавления пользователей изменить их права до суперпользователя. Плагин должен быть исполььзован только на начальной стадии разработки чтобы быстро разработать прототип и должен быть выключен на продакшан сайтах.

 

5.7. Teaser

Отображает контейнер си тизером на другую страницу с указанным URL. При необходимости, можно добавить изображение и описание.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.teaser',
    # ...
) 

Вы должны позаботиться о том, чтобы директорий CMS_PAGE_MEDIA_PATH определеный в конфигурационом файле (по умолчанию cms_page_media указывает на MEDIA_ROOT) доступен для записи для пользователя от имени которого будет запущен проект Django.

 

Замечание

Для более сложных случаев где Вы бы хотели загружать ваши изображения выравнивая по центру, попробуйте воспользоваться django-filer и его плагином cmsplugin_filer_video

 

5.8. Text

Отображает текст. Некоторые плагины могут быть помещены внутрь текста если у них есть признак text-enabled. На данный момент text-enabled  есть у следующих плагинов: 

  • cms.plugins.link
  • cms.plugins.picture
  • cms.plugins.file
  • cms.plugins.snippet

Редактором по умолчанию является  Wymeditor. Если вместо него Вы хотете использовать TinyMce вам необходимо установить django-tinymce. Если tinymсe указан в настройках INSTALLED_APPS он будет автоматически включен. Если у Вас установлен tinymce, но Вы не хотите его использовать в CMS, укажите следующую опцию в файле settings.py:

CMS_USE_TINYMCE = False

  

Замечание

Если Вы используете django-tinymce, то Вам потребуется настроить его дополнительно. Поднобную информацию можно получить в документации django-tinymce.

 

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.text',
    # ...
)

5.9. Video

Проигрывает видео файлы или видео с Youtube или Vimeo. Использует OSFlashVideoPlayer.Так-же при загрузке видео используются .flv файлы или файлы с кодеком h264.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.video',
    # ...
)

Есть несколько настроек которые можно указать в файле settings.py чтобы переопределить какое-то стандартное поведение:

  • VIDEO_AUTOPLAY ((по умолчанию: False)
  • VIDEO_AUTOHIDE (по умолчанию: False)
  • VIDEO_FULLSCREEN (по умолчанию: True)
  • VIDEO_LOOP (по умолчанию: False)
  • VIDEO_AUTOPLAY (по умолчанию: False)
  • VIDEO_BG_COLOR (по умолчанию: "000000")
  • VIDEO_TEXT_COLOR (по умолчанию: "FFFFFF")
  • VIDEO_SEEKBAR_COLOR (по умолчанию: "13ABEC")
  • VIDEO_SEEKBARBG_COLOR (по умолчанию: "333333")
  • VIDEO_LOADINGBAR_COLOR (по умолчанию: "828282")
  • VIDEO_BUTTON_OUT_COLOR (по умолчанию: "333333")
  • VIDEO_BUTTON_OVER_COLOR (по умолчанию: "000000")
  • VIDEO_BUTTON_HIGHLIGHT_COLOR (по умолчанию: "FFFFFF")

Вы должны позаботиться о том, чтобы директорий CMS_PAGE_MEDIA_PATH определеный в конфигурационом файле (по умолчанию cms_page_media указывает на MEDIA_ROOT) доступен для записи для пользователя от имени которого будет запущен проект Django.

  

Замечание

Для более сложных случаев где Вы бы хотели загружать ваши изображения выравнивая по центру, попробуйте воспользоваться django-filer и его плагином cmsplugin_filer_video

 5.10. Twitter

Отображает несколько последних сообщений из твиттера.

Для установки убедитесь что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.twitter',
    # ...
)

 

Замечание

Так как нет гарантии что аватары будут доступны при использовании SSL (HTTPS), по умолчанию Twitter плагин не использует аватары для таких сайтов.

 

5.11. Inherit

Отображает все плагины с другой страницы или другого языка. Прекрасно подходит если Вы всегда используете одни и те же плагины на множестве страниц.

Для установки убедитесь, что в файле настроек settings.py в секции INSTALLED_APPS присутствует следующий код:

INSTALLED_APPS = (
    # ...
    'cms.plugins.inherit',
    # ...
)

 

Предупреждение

Наследование плагинов используется только для родных плагинов и не может быть использовано для плагинов не въодящих в состав CMS.


Оставьте свой комментарий

comments powered by Disqus
Меню

Cult of digits 2014 Яндекс.Метрика