This group is used to document the Cookbook:PmForm recipe.
There are several steps for PmForm to work.
- Download pmform.zip and extract it to your PmWiki directory on your server
Note: You need to put
pmform.php direct into your cookbook/ directory, and Site.PmFormTemplates into your wikilib.d directory.
- Xes: I don't recommend putting Site.PmFormTemplates directly in wikilib.d because that's part of the upgrade tree and should not be modified by users or recipes. I created my own xeslib.d directory and put Site.PmFormTemplates into it, adding this as the very FIRST line in my config.php:
$WikiLibDirs = array(&$WikiDir,new PageStore('$FarmD/xeslib.d/{$FullName}'),new PageStore('$FarmD/wikilib.d/{$FullName}'));
This is how you can create your own lib (library) directory ("lib.d") name for wiki page templates separate from user-overwritten wiki.d files.
- Modify your
local/config.php or other local customization file, enabling PmForm
include_once("$FarmD/cookbook/pmform.php");
- note you also will need a line in your config.php file to define the reference for every unique
(:pmform reference:) directive:
$PmForm['reference'] = 'subject="Email from '.$WikiTitle.'" mailto=yourname@example.com form=#yourform fmt=#yourformpost from=myname@myexample.com';
- Create wiki page called Site.LocalTemplates if it doesn't exist already
- Modify Site.LocalTemplates, editing the form code creating the form (named #yourform from the config.php line above) and the output format (named #yourformpost from the config.php line above)
- Inserting the (:pmform reference:) directive into any wiki page where you want this specific form
Starting points:
- Basic Email Form - a walkthrough creating a basic email form with honeypot & captcha (by Xes)
- MailForm - forms for sending electronic mail
- HoneyPot - filter posts from robots
- Comments - Add comments to current page, or a comment page
- Data Forms - Add data to pages
Unofficial user's notes about PmForms:
All relevant pages in PmForm:
