Instructions

README

ColorPicker

This module gives you a new custom Fieldtype. Let's you select a color using a Colorpicker jQuery Plugin. The color selected will be stored in HEX format uppercase: "EAEAEA";

When creating a new field in the admin, you can set a default value. The default value will be set when creating a new page, and it will also be used for empty fields.

The field supports a transparent value. In the field setting you can use the name "transp" to define it. When output formatting (2.0.0) of the field is enabled, the field will return "transparent" in template code.

The field supports a "reset" button to be able to set it back to the default value.

How to use it

To use it in your template as a background HEX color, you'd simple output the value and prefix it with a #:

echo "background-color: #" . $page->color;

Since of 2.0.0 you can enable output formatting of the field in the details settings. When enabled it will format value directly from AADDEE to "#AADDEE" and "transp" to "transparent".

added support for color swatches for easy predefining and selecting color values @Rayden

added "transp" support for a transparent value (empty)

1.0.5

fix bug with default value

1.0.4

fix bug when used in repeaters

1.0.3

added support for default value

added reset link to set back to default color

1.0.2

Fixed issue with colorpicker not working when used in tabs

1.0.1

Remove lots of code not needed. Cleanup.

1.0.0

Initial Stable Release.

How to install:

Download the contents of this repository and put the folder renamed as "ColorPicker" into your site/modules/ folder

Login to processwire and got to Modules page and click "Check for new modules". You should see a note that two new modules were found. Install the FieldtypeColorPicker module under "Field" section. This will also install the required InputfieldColorPicker at the same time.

Comments

It should be noted that the instructions for the module on this page are contradictory: the module has to be put in a folder called ColorPicker under /modules/, not "/site/modules/FieldtypeColorPicker/" as it notes earlier on this page, otherwise the module fails to find its own assets at the JS breaks the PW admin.