Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/collective/collective.z3cform.norobots

collective.z3cform.norobots provides a "human" captcha widget based on a list of questions/answers.
https://github.com/collective/collective.z3cform.norobots

Last synced: 3 months ago
JSON representation

collective.z3cform.norobots provides a "human" captcha widget based on a list of questions/answers.

Host: GitHub
URL: https://github.com/collective/collective.z3cform.norobots
Owner: collective
License: other
Created: 2012-06-13T11:39:28.000Z (about 12 years ago)
Default Branch: master
Last Pushed: 2022-08-23T08:15:04.000Z (almost 2 years ago)
Last Synced: 2024-01-23T21:47:37.115Z (5 months ago)
Language: Python
Size: 322 KB
Stars: 5
Watchers: 4
Forks: 6
Open Issues: 4
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
- License: LICENSE.txt

Lists

awesome-plone - collective.z3cform.norobots - A "human" captcha widget based on a list of questions/answers. (Forms)

README

        .. image:: https://travis-ci.org/collective/collective.z3cform.norobots.svg?branch=master

    :target: https://travis-ci.org/collective/collective.z3cform.norobots

.. image:: https://coveralls.io/repos/github/collective/collective.z3cform.norobots/badge.svg?branch=master

    :target: https://coveralls.io/github/collective/collective.z3cform.norobots?branch=master

    :alt: Coveralls

.. image:: https://img.shields.io/pypi/v/collective.z3cform.norobots.svg

    :target: https://pypi.python.org/pypi/collective.z3cform.norobots/

    :alt: Latest Version

.. image:: https://img.shields.io/pypi/status/collective.z3cform.norobots.svg

    :target: https://pypi.python.org/pypi/collective.z3cform.norobots

    :alt: Egg Status

.. image:: https://img.shields.io/pypi/pyversions/collective.z3cform.norobots.svg?style=plastic   :alt: Supported - Python Versions

===============================================

collective.z3cform.norobots

===============================================

.. contents:: Table of Contents

   :depth: 2

Overview

--------

``collective.z3cform.norobots`` provides a "human" captcha widget based on a list of

question/answer(s).

This captcha can be used :

    * as a ``plone.app.discussion`` (Plone Discussions) captcha plugin

    * as a ``z3c form`` field

    * as a macro in a custom form

    * as a PloneFormGen field with `collective.pfg.norobots`_

The widget is based on z3c.form.TextWidget.

Since version 1.4, questions configuration uses a dedicated control panel (using ``plone.app.registry``)

instead of a simple properties sheet. An upgrade step provides migration from earlier versions.

Interface is translated in the following languages: Czech [cs], Danish [da], German [de],

Basque [eu], Spanish [es], Suomeksi [fi], French [fr], Dutch [nl], Simplified Chinese [zh_CN],

Italian [it] and Russian [ru].

Requirements

------------

I have tested this release with Plone 4.3.10, Plone 5.0.5.

Since version 2.0 Plone 6 is supported.

See previous releases for old Plone versions.

Screenshot

------------

.. image:: https://github.com/sylvainb/collective.z3cform.norobots/raw/master/docs/collective-z3cform-norobots-screenshot.png

   :height: 324px

   :width: 499px

   :scale: 100 %

   :alt: Screenshot

   :align: center

Installation

------------

Getting the module

~~~~~~~~~~~~~~~~~~~~

Add ``collective.z3cform.norobots`` to your ``plone.recipe.zope2instance`` buildout section e.g.::

    [instance]

    ...

    eggs =

        Plone

        ...

        collective.z3cform.norobots

    ...

    zcml =

        ...

        collective.z3cform.norobots

Or, you can add it as a dependency on your own product *setup.py*::

    install_requires=[

        ...

        'collective.z3cform.norobots',

    ],

Enabling the module

~~~~~~~~~~~~~~~~~~~~

In the Addons control panel, install "Norobots captcha field (collective.z3cform.norobots)".

Add a new question

~~~~~~~~~~~~~~~~~~~~

In the "Norobots widget settings" control panel, add a new line in the field "Norobots question::answer":

::

   your_question::the_answer

   Example : What is 10 + 12 ?::22

Answer can contain multiple values delimited by semicolon:

::

   your_question::the_answer;another_answer

   Example : What is 5 + 5 ?::10;ten

