DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:orgchart

This is an old revision of the document!


OrgChart Plugin

Compatible with DokuWiki

2013-12-08 "Binky", 2014-05-05 "Ponder Stibbons", Hrun, Detritus

plugin Create an Org Chart from a table

Last updated on
2016-04-06
Provides
Action
Repository
Source
Requires
data, wrap

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 jorgchart, orgapp

Tagged with chart, orgchart, relation, staff

Installation

:!: External requirements: This plugin requires the following additional components that must be installed separately:

  • Either the wrap plugin
  • Or the data plugin

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

This plugin calls Google's JavaScript API to use their Org Chart library. Therefore this plugin needs an internet connection.

Usage

This plugin will create org charts out of any table which a) follows a certain structure (namely having columns for name, manager and optional job title and photo - in that order) and b) are marked as being an org chart (by adding the 'orgchart' class to the table).

Syntax

Independent of whether the wrap or data plugin is used to help build the org chart, the following syntax rules always apply:

  • The class orgchart must be added.
  • The order of the columns must be:
    • name
    • line manager
    • job title
    • photo
  • Job title and photo are optional.

Using Wrap Plugin

Simplest example

<WRAP orgchart>
^Name           ^Line Manager   ^
|Alice Baker    |Bob Smith      |
|Bob Smith      |Carol Davidson |
|Carol Davidson |               |
|Dave Miller    |Carol Davidson |
|Eric Taylor    |Bob Smith      |
</WRAP>

Example including photos and job titles

<WRAP orgchart>
^Name           ^Line Manager   ^Job Title          ^Photo                   ^
|Alice Baker    |Bob Smith      |PR                 |{{:staff:alice.png?60}} |
|Bob Smith      |Carol Davidson |Marketing Director |{{:staff:bob.jpg?60}}   |
|Carol Davidson |               |CEO                |{{:staff:carol.jpg?60}} |
|Dave Miller    |Carol Davidson |Secretary          |{{:staff:dave.jpg?60}}  |
|Eric Taylor    |Bob Smith      |                   |                        |
</WRAP>

Additional syntax rules

  • The line manager's name must be the same as it appears in the name column of that manager.

Using Data Plugin

Dataentry needs at least:

  • name (staff member's name, type: 'pageid' or simple string)
  • line manager (line manager's pagename, type: 'page' or simple string; when using 'page' this needs to be the exact pagename, when using simple string it needs to be the exact same string for each entry of the same manager)

Optional dataentry:

  • job title (staff member's job title, type: simple string)
  • photo (photo of staff member, type: 'img')

Examples including all the things

---- datatable orgchart includelinks ----
cols    : name_pageid, linemanager, title, photo_img60
headers : Name, Line Manager, Job Title, Photo
sort    : name
----

Would look like this:

Simpler example

---- datatable orgchart ----
cols    : name_pageid, linemanager_page, title
headers : Name, Line Manager, Job Title
sort    : name
----

Could look like this:

Additional syntax rules

  • class 'includelinks' results in link to a staff member's page being included
  • if type 'page' is used for line manager, the link text doesn't need to match the exact name as the pagename in the link will be used to match managers

Discussion

Problems with more than one OrgChart

I've problems with two orgcharts on one page. The'll be placed side by side and not in the right position. — kkue 2014-09-09 16:53

This has now been fixed in the latest version. — Anika Henke 2016-04-06 19:59

¿It is possible add a link from any way?

Sorry, this is not possible right now. — Anika Henke 2016-04-06 19:59
plugin/orgchart.1459965777.txt.gz · Last modified: 2016-04-06 20:02 by ach

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