Dagon Design

Scheduled Post Shift Plugin for WordPress

Admin — Mon, 28 Apr 2008 01:16:11 +0000

This plugin automatically takes your oldest post, and updates its timestamp so that it appears as the latest post on your WordPress site. It does this by utilizing the cron feature built into WordPress 2.1 (and newer). It can rotate all the posts on your site, or just ones in a specific category. You can currently schedule it by setting the number of hours between shifts. For example, set it to 24 hours and it will shift the oldest post every day, at the time that you enabled it.

Download

Latest Release (For WordPress 2.1 through 2.5)

Instructions

Download the above file, rename it from .txt to .php, and upload it to your plugins directory
Enable the plugin
Configure the plugin options (under DDPostShift)
Click the ‘Enable Post Shift’ button to start

Disabling the Schedule

To stop the schedule, simply click the ‘Disable Post Shift’ button on the options page.

Change Log

04-27-08 Version 1.21 - Updated for WordPress 2.5 and to be compatible with WP Security Scan plugin
09-29-07 Version 1.2 - Updated for WordPress 2.3
05-16-07 Version 1.1 - Updated for WordPress 2.2
04-09-07 Version 1.0 - First release

Options

Here are the options available in this plugin’s options page in the WordPress admin panel.

Shift Delay

This is the number of hours between post shifts. The schedule will start as soon as you click the ‘Enable Post Shift’ button.

Category ID

If left blank, the plugin will operate on all of your posts. If you enter a category ID, it will only update posts in that category.

Draft Notification Plugin for WordPress

Admin — Sun, 27 Apr 2008 23:05:56 +0000

This WordPress plugin automatically emails the admin when a new draft is saved. The email contains the post’s title, the author, and a link. There is no options page currently, because there is really nothing to configure. The plugin now supports the new ‘pending’ status.

Download

Latest Release (For WordPress 2.0 through 2.5)

Instructions

Download the above file, rename it from .txt to .php, and upload it to your plugins directory.
Enable the plugin.

Change Log

04-27-08 Version 1.21 - Updated to work with WordPress 2.5 and the ‘pending’ status.
05-16-07 Version 1.2 - Updated to work with WordPress 2.2.
10-20-06 Version 1.1 - The emails now contain the author’s name, instead of ID.
04-22-06 Version 1.0 - First release.

Notes

Because of the way this plugin works, it also sends out an email when an existing draft has been saved again. There does not seem to be an efficient way to check to see if it is the first time the draft has been saved, since dates are not stored for drafts.

By default, the author’s display_name is shown in the email. If you would prefer to see the login_name, or nice_name field, just look for the line in the script that says “Choose one of the following options to show the author’s name” and uncomment the option you would like to use.

Modifications

If you would rather have the email notification sent to the author of the post, instead of the admin, replace this line:

$recipient = get_bloginfo('admin_email');

With this:

$recipient = get_the_author_email();

Sitemap Generator Plugin for Wordpress

Admin — Sat, 26 Apr 2008 19:11:05 +0000

This plugin creates a sitemap for your WordPress powered site. This is not just another XML sitemap plugin, but rather a true sitemap generator which is highly customizable from its own options page in the WordPress admin panel. Some of its features include: support for multi-level categories and pages, category/page exclusion, multiple-page generation with navigation, permalink support, choose what to display, what order to list items in, show comment counts and/or post dates, and much more. To see this plugin in action, visit my sitemap page.

Download

Latest Release
(For WordPress 2.1 through 2.5)
Version 2.7
(No Longer Supported! - For WordPress 2.0)

Languages

The latest version of this plugin includes complete support for language files. If you would like to submit a translation, please contact me. You can choose the language from the options page.

Current languages: English, Albanian, Brazilian-Portuguese, Bulgarian, Czech, Dutch, French, German, Italian, Japanese, Lithuanian, Polish, Romanian, Russian, Simplified Chinese, Slovene, Spanish, Swedish, Turkish, Ukrainian

The language file contains not only the text shown on the sitemap page, but all of the text in the options page as well.

Changelog

04-26-08 Version 3.13 - The plugin has been tested and works in WP 2.5. Added language files: Lithuanian, Romanian, Italian, Ukranian, and updated Spanish. Updated for compatibility with the WP Security Scan Plugin (thanks Michael). Undefined offset errors should be gone now. Updated the code that displays post/page titles. Fixed issue where comment counts showed on new lines.
09-26-07 Version 3.12 - Instead of having separate plugin versions for pre and post WP2.3, this version handles everything from WP 2.1 to 2.3. There is a separate download for those using WP 2.0. A bug was also fixed that caused posts to be duplicated in 2.3.
09-22-07 Version 3.11 - Bug fixed - categories were not showing up if they had a parent category with no posts.
09-20-07 Version 3.1 - Now supports WordPress 2.3. Added Czech, Russian, and (updated) French language files.
07-27-07 - Not a version update - added Albanian, Bulgarian, Swedish, and Turkish language files.
07-08-07 Version 3.07 - Post titles with html formatting should now show up properly in the sitemap. Slovene language file added.
06-22-07 Version 3.06 - Updated to display sub-categories (with posts), even when parent category has no posts.
06-20-07 Version 3.05 - Ampersands (in titles) issue fixed.
06-18-07 - Not a version update - added French and Brazilian-Portuguese language files.
05-31-07 Version 3.04 - Better support for international date formatting added (using the date_i18n function). Option to limit multi-cat posts to one cat removed for now due to incompatibility issues. Spanish and Polish language files added.
05-17-07 Version 3.03 - Parse error bug fixed. Non-published (draft) pages now hidden.
05-16-07 Version 3.02 - Updated to work with WordPress 2.2. Drafts no longer appear in the sitemap. Added new languages: Simplified Chinese, Dutch, and Japanese.
05-09-07 Version 3.01 - Bug fixed with future post check. German language file added.
05-03-07 Version 3.0 - This is a very big update. Most of the plugin has been rewritten from the ground up. Many things have been fixed, several new features have been added, and it runs much faster than before. Be sure to read the updated information below.
03-24-07 Version 2.73 - Sitemap page navigation will no longer show ‘/1/’ in the URL for the first page. The same method has also been applied for those not using permalinks.
02-09-07 Version 2.72 - Fixed a compatibility issue with this plugin and some of my others.
01-25-07 Version 2.71 - Fixed bug when used with WordPress 2.1
09-17-06 Version 2.7 - You can choose to show excerpts even when a post or page title exists. They settings are now independent.
04-02-06 Version 2.6 - The page and category exclusion lists are no longer case-sensitive. An issue has also been fixed for excluded categories that have non-excluded sub-categories. They now show up properly. Lastly, an issue was fixed where sites with more than 10,000 posts were having problems generating the sitemap.
03-23-06 Version 2.5 - Lots of optimizations, runs much faster. Can now exclude pages (and subpages). Options page completely redone. All visible text is an option (under Language Settings). Comment count only counts approved comments.
03-21-06 Version 2.4.2 - Some minor code adjustments. Works properly when the Google Analytics plugin by boakes.org is enabled.
03-18-06 Version 2.4.1 - Several minor issues fixed. Rewrite code greatly improved. Added option to change ‘continued text’. Can now generate sitemap on error pages.
03-14-06 Version 2.4 - Several requested features added: Choose to show everything, or just posts or pages. Can show publish date for posts (and configure the date/time format). Added ability to exclude categories. Option to open links in new windows
02-16-06 Version 2.3.1 - Fixed uploads/attachments showing up in sitemap.Fixed small bug when sorting pages by title.
01-23-06 Version 2.3 - Permalink support for navigation added! (read permalink section below for more info)
01-22-06 Version 2.2.1 - Option to hide password-protected items. Fixed navigation bug (when Wordpress was in sub-folder).
01-21-06 Version 2.2 - Rewritten again! - Handles multi-level categories and pages. Continuation of previous posts/pages shown. Customizable text for category pages. Separate sort orders for posts and pages. CSS added for easy customization. Always hides drafts and future-dated posts now (there’s no reason not to). Multi-category posts handled much better. ‘Breadcrumb trail’ for sub-categories. For posts without titles - display ‘(no title)’, first X characters, or first X words. And many other fixes/updates.
01-14-06 Version 2.0 - Rewritten completely, and turned into a plugin
01-15-06 Version 2.1 - New features and various fixes: -
Handles custom table prefixes. Fade effect upon submitting options (for WP 2.0 users). Option to display posts or pages first. For posts without titles, choose to ignore, use “(no title)”, or first few words of text. Place sitemap navigation at the top, bottom, or both.
01-14-06 Version 2.0 - Rewritten completely, and turned into a plugin
12-08-05 - Original (non-plugin) version 1.0

