AutoViewTemplatePlugin

Description

This plugin sets the VIEW_TEMPLATE and EDIT_TEMPLATE variables according to a corresponding form definition. So when you attach a new form to a topic, this plugin will enable the corresponding view/edit template automatically. This comes in very handy for applications where users create new topics without the help of a topic creator wizard, e.g. creating a new topic for a yet non-existing WikiWord. Together with the appropriate application settings, this plugin will then assure that the data the user enters is handled appropriately during view and edit.

There are two modes on how the name of the template is derived:

1. exist (default) and
2. section.

Mode "exist"

A topic that has a MyForm TWikiForm attached to it, will be displayed using the view template MyView and editted using the MyEdit if they exist. The template name is derived by stripping off the suffix ...Form from the form name and appending ...View. The TWiki engine will then use the template name MyView to search for the correct template along the template search path, for example using a topic MyView.

Examples:

You have a form called PurchaseRequestForm. The plugin will now search for PurchaseRequestViewTemplate, and PurchaseRequestEditTemplate.

Mode "section"

A topic with a MyForm will be displayed/editted using the template name stored in the named section viewtemplate/edittemplate . For example given the MyForm form definition topic contains a section viewtemplate whose only content is MyOtherView, then this will be used to view the topic. Likewise, the content of the edittemplate section in MyForm will read to find the edit template.

By default existing values for VIEW_TEMPLATE and EDIT_TEMPLATE have priority. You can change this behaviour in configure so that the form defined templates have priority.

Examples:

We have a form called PurchaseRequestForm which contains the usual table that defined the form fields.

We want this form to define that the topics are viewed with ViewFormAtTopTemplate and edited with EditPurchaseRequestTemplate.

Below this we place the two sections that defines the templates to be used. Note that you must ommit the ...Template from the template names.

%STARTSECTION{"viewtemplate"}%ViewFormAtTopTemplate%ENDSECTION{"edittemplate"}%

%STARTSECTION{"edittemplate"}%EditPurchaseRequest%ENDSECTION{"edittemplate"}% 

Configuration Settings

The following settings can be defined in configure

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the TWiki server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

Manual installation:

• Just download the zip or tgz and unzip it into your twiki directory.
• Files:

  File:	Description:
  data/TWiki/AutoViewTemplatePlugin.txt	Plugin doc page
  lib/TWiki/Plugins/AutoViewTemplatePlugin.pm	Plugin Perl module
  lib/TWiki/Plugins/AutoViewTemplatePlugin/Config.spec	Config spec

• Plugin configuration is done via configure.

Plugin Info

Plugin Author:	TWiki:Main.OliverKrueger
Copyright:	© 2008-2009, Oliver Krueger; © 2008-2011 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Release:	2011-05-14
Plugin Version:	21260 (2011-05-14)
Change History:
2011-05-14:	TWikibug:Item6701: Small doc fixes -- TWiki:Main.PeterThoeny
2010-12-29:	TWikibug:Item6530: Doc improvements, code sync
31 Jul 2010:	Documentation updates
06 Oct 2009:	Plugin got better documentation. No change in behavior.
20 Aug 2009:	Added forward-compatibility for newer TWiki (MD)
15 Nov 2008:	Minor doc changes
11 Jul 2008:	TWikibug:Item5770: try to derive the EDIT_TEMPLATE of a new topic using the WebTopicEditTemplate (MD)
03 Jul 2008:	TWikibug:Item5747: fixed normalizing web part of form names (MD)
13 Nov 2007:	added EDIT_TEMPLATE, speed improvements, docu (MD)
29 Oct 2007:	TWikibug:Item4904: made specification of view template skin agnostic, fixed view templates in subwebs (MD)
04 Sep 2007:	Added build script and installer, minor doc changes
05 Jun 2007:	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.026
CPAN Dependencies:	none
Other Dependencies:	none
Plugin Home:	http://TWiki.org/cgi-bin/view/Plugins/AutoViewTemplatePlugin
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/AutoViewTemplatePluginDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/AutoViewTemplatePluginAppraisal

Related Topics: TWikiPreferences, TWikiPlugins