TIP SetTopicValuesPlugin is not installed on Foswiki.org.


Set addressible sub-elements of topics


This Plugin adds the ability to use some of the Topic Object model addressing introduced in QuerySearch to modify values.

(only supports PREFERENCES and FIELDS - the others will come with the Foswiki:Development.AddMetaSetActionToEditAndSave Foswiki 1.1 feature.

In essence, this plugin adds Set+ and Unset+ urlparams to the =save= Script.


The save script performs a range of save-related functions, as selected by the action parameter.

Parameter Description Default
set+SomeTOM=someValue Set a META PREFERENCE or FormFIELD to a value  
unset+SomeTOM unset (ie remove) a META PREFERENCE or FormFIELD  

Be aware that while you can set a FormFIELD that is not specified in the topics FORM, the next save will remove it.

For security reasons, the rvalues are entityEncoded before being saved. This means you cannot set a a preference or formfield to another TML MACRO - just constant strings.


  • http://somewhere.com/save/Sandbox/TestTopic5?set+VIEW_TEMPLATE=SomeValue
  • http://somewhere.com/save?set+Sandbox.TestTopic5/preferences[VIEW_TEMPLATE]=SomeValue
    • adds a META PREFERENCE (or potentially edits an existing in-text Setting?)
  • http://somewhere.com/save?unset+Sandbox.TestTopic5/preferences[VIEW_TEMPLATE]

Technical details

So that URL settings can be used to set the values on a topic that is being created, it uses the afterSaveHandler.

To simplify the implementation, PREFERENCES are all stored in the META::PREFERENCES, not inline in the topic.

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 server.

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

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Author(s): Foswiki:Main.SvenDowideit
Copyright: © 2008-2009 SvenDowideit@fosiki.com - fosiki
License: GPL 3(Gnu General Public License)
Version: 2713 (26 Feb 2009)
Change History:  
Feb 2009: initial public release
Dependencies: None
Home page: http://foswiki.org/bin/view/Extensions/SetTopicValuesPlugin

Topic revision: r1 - 26 Feb 2009, SvenDowideit - This page was cached on 28 May 2016 - 13:53.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License