PmWiki | Cookbook / PmForm

Summary: Form processing engine for PmWiki

Version: 2011-02-16

Prerequisites: pmwiki-2.2.0-beta46

Status: Development

Maintainer: Pm, Petko

Categories: Forms

Questions answered by this recipe

How can I create a form in PmWiki to send mail?

Description

The pmform.zip Δ module provides a variety of forms processing capabilities. The module is still under development.

Documentation and examples for PmForm are being performed in a separate wiki at http://www.pmwiki.org/pmform/ . Some key pages:

PmForm:Installation
PmForm:MailForm - forms to send email

Notes

PmForm blocks directives from data being saved to pages by converting markups: thus "(:" becomes "( :" and ":)" becomes ": )". These are managed by the $PmFormPostPatterns array.

The (:template require:) directive can be used to prevent certain string combinations from appearing in posted fields. For example, to prevent someone from entering link markups, use:

   (:template require text match=-[[ errmsg="links not allowed":)

which says that the 'text' field must not contain "[[".

Release Notes

The recipe requires pmwiki-2.2.0-beta46 or later.

2011-02-16 - added variable $EnablePmFormMailSubjectEncode (PITS:01238).
2010-09-04 - added $PmFormExitFunction, $PmFormRedirectFunction (PITS:01179), fixed carriage returns (PITS:01175).

Comments

Comments : how to keep page PVs when posting? I'm trying to integrate this recipe to add comments functional to my pages. The only thing I need is to let my anonymous site's visitors add comments to pages. The problem is that posting this form deletes my Page Variables, existed on the page before. For example I have PV ctime and author and title, all of them are overwritten after posting: ctime and title become deleted, author overwrites with name provided by poster. I want all these fields to keep intact, and just add something like

-> Posted by {$$guest} on {$$CurrentTime}
{$$text}

to my page content. What is the best way to do it? --Finar

Should this recipe be modified so it uses the SiteAdmin group by default? --Hagan

Contributors

Pm
Ian MacGregor
XES - ideas & frequent sounding board

Is there a way that I could create a form that would allow people to self register for a login/password combo via PMWiki? If so, how would I that? Thanks, Chris 8-26-08

User notes +4: If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.

PmForm