Changes between Version 4 and Version 5 of quintagroup.plonecaptchas

Timestamp:

Sep 14, 2010 1:06:02 PM (14 years ago)

Author:

olha

Comment:

--

quintagroup.plonecaptchas

@@ -26 +26 @@
  * Captcha will now be applied to the registration form.
 
+== Installation ==
+
+=== Plone 3, 4 buildout ===
+
+If you are using buildout to manage your project, you can do this:
+
+ * Add quintagroup.plonecaptchas to the list of eggs to install in the buildout.cfg file:
+ {{{
+     [buildout]
+     ...
+     eggs =
+         ...
+         quintagroup.plonecaptchas
+ }}}
+
+ * Tell the plone.recipe.zope2instance recipe to install a ZCML slug for this product: add quintagroup.plonecomments and quintagroup.plonecomments-overrides to zcml area of a buildout.cfg file:
+
+ {{{
+    [instance]
+    recipe = plone.recipe.zope2instance
+    ...
+    zcml =
+        quintagroup.plonecaptchas
+ }}}
+
+ * Re-run buildout with:
+
+ {{{
+    $ ./bin/buildout
+ }}}
+
+ * Restart the Zope server with the following command in the terminal:
+
+ {{{
+    $ ./bin/instance restart
+ }}}
+
+ * Activate Plone Captchas via Quickinstaller in Plone: Site Setup -> Add-ons.
+
+==== Important Note ====
+
+With quintagroup.plonecaptchass you have to be care with the version of the package you need on your instance:
+
+ * For Plone 4 versions - use quintagroup.plonecaptchas 4.x releases. In your buildout.cfg file's egg section set product version:
+ {{{
+      [buildout]
+      ....
+      eggs =
+            ...
+            quintagroup.plonecaptchas >=4.0
+ }}}
+
+ * For Plone 3 versions - use quintagroup.plonecaptcha 3.x releases. In your buildout.cfg file's egg section set product version:
+ {{{
+      [buildout]
+      ....
+      eggs =
+            ...
+            quintagroup.plonecaptchas >=3.0,<4.0
+ }}}
+
+=== Traditional Zope 2 Instance for Plone 3 ===
+
+To install quintagroup.plonecaptchas into the global Python environment (or a workingenv), using a traditional Zope 2 instance, you can do this:
+
+ * Copy '''quintagroup''' folder to your instance ''/lib/python'' directory.
+ * Create a file called '''quintagroup.plonecaptchas-configure.zcml''' in your instance ''/etc/package-includes'' directory. The file should only contain this:
+ {{{
+    <include package="quintagroup.plonecaptchas" file="configure.zcml" />
+ }}}
+ * Restart the Zope server, for example, with the following command in the terminal:
+ {{{
+    $ ./bin/zopectl restart
+ }}}
+ * Activate Plone Captchas via Quickinstaller in Plone: Site Setup -> Add-ons.
+
+=== Plone 2.x ===
+
+For Plone 2.x versions - use [http://plone.org/products/plone-captchas/releases/1.3.4 1.3.4 version] of qPloneCaptchas product to add captcha to PloneFormMailer forms.
+
 == Notes ==
 
+ * If Plone Captchas is expected to be used with Plone Comments product, for proper behaviour, you have to install Plone Captchas first, and then Plone Comments.
  * If you want to change captcha look - use [wiki:quintagroup.captcha.core quintagroup.captcha.core] settingsproduct.
  * If you want captcha support for !PloneFormGen forms - use [wiki:quintagroup.pfg.captcha quintagroup.pfg.captcha] product.