Installation

Download sitemap-generator.zip and uncompress
Upload the entire sitemap-generator folder (not just the files inside) to your plugins directory
Activate the plugin in your administration panel
Configure the plugin in the options panel (under DDSitemapGen)
If using permalinks, read the permalink section below
Simply add the following line to a WordPress page (where you would like the sitemap to display):
Note: For those of you using the new rich-text editor - be sure to click the ‘html’ button to edit the page source directly. Otherwise Wordpress will wrap code tags around the line which generates the sitemap and it will not work properly.

Upgrading?

To upgrade, disable and then delete the existing plugin. Then install the new version as explained above.

After you install, be sure to click the ‘Load Default Options’ button, as some of the settings have changed.

Version 3.0 of this plugin is a big jump from the previous versions. Most of the code has been rewritten from scratch, and a few things are different. One of the best improvements is the speed and stability. The sitemap generation is much faster now, which should especially help people with larger sites. Be sure to read the updated information below.

Want to run the plugin from a template file?

To use the sitemap generator function directly from a template file, just insert the following line where you would like the sitemap to be generated:

Permalinks for sitemap navigation

Depending on your settings, the sitemap may be spread across multiple pages. If you are using permalinks, be sure to enter the page slug of your sitemap page in the plugin options. That way it will use permalinks for the sitemap navigation as well. If you are not using permalinks, simply leave this option blank.

CSS declarations

This plugin has a couple of CSS classes built in to easily change the look of your sitemap. Just add the new declarations to your themes CSS file, and customize it however you like.

.ddsg-wrapper - Div around the entire sitemap.
.ddsg-pagenav - Div around the page navigation.

Available Options

These options can be configured from the options page in the WordPress admin panel. Most of these are fairly self-explanatory.

General Options

Language - Language files are located in /wp-content/plugins/sitemap-generator/lang/
Items per page - Set to 0 for unlimited
Sitemap page slug - If using permalinks, enter the slug of your sitemap page

Sitemap Generation

What to show - Show posts, pages, or both
If showing both, which first - Show posts or pages first
Post sort order - Sort by title or date (oldest or newest first)
Page sort order - Sort by title or date (oldest or newest first) or menu order (ascending or descending)
Show comment count after posts
Show comment count after pages
If showing comment counts, display when zero
Show dates after posts
Show dates after pages
Date format (if showing dates) - Use PHP date() formatting

Exclusions

Excluded categories - Category IDs, separated by commas. Sub-categories will also be excluded, as well as all posts contained in excluded categories
Excluded pages - Page IDs, separated by commas. Sub-pages will also be excluded
Hide future-dated posts
Hide password-protected items

Navigation

Sitemap navigation method - Two types to choose from
Show sitemap navigation - Where to show the navigation

Miscellaneous

Full path to XML sitemap - If you are also using an XML sitemap plugin, you can enter the path to the XML file here, and a link to it will be added to your sitemap page
Where to show XML sitemap link - At the end of the last page, or at the end of every page

Interstitial Ads Plugin for WordPress

Admin — Mon, 21 Apr 2008 23:39:50 +0000

This plugin allows you to automatically add javascript (or anything else) to all links on your WordPress site. One common use for this is the implementation of interstitial ads, which require javascript to be added to each link, although there are many other possible uses.

Download

Latest Release (For WordPress 2.0 through 2.5)

Installation

Download the above file
Rename dd-interstitial.txt from .txt to .php and upload it to your plugins directory
Activate the plugin from the WordPress admin panel
Configure the options under the admin panel: Options - DDInterAds

Usage

To use this plugin, simply go to the options page and enter the code you want added to all links.

Change Log

04-21-08 Version 1.1 - Code is now ignored if it is in code, pre, or textarea blocks.
05-23-07 Version 1.0 - First release.

Notes

For those of you using this plugin to add interstitial ads, often times you must also add some javascript (provided by the advertiser) to the header of your files. You can do this in the header.php file in your theme directory.

This plugin uses the ob_start function for output buffering to allow filtering of the entire page before display. While this generally works without any problems, certain plugins may conflict with this - especially if they are using a similar method. Keep this in mind when troubleshooting.

Lastly - Future options may be added depending on interest in the plugin.

Prevent author impersonation in WordPress comments

Admin — Sat, 05 Apr 2008 22:22:02 +0000

This modification to WordPress prevents unregistered comment authors from using the names or email addresses of the registered authors on your site. It does this by first checking to see if the comment author is logged in. If they are not, it compares their name and email address to the registered author data. If there is a match, the comment is blocked and a custom message is displayed. The name and email address comparison is case-insensitive.

Requirements

This code modification has been tested in WordPress 2.2 through 2.5.

Instructions

1) Open /wp-comments-post.php for editing (backup the file first!)

2) Find the following block of code:

$comment_author       = trim(strip_tags($_POST['author']));
$comment_author_email = trim($_POST['email']);
$comment_author_url   = trim($_POST['url']);
$comment_content      = trim($_POST['comment']);

3) After it, add the following:

// get list of user (display) names for blog
global $wpdb;
$valid_users = (array)$wpdb->get_results("
  SELECT display_name, user_email FROM " . $wpdb->prefix . "users");

// get ID of logged in user (if there is one)
global $userdata;
get_currentuserinfo();
$logged_in_name = $userdata->ID;
$logged_in_email = $userdata->user_email;
 
// see if the comment author matches an existing author
$found_match = FALSE;
foreach ($valid_users as $va) {
  if (trim($va->display_name) != '') {
    if (strtolower($va->display_name) == strtolower($comment_author)) {
      $found_match = TRUE;
      break;
    }
  }
  if (trim($va->user_email) != '') {
    if (strtolower($va->user_email) == strtolower($comment_author_email)) {
      $found_match = TRUE;
      break;
    }
  }  
}

// if commenter is not logged in, but match was found, block the comment
if (trim($logged_in_name) == '') {
  if ($found_match == TRUE) {
    wp_die( __('You cannot post using the name or email of a registered author.') );
  }
}

4) Save and close the file

Notes

To test this modification, simply log out and try to post a comment using the name that displays when you regularly post comments (when you are logged in).

If you would like to change the message, just modify this line:

wp_die( __('You cannot post using the name or email of a registered author.') );

Secure PHP Form Mailer Script

Admin — Sun, 25 Nov 2007 21:31:49 +0000

This is the PHP version of my secure form mailer script. This script has a wide range of features including: an easy to use dynamic form generation system (any number of fields, in any order), multiple recipients, multiple file attachments, optional auto reply feature, an image verification system, numerous security features (including protection against email header injection), a message template system, multiple languages, and too many other things to list. This script was designed to be easy to use, while still being extremely flexible. If you just want a simple contact form, you can set one up with just a few clicks. For those of you who need something a bit more advanced, you can completely customize script plugin to fit your needs - whether it is 5 fields or 500. A WordPress plugin version is also available. ReCaptcha support has also been added.

You can see a very basic implementation of the WordPress plugin version of this script on this site’s contact page.

Notice: WordPress Users

Information on the WordPress plugin version of this script

Languages

As of the latest release, this script contains language files for:

English, Brazilian Portuguese, Catalan, Danish, Dutch, Finnish, French, German, Greek, Italian, Norwegian BokmÃ¥l, Polish, Portuguese, Romanian, Russian, Slovak, Slovene, Spanish, Swedish, Turkish

If you would like to submit a language file please contact me.

WordPress vs PHP Versions

To make things easier to find, the two versions of this script share much of the same documentation. While the basic features are the same, there are several differences, so be sure to reference the proper page.

Due to the size of this page, I have split everything up into sections:

Download
Changelog
Installation
Required Configuration
Other Configuration Options
Other Customizations
Usage
Advanced Recipient Options
Advanced Form Structure
Manual Form Code
Auto Reply Feature
Other Modifications
Troubleshooting
Comments

Download

Latest Release

Changelog

Since both the WordPress and non-WordPress versions of this script are updated together, the changelog below reflects both versions.

