Skip to main content

"cms.plugins.snippet" (from djangocms) clone to extend it with some facilities

Project description

This is a “cms.plugins.snippet” (from djangocms) clone to extend it with some facilities

Original code is from the original DjangoCMS plugin.

Changes from original code

This clone try to change as few orignal code as possible, actually the differences are :

  • Adding a template tag to directly use snippet fragments in the templates, not only from CMS pages;

  • Changing Snippet model to bind djangocms_text_ckeditor.fields.HTMLField on the field html;

Requires

Install

The only thing needed is to replace the cms.plugins.snippet in your DjangoCMS settings, like this :

INSTALLED_APPS = (
    'cms',
    # Plugins
    ...
    #'cms.plugins.snippet',
    'snippet', # the snippet plugin clone
    ...
)

Because the code is cloned from the original plugin with just a few changes, all CMS stuff should work as with the original plugin, you should even add it in an existing install without loss in database and without any syncdb.

Usage

Template tags

Use the template tags in your templates :

{% load snippet_tags %}
{% snippet_fragment [Snippet ID or instance] %}

Like this :

{% load snippet_tags %}
{% snippet_fragment 42 %}

The required argument is for the Snippet ID or a Snippet instance if you want.

Snippet html field

You don’t need to do nothing, the CKEditor should automatically take in place of the textarea input.

Project details


Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page