DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:gchart

Google Chart Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" unknown

plugin Allows to embed simple chart graphics using the Google Chart API

Last updated on
2021-09-20
Provides
Syntax
Repository
Source

Download and Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Changes

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 to 320x140
  • Type defaults to pie3d, can be one of the following
    • pie3d for a 3D pie graph
    • pie2d for a 2D pie graph
    • line for a line graph
    • sparkline for a “sparkline” graph
    • hbar for a horizontal bar graph
    • vbar for a vertical bar graph
    • qr 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 or right. Defaults to right.
  • 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
plugin/gchart.txt · Last modified: 2024-01-11 02:10 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki