Form Pivot Plugin

Introduction

Basic analysis of topics with TWiki Forms in a web. The analysis is done on form field values of topics that share a specific TWiki Form.

Syntax rules

%FORMPIVOT{ form="..." fields="..." type="grid|count" }%

Known Issues

This is a fairly simple initial implementation and probably doesn't yet deserve the designation of pivot.

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %FORMPIVOTPLUGIN_SHORTDESCRIPTION%

• One line description, shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = Statistics of values in a TWiki Form

• Set DEBUG to 1 to get debug messages in data/debug.txt. Default: 0
  • Set DEBUG = 0

Plugin Installation Instructions

• Download the ZIP file from the Plugins web (see below)
• Unzip FormPivotPlugin.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/FormPivotPlugin.txt	Plugin topic
  data/Sandbox/FormPivotTest*.txt	Form pivot test topics
  lib/TWiki/Plugins/FormPivotPlugin.pm	Plugin Perl module

• Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.
• Test if the plugin is correctly installed:
  • See Sandbox.FormPivotTest for the two types of pivot.

Plugin Info

Plugin Author:	TWiki:Main.JohnTalintyre
Copyright:	© 2002 TWiki:Main.JohnTalintyre © 2007-2011 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Plugin Version:	2011-02-01
Change History:
2011-02-01:	TWikibug:Item6638: Fix for TWiki-5.0; many doc improvements; changing TWIKIWEBT to SYSTEMWEB -- TWiki:Main.PeterThoeny
2002-04-15:	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.1
CPAN Dependencies:	none
Other Dependencies:	none
Perl Version:	5.005
TWiki:Plugins.Benchmark:	GoodStyle nn%, FormattedSearch nn%, FormPivotPlugin nn%
Plugin Home:	http://TWiki.org/cgi-bin/view/Plugins/FormPivotPlugin
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/FormPivotPluginDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/FormPivotPluginAppraisal

Related Topics: FormPivotTest, FormPivotTestForm, TWikiPreferences, TWikiPlugins