.. only:: text This document file was automatically generated. If you want to edit the documentation, DON'T do it here--do it in the docstring of the appropriate plugin. Plugins are located in ``Pyblosxom/plugins/``. ==================================================== magicword - Magic word method for reducing comm... ==================================================== Summary ======= This is about the simplest anti-comment-spam measure you can imagine, but it's probably effective enough for all but the most popular blogs. Here's how it works. You pick a question and put a field on your comment for for the answer to the question. If the user answers it correctly, his comment is accepted. Otherwise it's rejected. Here's how it works: Install ======= Requires the ``comments`` plugin. This plugin comes with Pyblosxom. To install, do the following: 1. Add ``Pyblosxom.plugins.magicword`` to the ``load_plugins`` list in your ``config.py`` file. 2. Configure as documented below. Configure ========= Here's an example of what to put in config.py:: py['mw_question'] = "What is the first word in this sentence?" py['mw_answer'] = "what" Note that ``mw_answer`` must be lowercase and without leading or trailing whitespace, even if you expect the user to enter capital letters. Their input will be lowercased and stripped before it is compared to ``mw_answer``. Here's what you put in your ``comment-form`` file:: The Magic Word:
$(mw_question)

It's important that the name of the input field is exactly "magicword". Security note ============= In order for this to be secure(ish) you need to protect your ``config.py`` file. This is a good idea anyway! If your ``config.py`` file is in your web directory, protect it from being seen by creating or modifying a ``.htaccess`` file in the directory where ``config.py`` lives with the following contents:: Order allow,deny deny from all This will prevent people from being able to view ``config.py`` by browsing to it. License ======= Plugin is distributed under license: MIT