11-25-07 - v5.4 Added support for ReCaptcha, manual form code entry, 5 new languages (Catalan, Danish, Polish, Romanian, and Turkisk), several html and css tweaks, and other misc. updates.
07-27-07 v5.33 - Few minor bugs fixed. Finnish language file added.
07-08-07 v5.32 - Error messages affecting form alignment issue resolved. Italian and Slovak language files added.
06-18-07 v5.3 - ‘undefined index’ errors fixed, image verification adjustments, p tags removed from fieldsets, changes to help html validity, various other fixes.
05-09-07 v5.25 - ‘Thank you’ message now allows for form field inputs as well.
05-08-07 v5.24 - Auto-reply message now allows for form field inputs. Language selection issue resolved. str_replace errors (on certain servers) fixed. Norwegian BokmÃ¥l language file added.
05-01-07 - Not a version update. Greek and Swedish language files added.
04-18-07 v5.23 - Renamed email verification function (to fix conflicts with other scripts). The GD check is now disabled if you are not using image verification. Added two new language files - Portuguese and Russian.
04-18-07 - Not a version update. Brazilian Portuguese language file has been added.
04-03-07 v5.22 - Email generation code has been modified to try to work with more servers. French language file has also been updated.
03-28-07 v5.21 - Highly recommended update - Fixed an issue with the verification code not being handled properly. Nothing else has been changed.
03-25-07 v5.2 - Email generation improved - should work better in more email clients. Many issues with message generation and field types have been fixed. Better support added for field requirement options. CSS for various fields updated. Issue with submit button fixed. Dutch and French language files added. Checkbox and drop-down issues resolved. Email verification method improved. Undefined index errors fixed, and much more. Be sure to read the updated instructions for the field types.
03-13-07 v5.1 - Lots of updates: Slash escaping has been improved, p tags are now added around form elements, each form instance can have its own language setting, the language selection issue has been fixed, improved foreign character support in messages, check box handling improved, and a new optional auto reply feature has been added.
02-06-07 v5.0 - This is a major update from version 4, and because of this, I have completely re-written this page, and removed the old changelog to save space.

Installation

1) Download and uncompress dd-formmailer.zip
2) Upload the entire dd-formmailer directory to your server
4) Configure your options (explained below)
5) Add the form to your page (explained below)

Required Configuration

While this script is highly configurable, some of you may just want to get up and running quickly with a simple (and secure) contact form. If so, these are the minimum options you need to configure within the file:

Standalone Option

$standalone - If you plan to use this script by itself (not included from another PHP file), set this option to TRUE, and it will generate a proper html header and footer. If you want to change the basic header and footer, they are found near the bottom of this script.

Path to CSS

$path_to_css - If you are using the standalone option, enter the relative path to your CSS file so it can be declared properly in the header. For those of you including this script in another PHP file, be sure to manually add the CSS declaration in the header section of your page, like this:

Language Setting

$language - The relative path to the language file you want to use.

Full URL to Script

$script_path - The full URL to dd-formmailer.php (or whatever you have renamed it to)

Full URL to Contact Page

$path_contact_page - If you are running this script in standalone mode, leave this blank. Otherwise, enter the full URL to the page that is displaying the form

Recipient Data

$recipients - If you are just sending email to a single address, enter it here. For more advanced usage such as multiple recipients, CC, BCC, etc.. more information is below

The other settings are optional, and are explained below.

Other Configuration Options

This is a listing of the other configurable options in the script. These are optional, but allow for much greater customization

Form Structure - This is where you define the fields that will be used on this form. There are a lot of options available for this, and they will be explained further down as well

Manual Form Code - This is a very advanced option that has its own section on this page.

Wrap messages - This option wraps message lines to 70 characters to comply with RFC specifications

Show required - If enabled, required fields will be marked with an asterisk

Show IP and Hostname - If enabled, the visitor’s IP and hostname are added to the message

Special Fields - Sender name, Sender email, and Email subject - These options help generate the email headers. If you enter a field name, it will be replaced by user input from that field. For example, if you have a form field called fm_name and you use that as the Sender name option, the visitor’s name will be used as the From field in the email. You can also combine them. If you have a field called fm_firstname and fm_lastname you could enter ‘fm_lastname, fm_firstname’ - For the Sender email option, just use your email field

Max upload size - This allows you to set the maximum file size (in bytes) for attachment uploads. This option only applies if the setting is lower than the value already set in your php.ini file

Message Structure - This feature is optional. If left blank, the script will generate the email message itself, which will include all the data the visitor submits. If you choose to use this option, it will act as the message template. Simply enter your custom text, including your field names. When the message is generated, the field names will be replaced by the user input from those fields. Note: Since the script will just do a search and replace for field names, be sure they are unique enough. Example: A check for fm_message2 would also get triggered by fm_message when the script adds in the input.

Success Message - This is the text that is shown after the email has been sent. You can also use field names in this, and the user input from those fields will be used to generate the message.

Auto Reply - This is an optional feature that allows you to automatically send a pre-defined message back to those who contact you. More information on this is below

Image Verification Method - There are three choices for image verification. It can be disabled, you can use the script’s built-in system (a simple captcha - requires GD support on the server), or you can use the ReCaptcha system (requires signing up for a free account at recaptcha.net)

Basic Method Options - If using the basic image verification method, you can choose the text and background color for the image (3 or 6 digit hex codes). By default, the script will try and choose the best file format for the verification image, but if it gives you any problems, you can manually specify the format to see what works best for your server.

ReCaptcha Method Options - If using the ReCaptcha image verification method, you must enter the public and private keys given to you at the ReCaptcha website. These are used to generate the verification form, and the keys are specific to the website under your account (meaning if you use this script on multiple sites, you need a set of keys for each).

Other Customizations

With the exception of the text defined in the options, all text visible to the visitor is contained within the language file.

Visual changes to the form can be made in the included CSS file. The class names used in the examples below already exist within the CSS.

Usage

If you are using the standalone option, all you have to do is open the URL to the script file in your browser.

If you are not using the standalone option, you can include the script in your existing PHP file with the following code:

Be sure to use the relative path to the script file.

Advanced Recipient Options

As mentioned above, if you want to send the messages to a single recipient, just enter the email address in the recipients option. To send to multiple recipients, separate the addresses with a | (pipe) character, and use one of the following prefixes for each: to= cc= bcc=

Examples:

to=user1@domain.com|to=user2@domain.com
to=user1@domain.com|cc=user2@domain.com
to=user1@domain.com|cc=user2@domain.com|bcc=user3@domain.com

You can have as many of each type (to, cc, bcc) as you like, and they can be in any order, although the first one in the list is the always the primary recipient, and must use to=

For those of you who want to let the vistor choose the recipient from a drop-down box, first you must enter selrecip in the recipients field. Then you must add a new line in the form structure box. Example:

type=selrecip|class=fmselect|label=Recipient|data=(select),
User1,user1@domain.com,User2,user2@domain.com

The type must be selrecip, but you can use whatever you like as the CSS class, and label. The first item in the data parameter is the default (unselected) option. After that are the names and email addresses. You can add in as many as you like - just keep them in the proper order (name,email,name,email,etc..). Only the names are visible within the HTML for privacy reasons.

The ‘(select)’ item is the default selection, which the user must change to submit the form. You can change the ‘(select)’ text if you choose.

Advanced Form Structure

This script uses a dynamic form generation system, which means that by simply adding a new line to the form structure, you will have a new field in your form. You can have as many fields as you like, and in any order. The only field type that you must absolutely have is the verify field if you are using the image verification option. All of the fields are explained below, with examples. Separate each field type with a single newline in the form structure option. (Some of the examples below are bit long, so they are wrapped to the next line - be sure that the only newlines are after each field type when adding them to your form structure.)

These are the different parameters that apply to most of the field types (Special exceptions and parameters unique to a particular field are listed under each field type):

type - This tells the script what type of field you are adding.
class - The CSS class used to style the field. The classes used in the examples below already exist in the CSS file.
label - Text that is shown next to the field.
fieldname - The name of the form field (must be unique).
max - Maximum number of characters allowed.
req - (OPTIONAL) If you want to require a field, set this to true. If not, do not add it.
default - (OPTIONAL) This allows you to specify the default value of a field.

TEXT

This is a standard text input field.

type=text|class=|label=|fieldname=|max=|[req=true]|[ver=]|[default=]

The text field type has a special parameter - ver - which can be used to verify the input. You can choose email (which checks that the input is a proper email address) or url (which checks that the input is not only a proper URL, but that it actually exists). If you do not want to use either validation option, do not add this parameter.

Examples:

type=text|class=fmtext|label=Name|fieldname=fm_name|max=100|req=true 

type=text|class=fmtext|label=Age|fieldname=fm_age|max=100|
default=Enter your age! 

type=text|class=fmtext|label=Email|fieldname=fm_email|max=100|req=true|
ver=email 

type=text|class=fmtext|label=URL|fieldname=fm_url|max=100|ver=url

PASSWORD

This is a standard password field. It is exactly like a text field, except it shows asterisks when the user types.

type=password|class=|label=|fieldname=|max=|[req=true]|[confirm=true]

The password field type also has a special parameter - confirm - which if set to true, it duplicates the password field, so that the visitor has to confirm their input. If you do not want to use this, do not add the confirm parameter.

Examples:

