TFO Graphviz

Graphviz is a powerful tool for visualizing network and tree structures that connect objects. This WordPress plugin provides a shortcode mechanism to create Graphviz graphics within blogs, including image map generation and most other Graphviz features. How to use TFO Graphviz The shortcode syntax is: [graphviz <options>] <DOT code> [/graphviz] Where <options> is anything from this list. All are entirely optional:

• class="<css_class>"

Adds an extra CSS class name (or names) to the img tag of the rendered graph. This is in addition to the graphviz class that is already applied. * emitjs="yes|no" Override the global setting that controls whether JavaScript is emitted as necessary. Typically this JavaScript is only produced when rendering SVG output and is intended to ensure SVG images work on most browsers. However this can sometimes be undesirable and thus this option gives some control over this. * height="<image_height>" Adds a height attribute to the image tags to enable control of the image rendering. This is useful for making sure the graphic fits into a certain space and works well for SVG rendered graphs. * href="self|<URL>" Encompasses the generated image with a link either to the image itself (with the self value) or to the provided URL. If the option is empty (for example, href="") then no link is generated. This is the default. * id="<id>" Provides the identifier used to link the generated image to an image map. If you use the simple option then it also provides the name of the generated DOT graph container (since Graphviz uses this to generate the image map). If not given then an identifier is generated with the form tfo_graphviz_N where N is an integer that starts at one when the plugin is loaded and is incremented with use. * imap="yes|no" Graphviz can generate image maps using any URL's given in the DOT code so that clicking on objects in the resultant image will direct a web browser to a new page. The effect of this option is to both instruct Graphviz to generate a client-side image map and to also insert that map into the generated HTML. It will use the id value as the name of the map (see the id option for details). imap defaults to no. Take note that the id value specified in the shortcode tag must match the name of the graph inside your DOT; the HTML for the image map is generated by Graphviz using the name of the graph as the map id and name. This plugin uses the id specified in the shortcode tag to link the image to the map and thus these values need to match. For example, note that mymap is both the id and the graph name: [graphviz imap="yes" title="This is my map" id="mymap"] digraph mymap { input[shape="box", style="rounded", label="My label", URL="/myurl"]; } [/graphviz] If you do not give the graph any name at all the results are undefined. Some versions of Graphviz use the string %3 as the identifier in the map but this may not be universally true. * lang="<dot|neato|twopi|circo|fdp>" Specifies the particular Graphviz interpreter to use. The options are dot, neato, twopi, circo and fdp. The default is dot. * output="<png|gif|jpg|svg>" Indicates the desired image format. Defaults to png. * simple="yes|no" The simple option provides a very basic DOT wrapper around your code such that the following is possible: [graphviz simple="yes"] a -> b -> c; [/graphviz] The generated code would look like: digraph tfo_graphviz_1 { a -> b -> c; } See the id option for a description of how the name of the digraph is created. simple defaults to no. * title="<title>" Indicates the title of the image. This is used in the alt and title attributes of the image reference. This defaults to an empty string. Note that image maps may indicate a title string which will appear in tool-tips. * width="<image_width>" Adds a width attribute to the image tags to enable control of the image rendering. This is useful for making sure the graphic fits into a certain space and works well for SVG rendered graphs. * method="<Graphviz|Graphlib_Dot|PHP>`" Overrides the configured output generation method to use the one indicated. This is useful when the mechanism normally in use does not support a specific feature, or when developing new methods. Note that since this does not have the same tests that the settings page has it may fail in mysterious ways without letting you know that it did. In particular, note that the Graphlib_Dot method is very experimental at the moment.

Installation is simple. Either install from directly within WordPress or:

1. Download and unzip the plugin to the /wp-content/plugins/tfo-graphviz directory within your WordPress installation.
2. Make the directory /wp-content/tfo-graphviz and make it writable by the web server - this is where generated images and image maps go.
3. 通过 WordPress 的“插件”菜单以激活本插件。
4. Choose a generation method on the plugin settings page.
5. Use the [graphviz] shortcode to generate graphs.

You need access to a Graphviz renderer:

