<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>BackgroundColor</key> <dict> <key>b</key> <string>1</string> <key>g</key> <string>1</string> <key>r</key> <string>1</string> </dict> <key>Columns</key> <array> <dict> <key>Identifier</key> <string>73e62b973f27fe9a2f800164</string> <key>MaximumWidth</key> <real>3.000000e+01</real> <key>MinimumWidth</key> <real>1.300000e+01</real> <key>OOPlainTextExportWidthKey</key> <integer>1</integer> <key>Title</key> <string></string> <key>Width</key> <real>1.300000e+01</real> </dict> <dict> <key>Identifier</key> <string>53972b983f27fe9a2f800164</string> <key>MaximumWidth</key> <real>1.000000e+06</real> <key>MinimumWidth</key> <real>1.300000e+01</real> <key>OOPlainTextExportWidthKey</key> <integer>72</integer> <key>Title</key> <string>Topic</string> <key>Width</key> <real>6.120000e+02</real> </dict> </array> <key>IsNoteExpanded</key> <true/> <key>NoteColumn</key> <string>73e62b973f27fe9a2f800164</string> <key>NoteHeight</key> <integer>162</integer> <key>Other Information</key> <dict> <key>Page Layout</key> <data> BAt0eXBlZHN0cmVhbYED6IQBQISEhAtOU1ByaW50SW5mbwGEhAhOU09iamVj dACFkoSEhBNOU011dGFibGVEaWN0aW9uYXJ5AISEDE5TRGljdGlvbmFyeQCU hAFpCJKEhIQITlNTdHJpbmcBlIQBKw5OU0JvdHRvbU1hcmdpboaShISECE5T TnVtYmVyAISEB05TVmFsdWUAlIQBKoSEAWadJIaShJmZFk5TSG9yaXpvbnRh bGx5Q2VudGVyZWSGkoSbnISEAXOeAIaShJmZDE5TTGVmdE1hcmdpboaShJuc nZ0khpKEmZkNTlNSaWdodE1hcmdpboaShJucnZ0khpKEmZkUTlNWZXJ0aWNh bFBhZ2luYXRpb26GkoSbnKCeAIaShJmZFE5TVmVydGljYWxseUNlbnRlcmVk hpKfkoSZmQtOU1RvcE1hcmdpboaShJucnZ0khpKEmZkVTlNIb3Jpem9uYWxQ YWdpbmF0aW9uhpKEm5ygngCGhoY= </data> <key>SpellCheckingEnabled</key> <true/> </dict> <key>OutlineColumn</key> <string>53972b983f27fe9a2f800164</string> <key>Root Item</key> <dict> <key>Children</key> <array> <dict> <key>Children</key> <array> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 The Form-To-Mail package is designed to work somewhat like formmail.pl - the user enters information into an HTML form on a page, and upon submitting the page the data is collected and emailed to an address of the administrator's choosing. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Form-to-Mail (FTM) is designed with reuse, and hopefully some security, in mind. Email addresses such as sender and recipient are configured by the administrator, stored in the database, and cannnot be overridden by form variables, which limits abuse of the form by third parties. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 FTM is designed to be included on other pages in the site, and provides a facility for adding custom form elements to the form, using a .tcl file that can be as simple or complex as the developer requires. The package uses a single instance to generate the included HTML form, and to process the submitted form. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Introduction }</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 Form-to-Mail is made up of two pages: form and form-proc. To add a mail form to your site, first mount an instance of Form-To-Mail under your site. The name of the instance doesn't really matter, but there should be only one instance and it would be good to name it something generic but that does not give away its purpose (i.e., naming it "Form-to-Mail" is likely to invite malcontents to try and abuse it). I like to use 'ftm'. }</string> </array> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf2 <div><img src="forms.jpg" alt="" width="571" height="177" border="1" align="bottom" /><br>Fig 1: The Form-to-Mail Admin page</div>}</string> </array> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 Visit /yoursite/<ftm-instance>/admin. (Replace <ftm-instance> with whatever you named your Form-to-Mail instance. }</string> </array> <key>Expanded</key> <true/> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Form Name:</b> a descriptive name you can remember. You'll use it when adding the form to your pages. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Subject Prefix:</b> a prefix, often of a form like "[name of form]", but can be whatever you want. The user will not see this, but it can help the recipient recognize and filter incoming mail from the form. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Subject Default:</b> this will be the default subject, and will appear in the subject form field when the user creates a new form. The user can replace this with whatever they want. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Show Subject: Yes/No</b> - Should the form show a subject field, or just use the default subject?}</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Show Comments: Yes/No</b> - Should the form show the comments textarea?}</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Recipient:</b> valid email address where the email from the form will be directed. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Sender:</b> email address with at least a valid domain which will be used as the "from" address in the email. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 <b>Confirmation:</b> Enter the Confirmation or Thank You message you would like to display to the user when the form is successfully submitted.}</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720 \f0\fs22 \cf2 <div><img src="addForm.jpg" alt="" width="458" height="523" border="1" align="bottom" /><br>Fig 2: Adding a form</div>}</string> </array> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 Add a new form, entering the information as requested: }</string> </array> <key>Expanded</key> <true/> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Getting Started }</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 On the page or template where you want the form to appear, include it like this: }</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Arial-ItalicMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\i\fs24 \cf0 <include src="/packages/form-to-mail/www/form" form_name="name of the form" extra_form_file="/path/to/file"> }</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Arial-ItalicMT;\f1\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\i\fs24 \cf0 src \f1\i0 : typical include src. Should always be "/packages/form-to-mail/www/form". }</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Arial-ItalicMT;\f1\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\i\fs24 \cf0 form_name \f1\i0 : This is the descriptive name you gave the form when creating it. This tells the form-to-mail package which default values to pull fromt he database, and later, which sender and recipient to use. }</string> </array> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720 \f0\fs22 \cf2 <div><img src="include.jpg" alt="" width="413" height="78" border="1" align="bottom" /><br>Fig 3: Including the form</div>}</string> </array> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Arial-ItalicMT;\f1\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\i\fs24 \cf0 extra_form_file \f1\i0 : Optional, this is a .tcl file containing at least a call to ad_form -extend, as documented below. }</string> </array> <key>Expanded</key> <true/> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Usage }</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 Form-to-Mail is designed to be extensible. The forms you create in the admin area can be used as is - subject and body (actually title and comments) fields will be generated for you. However, most developers will want to collect a variety of information from the form. FTM provides for this by taking a .tcl file as a parameter to the <include> tag and sourcing it when generating the form.}</string> </array> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fmodern\fcharset77 Courier;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 <pre>ad_form -extend -name mail_form -form \{\ \{ ftmx.field1:text ... \}\ \{ ftmx.field2:text(select) ... \}\ \}</pre>}</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf2 <div><img src="extra_form.jpg" alt="" width="324" height="168" border="1" align="bottom" /><br>Fig 4: The extra_form_file</div>}</string> </array> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 Create a .tcl file in your site somewhere. I usually name it after the form I'm extending, i.e. form_name_extra_form.tcl. In the file, you need at least one call to <code>ad_form -extend -name mail_form</code>, like this: }</string> </array> <key>Expanded</key> <true/> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 The form name, "mail_form", is the name of the form generated by the package and should not be changed. }</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 In the call to ad_form, your form elements should be named with "ftmx." as a prefix. This adds the form element to an array passed to the form processor, and makes sure that it gets added to the outgoing email. }</string> </array> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf2 <div><img src="moreInfoForm.jpg" alt="" width="458" height="234" border="1" align="bottom" /><br>Fig 5: The rendered form</div>}</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf2 <div><img src="thankYou.jpg" alt="" width="519" height="169" border="1" align="bottom" /><br>Fig 6: After submitting</div>}</string> </array> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;\red0\green0\blue0;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf2 <div><img src="email.jpg" alt="" width="313" height="137" border="1" align="bottom" /><br>Fig 7: The email</div>}</string> </array> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 ArialMT;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 You can use whatever techniques you want to generate your form elements. One popular technique might be to fetch a list of values from the database to create the options for a select input (drop-down list element). Another might be grabbing the url of the current page to pass as a hidden field and thereby sent with the email. }</string> </array> <key>Expanded</key> <true/> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Extra_form_file }</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Children</key> <array> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 I would be completely remiss if I did not thank the denizens of #openacs - especially daveb, jadeforrest, jim, jaufrec, michaels, talli, and til - for their help, encouragement, and patience with a complete n00b. }</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Acknowledgements}</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> <dict> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 #template "<p style='font-size:small; font-style:italic'>%text%</p>"}</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Form-to-Mail Package, Steve Ivy, <a href="mailto:steve@redmonk.net">steve@redmonk.net</a>, 2003}</string> </array> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fswiss\fcharset77 Helvetica;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs24 \cf0 #template "<html><head><title>%text%</title><head><body style='margin:10px 30px 10px 10px;'>%pTarget%<h2>%text%</h2>%children%<p style='font-size:small'>Last Modified: %modified%</p></body></html>"\ #template "%pTarget%<h3>%text% <span style='font-size:small'>%pLink%</span></h3>%children%"\ #template "<p>%text% <span style='font-size:small'></span><blockquote>%children%</blockquote></p>"\ #template "<p>%text%<br>%children%</p>"}</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl\f0\fnil\fcharset77 LucidaGrande;} {\colortbl;\red255\green255\blue255;} \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural \f0\fs22 \cf0 Form-To-Mail}</string> </array> <key>Expanded</key> <true/> <key>Style</key> <dict> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> </dict> </array> <key>Cols</key> <array> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> <string>{\rtf1\mac\ansicpg10000\cocoartf102 {\fonttbl} {\colortbl;\red255\green255\blue255;} }</string> </array> <key>Expanded</key> <true/> </dict> <key>StatusHidden</key> <string>Yes</string> <key>Styles</key> <array> <dict> <key>Heading</key> <dict> <key>type</key> <string>None</string> </dict> <key>ShouldAllowSorting</key> <true/> <key>TextColor</key> <dict> <key>b</key> <string>0</string> <key>g</key> <string>0</string> <key>r</key> <string>0</string> </dict> <key>TextFont</key> <dict> <key>name</key> <string>LucidaGrande</string> <key>size</key> <real>1.100000e+01</real> </dict> </dict> <dict> <key>Heading</key> <dict> <key>type</key> <string>None</string> </dict> <key>ShouldAllowSorting</key> <true/> </dict> <dict> <key>Heading</key> <dict> <key>type</key> <string>None</string> </dict> <key>ShouldAllowSorting</key> <true/> </dict> <dict> <key>Heading</key> <dict> <key>type</key> <string>None</string> </dict> <key>ShouldAllowSorting</key> <true/> </dict> <dict> <key>Heading</key> <dict> <key>type</key> <string>None</string> </dict> <key>ShouldAllowSorting</key> <true/> </dict> </array> <key>Version</key> <integer>6</integer> </dict> </plist>