This is an old revision of the document!
Table of Contents
Google Chart Plugin
Compatible with DokuWiki
2010-11-07 2011-05-25+, Frusterick Manners
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to achart, c3chart, charter, googlechart, pchart
Download and Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Changes
- Version upped (2024-05-05 23:50)
- legends for pie charts are not supported in quickchart.io (2024-05-05 16:25)
- remove debug statement (2024-05-05 16:17)
- auto code cleanup (2024-05-05 16:09)
- use quickchart.io instead of Google (2024-05-05 15:47)
- Version upped (2021-09-20 23:50)
- added missing semicolon. fixes #13 (2021-09-20 10:17)
- Version upped (2021-09-19 23:50)
Syntax
Let's start with an example:
<gchart 350x120 pie3d #0000ff #ffffff right> Apples = 3 Peaches = 23 Strawberries = 25 Peanuts = 7 </gchart>
As you can see, the usage is simple. You give your data as name=value pairs inside the <gchart>
tags. In the start tag you can add various optional options:
- Size give in the form
widthxheight
in pixels. Defaults to320x140
- Type defaults to
pie3d
, can be one of the followingpie3d
for a 3D pie graphpie2d
for a 2D pie graphline
for a line graphsparkline
for a “sparkline” graphhbar
for a horizontal bar graphvbar
for a vertical bar graphqr
for a two-dimensional barcode
- Graph color this is the first hex color given. Defaults to the configuration (see below) or orange if no config is given.
- Background color this is the second hex color given. Defaults to the configuration (see below) or white if no config is given.
- Alignment can be
left
,center
orright
. Defaults toright
. - Value Display if
value
is given, the entered values are added to the graph - Legend is only available for pie graphs. If
legend
is given, the slices will not be labeled directly - Title if you want to add a title to the graphic, give it in quotes. E.g.
“this is my Title”
Hex colors can be the typical 3 part RGB hexcodes known from HTML or can contain a 4th alpha transparency value.
For QR-codes, the first line of data may contain a unique lettre L
, M
, Q
or H
to indicate the error correction level. The default value in L
. The other lines are joined with a semi-colon (;) and encoded in the barcode:
<gchart qr 120x120> M URLTO:www.dokuwiki.org/plugin:gchart </gchart>
Configuration
The default graph and background color can be set in the configuration manager to match the style of your template.
It is recommended to enable the fetchsize option to make use of image caching.
Limitations
- No encoding is used for the values, it might not work for big or many values
- An internet connection is needed (because Google's servers are used)
- Only single dimensional charts (a single row of data pairs) are supported
- If this is too limiting for you I recommend one of the similar plugins