cmsplugin-nvd3 0.5.0

Insert nvd3 charts into django-cms driven sites

Requirements

The plugin works under Python 2.7 and Python 3.4 with all versions of Django supported by Django-CMS. The following libraries (along with those required by django-CMS) are necessary:

• Django >= 1.5

• django-cms >= 2.4 (include all of Django CMS 3.x releases)

• python-nvd3

More detailed docs with examples are available here.

Installation

It is assumed that django-cms is already installed. Additionally, you need to install python-nvd3.

$ pip install python-nvd3

$ pip install cmsplugin-nvd3

Insert the plugin app in your settings.py

INSTALLED_APPS = [
    # ...
    'cmsplugin_nvd3',
        #...
]

Create necessary database tables. If you are working with Django 1.7 and higher, do:

manage.py makemigrations cmsplugin_nvd3

manage.py migrate cmsplugin_nvd3

If your Django version is lower 1.7, use syncdb command

manage.py syncdb

The plugin can be used in a single manner or embedded into text plugins.

Configuration

Behaviour of the plugin is controlled by the following settings (defaults are listed below):

# Value separator for x-data
CMSNVD3_DATASEP = ','

# Group separator for y-series
CMSNVD3_YDATAGROUPSEP = ';'

# Length of random part of id
CMSNVD3_ID_RANDOM_LENGTH = 7

# Container prefix; used only if <container name> field is left empty.
CMSNVD3_CONT_ID_PREFIX = 'nvd3id_'

# Default container width;
CMSNVD3_CONT_WIDTH = 600

# Default container height;
CMSNVD3_CONT_HEIGHT = 400

# Maximum allowed container size; all values of width or height will be
# reduced to defaults if they exceed this value
CMSNVD3_MAX_CONT_DIM = 3000

# D3, NVD3 sources.
CMSNVD3_D3JS_SOURCE = '//cdnjs.cloudflare.com/ajax/libs/d3/3.5.6/d3.min.js'
CMSNVD3_JS_SOURCE = '//cdn.rawgit.com/novus/nvd3/v1.8.1/build/nv.d3.min.js'
CMSNVD3_CSS = '//cdn.rawgit.com/novus/nvd3/v1.8.1/build/nv.d3.css'
# If one or all of these constants was set up to 'local' (e.g. CMSNVD3_CSS='local'),
# the static resource(s) will be loaded via path CMSNVD3_URL

#a path for d3, nvd3 static files, defined as: STATIC_URL+CMSNVD3_URL
CMSNVD3_URL = 'nvd3plugin/'

#Floating point delimiter. You probably will never need to change it.
    CMSNVD3_FLT_DELIMITER = '.'