• This web contains the official documentation of the TWiki-6.0 Release, code named JerusalemRelease.
• It is a read-only web for reference. Please update documentation at TWiki.PercentCompletePlugin.
Tags:
create new tag
, view all tags

Percent Complete Plugin

Percent complete screenshot
Percent complete selector, for use in TWiki forms and TWiki applications

Introduction

This TWiki plugin package adds a percent complete selector to TWiki forms and TWiki applications. The percentage can be set by clicking on the indicator bar, or by picking a value from the pick list. Percent values are in range 0% to 100%, and rounded to nearest 10% if needed.

Use Percent Selector in TWikiForms

This package adds a percent type to TWikiForms:

Type Description Size Value
percent screenshot-small Percent complete indicator and pick list. The percentage can be set by clicking on the percent complete indicator bar, or by picking a value from the pick list. N/A Initial (default) percentage value

Example form definition:

Name: Type: Size Values: Tooltip message:
Progress percent     Select percent complete

Use Percent Selector in HTML Forms

You can also use the percent complete selector directly in your HTML forms, without having to write any code. Just include this in the topic text:

<form action="...">
%PERCENTCOMPLETE{ name="Progress" value="60" }%
<form>
This will show an HTML selector named "Progress" and a percent complete indicator bar tied to it.

Parameter Description Default Example
name Name of selector (required) name="Progress"
value Initial value, range 0 to 100. "0" value="70"

Test: (this only works if the PercentCompletePlugin is installed and enabled)

Installation Instructions

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

  • For an automated installation, run the configure script and follow "Find More Extensions" in the in the Extensions section.

  • Or, follow these manual installation steps:
    • Download the ZIP file from the extension home on twiki.org (see below).
    • Unzip PercentCompletePlugin.zip in your twiki installation directory.
    • Set the ownership of the extracted directories and files to the webserver user.
    • Install the dependencies (if any).

  • Plugin configuration and testing:
    • Run the configure script and enable the plugin in the Plugins section.
    • Configure additional plugin settings in the Extensions section if needed.
    • Test if the installation was successful using the examples provided.

Plugin Info

  • Set SHORTDESCRIPTION = Percent complete selector, for use in TWiki forms and TWiki applications

Author: TWiki:Main.PeterThoeny, TWiki.org
Copyright: © 2012 TWiki:Main.PeterThoeny;
© 2012 TWiki:TWiki.TWikiContributor
License: GPL (GNU General Public License)
Dependencies:
NameVersionDescription
TWiki::Plugins::JQueryPlugin>=1.0Required; pre-installed in TWiki-5; download from TWiki:Plugins/JQueryPlugin
Version: 2012-12-05
Change History:  
2012-12-05: TWikibug:Item7020: Add VarPERCENTCOMPLETE variable doc topic with category
2012-08-10: TWikibug:Item6907: Initial version of PercentCompletePlugin
Home: http://TWiki.org/cgi-bin/view/Plugins/PercentCompletePlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/PercentCompletePluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/PercentCompletePluginAppraisal

Related Topics: VarPERCENTCOMPLETE, TWikiPreferences, TWikiForms, TWikiPlugins

Topic revision: r0 - 2012-12-06 - TWikiContributor
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2017 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.PercentCompletePlugin.