Skip to topic | Skip to bottom
TWiki.FormFieldListPluginr1.1 - 01 Oct 2004 - 12:25 - BerndRaichle?topic end

Start of topic | Skip to actions


FORMFIELDLIST{"field names"} renders a list of fields in the form attached to some topic. It is an extended version of the predefined variable FORMFIELD{"fieldname"} to render more than one form field.

Syntax Rules

  • %FORMFIELDLIST{"field names"}%
  • Supported parameters: | Parameter: | Description: | Default: | | "field names" | A list of TWiki form field names separated by comma. | required | | topic="..." | Topic where form data is located. May be of the form Web.TopicName. | Current topic | | format="..." | Format string. $value expands to the field value. $title and $name expand to the field title as specified in the TWiki form and the field title without spaces. | "$title=$value " | | default="..." | Text shown when no value is defined for the field. | "" | | alttext="..." | Text shown when field is not found in the form .| "" | | separator="..." | Line separator between rendered entries. | Newline "$n" |
  • The variable $n expands to a newline for the complete rendered output.


  • %FORMFIELDLIST{"ProjectName, ProjectLeader, ProjectStatus" topic="Projects.SushiProject" separator=". " default="(Field $title not set)" alttext="_$title_ field not found"}%
  • Output as list: %FORMFIELDLIST{"ProjectName, ProjectLeader, ProjectStatus" topic="Projects.SushiProject" format="   * $title: $value." default="   * $title: not set." alttext="   * $title: not found."}%

Plugin Settings

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

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Renders a list of fields in the form attached to some topic (xtending the predefined variable FORMFIELD)

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

  • Download the ZIP file from the Plugin web (see below)
  • Unzip in your twiki installation directory. Content: | File: | Description: | | data/TWiki/FormFieldListPlugin.txt | Plugin topic | | data/TWiki/FormFieldListPlugin.txt,v | Plugin topic repository | | lib/TWiki/Plugins/ | Plugin Perl module |
  • Test if the installation was successful:
    • The expansion of %FORMFIELDLIST{"TopicClassification,InstalledOnTwikiOrg,NotFound,DemoUrl" format="$title: $value." default="(Field $title not set)" alttext="_$title_ field not found."}% is
TopicClassification field not found. InstalledOnTwikiOrg field not found. NotFound field not found. DemoUrl field not found..

Plugin Info

Plugin Author: TWiki:Main/BerndRaichle
Plugin Version: 01 Oct 2004 (V1.000)
Change History:  
01 Oct 2004: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.024
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
TWiki:Plugins/Benchmark: GoodStyle nn%, FormattedSearch nn%, Form Field List Plugin nn%
Plugin Home:

Related Topics: Predefined variable FORMFIELD TWikiPreferences, TWikiPlugins

-- TWiki:Main/BerndRaichle - 01 Oct 2004
to top

TWiki.FormFieldListPlugin moved from TWiki.FormfieldListPlugin on 01 Oct 2004 - 12:23 by BerndRaichle? - put it back
You are here: TWiki > FormFieldListPlugin

to top

Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback