TABLE OF CONTENTS › Un/Subscription Forms

Postmaster utilizes the Zem_Contact_Reborn [ZCR] API to allow the use of that robust plugin’s capabilities. You set up a ZCR form as you would any other [see the ZCR documentation for more on this]; the only difference between a regular contact form and a Postmaster form will be the name values you assign to particular fields in the form.

Here’s an example subscription form:

<txp:zem_contact to="youremail@yourwebsite.com" >
<txp:zem_contact_text name="zemSubscriberName" label="Your Name:" />
<txp:zem_contact_email name="zemSubscriberEmail" label="Your Email:" />
<txp:zem_contact_select list="default,test" selected="default" name="zemSubscriberLists" label="Your List:" />
<txp:zem_contact_text name="zemSubscriberCustom1" label="Your Favorite Color:" />
<txp:zem_contact_checkbox label="This is not Spam. " />
<txp:zem_contact_submit /> </txp:zem_contact>

This form will:

  • Send a subscription notice (ie, an email that so-and-so subscribed) to whatever email address you enter
  • Display fields for Subscriber Name, Email, and Favorite Color, a dropdown choice for what list to subscribe to, and a checkbox that is required as an anti-spam method
    The subscription form is truly customizable. Styling is carefully worked out by the folks over at ZCR — see the ZCR documentation .

I suggest reading the ZCR documentation thoroughly, and taking advantage of all the tag attributes you can.

Proper “name” values are important — the possibilities are:

  • name="zemSubscriberName"
  • name="zemSubscriberEmail"
  • name="zemSubscriberLists"
  • name="zemSubscriberCustom1"
  • name="zemSubscriberCustom2"
  • name="zemSubscriberCustom3"
  • name="zemSubscriberCustom4"
  • name="zemSubscriberCustom5"
  • name="zemSubscriberCustom6"
  • name="zemSubscriberCustom7"
  • name="zemSubscriberCustom8"
  • name="zemSubscriberCustom9"
  • name="zemSubscriberCustom10"
  • name="zemUnSubscribe"
  • name="zemDoSubscribe"

Back to the Table of Contents

Comment

Textile Help

Official Documentation for Postmaster (A Textpattern Plugin)

Get Postmaster

RELATED

REGULARS

DISCLAIMER

Postmaster is a plugin for Textpattern, and is licensed under the GNU GPL. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public Licens for more details.