Quickly test ?

~~~~~~~~~~~~~~~~~~~~

Download ``collective.z3cform.norobots`` and use ``virtualenv`` and ``buildout`` to test the module::

    easy_install virtualenv

    cd collective.z3cform.norobots

    virtualenv .

    source bin/activate

    (collective.z3cform.norobots) easy_install zc.buildout

    !!! check the buildout config file ``test-plone-base.cfg`` before running !!!

    (collective.z3cform.norobots) ln -s test-plone-5.0.x.cfg buildout.cfg

    (collective.z3cform.norobots) python bootstrap.py

    (collective.z3cform.norobots) bin/buildout

    [...] be patient... [...]

    (collective.z3cform.norobots) ./bin/instance fg

Go to http://localhost:8080, add a new Plone Site and install collective.z3cform.norobots (see above).

Launch tests::

    (collective.z3cform.norobots) pip install unittest2

    (collective.z3cform.norobots) ./bin/test -s collective.z3cform.norobots

Launch code coverage::

    (collective.z3cform.norobots) bin/coverage

    (collective.z3cform.norobots) bin/report

    And open with a browser htmlcov/index.html

Usage as a ``plone.app.discussion`` (Plone Discussions) captcha plugin

----------------------------------------------------------------------

In the Discussion control panel, activate anonymous comments then select "Norobots" for the captcha.

This enable the captcha for anonymous users.

Usage in a z3c form

-------------------

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

::

    from zope import interface, schema

    from z3c.form import interfaces, form, field, button, validator

    from plone.app.z3cform.layout import wrap_form

    from collective.z3cform.norobots.i18n import MessageFactory as _

    from collective.z3cform.norobots.widget import NorobotsFieldWidget

    from collective.z3cform.norobots.validator import NorobotsValidator

    class INorobotsForm(interface.Interface):

        norobots = schema.TextLine(title=_(u'Are you a human ?'),

                                   description=_(u'In order to avoid spam, please answer the question below.'),

                                   required=True)

    class NorobotsForm(form.Form):

        fields = field.Fields(INorobotsForm)

        fields['norobots'].widgetFactory = NorobotsFieldWidget

    # wrap the form with plone.app.z3cform's Form wrapper

    NorobotsFormView = wrap_form(NorobotsForm)

    # Register Norobots validator for the correponding field in the IContactInfo interface

    validator.WidgetValidatorDiscriminators(NorobotsValidator, field=INorobotsForm['norobots'])

In your configure.zcml you have to add the following adapter, to make the validation work.

::

    

For more information see ``contact_info.py`` in the ``plone_forms`` directory.

To activate this example, add ```` in the package's

``configure.zml`` file and open http://localhost:8080/Plone/@@z3cform-contact-info

Usage as a macro in a custom form

----------------------------------

See ``browser/norobots_macro.pt`` available through @@norobots_macro browser page.

Possible problems

-----------------

  * In a fresh Plone 5.0.5 the captcha widget does not appear in the comments form even if ``Norobots``

    is the selected captcha. Installing an other captcha like ``plone.formwidget.captcha`` solve

    this problem (sic!). In my website, updated from Plone 5.0.4 to 5.0.5, all is ok.

  * I have the following error when launching the tests: "ImportError: No module named lxml.html"

    => In order to run the tests you need lxml. You can add for example

    "z3c.form [test]" to your buildout. See http://plone.293351.n2.nabble.com/Custom-Dexterity-Widgets-td5594532.html for more details.

Credits

-----------------

* Sylvain Boureliou [sylvainb] - `GitHub `_ - `Website `_

* Makina Corpus `Makina Corpus `_

Source code

-----------

`Source code `_ is hosted on Github.

How to contribute and submit a patch ?

--------------------------------------

`Source code `_ and an `issue tracker `_ is hosted on Github.

Contributors

-----------------

* Sylvain Boureliou [sylvainb]

* Mikel Larreategi [erral]

* Aijun Jian

* Radim Novotny [naro]

* Thomas Clement Mogensen [tmog]

* Peter Mathis [petschki]

* Petri Savolainen [petri]

* Helmut Toplitzer

* Luca Fabbri [keul]

* Andrea Cecchi [cekk]

* [serge73]

.. _`collective.pfg.norobots`: http://pypi.python.org/pypi/collective.pfg.norobots