Skip to main content

A Django CMS plugin that implements the Typed.js jQuery plugin.

Project description

https://img.shields.io/badge/pypi-v1.0.0-blue.svg https://img.shields.io/badge/license-MIT%20License-red.svg

djangocms-typedjs

This is a simple django-cms plugin that implements the Typed.js jQuery plugin.

Dependencies

  • django>=1.8
  • django-cms>=3.2

Installation

To install:

pip install djangocms-typedjs

Then add djangocms-typedjs to your installed apps:

INSTALLED_APPS = [
    ...
    'djangocms_typedjs',
    ...
]

If you’re not already using djangocms-text-ckeditor then this too will need to be added to your installed apps:

INSTALLED_APPS = [
    ...
    'djangocms_text_ckeditor',
    ...
]

Then run the migrations:

./manage.py migrate

The package assume that jQuery has been added to the site already. So if you’re not using, please add to you templates/base.html:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js"></script>

Configuration

The Typed.js javascript by default is loaded from the below CDN. If you wish to override this, this can be done in your settings.py file by adding the below with your updated URL. This is optional.

DJANGOCMS_TYPEDJS = {
    'JS_URL':  'https://cdnjs.cloudflare.com/ajax/libs/typed.js/1.1.4/typed.min.js',
}

Usage

When creating the plugin simply name the plugin for reference purposes, specifiy if you would like to have a blinking cursor and optionally specify the JSON configuration (see Typed.js for more info). Next add a child text plugin for every sentance you would like to use.

Djangocms-typedjs can also be used inside a text plugin. Simply add the child plugin to the text container and configure as usual, with one difference. Here child plugins cannot be added to djangocms-typedjs so the sentances need to be passed as part of the JSON config. The below code snippet demonstrates how to achieve this:

{
  // each of the sentances need to be set here:
  strings: ["First sentence.", "Second sentence."],
  // the stringElement needs to be set to null as I'm using this method by default.
  stringsElement: null
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for djangocms-typedjs, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size djangocms_typedjs-1.0.0-py2-none-any.whl (25.1 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size djangocms-typedjs-1.0.0.tar.gz (13.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page