• By using a local installation of Graphviz and the dot binary.
• By using a local installation and PHP bindings to the library.

See the FAQ for more details on these options and http://www.graphviz.org/Download.php for details on installing Graphviz on your web server.

1.19

• The method override was not working as expected if you fully qualified the method name.

1.18

• The hash that is used to name the generated output for caching was not including all the options for generation; this meant that changing things like the GraphViz language from "dot" to something else or changing the image size was not re-renerating the output.
• Removed all references to the defunct 'remote' method.
• Add a mechanism for a method to produce its content inline, not just by URL.
• Experiment with the Graphlib-Dot JavaScript library. See https://github.com/dagrejs/graphlib-dot/wiki.
• Add a method attribute that allows overriding the generation method.
• Better reporting on the admin page when a generation module is not available.

1.17

• HTML decode the content; WP now seems to encode HTML entities between our tags.

1.16

• Add class attribute to the shortcode to enable adding CSS classes to the img tag.
• Make the test graph on the admin page have a transparent background.
• Document emitjs attribute.

1.15

• Validate graph language and output format.
• Some sanity checking in the PHP bindings method.
• Document the need to specify both a shortcode id and a DOT graph name.
• Tested up to WP 4.7.2

1.14

• Finally worked out how to disable wptexturize! Less demangling now required.
• Add an option to control whether we ever emit JavaScript.

1.13

• Better diagnostic output for when running dot doesn't work, including the command line used and adding the DOT as submitted, with line numbers. (Joachim Durchholz)
• Add more de-mangling rules, for smart quotes and ellipsis. (Joachim Durchholz)
• Improve the newline de-mangling. (Joachim Durchholz)
• Add the SVG output format. See http://blog.flirble.org/2015/11/15/adding-svg-support-tfo-graphviz/ for example. (Joachim Durchholz)
• Add a fix for when the required GV class isn't loadable, such as when GV gets upgraded on the system. (Sam Wilson)
• Include some JavaScript for when both an image map and width/height scaling is specified. This is required to scale the image map to whatever the image has been scaled to. Image map scaling code comes from https://github.com/davidjbradshaw/image-map-resizer

1.12

• clean_url() and attribute_escape() have both been deprecated. Migrate to esc_url() and esc_attr()`. (Sam Wilson)

1.11

• Remove deprecated constructor definitions. (Sam Wilson)
• Testing against 4.3.

1.10

• Require at least WP 4.2 now.
• Fix use of add_query_arg() to escape its output; a possible XSS vector.
• Added GPL v2 license information.

1.9

• Make some debugging output conditional.
• Fix where that debugging output is stored. (Sam Wilson)

1.8

• Fix a packaging error in 1.7.
• Fix use of hardcoded "/tmp" path. (Sam Wilson)

1.7

• Test upto WP 4.2.2.
• Change an exec("mv...") to using rename() instead. (Sam Wilson)
• Code documentation improvement.
• Some reformatting.

1.6

• Fix some cosmetic documentation issues.

1.5

• Update documentation for using the PHP gv bindings.

1.4

• Wordpress 4.0 support.
• Fix for PHP Graphviz module loading; newer PHP's don't allow dl() at all in some cases, we should therefore detect this.
• Use WP_Error properly.
• Liberal use of try/catch to detect runtime issues.

1.3

• No changes; version bump for the later 3.x series.

1.2

• Removed leftover diagnostic code in PHP render class (which was appearing in posts!)
• Added remote Graphviz rendering support. Note that this is still young and will add a mark to the graph indicating it was generated by this plugin.
• Tested on WordPress 3.0.2 and 3.0.3.

1.1

• Added support for locally installed PHP bindings to the Graphviz library. This only works if PHP either allows dl() to load a module or gv.so/dll is staticly configured to load in php.ini.
• Made render module selection somewhat more robust.
• Attempt to create our wp-content/tfo-graphviz directory if it doesn't already exist.
• Better (as in, "any at all") error generation in the shortcode handler.
• Add content expiration - configurable. Will remove files from the wp-content/tfo-graphviz directory, but only if the threshold is >0 and older than the threshold.

1.0

• First release.