A quick roll-your-own carnival submission form
Managing November 2nd, 2008
BlogCarnival.com has become an integral part of many blog carnivals. They were down for about a week with database maintenance. I know that this was probably quite hectic for them as well as for all of the carnival managers that depend on the features it brings to the table.
A reasonable backup plan to handle submissions is to post an e-mail address to send the submissions to, and ask for blog name, blog URL, post name, post URL, blogger name or screen name, and any remarks about the post. That covers most of the important things a host would need to put their carnival together.
This will work, but it can suffer from being a little bit too free-form. A better solution is to set up a submission form on the website with specific fields and with form validation. This requires a bit of scripting to pull off, but I found a great WordPress form generator that let me roll my own submission form for the Carnival of Debt Reduction. It’s the Secure PHP Form Mailer Script by Dagon Design.
Here’s what I did to put together the form you see here:
- I downloaded the script, unpacked it, uploaded it to my wp-content/plugins directory, and activated it. Standard plugin installation.
- I signed up for a Recaptcha account for my spam retarder. This gave me the two keys I needed for the plugin. I selected the Recaptcha option and entered the two keys in the Plugins -> DFFM-Main section in the Settings tab of my WordPress admin section.
- I edited the submit page and added the code <!– ddfm1 –> to that page where I wanted the form to appear.
- I clicked on the DFFM1 tab to customize the form. For what you see on that form, this is what I put in the Form Structure portion:
type=text|class=fmtext|label=Your Name|fieldname=fm_name|max=100|req=true
type=text|class=fmtext|label=Email|fieldname=fm_email|max=100|req=true|ver=email
type=text|class=fmtext|label=Blog Name|fieldname=fm_blog_name|max=100|req=true
type=text|class=fmtext|label=Blog URL|fieldname=fm_blog_url|max=100|req=true
type=text|class=fmtext|label=Post Title|fieldname=fm_post_title|max=100|req=true
type=text|class=fmtext|label=Post Permalink|fieldname=fm_permalink|max=100|req=true
type=text|class=fmtext|label=Post Trackback|fieldname=fm_trackback|max=100|req=false
type=verify|class=fmverify|label=Verify
type=textarea|class=fmtextarea|label=Remarks|fieldname=fm_remarks|max=1000|rows=6|req=false
- And here’s what I put into the Message Structure portion:
Someone has submitted a post to the Carnival of Debt Reduction!
Email: fm_email
Blog Name: fm_blog_name
Blog URL: fm_blog_url
Name/Nickname: fm_name
Post Title: fm_post_title
Post Permalink: fm_permalink
Post Trackback: fm_trackback
Remarks: fm_remarksThanks!
- Those two points above are what define it as a carnival submission form. I think the rest of the options on the form customization page are self-explanatory and they’re best learned just by playing with them.
- One slightly-tricky thing I did was to change the text in the button to “Submit” rather than the default. The fix is to change one of the identifiers in the lang/English.php file:
define(‘DDFM_SUBMITBUTTON’, ‘Submit’);
And that’s mostly it. This is a decent way to get a carnival submission form up and running on WordPress. Hope this helps you manage your carnival better!
