Tags:
create new tag
, view all tags

Color Picker Contrib

NOTE: This contrib is no longer maintained, it is superseded by the ColorPickerPlugin.

screenshot-edit.png Color picker for use in TWiki forms and TWiki applications

Introduction

This module packages the Farbtastic color picker, which is a jQuery plugin developed by Steven Wittens of Acko.net. The package adds a color picker to TWiki forms and TWiki applications.

Using the color picker in TWikiForms

This package adds a color type to TWikiForms:

Type Description Size Value
color Single-line text box and a color picker to pick a color. The color can also be typed into the text box, such as #123456. Text box width in number of characters Initial (default) color

Example form definition:

Name: Type: Size Values: Tooltip message:
Background color color 12   Select color

Using the color picker in an HTML form

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

%INCLUDE{ "%SYSTEMWEB%.ColorPickerContrib" section="code" }%
%INCLUDE{ "%SYSTEMWEB%.ColorPickerContrib" section="picker" NAME="text_color" SIZE="12" VALUE="#123456" EXTRA="class=\"twikiInputField\"" }%
This will show an HTML input field named "text_color" and a color picker tied to it. The "code" section should be included once per topic, the "picker" section can be included as many times as needed. The size, value and extra parameters are optional. Use the extra parameter to add additional parameters to the HTML input field.

Test: (this works only if the ColorPickerContrib is installed)

Detailed Documentation

This package includes a small Perl module to make it easier to use the color picker from TWiki plugins. This module includes the functions:

renderForEdit

TWiki::Contrib::ColorPickerContrib::renderForEdit($name, $value, [, \%options]) -> $html

This is the simplest way to use the color picker from a plugin.

  • $name is the name of the CGI parameter for the calendar (it should be unique),
  • $value is the color such as '#8899aa' (may be empty)
  • \%options is an optional hash containing base options for the textfield.
Example:
use TWiki::Contrib::ColorPickerContrib;
my $html = "<form>\n";
$html .= TWiki::Contrib::ColorPickerContrib::renderForEdit( 'webcolor'i, $value );
...

addHEAD

TWiki::Contrib::ColorPickerContrib::addHEAD( )

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages.

Installation Instructions

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

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

  • If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • If you have any problems, then you can still install manually from the command-line:
    1. Download one of the .zip or .tgz archives
    2. Unpack the archive in the root directory of your TWiki installation.
    3. Run the installer script ( perl <module>_installer )
    4. Run configure and enable the module, if it is a plugin.
    5. Repeat for any missing dependencies.
  • If you are still having problems, then instead of running the installer script:
    1. Make sure that the file permissions allow the webserver user to access all files.
    2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
    3. Manually edit LocalSite.cfg to set any configuration variables.

Contrib Info

  • Set SHORTDESCRIPTION = Color picker for use in TWiki forms and TWiki applications

Author: TWiki:Main.PeterThoeny, Twiki Inc
Copyright: © 2007 Steven Wittens, Acko.net for Farbtastic jQuery plugin
© 2010 TWiki:Main.PeterThoeny and TWiki:TWiki.TWikiContributor for TWiki ColorPickerContrib
License: GPL (GNU General Public License)
Dependencies: None
Version: 19885 (2010-11-26)
Change History:  
2010-11-27: TWikibug:Item6609: In TWikiForms type table, automatically list the color form field type defined in this contrib -- TWiki:Main.PeterThoeny
2010-11-26: TWikibug:Item6606: Complete rewrite of contrib using Farbtastic color picker -- TWiki:Main.PeterThoeny
2006-10-27: Initial version by TWiki:Main.FlavioCurti using Colorpicker by Norman Timmler (inlet media e.K., Hamburg, Germany)
Home: http://TWiki.org/cgi-bin/view/Plugins/ColorPickerContrib
Feedback: http://TWiki.org/cgi-bin/view/Plugins/ColorPickerContribDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/ColorPickerContribAppraisal

Related Topics: TWikiPreferences, TWikiForms, TWikiContribs

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 ColorPickerContrib.md5 r5 r4 r3 r2 r1 manage 0.2 K 2010-11-27 - 00:06 PeterThoeny  
Compressed Zip archivetgz ColorPickerContrib.tgz r5 r4 r3 r2 r1 manage 63.2 K 2010-11-27 - 00:06 PeterThoeny  
Compressed Zip archivezip ColorPickerContrib.zip r6 r5 r4 r3 r2 manage 70.4 K 2010-11-27 - 00:06 PeterThoeny  
Unknown file formatEXT ColorPickerContrib_installer r1 manage 4.0 K 2010-11-27 - 00:06 PeterThoeny  
Edit | Attach | Watch | Print version | History: r8 < r7 < r6 < r5 < r4 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r8 - 2013-10-16 - PeterThoeny
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2017 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.