type=password|class=fmtext|label=Password|fieldname=fm_pass|max=100|
req=true|confirm=true
 
type=password|class=fmtext|label=Secret Word|fieldname=fm_secret|max=100

TEXTAREA

This is a standard text area, for multiple lines of text.

type=textarea|class=|label=|fieldname=|max=|rows=|[req=true]|[default=]

The textarea field type has a special parameter - rows which defines the number of rows in the field (required for valid html).

Examples:

type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|
max=1000|rows=6
 
type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|max=1000|
rows=4|req=true
 
type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|max=1000|
rows=10|req=true|default=Type here!

WIDETEXTAREA

This is exactly the same as the standard textarea, except that it’s wider, and the label is above it instead of to the side.

type=widetextarea|class=|label=|fieldname=|max=|rows=|[req=true]|[default=]

Example:

type=widetextarea|class=fmtextwide|label=Message|fieldname=fm_message|
max=1000|rows=10|req=true

* Note that the normal textarea, and wide textarea fields use a different CSS class for formatting.

VERIFY

This field is required if you are using the basic verification method. It does not apply if you are using the ReCaptcha method. It is used for placement of the verification image (and associated text box) in the form.

type=verify|class=|label=

Example:

type=verify|class=fmverify|label=Verify

FULLBLOCK and HALFBLOCK

These are not standard form fields, but simply a way you can add text to your form. The full block is as wide as a wide textarea, while the half block is aligned with other standard fields. You can use basic HTML in your text if you like.

type=fullblock|class=|text=
type=halfblock|class=|text=

Examples:

type=fullblock|class=fmfullblock|text=This could be some sort of 
introduction message.
 
type=halfblock|class=fmhalfblock|text=This could be used to explain a field 
in greater depth.

OPENFIELDSET and CLOSEFIELDSET

These do just what the name implies - they open and close a fieldset in your form so you can help group fields together. It also allows you to specify a legend for the fieldset (required for valid HTML).

type=openfieldset|legend=
type=closefieldset

Examples:

type=openfieldset|legend=Your Information
 
(other field would go between these)
 
type=closefieldset

CHECKBOX

The checkbox field can be used to generate a single checkbox, or a group of them. The usage is a bit different than the other fields.

type=checkbox|class=|label=|data=
(fieldname),(text),(checked),(REQUIRED),
(fieldname),(text),(CHECKED),(REQUIRED)...

As you can see, the checkbox data is a comma separated list of four items per checkbox:

fieldname - A unique fieldname for each checkbox in the form.
text - The text shown to the right of each checkbox.
checked - true or false. This allows you to make checkboxes checked by default.
required - true or false. If true, it means that the user must check the box to send the message. Mainly useful for ‘check here to agree’ type situations.

Examples

type=checkbox|class=fmcheck|label=I Agree|data=fm_agree,I agree to the 
terms,false,true
 
type=checkbox|class=fmcheck|label=Interests|data=fm_i1,Computers,false,
false,fm_i2,Art,false,false,fm_i3,Music,false,false

RADIO

This field generates a group of radio buttons. Radio buttons are similar to checkboxes, except that they are treated as a group, and only one option may be selected.

type=radio|class=|label=|fieldname=|[req=true]|[default=]|data=(text),(text),
(text)...

The req and default items are optional. req, if set to true, makes the field required. default can be set to the option number you want to be selected by default (starting at 1).

Examples:

type=radio|class=fmradio|label=Gender|fieldname=fm_gender|data=Male,Female
 
type=radio|class=fmradio|label=Color|fieldname=fm_color|req=true|default=1|
data=Unspecified,Red,Green,Blue

SELECT

The select field generates either a standard drop-down box, or a multi-select box, depending on the multi option. Option groups are supported as well.

type=select|class=|label=|fieldname=|[multi=true]|[req=true]|data=(#group),
(text),(text),(#group),(text)...

The multi and req options are optional.

If the field is required, the first option you have in the data paramater will be the default, which tells the user they need to select one of the options. If they do not change the default option, and it is required, they will receive an error.

The data field is just a list of the options, separated by a comma. To define the start of an option group, just prefix the group name with a # as shown below.

Examples:

type=select|class=fmselect|label=Age|fieldname=fm_age|req=true|
data=(select),0-30,31-60,61-90,91-120
 
type=select|class=fmselect|label=Colors|fieldname=fm_colors|
multi=true|req=true|data=(select),Red,Green,Blue
 
type=select|class=fmselect|label=Choose|fieldname=fm_choose|
data=#Category1,item1,item2,#Category2,item3,item4

FILE

The file field generates a file upload box. As with all other fields, you can add as many of these as you like, as this script supports not only attachments, but multiple attachments. The only thing to keep in mind is that you may need to find out the limit your server has set for file upload sizes.

type=file|class=|label=|fieldname=|[req=true]|[allowed=1,2,3]

The allowed field is optional, and lets you define a (comma separated) list of file extensions that are allowed to be uploaded. Otherwise, all file types will be allowed.

Examples:

type=file|class=fmfile|label=Upload|fieldname=fm_upload
 
type=file|class=fmfile|label=Upload|fieldname=fm_upload|req=true|
allowed=jpg,jpeg,gif,png

Manual Form Code

This feature allows you to manually specify the code used to generate your form. By default, this script uses the form structure information to dynamically generate the form. While this makes it easier for most people, since they do not have to write any code, it can limit those who need a bit more flexibility in their form structure.

Notice: Usage of this feature is a bit tricky. If you do not have a good amount of experience with html forms and CSS, I do not recommend attempting it.

1) Customize your form using the ‘Form Structure’ option as you would normally - this is required even when using the manual code entry, as it allows for processing of the form.
2) Be sure you have all your options exactly as you want them, and view your newly created form page.
3) View the source of the page, so you can copy the generated html. The code you need is between the following lines:
4) You can now customize this form code however you like, as long as the core elements of the form and fields are still in place.
5) Enter your new code into the ‘Manual Form Code’ option. (PHP VERSION NOTICE: Depending on your form code, you may have to ‘escape’ single or double quotes, as you are assigning this code as a string value to the $manual_form_code option!)
6) If everything worked properly, your page will now use the custom form code. Once again, the standard form structure option is still required, as it is still for processing of the form.

You can also adjust the included CSS file to better fit your needs, or completely clear it out and manually create an entire new CSS structure for your task. Keep in mind that if you change any field items (or any options which affect the form code generation), you will have to repeat this process.

To disable the manual form code feature, just clear out the option for it.

Auto Reply Feature

The options page for each instance includes fields to define an auto reply message. This is a pre-defined message that is sent back to the visitor.

To use this option, simply enter the name, email address, subject line, and message for your auto response. To disable this feature, just leave the message field blank.

You can also use field names in the auto reply message, and the user input from those fields will be used to generate the message.

Other modifications

Redirect after form submission - Method 1

It is possible to use Javascript to redirect the user after the form has been filled out. While this method is not 100% valid (Javascript redirection should go in the HEAD section of the page), it works. To add this feature, first find the following line in the script:

$o .= $sent_message;

And replace it with this:

$o .= '';

(where mysite.com is the URL you want to redirect to)

Redirect after form submission - Method 2

This is another method you can use to redirect the user after the form has been submitted. First, find this line:

$o .= $sent_message;

And after it, add this:

$o .= '';

Where ‘4′ is the number of seconds to wait before refresh, and the ‘http://www.mysite.com/’ is the URL you want to redirect to.

Passing values to the form

To allow values to be passed directly to the form, all you have to do is change all references of $_POST to $_REQUEST (The REQUEST superglobal contains the values of both POST and GET items)

Prevent form data from being resubmitted upon refresh

This feature is included in the WordPress plugin version, but not in the PHP version, because of how it has to be used. To enable the feature when using the script in standalone mode, add the following code after the PHP declaration at the top of the script:

if (count($_POST) > 0) {
  $lastpost = isset($_COOKIE['lastpost']) ? $_COOKIE['lastpost'] : '';
  if ($lastpost != md5(serialize($_POST))) {
    setcookie('lastpost', md5(serialize($_POST)));
    $_POST['_REPEATED'] = 0;
  } else {
    $_POST['_REPEATED'] = 1;
  }
}

If you are not using the standalone option, you must add that code at the very top of the PHP file you are calling the script from. Add PHP tags around it if needed. Just make sure there is no extra whitespace around the PHP tags.

Modifying the script to use HII for image verification

Miro has posted instructions for users wanting to use HII: Read the comment. Notice: Modifications listed in the comments may not apply for new versions of the script.

Using SELRECIP and BCC together

The easiest way to do this, is to find the following line in the script:

$send_status = mail($send_to, $email_subject, $msg, $headers);

