Simple Chart.js

Please see Version 1.0 in the WordPress.org repository for current version of enigma Chart.js!

The plugin is no longer maintained and is removed from the WordPress.org repository.

Introduction

As I was searching for a wordpress plugin, offering an easy implementation plotted data I found many different approaches. However, those were on the one hand commercially available or on the other hand hard to work with. The Simple Chart.js plugin offers you a simple way to include and plot your data with six different kind of graphs. The plugin itself is based on the famous Chart.js library by Nick Drownie.

Features

At the moment the plugin gives a basic functionally.

  • Choose from six different graphs to plot your data (metric)
  • Beside settings the plugins offers the full Chart.js experience (colors, labels…)
  • The graphs will use the default settings as given by Chart.js (For modification see the Chart.js documentation)
  • As Chart.js does not support legends yet, this is not included. However, this will be included in a future release

Other features will be included in further releases.

How to Use

The syntax itself is quite simple:

[chart TYPE DATA]

Current available types are: pie, bar, line, doughnut, polar and radar as provided by Chart.js. As each type of graph has different requirements there currently two groups of graphs which need different syntax for inserting data.

The first group consists of the types: pie, doughnut and radar. The insertion is quite simple for these ones:

{VALUE:COLOR,VALUE:COLOR,VALUE:COLOR}

For each value a color will be attributed. Colors can be inserted as described in the Chart.js documentation. Plotting some data with a pie, polar or doughnut chart could look like this:

Your code for the pie chart would be (ignore the space before the „chart“):

[ chart pie {58.1:#1bd081,30.17:#e0cb1e,11.73:#19a694}]

For the types line and polar things are a little bit more complicated due to the required labels. Here the data syntax consists of different elements:

{LABELS [fillColor;strokeColor;pointColor;pointStrokeColor||DATA|fillColor2;strokeColor2;pointColor2;pointStrokeColor2|DATA2]}

The data insertion starts with a ; separated list of the labels. Data and colors are then within squared brackets. Note the space between the labels and the first bracket. Also note that no spaces are used in LABELS or any other list of ; separated values. Spaces in labels will be a feature in future releases.

The line graph, for instance, would be resulted by (ignore the space before the „chart“):

[ chart line {1;2;3;4;5 [#FFFFFF;#CDCDCD;#CCCCCC;#000000|10;20;30;80;90||#ff3600;#CDCDCD;#000;#CCC|20;30;10;0;90]}]

The last available kind of graph is the bar chart. The syntax only slightly differs from the line or the polar graph. Here the pointColor and pointStrokeColor are not available. For instance,

[ chart bar {1;2;3;4;5 [#FFFFFF;#CDCDCD|10;20;30;80;90||#ff3600;#CDCDCD|20;30;10;0;90]}]

would result in this (ignore the space before the „chart“):

Known issues

You absolutely need to stick to the format when requesting a chart. It is not known or tested what happens if a wrong input is used. It is also known that there are some issues with the „wp-markdown“ plugin. For some reason there is an issue with random addition of backslashs to squared brackets. However, this is caused by the wp-markdown plugin and not by „Simple Chart.js“.

Download

The plugin is no longer maintained.

Bug reporting & feature requests

Please use any of the provided ways on this website to contact me for reporting bugs or requesting features.