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


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
djangocms_typedjs-1.0.0-py2-none-any.whl (25.1 kB) Copy SHA256 hash SHA256 Wheel py2
djangocms-typedjs-1.0.0.tar.gz (13.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page