If you are using SELRECIP, the message will be sent to whoever the visitor chooses. If you would also like the message to go to someone else, no matter who is chosen, just duplicate that line like so, adding in the address of the secondary recipient:

$send_status = mail("user2@domain.com", $email_subject, $msg, $headers);

Troubleshooting

Verification image not showing up

The first thing to do is check to make sure your paths are set correctly in the options.

This script automatically chooses the best file type to generate the verification image. If your verification image is not displaying, the problem could be that your server will not properly generate that type of file. You can manually set this using the ‘Force image type’ option in the script. It allows you to manually specify jpeg, gif, or png.

Try all the options to see which works best for you.

Problems sending email

The most common question I receive is ‘Why am I not receiving email from the script?’

There are many reasons this can happen. The first thing to do is make sure you have access to the PHP mail function on your web server, and that there are no restrictions in place that might prevent certain features of this script from working. If you are not sure, please ask your host for information. Unfortunately, I am not able to spend the time troubleshooting general server issues for everyone.

Also try having the script send the messages to another email address (on another domain), just to be sure the problem is not with your email account.

If you believe you can use the PHP mail function and have already tried a different email address, create a small PHP file with the following contents (be sure to use your own email address):

Open the file in your browser and then check your mail. If you did not receive the message, something is not set properly on your server, and the trouble is not with this script. Even if other mail scripts work for you, that does not mean this one will, as there are several methods to send mail in PHP.

If you do receive the message, it most likely means that your server is configured to not allow the use of the fourth parameter (extra headers) in the mail() function. To work around this, replace this line:

$send_status = mail($send_to, $email_subject, $msg, $headers);

With this:

$send_status = mail($send_to, $email_subject, $msg);

The only downside is that certain features (such as some header information, and the ability to send to multiple recipients) will be disabled. You may be able to contact your host and have them change this though. Many hosts add in this restriction for security reasons, to protect against unsafe scripts.

Lastly, some servers require an extra parameter for the mail function that specifies who the message is from. In many cases, this must be an email address on the server itself. Example:

$send_status = mail($send_to, $email_subject, $msg, $headers", "-f user@domain.com");

‘Headers already sent’ error

Another common question is the ‘headers already sent’ error message. Without getting into the details, this generally happens when something is output to the browser before a call to set_cookie, header, or a number of other PHP functions. Be sure there is no extra whitespace at the top of your file.

Mail headers showing up in message body / attachments not working

This issue can be caused if your server does not like the return/newline character set being used to end lines of the email headers. If you are experiencing this problem, try changing this line:

if (!defined('PHP_EOL')) define ('PHP_EOL', strtoupper(substr(PHP_OS,0,3) == 'WIN') ? "\r\n" : "\n");

To this:

if (!defined('PHP_EOL')) define ('PHP_EOL', strtoupper(substr(PHP_OS,0,3) == 'WIN') ? "\n" : "\n");

If you require special SMTP settings for mail to be sent

If you have to manually specify the SMTP settings, you can do so with the following code. This is only recommended for advanced users.

ini_set("SMTP","mail.MYDOMAIN.com");
ini_set("smtp_port","587");
ini_set("username","MYUSERNAME@MYDOMAIN.com");
ini_set("password","MYPASSWORD"); 
ini_set('sendmail_from', $sender_email);
$send_status = mail($send_to, $email_subject, $msg, $headers);
ini_restore('sendmail_from');

(Just search for the reference to the mail() function to see where to add it)

Conclusion

Please be sure to read the entire article before asking a question. I spend a lot of time on the scripts and plugins available on this site, and it can be hard to keep up with all the requests. If you need modifications or a custom version, please contact me. Thanks for reading!

Secure Form Mailer Plugin For Wordpress

Admin — Sun, 25 Nov 2007 21:30:42 +0000

This is the WordPress plugin version of my secure PHP form mailer script. This plugin has a wide range of features including: Support for multiple instances, an easy to use dynamic form generation system (any number of fields, in any order), multiple recipients, multiple file attachments, optional auto reply feature, an image verification system, numerous security features (including protection against email header injection), a message template system, multiple languages, and too many other things to list. This plugin was designed to be easy to use, while still being extremely flexible. If you just want a simple contact form, you can set one up with just a few clicks. For those of you who need something a bit more advanced, you can completely customize the plugin to fit your needs - whether it is 5 fields or 500. A non-WordPress version is also available. ReCaptcha support has also been added.

You can see a very basic implementation of the WordPress plugin version of this script on this site’s contact page.

Notice: non-WordPress Users

Information on the PHP version of this script

Languages

As of the latest release, this script contains language files for:

English, Brazilian Portuguese, Catalan, Danish, Dutch, Finnish, French, German, Greek, Italian, Norwegian BokmÃ¥l, Polish, Portuguese, Romanian, Russian, Slovak, Slovene, Spanish, Swedish, Turkish

If you would like to submit a language file please contact me.

WordPress vs PHP Versions

Due to the size of this page, I have split everything up into sections:

Download
Changelog
Installation
Quick and Basic Configuration
Initial Configuration
Form Configuration
Other Configuration Options
Usage
Advanced Recipient Options
Advanced Form Structure
Manual Form Code
Auto Reply Feature
Other Modifications
Troubleshooting
Comments

Download

Latest Release (For WordPress 2.0 through 2.5)

Changelog

Since both the WordPress and non-WordPress versions of this script are updated together, the changelog below reflects both versions.

11-25-07 - v5.4 Added support for ReCaptcha, manual form code entry, 5 new languages (Catalan, Danish, Polish, Romanian, and Turkisk), several html and css tweaks, and other misc. updates.
07-27-07 - v5.33 Few minor bugs fixed. Finnish language file added.
07-08-07 - v5.32 Error messages affecting form alignment issue resolved. Italian and Slovak language files added.
06-18-07 - v5.3 ‘undefined index’ errors fixed, image verification adjustments, p tags removed from fieldsets, changes to help html validity, various other fixes.
05-09-07 - v5.25 ‘Thank you’ message now allows for form field inputs as well.
05-08-07 - v5.24 Auto-reply message now allows for form field inputs. Language selection issue resolved. str_replace errors (on certain servers) fixed. Norwegian BokmÃ¥l language file added.
05-01-07 Not a version update. Greek and Swedish language files added.
04-18-07 - v5.23 Renamed email verification function (to fix conflicts with other scripts). The GD check is now disabled if you are not using image verification. Added two new language files - Portuguese and Russian.
04-18-07 Not a version update. Brazilian Portuguese language file has been added.
04-03-07 - v5.22 Email generation code has been modified to try to work with more servers. French language file has also been updated.
03-28-07 - v5.21 Highly recommended update - Fixed an issue with the verification code not being handled properly. Nothing else has been changed.
03-25-07 - v5.2 Email generation improved - should work better in more email clients. Many issues with message generation and field types have been fixed. Better support added for field requirement options. CSS for various fields updated. Issue with submit button fixed. Dutch and French language files added. Checkbox and drop-down issues resolved. Email verification method improved. Undefined index errors fixed, and much more. Be sure to read the updated instructions for the field types.
03-13-07 - v5.1 Lots of updates: Slash escaping has been improved, p tags are now added around form elements, each form instance can have its own language setting, the language selection issue has been fixed, improved foreign character support in messages, check box handling improved, and a new optional auto reply feature has been added.
02-06-07 - v5.0 This is a major update from version 4, and because of this, I have completely re-written this page, and removed the old changelog to save space.

Installation

1) Download and uncompress dd-formmailer-wp.zip
2) Upload the entire dd-formmailer directory to your WordPress plugins directory
3) Activate the plugin
4) Configure your options (explained below)
5) Add the form to your page (explained below)

Quick and Basic Configuration

While this plugin is highly configurable, some of you may just want to get up and running quickly with a simple (and secure) contact form. If so, these are the minimum configuration changes you must make:

Create a new WordPress page, and type in the trigger text:

Under Options -> DDFM1, fill in the following options:

Contact page - Enter the full URL of your newly created contact page.

Recipients - Enter your email address.

Click Update options and you are finished! If you would like to learn more about the other features of this plugin, please continue reading.

Initial Configuration

After activating the plugin, you will have a new options page in the admin panel - DDFM-Main. These are the settings that apply to all instances of the plugin:

Instances - The number of contact forms this plugin will generate. If you just need a single contact form, leave this set to 1.

Image Verification Method - There are three choices for image verification. It can be disabled, you can use the script’s built-in system (a simple captcha - requires GD support on the server), or you can use the ReCaptcha system (requires signing up for a free account at recaptcha.net)

