Percent Complete Plugin

<--
   Contributions to this plugin package are appreciated. Please update this page at
   http://twiki.org/cgi-bin/view/Plugins/PercentCompletePlugin or provide feedback at
   http://twiki.org/cgi-bin/view/Plugins/PercentCompletePluginDev.
   If you are a TWiki contributor please update the extension in the SVN repository.
-->

Page contents

• Introduction
• Use Percent Selector in TWikiForms
• Use Percent Selector in HTML Forms
• Installation Instructions
• Plugin Info

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	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:

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>

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

0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100%

Installation Instructions

• For an automated installation, run the configure script and follow "Find More Extensions" in the in the Extensions section.
  • See the installation supplement on TWiki.org for more information.

• 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-2015 TWiki:Main.PeterThoeny; © 2012-2015 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Dependencies:	Name Version Description TWiki::Plugins::JQueryPlugin >=1.0 Required; pre-installed in TWiki-5; download from TWiki:Plugins/JQueryPlugin
Version:	2015-05-29
Change History:	<-- versions below in reverse order -->
2015-05-29:	TWikibug:Item7604: Switch from GPL v2 to v3
2014-12-11:	TWikibug:Item7577: TWiki form field type with configure attributes
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