Metadata-Version: 2.4
Name: collective.z3cform.colorpicker
Version: 4.0.0
Summary: Colorpicker widget for Plone
Home-page: http://www.giorgioborelli.it
Author: Giorgio Borelli
Author-email: giorgio@giorgioborelli.it
License: GPL
Keywords: plone z3cform colorpicker widget
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 6.2
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
License-File: LICENSE.txt
Requires-Dist: plone.app.z3cform
Requires-Dist: plone.z3cform
Requires-Dist: Products.CMFCore
Requires-Dist: z3c.form
Requires-Dist: zope.component
Requires-Dist: zope.interface
Requires-Dist: zope.schema
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

.. contents::

Introduction
============

collective.z3cform.colorpicker provides a color picker widget, which uses the Browser native color input.

.. image:: https://raw.githubusercontent.com/collective/collective.z3cform.colorpicker/master/screenshot.png


Requirements
============

* Plone >= 5.0
* plone.app.z3cform

For previous Plone versions use a version collective.z3cform.colorpicker
less than 2.x


Installation
============

Install collective.z3cform.colorpicker by adding it to your buildout::

    [buildout]

    ...

    eggs =
        collective.z3cform.colorpicker


and then running ``bin/buildout``

or installing it via ``pip install collective.z3cform.colorpicker``


Usage
=====

You can use this widget setting the "widgetFactory" property of a form field:
::

        from z3c.form import form, field
        from collective.z3cform.colorpicker import Color

        class IColorForm(interface.Interface):
            color = Color(
                title=u"Color",
                description=u"",
                required=False,
                default="#ff0000"
            )


        class ColorForm(form.Form):
            fields = field.Fields(IColorForm)
            ...

for more information see demo directory in the package sources.

Contributors
============

* Giorgio Borelli - gborelli, Original Author
* Silvio Tomatis - silviot
* Ramon Navarro Bosch - bloodbare
* Maurits van Rees - maurits
* Leonardo J. Caballero G. - macagua

Changelog
=========

.. You should *NOT* be adding new change log entries to this file.
   You should create a file in the news directory instead.
   For helpful instructions, please see:
   https://github.com/plone/plone.releaser/blob/master/ADD-A-NEWS-ITEM.rst

.. towncrier release notes start

4.0.0 (2026-06-17)
------------------

Breaking changes:


- Replace ``pkg_resources`` namespace with PEP 420 native namespace.
  Support only Plone 6.2 and Python 3.10+. (#3928)


3.0.1 (2023-10-26)
------------------

- fix GS breaking because of empty registry.xml file
  [MTango]


3.0.0 (2023-07-24)
------------------

- Move to native input color field, which is supported by all moderns browsers
  [MrTango]

- Plone compatibility
  [MrTango]


2.1.0 (2021-09-17)
------------------

- Python 3 support.  [espen]


2.0 (2017-12-21)
----------------

- Added Color and ColorAlpha fields for colorpicker widgets
  [giorgio]

- Removed JPicker and farbastic javascripts
  [gborelli]

- Added colorpicker patterns based on bootstrap-colorpicker
  [gborelli]

- Added plone5.0 resource registry support
  [gborelli]

- Added Docker configuration for development
  [gborelli]

- Improved demo page - http://<yourplonesite>/@@colorpicker-demo
  [gborelli]


1.4 (2015-11-11)
----------------

- Added Dutch translations.
  [maurits]

- Made the close button translatable.
  Found with ``i18ndude find-untranslated .``.
  [maurits]


1.3 (2015-10-05)
----------------

- Remove from jpicker js file the bad chars from the beginning
  [bloodbare]

- Renamed txt files to rst, without symlinks.  Symlinks can give
  installation problems, due to either the symlink or the original
  file missing from the distribution or being empty, because the link
  can end up the wrong way around.  Fixes issue #1.
  [maurits]


1.2 (2015-05-02)
----------------

- Updated classifiers list for package [macagua]
- Added Spanish translation [macagua]


1.1 (2013-06-02)
----------------

- fix MANIFEST.in
  [gborelli]


1.0 (2013-06-02)
----------------

- add z3cform_colorpicker.js to initialize JPicker widget
  [gborelli]

- add internationalization support
  [gborelli]

- add css and javascript to Plone registry in order to make html valid
  [gborelli]

- add profile to install colorpicker package
  [gborelli]

- change some jpicker styles
  [gborelli]

- update jpicker to v1.1.6
  [gborelli]

- egg layout refactoring
  [gborelli]

- change Browser import from Testing.testbrowser
  [gborelli]


0.2 (2010-10-31)
----------------

- include jPicker widget for alpha transparency support
  [gborelli]

0.1 (2009-06-19)
----------------

* Initial release