Basic Method Options - If using the basic image verification method, you can choose the text and background color for the image (3 or 6 digit hex codes). By default, the script will try and choose the best file format for the verification image, but if it gives you any problems, you can manually specify the format to see what works best for your server.

ReCaptcha Method Options - If using the ReCaptcha image verification method, you must enter the public and private keys given to you at the ReCaptcha website. These are used to generate the verification form, and the keys are specific to the website under your account (meaning if you use this script on multiple sites, you need a set of keys for each).

A ‘Load Default Options’ button is available if you wish to reset the settings on this page.

Each instance you create will have its own options page - DDFM1, DDFM2, etc. This is where you configure the settings for each individual form. These settings are listed below.

Form Configuration

These are the settings found on the options page for each instance:

Language - The language you want to use. To create a new language, simply duplicate the existing English.php file (in the plugins lang subdirectory), give it a new name, and edit it for your language. It will then automatically appear in this list (after reloading the page).

Contact page - This is the full URL of the page the form is actually going to be displayed on.

Recipients - If sending to a single recipient, all you have to do is enter the email address. This plugin supports multiple recipients, including CC and BCC, and even a drop-down box for recipient selection. Information on these configurations can be found further down on this page.

Form Structure - This is where you define the fields that will be used on this form. There are a lot of options available for this, and they will be explained further down as well.

Manual Form Code - This is a very advanced option that has its own section on this page.

Sender name, Sender email, and Email subject - These options help generate the email headers. If you enter a field name, it will be replaced by user input from that field. For example, if you have a form field called fm_name and you use that as the Sender name option, the visitor’s name will be used as the From field in the email. You can also combine them. If you have a field called fm_firstname and fm_lastname you could enter ‘fm_lastname, fm_firstname’ - For the Sender email option, just use your email field.

The Email subject option works the same way. For example, you could enter ‘Contact: fm_subject’ and it will use the subject that the visitor entered, with the ‘Contact:’ prefix.

Message Structure - This feature is optional. If left blank, the script will generate the email message itself, which will include all the data the visitor submits. If you choose to use this option, it will act as the message template. Simply enter your custom text, including your field names. When the message is generated, the field names will be replaced by the user input from those fields. Note: Since the script will just do a search and replace for field names, be sure they are unique enough. Example: A check for fm_message2 would also get triggered by fm_message when the script adds in the input.

Auto Reply - This is an optional feature that allows you to automatically send a pre-defined message back to those who contact you. More information on this is below.

Success Message - This is the text that is shown after the email has been sent. You can also use field names in this, and the user input from those fields will be used to generate the message.

Show required - If enabled, required fields will be marked with an asterisk.

Show IP and Hostname - If enabled, the visitor’s IP and hostname are added to the message.

Wrap messages - This option wraps message lines to 70 characters to comply with RFC specifications.

Max upload size - This allows you to set the maximum file size (in bytes) for attachment uploads. This option only applies if the setting is lower than the value already set in your php.ini file.

The option page for each inststance also has a ‘Load Default Options’ button.

Other Configuration Options

With the exception of the text defined in the options pages, all text visible to the visitor is contained within the language file.

Visual changes to the form can be made in the included CSS file. The class names used in the examples below already exist within the CSS.

Usage

To show the form on your page, simply add the trigger text (followed by the instance number) to your page, just like you would any text:

For those of you who want to display the form directly from a template file, you can use the following code:

generate_data(); ?>

(where ‘1′ is the instance number)

Advanced Recipient Options

As mentioned above, if you want to send the messages to a single recipient, just enter the email address in the recipients field. To send to multiple recipients, separate the addresses with a | (pipe) character, and use one of the following prefixes for each: to= cc= bcc=

Examples:

to=user1@domain.com|to=user2@domain.com
to=user1@domain.com|cc=user2@domain.com
to=user1@domain.com|cc=user2@domain.com|bcc=user3@domain.com

You can have as many of each type (to, cc, bcc) as you like, and they can be in any order, although the first one in the list is the always the primary recipient, and must use to=

type=selrecip|class=fmselect|label=Recipient|data=(select),User1,
user1@domain.com,User2,user2@domain.com

The ‘(select)’ item is the default selection, which the user must change to submit the form. You can change the ‘(select)’ text if you choose.

Advanced Form Structure

This plugin uses a dynamic form generation system, which means that by simply adding a new line to the form structure, you will have a new field in your form. You can have as many fields as you like, and in any order. The only field type that you must absolutely have is the verify field if you are using the image verification option. All of the fields are explained below, with examples. Separate each field type with a single newline in the form structure option. (Some of the examples below are bit long, so they are wrapped to the next line - be sure that the only newlines are after each field type when adding them to your form structure.)

These are the different parameters that apply to most of the field types (Special exceptions and parameters unique to a particular field are listed under each field type):

type - This tells the plugin what type of field you are adding.
class - The CSS class used to style the field. The classes used in the examples below already exist in the CSS file.
label - Text that is shown next to the field.
fieldname - The name of the form field (must be unique).
max - Maximum number of characters allowed.
req - (OPTIONAL) If you want to require a field, set this to true. If not, do not add it.
default - (OPTIONAL) This allows you to specify the default value of a field.

TEXT

This is a standard text input field.

type=text|class=|label=|fieldname=|max=|[req=true]|[ver=]|[default=]

Examples:

type=text|class=fmtext|label=Name|fieldname=fm_name|max=100|req=true 

type=text|class=fmtext|label=Age|fieldname=fm_age|max=100|
default=Enter your age! 

type=text|class=fmtext|label=Email|fieldname=fm_email|max=100|req=true|
ver=email 

type=text|class=fmtext|label=URL|fieldname=fm_url|max=100|ver=url

PASSWORD

This is a standard password field. It is exactly like a text field, except it shows asterisks when the user types.

type=password|class=|label=|fieldname=|max=|[req=true]|[confirm=true]

Examples:

type=password|class=fmtext|label=Password|fieldname=fm_pass|max=100|
req=true|confirm=true
 
type=password|class=fmtext|label=Secret Word|fieldname=fm_secret|max=100

TEXTAREA

This is a standard text area, for multiple lines of text.

type=textarea|class=|label=|fieldname=|max=|rows=|[req=true]|[default=]

The textarea field type has a special parameter - rows which defines the number of rows in the field (required for valid html).

Examples:

type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|
max=1000|rows=6
 
type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|max=1000|
rows=4|req=true
 
type=textarea|class=fmtextarea|label=Message|fieldname=fm_message|max=1000|
rows=10|req=true|default=Type here!

WIDETEXTAREA

This is exactly the same as the standard textarea, except that it’s wider, and the label is above it instead of to the side.

type=widetextarea|class=|label=|fieldname=|max=|rows=|[req=true]|[default=]

Example:

type=widetextarea|class=fmtextwide|label=Message|fieldname=fm_message|
max=1000|rows=10|req=true

* Note that the normal textarea, and wide textarea fields use a different CSS class for formatting.

VERIFY

type=verify|class=|label=

Example:

type=verify|class=fmverify|label=Verify

FULLBLOCK and HALFBLOCK

type=fullblock|class=|text=
type=halfblock|class=|text=

Examples:

type=fullblock|class=fmfullblock|text=This could be some sort of 
introduction message.
 
type=halfblock|class=fmhalfblock|text=This could be used to explain a field 
in greater depth.

OPENFIELDSET and CLOSEFIELDSET

type=openfieldset|legend=
type=closefieldset

Examples:

type=openfieldset|legend=Your Information
 
(other field would go between these)
 
type=closefieldset

CHECKBOX

The checkbox field can be used to generate a single checkbox, or a group of them. The usage is a bit different than the other fields.

type=checkbox|class=|label=|data=
(fieldname),(text),(checked),(REQUIRED),
(fieldname),(text),(CHECKED),(REQUIRED)...

As you can see, the checkbox data is a comma separated list of four items per checkbox:

fieldname - A unique fieldname for each checkbox in the form.
text - The text shown to the right of each checkbox.
checked - true or false. This allows you to make checkboxes checked by default.
required - true or false. If true, it means that the user must check the box to send the message. Mainly useful for ‘check here to agree’ type situations.

Examples

type=checkbox|class=fmcheck|label=I Agree|data=fm_agree,I agree to the 
terms,false,true
 
type=checkbox|class=fmcheck|label=Interests|data=fm_i1,Computers,false,
false,fm_i2,Art,false,false,fm_i3,Music,false,false

RADIO

This field generates a group of radio buttons. Radio buttons are similar to checkboxes, except that they are treated as a group, and only one option may be selected.

type=radio|class=|label=|fieldname=|[req=true]|[default=]|data=(text),(text),
(text)...

The req and default items are optional. req, if set to true, makes the field required. default can be set to the option number you want to be selected by default (starting at 1).

