WordPress.org

Ready to get started?Download WordPress

Plugin Directory

TFO Graphviz

Generates Graphviz graphics using shortcodes. Supports almost all Graphviz features.

What is Graphviz?

Graphviz is a way of generating visualisations of structural relationships between objects. Almost any kind of diagram where something connects to something else can be drawn and automatically laid out using the language DOT.

How do I use this plugin?

Use the [graphviz] shortcode. Various uses are explained in the "How to use" section.

How to I write DOT?

The online documentation for Graphviz is terse and not especially helpful, in particular the DOT language page is only helpful if you happen to be able to read and approximation of BNF.

There are however several other introductions to Graphviz and DOT, including an excerpt on the O'Reilly LinuxDevCenter.com site. Another approach would be to look at the examples in the Graphviz gallery.

If in doubt, find an example and experiment with it.

Nothing is being rendered, maybe my DOT is broken?

If you're using a local Graphviz renderer then errors from Graphviz will likely appear in your webserver error logs.

How do I install Graphviz locally

This depends on your host. You will find some details at http://www.graphviz.org/Download.php but many systems also have it in their own package management system, for example this is package graphviz on Debian, Ubuntu and Fedora systems.

There are currently two ways to use a local installation of Graphviz. The settings page will only show options for those methods that are actually available and configured correctly.

  1. Using a local Graphviz installation and the dot binary. You configure the path to this binary on the admin settings page of the plugin.
  2. Using PHP bindings to the Graphviz library. This requires that gv.php is available and that the associated module is either already loaded or loadable with dl(). dl is often disabled in php.ini and doesn't work on multithreaded webservers (in which case, ensure the library is loaded with extensions=gv.so or similar somewhere in the PHP configuration).

How do I use Graphviz remotely?

You can also use a remote Graphiz render service with no need to install Graphviz locally. This does however require that your PHP has the curl extension loaded.

The plugin caches results locally thus reducing the number of times it needs to generate a new graph; though do note that a logged-in administrator does not use the cache.

This is an experimental service and may be withdrawn at any time. The intention is to make this a freemium service, where for no charge you can render graphs but with some sort of mark added to it to indicate use of service. Users can also pay a nominal subscription and have graphs rendered without this mark. At the moment the service will operate in "free" mode and ignore any entered API key. Feedback is welcomed on this feature.

Where do I get an API key for remote rendering?

At the moment, you can't. This value is currently ignored.

Requires: 3.0.0 or higher
Compatible up to: 3.9.2
Last Updated: 2014-4-16
Downloads: 827

Ratings

5 stars
5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1 100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1 100,1,1