%META:TOPICINFO{author="TWikiContributor" date="1432929259" format="1.1" version="$Rev$"}%
---+!! 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.
-->
<sticky>
<div style="float:right; background-color:#EBEEF0; margin:0 0 20px 20px; padding: 0 10px 0 10px;">
%TOC{title="Page contents"}%
</div>
<div style="float:right; margin:0 0 20px 20px; padding: 0 10px 0 10px;">
<img src="%PUBURLPATH%/%WEB%/%TOPIC%/percent-complete-screenshot.png" alt="Percent complete screenshot" width="264" height="167" />
</div>
</sticky>
%SHORTDESCRIPTION%

---++ 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 %SYSTEMWEB%.TWikiForms:

| *Type* | *Description* | *Size* | *Value* |
| =percent= | <img src="%PUBURLPATH%/%WEB%/PercentCompletePlugin/screenshot-small.png" alt="screenshot-small" width="179" height="25" align="right" style="margin-left:20px;" /> 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. %IF{ "'%BASETOPIC%'='TWikiForms'" then="[[PercentCompletePlugin][See details]]." }% | 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:
<verbatim>
<form action="...">
%PERCENTCOMPLETE{ name="Progress" value="60" }%
<form>
</verbatim>
This will show an HTML selector named "Progress" and a percent complete indicator bar tied to it.

%INCLUDE{ "VarPERCENTCOMPLETE" section="parameters" }%

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

<form>
%PERCENTCOMPLETE{ name="Progress" value="60" }%
</form>

---++ Installation Instructions

   * For an __automated installation__, run the [[%SCRIPTURL{configure}%][configure]] script and follow "Find More Extensions" in the in the __Extensions__ section.
      * See the [[http://twiki.org/cgi-bin/view/Plugins/BuildContribInstallationSupplement][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 ==%TOPIC%.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 [[%SCRIPTURL{configure}%][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, [[http://twiki.org/][TWiki.org]] |
|  Copyright: | &copy; 2012-2015 TWiki:Main.PeterThoeny; %BR% &copy; 2012-2015 TWiki:TWiki.TWikiContributor |
|  License: | GPL ([[http://www.gnu.org/copyleft/gpl.html][GNU General Public License]]) |
|  Dependencies: | <table border="1"><tr><th>Name</th><th>Version</th><th>Description</th></tr><tr><td align="left">TWiki::Plugins::JQueryPlugin</td><td align="left">&gt;=1.0</td><td align="left">Required; pre-installed in TWiki-5; download from TWiki:Plugins/JQueryPlugin</td></tr></table> |
|  Version: | 2015-05-29 |
|  Change History: | <!-- versions below in reverse order -->&nbsp; |
|  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/%TOPIC% |
|  Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev |
|  Appraisal: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Appraisal |

__Related Topics:__ VarPERCENTCOMPLETE, %SYSTEMWEB%.TWikiPreferences, %SYSTEMWEB%.TWikiForms, %SYSTEMWEB%.TWikiPlugins


%META:FILEATTACHMENT{name="complete0.png" attachment="complete0.png" attr="h" comment="" date="1344565519" path="complete0.png" size="1112" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete5.png" attachment="complete5.png" attr="h" comment="" date="1344565519" path="complete5.png" size="1197" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete10.png" attachment="complete10.png" attr="h" comment="" date="1344565519" path="complete10.png" size="1176" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete15.png" attachment="complete15.png" attr="h" comment="" date="1344565519" path="complete15.png" size="1223" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete20.png" attachment="complete20.png" attr="h" comment="" date="1344565519" path="complete20.png" size="1189" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete25.png" attachment="complete25.png" attr="h" comment="" date="1344565519" path="complete25.png" size="1230" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete30.png" attachment="complete30.png" attr="h" comment="" date="1344565519" path="complete30.png" size="1190" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete35.png" attachment="complete35.png" attr="h" comment="" date="1344565519" path="complete35.png" size="1231" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete40.png" attachment="complete40.png" attr="h" comment="" date="1344565519" path="complete40.png" size="1190" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete45.png" attachment="complete45.png" attr="h" comment="" date="1344565519" path="complete45.png" size="1230" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete50.png" attachment="complete50.png" attr="h" comment="" date="1344565519" path="complete50.png" size="1187" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete55.png" attachment="complete55.png" attr="h" comment="" date="1344565519" path="complete55.png" size="1233" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete60.png" attachment="complete60.png" attr="h" comment="" date="1344565519" path="complete60.png" size="1190" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete65.png" attachment="complete65.png" attr="h" comment="" date="1344565519" path="complete65.png" size="1233" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete70.png" attachment="complete70.png" attr="h" comment="" date="1344565519" path="complete70.png" size="1191" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete75.png" attachment="complete75.png" attr="h" comment="" date="1344565519" path="complete75.png" size="1231" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete80.png" attachment="complete80.png" attr="h" comment="" date="1344565519" path="complete80.png" size="1192" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete85.png" attachment="complete85.png" attr="h" comment="" date="1344565519" path="complete85.png" size="1234" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete90.png" attachment="complete90.png" attr="h" comment="" date="1344565519" path="complete90.png" size="1182" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete95.png" attachment="complete95.png" attr="h" comment="" date="1344565519" path="complete95.png" size="1165" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete100.png" attachment="complete100.png" attr="h" comment="" date="1344565519" path="complete100.png" size="1100" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="complete.png" attachment="complete.png" attr="h" comment="" date="1344565519" path="complete.png" size="1112" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="percent-complete-screenshot.png" attachment="percent-complete-screenshot.png" attr="h" comment="" date="1344565519" path="percent-complete-screenshot.png" size="16969" user="TWikiContributor" version="1"}%
%META:FILEATTACHMENT{name="screenshot-small.png" attachment="screenshot-small.png" attr="h" comment="" date="1344575289" path="screenshot-small.png" size="6539" user="TWikiContributor" version="1"}%