Examples:

type=radio|class=fmradio|label=Gender|fieldname=fm_gender|data=Male,Female
 
type=radio|class=fmradio|label=Color|fieldname=fm_color|req=true|default=1|
data=Unspecified,Red,Green,Blue

SELECT

The select field generates either a standard drop-down box, or a multi-select box, depending on the multi option. Option groups are supported as well.

type=select|class=|label=|fieldname=|[multi=true]|[req=true]|data=(#group),
(text),(text),(#group),(text)...

The multi and req options are optional.

The data field is just a list of the options, separated by a comma. To define the start of an option group, just prefix the group name with a # as shown below.

Examples:

type=select|class=fmselect|label=Age|fieldname=fm_age|req=true|
data=(select),0-30,31-60,61-90,91-120

type=select|class=fmselect|label=Colors|fieldname=fm_colors|
multi=true|req=true|data=(select),Red,Green,Blue

type=select|class=fmselect|label=Choose|fieldname=fm_choose|
data=#Category1,item1,item2,#Category2,item3,item4

FILE

type=file|class=|label=|fieldname=|[req=true]|[allowed=1,2,3]

The allowed field is optional, and lets you define a (comma separated) list of file extensions that are allowed to be uploaded. Otherwise, all file types will be allowed.

Examples:

type=file|class=fmfile|label=Upload|fieldname=fm_upload
 
type=file|class=fmfile|label=Upload|fieldname=fm_upload|req=true|
allowed=jpg,jpeg,gif,png

Manual Form Code

Notice: Usage of this feature is a bit tricky. If you do not have a good amount of experience with html forms and CSS, I do not recommend attempting it.

1) Customize your form using the ‘Form Structure’ option as you would normally - this is required even when using the manual code entry, as it allows for processing of the form.
2) Be sure you have all your options exactly as you want them, and view your newly created form page.
3) View the source of the page, so you can copy the generated html. The code you need is between the following lines:
4) You can now customize this form code however you like, as long as the core elements of the form and fields are still in place.
5) Enter your new code into the ‘Manual Form Code’ field in the options and save.
6) If everything worked properly, your page will now use the custom form code. Once again, the standard form structure option is still required, as it is still for processing of the form.

To disable the manual form code feature, just clear out the option for it.

Auto Reply Feature

The options page for each instance includes fields to define an auto reply message. This is a pre-defined message that is sent back to the visitor.

To use this option, simply enter the name, email address, subject line, and message for your auto response. To disable this feature, just leave the message field blank.

You can also use field names in the auto reply message, and the user input from those fields will be used to generate the message.

Other modifications

Redirect after form submission - Method 1

$o .= $sent_message;

And replace it with this:

$o .= '';

(where mysite.com is the URL you want to redirect to)

Redirect after form submission - Method 2

This is another method you can use to redirect the user after the form has been submitted. First, find this line:

$o .= $sent_message;

And after it, add this:

$o .= '';

Where ‘4′ is the number of seconds to wait before refresh, and the ‘http://www.yoursite.com’ is the URL you want to redirect to.

Passing values to the form

To allow values to be passed directly to the form, all you have to do is change all references of $_POST to $_REQUEST (The REQUEST superglobal contains the values of both POST and GET items)

Modifying the script to use HII for image verification

Miro has posted instructions for users wanting to use HII: Read the comment. Notice: Modifications listed in the comments may not apply for new versions of the script.

Using SELRECIP and BCC together

The easiest way to do this, is to find the following line in the script:

$send_status = mail($send_to, $email_subject, $msg, $headers);

$send_status = mail("user2@domain.com", $email_subject, $msg, $headers);

Troubleshooting

Verification image not showing up

The first thing to do is check to make sure your paths are set correctly in the options.

This plugin automatically chooses the best file type to generate the verification image. If your verification image is not displaying, the problem could be that your server will not properly generate that type of file. You can manually set this using the ‘Force image type’ option under the DDFM-Main options page. It allows you to manually specify jpeg, gif, or png.

Try all the options to see which works best for you.

Problems sending email

The most common question I receive is ‘Why am I not receiving email from the script?’

Also try having the script send the messages to another email address (on another domain), just to be sure the problem is not with your email account.

If you believe you can use the PHP mail function and have already tried a different email address, create a small PHP file with the following contents (be sure to use your own email address):

$send_status = mail($send_to, $email_subject, $msg, $headers);

With this:

$send_status = mail($send_to, $email_subject, $msg);

Lastly, some servers require an extra parameter for the mail function that specifies who the message is from. In many cases, this must be an email address on the server itself. Example:

