Use Coranto with an SCForm Contact List
On this page... (hide)
Coranto is a Content Management Script available at:
It provides a web interface for creating and updating your website content.
SCForm is form mailer script that allows your list of contact e-mails to be hidden from e-mail harvesting robots. It is available at:
Since you can control the format that Coranto use to write its output files you can use Coranto to update this file. This means that you can update the e-mail addresses of the people on the contact list, add new contacts, or delete people from the list from just about anywhere you can access the internet.
I suggest getting SCForm functioning correctly before you build the interface with Coranto. Once you have it installed and running making it work with Coranto is simple.
SCForm uses a delimited text file to store your contact information. The file has three fields
- Menu Text
- E-Mail Address
They are stored separated by a colon. For example:
WebMaster: Web Master: email@example.com
Sales: Sales Dept.: firstname.lastname@example.org
both: Systems Admin.: email@example.com
This is a list of three contacts formatted for use by SCForm. The page with the contact form reads this file and displays the menu text as a drop down select list. The Key is used to tie the menu text to the e-mail address when the script that sends the e-mail is called upon submission of the form.
To use Coranto to maintain this list add three news fields.
Make them all one line text fields.
Define a style (we'll call it contacts) with this structure:
<Field: CustomField_FormKey>:<Field: CustomField_FormText>:<Field: CustomField_FormEmail>
Enter the style code on one line and be sure to press return at the end of the of the line. Then save the style.
Create a profile called Contacts and set the following options:
filename: contacts.cfg (this is the name SCForm Uses)
Set the path to the path where you put SCForm's contacts.cfg file when you installed it.
- Filter By Time
- Filter By Number
- Skip Days
- Skip Items
are all blank.
Select the news style we created earlier from the drop down list.
Enable Headlines - Should be set to NO
HTML Template - Should be set to none
Sort Order - can be set to your preference.
Anchor Tags - should be set to NO
Save the profile settings and then enable the profile.
If you are using XMS profiles to define profiles for submitting news make a new XMS profile for your contacts submission. Include the three custom fields you defined earlier and the standard subject field. Order them the way you want, save the profile, and enable it.
When submitting a contact fill out the three custom fields you made and then put a description of the contact in the subject field. The text in the subject field will show up on the modify news page. If you leave it blank you will have a bunch of blank entries on the modify news page, unless you are using an addon.
When your news is built your test contacts.cfg file will be overwritten by the file Coranto creates. Go to your contact form page and you should see the list of contacts you entered in Coranto.
SCForm also has a banlist. This can also be managed with Coranto. The banlist format is simply one entry per line.
Create a custom field such as:
write a style:
Making sure that you add a return at the end of the line and save it.
Following the steps above, create a profile that uses this style to create the banlist.cfg file used by SCForm in the same place you installed the file that came with SCForm.
- If you are going to use a banlist, read the SCForm documentation for this and make sure you understand it. You could accidentally ban people you don't intend to using the patterns available.
You should also look at the ShadowMail addon by Parahead.
- Originally published - November 13, 2003
- July 28, 2006
- Reformatted and published on this wiki
Discussion and comments for this article are in this forum thread.