Allows you to upload a file. A filetype icon will be assigned based on the file extension.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

You should take care that the directory defined by the configuration setting :setting:`CMS_PAGE_MEDIA_PATH` (by default cms_page_media/ relative to :setting:`django:MEDIA_ROOT`) is writable by the user under which django will be running.

You might consider using django-filer with django CMS plugin and its cmsplugin_filer_file component instead.

Allows you to upload and display a Flash SWF file on your page.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

Displays a map of an address on your page.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

Displays a link to an arbitrary URL or to a page. If a page is moved the URL will still be correct.

For installation be sure to have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

Displays a picture in a page.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

If you want to resize the picture you can get a thumbnail library. We recommend sorl.thumbnail.

In your project template directory create a folder called cms/plugins and create a file called picture.html in there. Here is an example picture.html template:

{% load i18n thumbnail %}
{% spaceless %}

{% if picture.url %}<a href="{{ picture.url }}">{% endif %}
{% ifequal placeholder "content" %}
    <img src="{% thumbnail picture.image.name 484x1500 upscale %}" {% if picture.alt %}alt="{{ picture.alt }}" {% endif %}/>
{% endifequal %}
{% ifequal placeholder "teaser" %}
    <img src="{% thumbnail picture.image.name 484x1500 upscale %}" {% if picture.alt %}alt="{{ picture.alt }}" {% endif %}/>
{% endifequal %}
{% if picture.url %}</a>{% endif %}

{% endspaceless %}

In this template the picture is scaled differently based on which placeholder it was placed in.

You should take care that the directory defined by the configuration setting :setting:`CMS_PAGE_MEDIA_PATH` (by default cms_page_media/ relative to :setting:`django:MEDIA_ROOT`) is writable by the user under which django will be running.

Renders a HTML snippet from a HTML file in your templates directories or a snippet given via direct input.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` setting in your project's settings.py file:

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

Displays a teaser box for another page or a URL. A picture and a description can be added.

For installation be sure you have the following in the :setting:`django:INSTALLED_APPS` settings in your project's settings.py file:

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

You should take care that the directory defined by the configuration setting :setting:`CMS_PAGE_MEDIA_PATH` (by default cms_page_media/ relative to :setting:`django:MEDIA_ROOT`) is writable by the user under which django will be running.

Displays text. If plugins are text-enabled they can be placed inside the text-flow. At this moment the following core plugins are text-enabled:

• :mod:`cms.plugins.link`
• :mod:`cms.plugins.picture`
• :mod:`cms.plugins.file`
• :mod:`cms.plugins.snippet`

The current editor is Wymeditor. If you want to use TinyMce you need to install django-tinymce. If tinymce is in your :setting:`django:INSTALLED_APPS` it will be automatically enabled. If you have tinymce installed but don't want to use it in the cms put the following in your settings.py:

CMS_USE_TINYMCE = False

For installation be sure you have the following in your project's :setting:`django:INSTALLED_APPS` setting:

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

Plays Video Files or Youtube / Vimeo Videos. Uses the OSFlashVideoPlayer. If you upload a file use .flv files or h264 encoded video files.

For installation be sure you have the following in your project's :setting:`django:INSTALLED_APPS` setting:

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

There are some settings you can set in your settings.py to overwrite some default behavior:

• VIDEO_AUTOPLAY ((default: False)
• VIDEO_AUTOHIDE (default: False)
• VIDEO_FULLSCREEN (default: True)
• VIDEO_LOOP (default: False)
• VIDEO_AUTOPLAY (default: False)
• VIDEO_BG_COLOR (default: "000000")
• VIDEO_TEXT_COLOR (default: "FFFFFF")
• VIDEO_SEEKBAR_COLOR (default: "13ABEC")
• VIDEO_SEEKBARBG_COLOR (default: "333333")
• VIDEO_LOADINGBAR_COLOR (default: "828282")
• VIDEO_BUTTON_OUT_COLOR (default: "333333")
• VIDEO_BUTTON_OVER_COLOR (default: "000000")
• VIDEO_BUTTON_HIGHLIGHT_COLOR (default: "FFFFFF")

You should take care that the directory defined by the configuration setting :setting:`CMS_PAGE_MEDIA_PATH` (by default cms_page_media/ relative to :setting:`django:MEDIA_ROOT`) is writable by the user under which django will be running.

Displays the last number of post of a twitter user.

For installation be sure you have the following in your project's :setting:`django:INSTALLED_APPS` setting:

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

Displays all plugins of another page or another language. Great if you need always the same plugins on a lot of pages.

For installation be sure you have the following in your project's :setting:`django:INSTALLED_APPS` setting:

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