Percent Complete Plugin

Page contents

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

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.