Form Pivot Plugin

Statistics of values in a TWiki Form

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

Related Topics: FormPivotTest, FormPivotTestForm, TWikiPreferences, TWikiPlugins