TWiki> TWiki Web>HideInEditModePlugin (27 Feb 2006, MeredithLesly? )EditAttach

HideInEditModePlugin

This is a plugin that you can use to hide one or two blocsk of text in the edit page, so that the text cannot be edited or changed unless the user has the access permission. The text is still rendered in the view page.

Syntax Rules

  • %STARTHIDDEN% ... %ENDHIDDEN%, which is the equivalent of
  • %STARTHIDDEN{"top"}% ... %ENDHIDDEN%
  • %STARTHIDDEN{"bottom"}% ... %ENDHIDDEN%
  • Text outside the %STARTHIDDEN% ... %ENDHIDDEN% is not hidden in the edit page, thus it can be edited like the normal way.
  • The access permission is controlled by the ALLOWTOPICHIDDEN preference variable. Only people listed in the ALLOWTOPICHIDDEN variable that can edit the hidden text. Obviously, the ALLOWTOPICHIDDEN variable must be set inside the %STARTHIDDEN% ... %ENDHIDDEN% so that a user who has write access (but not listed in the ALLOWTOPICHIDDEN) cannot change the variable.

Examples

%<nop>STARTHIDDEN%

<!--
   * Restrict who can see/edit the hidden text
      * Set ALLOWTOPICHIDDEN = Main.JoeSomebody
-->

Hello World

%ENDHIDDEN%

HideInEditModePlugin Global Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %HIDDENTEXTPLUGIN_SHORTDESCRIPTION%

  • One line description, shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Hide a block of text in the edit page

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

Known Problems

Currently everything is visible in raw view. This is clearly not the right thing. Help?

Plugin Installation Instructions

Note: 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 HideInEditModePlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/HideInEditModePlugin.txt Plugin topic
    data/TWiki/HideInEditModePlugin.txt,v Plugin topic repository
    lib/TWiki/Plugins/HideInEditModePlugin.pm Plugin Perl module
    data/Sandbox/HiddenTextTest.txt Text page

Plugin Info

Plugin Author: TWiki:Main/MeredithLesly
Plugin Version: 27 Feb 2006
Change History:  
06 Feb 2006: Added tags to allow hidden text above and below the rest of the text
04 Oct 2003: Change the syntax so that the hidden block can include '}%'
03 Oct 2003: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.005
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/HideInEditModePlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/HideInEditModePluginDev

Related Topics: TWikiPreferences, TWikiPlugins

-- TWiki:Main.MeredithLesly - 25 Feb 2006

Topic revision: r7 - 27 Feb 2006 - 19:34:21 - MeredithLesly?
TWiki.HideInEditModePlugin moved from TWiki.HiddenInEditPlugin on 27 Feb 2006 - 16:58 by MeredithLesly? - put it back
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.HideInEditModePlugin