$send_status = mail($send_to, $email_subject, $msg, $headers", "-f user@domain.com");

‘Headers already sent’ error

For WordPress users, it is also always a good idea to disable your other plugins temporarily to make sure that nothing is conflicting.

Mail headers showing up in message body / attachments not working

This issue can be caused if your server does not like the return/newline character set being used to end lines of the email headers. If you are experiencing this problem, try changing this line:

if (!defined('PHP_EOL')) define ('PHP_EOL', strtoupper(substr(PHP_OS,0,3) == 'WIN') ? "\r\n" : "\n");

To this:

if (!defined('PHP_EOL')) define ('PHP_EOL', strtoupper(substr(PHP_OS,0,3) == 'WIN') ? "\n" : "\n");

If you require special SMTP settings for mail to be sent

If you have to manually specify the SMTP settings, you can do so with the following code. This is only recommended for advanced users.

ini_set("SMTP","mail.MYDOMAIN.com");
ini_set("smtp_port","587");
ini_set("username","MYUSERNAME@MYDOMAIN.com");
ini_set("password","MYPASSWORD"); 
ini_set('sendmail_from', $sender_email);
$send_status = mail($send_to, $email_subject, $msg, $headers);
ini_restore('sendmail_from');

(Just search for the reference to the mail() function to see where to add it)

Conclusion

Free Text Host

Admin — Tue, 23 Oct 2007 00:50:43 +0000

The Free Text Host website is a new project by Dagon Design. The site allows visitors to host text without having to sign up or give any personal information. One possible usage for this is to host code snippets, but it can be used for just about anything really. Options include the ability to enter a password to allow you to edit or delete your text, and the choice to use preformatted text and make links clickable.

Try it out

Free Text Host

Changelog

10-22-07 - Option added to make links clickable, and to enable/disable preformatted output. You can also now edit the text with the edit/delete password.
10-20-07 - First public release

Usage

Just enter your text and the verification code (to help prevent spam) and you will be given a randomly generated URL that only you will know.

There is currently a 50000 character limit. I will see how this works before I raise it higher.

Options

If you choose, you can enter a password when submitting your text. This password will allow you to make changes or delete your page. If you do not include a password, the page cannot be modified.

You can also choose to use preformatted text, which means extra whitespace and linebreaks will appear exactly as you type them, and a fixed width font will be used.

Lastly, you can choose to make links in your text clickable. These links will contain the nofollow attribute.

Questions/Answers

Privacy Information

Only one cookie is used on the site, and it is for the verification code. The only information it contains is the code itself, and it is used to help prevent spam.

This site does not use any Javascript or Flash, and it has no tracking or logging features.

Is my hosted text visible by others?

Only if you give them the URL, or they guess it. The URL contains a 10 digit random alphanumeric ID, which allows for up to 3656158440062976 unique IDs, so it would be hard to guess.

The hosted text pages also use the noindex, nofollow, and noarchive robot directives to prevent search engine robots from indexing them.

Can I print my text?

Yes. If you print your page, it will only print the text itself. Everything else will be removed from the page.

Can I edit/delete my text?

Yes. When you enter your text, you have an option for a password. If you enter one, you can use it to edit or delete your page later.

What if I lose my URL?

Then it is lost. This is by design.

Possible Future Features

These are things that I may add at a later date. I plan to keep the interface relatively simple though, as it is part of my goal with this project.

Option to make pages auto-delete after a given period of time

Disclaimer

While the generated pages are relatively private unless you give out the URL, Dagon Design cannot guarantee that no one will see your text by guessing the URL, etc.

Multi Column Category List Plugin for WordPress

Admin — Sat, 29 Sep 2007 20:24:23 +0000

This plugin generates an alphabetical listing of your WordPress categories in multiple columns. You can choose the number of columns to display, with an option to split up the list of categories by letter. It also supports the use of a custom header to help separate the categories. For example, you could have it say ‘Topics: A’ and then list the topics that start with ‘A’, etc. The category list can easily be added to any post or page with the trigger text, or called directly from a template file. A CSS file is also included for easy style changes.

Related Plugins

There is also a plugin available to generate a multi-column list of your WordPress links.

Download

Latest Release (For WordPress 2.0 through 2.5)

Installation

Download the above file and uncompress
Upload dd-multi-col-cats.php to your plugins directory
Upload dd-multi-col-cats.css to your theme directory
Activate the plugin from the WordPress admin panel
Configure the options under the admin panel: Options - DDMultiColCats

Usage

To use this plugin, simply add the following trigger text to a post or page:

If you prefer, you can also call the function directly from a template file with the following command:

Change Log

09-29-07 Version 1.3 - Updated for WordPress 2.3. Added ‘Load Default Options’ button. Removed javascript expand code because it was too buggy.
05-16-07 Version 1.2 - Updated for WordPress 2.2.
03-02-07 Version 1.1 - Option added to allow click-to-expand lists. Special thanks to Richard K Miller for submitting the code!
02-03-07 Version 1.0 - First release.

Options

Here are the options available for this plugin under the WordPress admin panel

Number of columns

The number of columns that the categories will be shown in. If you want to show more columns than your layout width will handle, you can adjust the width of each column in the CSS file.

Separate items

Here you can choose to separate the categories by letter, with a custom separation header, or no separation at all.

Separation header

If the separation option is enabled, this is where you enter your separation text, which will be shown above each set of items. You can use %L to show the letter. For example, if you enter Topics: %L then it will show Topics: A, (list of cats), Topics: B, (list of cats), etc…

Excluded categories

This is a comma-separated list of the category IDs you want to exclude from the list.

Multi Column Link List Plugin for WordPress

Admin — Sat, 29 Sep 2007 20:23:19 +0000

This plugin generates an alphabetical listing of your WordPress links in multiple columns. You can choose the number of columns to display, with an option to split up the list of links by letter. It also supports the use of a custom header to help separate the links. For example, you could have it say ‘Links: A’ and then list the links that start with ‘A’, etc. The link list can easily be added to any post or page with the trigger text, or called directly from a template file. A CSS file is also included for easy style changes.

Related Plugins

There is also a plugin available to generate a multi-column list of your WordPress categories.

Download

Latest Release (For WordPress 2.0 through 2.5)

Notes

The purpose of this plugin is to generate a full list of links (with the exception of the link categories you exclude). This means that it does not sort links by category, only by name.

Installation

Download the above file and uncompress
Upload dd-multi-col-links.php to your plugins directory
Upload dd-multi-col-links.css to your theme directory
Activate the plugin from the WordPress admin panel
Configure the options under the admin panel: Options - DDMultiColLinks

Usage

To use this plugin, simply add the following trigger text to a post or page:

If you prefer, you can also call the function directly from a template file with the following command:

Change Log

09-29-07 Version 1.3 - Updated for WordPress 2.3. Added ‘Load Default Options’ button. Removed javascript expand code because it was too buggy.
05-16-07 Version 1.2 - Updated for WordPress 2.2.
03-02-07 Version 1.1 - Option added to allow click-to-expand lists. Special thanks to Richard K Miller for submitting the code!
02-13-07 Version 1.0 - First release.

Options

Here are the options available for this plugin under the WordPress admin panel

Number of columns

The number of columns that the links will be shown in. If you want to show more columns than your layout width will handle, you can adjust the width of each column in the CSS file.

Separate items

Here you can choose to separate the links by letter, with a custom separation header, or no separation at all.

Separation header

If the separation option is enabled, this is where you enter your separation text, which will be shown above each set of items. You can use %L to show the letter. For example, if you enter Links: %L then it will show Links: A, (list of links), Links: B, (list of links), etc…

Excluded link categories

This is a comma-separated list of the link category IDs you want to exclude from the list.

Change Default Thumbnail Size in WordPress

Admin — Fri, 28 Sep 2007 02:40:56 +0000

One question I get asked quite often is how to change the default size of the thumbnails that WordPress creates when you upload an image. It is actually quite easy to change - it just requires modification of one WordPress file. When WordPress 2.1 was released, it changed the way this was done, and once again with the release of WordPress 2.3, so I have included instructions below for versions 2.0 through 2.3. If you are using WordPress 2.5, there is now a built-in option to change the thumbnail size.

WordPress 2.0

Open /wp-admin/inline-uploading.php and look for the following code:

if ( $imagedata['width'] > 128 && 
$imagedata['width'] >= $imagedata['height'] * 4 / 3 )
      $thumb = wp_create_thumbnail($file, 128);
    elseif ( $imagedata['height'] > 96 )
      $thumb = wp_create_thumbnail($file, 96);

The default max size is 128 x 96. You can change these numbers to whatever you like, although you must keep the proper aspect ratio (4 / 3).

For example, to double the size of the thumbnails, replace 128 with 256, and 96 with 192. Be sure to change both sets of numbers - they are each listed in the code twice.

WordPress 2.1 - 2.2

Open /wp-admin/admin-functions.php and look for the following code:

$max_side = apply_filters( 'wp_thumbnail_max_side_length', 
128, $attachment_id, $file );

The number specified here (128 by default) is the maximum size of either dimension. Just change this to whatever you like.

WordPress 2.3

Open /wp-admin/includes/image.php and look for the following code:

$max_side = apply_filters( 'wp_thumbnail_max_side_length', 
128, $attachment_id, $file );

The number specified here (128 by default) is the maximum size of either dimension. Just change this to whatever you like.

WordPress 2.5

WordPress 2.5 now includes a built-in option to change the size of thumbnails. In your dashboard, just go to ‘Settings -> Miscellaneous’

Color Select Tool

Admin — Fri, 28 Sep 2007 01:21:09 +0000

The Color Select Tool is a small utility that allows you to quickly copy the hex code of a color on your screen. I originally created this program because I was tired of having to take a screenshot and open photoshop just to capture a color, and I was not happy with similar programs. Simply run the program, move the mouse to the color you want to capture, and press the shift key. The hex color code will then be copied to your clipboard. You can also choose to have it add the # symbol in front of the code, and/or have it stay on top of other windows.

Requirements

This program has been tested in Windows XP, XP 64, and Vista. It may work in previous Windows versions as well. If you receive any messages about VB runtime DLLs being required, these can easily be found on the internet.

Notice

The previous version of this program (2.0) required the .NET framework to be installed. The current version no longer requires this.

While I have tested this release, there may still be bugs, so if you encounter a problem please leave a comment below.

Download

Color_Select_Tool.zip

Changelog

09-27-07 Version 3.1 - Bug fixed with color code generation.
09-23-07 Version 3.0 - Re-written. New instructions below.
10-19-05 Version 2.0 - First public release.

Installing

No installation is needed. Just extract the executable from the ZIP file and run it.

Usage

To use the program, just move the mouse to the color on your screen that you want to capture and press the SHIFT key. The color will automatically be added to your clipboard.

If you would like the # symbol to be added in front of the color code, just check the ‘add #‘ checkbox, or press the A key on your keyboard.

To force the program to stay on top of other windows, check the ‘stay on top‘ checkbox, or press the T key.

Note: In order for the hotkeys (SHIFT, A, T) to work, the program has to have focus. This means it needs to be the currently active program. If the hotkeys do not work, just click on the title bar of the program to set it active.

If you minimize the program, it goes to the system tray. You can click on the system tray icon to show/hide the program, or right click to exit.

Dagon Design

Scheduled Post Shift Plugin for WordPress

Download

Instructions

Disabling the Schedule

Change Log

Options

Shift Delay

Category ID

Other Posts from Cat plugin for WordPress

Download

Instructions

Change Log

Notice

Styling

Options

Draft Notification Plugin for WordPress

Download

Instructions

Change Log

Notes

Modifications

Sitemap Generator Plugin for Wordpress

Download

Languages

Changelog

Installation

Upgrading?

Want to run the plugin from a template file?

Permalinks for sitemap navigation

CSS declarations

Available Options

General Options

Sitemap Generation

Exclusions

Navigation

Miscellaneous

Interstitial Ads Plugin for WordPress

Download

Installation

Usage

Change Log

Notes

Prevent author impersonation in WordPress comments

Requirements

Instructions

Notes

Secure PHP Form Mailer Script

Notice: WordPress Users

Languages

WordPress vs PHP Versions

Table of Contents

Download

Changelog

Installation

Required Configuration

Standalone Option

Path to CSS

Language Setting

Full URL to Script

Full URL to Contact Page

Recipient Data

Other Configuration Options

Other Customizations

Usage

Advanced Recipient Options

Advanced Form Structure

TEXT

PASSWORD

TEXTAREA

WIDETEXTAREA

VERIFY

FULLBLOCK and HALFBLOCK

OPENFIELDSET and CLOSEFIELDSET

CHECKBOX

RADIO

SELECT

FILE

Manual Form Code

Auto Reply Feature