Contact Manager

Quick Start

Contact Manager is a free WordPress plugin allowing you to easily insert contact forms (with or without CAPTCHA) into posts, pages and widgets of your website. You can create an unlimited number of contact forms and customize them completely. If you wish, Contact Manager can also record the messages in your database, and allows you to automatically offer a gift to people who send you a message (very useful for getting feedback from your customers on your products).

WordPress Download

Summary

  1. Installation
  2. Upgrade
  3. Display Of Forms
  4. Creation Of Forms
  5. Display Of Informations About A Form
  6. Display Of Informations About A Form Category
  7. Display Of Informations About A Message Or A Sender
  8. Counters
  9. Counters Of Displays And Messages
  10. Contents Restricted To Senders
  11. Display Of The Options
  12. Gift Offered To Sender
  13. Encryption Of URLs
  14. Emails
  15. Autoresponders
  16. Registration As A Client
  17. Registration To Affiliate Program
  18. Membership
  19. WordPress
  20. Display Of Informations About The User
  21. Custom Instructions
  22. Affiliation
  23. Custom Fields
  24. Non-WordPress Static Websites
  25. FAQ
  26. Changelog

Quick Start

Here's how to set up a form in less than 3 minutes:

1. Create a form through the Add Form page of Contact Manager. Enter a name for this form and click on one of the Save buttons.

2. Insert this code:

into your posts/pages/widgets to display this form.

That's all!

The Back Office page of Contact Manager allows you to customize your interface. With this page, you will can display the items that are useful for you and remove the others. In short, you will get an interface that fits precisely to your needs. We advise you to quickly browse through the admin pages of Contact Manager in order to have a global vision, and then take the time to properly configure your options.

1. Installation

  1. Unzip the plugin file.
  2. Upload with your FTP software the contact-manager folder, and only this folder, to your plugins directory (it should be wp-content/plugins).
  3. Activate the plugin through the Plugins menu in WordPress.
  4. Personalize the plugin interface through the Back Office page of Contact Manager in WordPress.
  5. Configure the plugin through the Options page of Contact Manager in WordPress.

You can also install Contact Manager through the Install Plugins page of the Plugins menu in WordPress (Plugins => Add New => Upload). Upload the plugin file without unzipping it.

2. Upgrade

When you upgrade Contact Manager, you don't lose any settings or any data.

  1. Unzip the plugin file.
  2. Upload with your FTP software the contact-manager folder, and only this folder, to your plugins directory (it should be wp-content/plugins), without deleting the contact-manager folder that already exists in this directory.

You don't need to deactivate and reactivate the plugin.

You can also upgrade Contact Manager through the Plugins menu in WordPress, and through the Updates page of the Dashboard menu in WordPress (Dashboard => Updates).

3. Display Of Forms

To display a form (you must have created one previously through the Add Form page of Contact Manager), insert into your posts/pages/widgets a code like this:

by replacing N with the form ID.

3.1 Redirection

By default, after sending his message, the user is not redirected to another page. To redirect the user, insert into your posts/pages/widgets a code like this:

by replacing URL with the URL to which you want to redirect the user and N with the form ID.

You can also redirect the user to a specific part of the page where he submitted the form, like this:

To redirect the user to the top of the form, simply enter # as the value for the redirection attribute:

You can also redirect the user to the page he saw just before the current page, if this page belongs to your website, by entering referring-url as the value for the redirection attribute:

3.2 Automatic Positioning Of The Cursor

You can decide, for each of your forms, if the cursor is or not automatically positioned in the first field when the page loads. This allows you to significantly improve your conversion rate. Insert into your posts/pages/widgets a code like this:

by replacing N with the form ID.

3.3 Automatic Completion Of Fields

You can significantly improve your conversion rate by automatically completing form fields with informations from the user when the page loads. Contact Manager allows you to do this when the page link has been sent through an autoresponder, by you or one of your affiliates.

To do this, simply add:

  • ?name-of-the-field=value-of-the-field to the URL of your page if it doesn't contain the ? and # characters
  • &name-of-the-field=value-of-the-field to the URL of your page if it contains the ? character, but not the # character

Example 1 (automatic completion of the first name):

http://www.kleor.com/your-opinion/?first-name=John

Example 2 (automatic completion of the email address):

http://www.kleor.com/your-opinion/?email-address=johnsmith@kleor.com

Example 3 (automatic completion of the first name and the email address):

http://www.kleor.com/your-opinion/?first-name=John&email-address=johnsmith@kleor.com

Use the dynamic tags provided by your autoresponder to automatically complete the fields.

3.4 Automatic Display

Contact Manager allows you, through its Options page, to automatically display one of your forms in all posts of your website. You can choose to display this form only on single post pages. You also can choose the maximum quantity of forms displayed per page.

4. Creation Of Forms

The Options page of Contact Manager, and the edit pages of a form or form category, include a field called Code. You must insert in this field a special code. This code is very similar to a normal HTML code, with the exception of the following characteristics:

  • The opening <form> tag and the closing </form> tag are absent.
  • Some HTML tags are replaced with shortcodes. For example, the <input /> tag is replaced with the [input] shortcode.

4.1 The [input] Shortcode

Insert into the Code field a code like this:

by replacing name with:

  • address to display a form field allowing the user to enter his address
  • captcha to display a form field allowing the user to enter the CAPTCHA
  • content to display a form field allowing the user to enter the content of his message
  • country to display a form field allowing the user to enter his country
  • email-address to display a form field allowing the user to enter his email address
  • first-name to display a form field allowing the user to enter his first name
  • last-name to display a form field allowing the user to enter his last name
  • login to display a form field allowing the user to enter his login name
  • message-confirmation-email-sent to display a checkbox allowing the user to choose to receive or not a message confirmation email
  • password to display a form field allowing the user to enter his password
  • phone-number to display a form field allowing the user to enter his phone number
  • postcode to display a form field allowing the user to enter his postcode
  • subject to display a form field allowing the user to enter the subject of his message
  • submit to display a button allowing the user to submit the form
  • town to display a form field allowing the user to enter his town
  • website-name to display a form field allowing the user to enter the name of his website
  • website-url to display a form field allowing the user to enter the URL of his website

Example:

The above code displays a form containing a field allowing the user to enter his first name, a field allowing him to enter his email address, and a button allowing him to submit the form.

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens, like this:

You can then display the value entered by the user for this field in the message confirmation/notification emails, with the following code:

4.2 Attributes Of The [input] Shortcode

All attributes (except id and name) of the <input /> HTML tag are also available for the [input] shortcode, with an identical role.

Example:

The above code displays a form containing a field (width of 20 characters) allowing the user to enter his first name, a field (width of 30 characters) allowing him to enter his email address, and a button allowing him to submit the form.

You can use the pattern HTML5 attribute to specify a syntax that the field must respect. In your regular expression, replace the [ and ] characters with their corresponding HTML entities: &#91; and &#93;.

Example:

4.3 The [textarea] Shortcode

Insert into the Code field a code like this:

by replacing Content with the content you want display in the text area before the user completes the form and name with:

  • address to display a text area allowing the user to enter his address
  • captcha to display a text area allowing the user to enter the CAPTCHA
  • content to display a text area allowing the user to enter the content of his message
  • country to display a text area allowing the user to enter his country
  • email-address to display a text area allowing the user to enter his email address
  • first-name to display a text area allowing the user to enter his first name
  • last-name to display a text area allowing the user to enter his last name
  • login to display a text area allowing the user to enter his login name
  • password to display a text area allowing the user to enter his password
  • phone-number to display a text area allowing the user to enter his phone number
  • postcode to display a text area allowing the user to enter his postcode
  • subject to display a text area allowing the user to enter the subject of his message
  • town to display a text area allowing the user to enter his town
  • website-name to display a text area allowing the user to enter the name of his website
  • website-url to display a text area allowing the user to enter the URL of his website

Example:

The above code displays a form containing a text area allowing the user to enter his first name, a text area allowing him to enter his email address, a text area allowing him to enter the subject of his message, a text area allowing him to enter the content of his message, and a button allowing him to submit the form.

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens, like this:

You can then display the value entered by the user for this field in the message confirmation/notification emails, with the following code:

4.4 Attributes Of The [textarea] Shortcode

All attributes (except id and name) of the <textarea> HTML tag are also available for the [textarea] shortcode, with an identical role.

Example:

The above code displays a form containing a text area (20 columns and 1 row) allowing the user to enter his first name, a text area (30 columns and 1 row) allowing him to enter his email address, a text area (60 columns and 1 row) allowing him to enter the subject of his message, a text area (60 columns and 10 rows) allowing him to enter the content of his message, and a button allowing him to submit the form.

4.5 The [select] Shortcode

The [select] shortcode has the same role as the <select> HTML tag. Insert into the Code field a code like this:

by replacing name with:

  • country to display a dropdown list allowing the user to select his country
  • postcode to display a dropdown list allowing the user to select his postcode
  • subject to display a dropdown list allowing the user to select the subject of his message
  • town to display a dropdown list allowing the user to select his town

Example:

The above code displays a form containing a dropdown list allowing the user to select his country, and a button allowing him to submit the form.

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens, like this:

You can then display the value entered by the user for this field in the message confirmation/notification emails, with the following code:

To display easily a dropdown list allowing the user to select a country, insert into the Code field the code below:

4.6 Attributes Of The [select] Shortcode

All attributes (except id and name) of the <select> HTML tag are also available for the [select] and [country-selector] shortcodes, with an identical role.

4.7 The [option] Shortcode

The [option] shortcode has the same role as the <option> HTML tag. Insert into the Code field a code like this:

If the name and the value of the option are identical, you can also insert into the Code field a code like this:

Example:

The above code displays a form containing a dropdown list allowing the user to select his country, and a button allowing him to submit the form.

4.8 Attributes Of The [option] Shortcode

All attributes of the <option> HTML tag are also available for the [option] shortcode, with an identical role.

4.9 Required Fields

By default, all form fields are optional. To insert a required field, use a code like this:

by replacing name with one element of this list or the name you want, provided it contains only lowercase letters, numbers and hyphens.

The required attribute is also available for the [textarea], [select] and [country-selector] shortcodes.

4.10 Error Messages

When the user does not complete one of the required fields of the form, or enters an invalid email address, error messages are displayed. You can customize these messages through the Options page of Contact Manager or through the edit page of the form or form category.

Insert into the Code field a code like this:

by replacing name with:

  • address to display the error message of address
  • content to display the error message of content
  • country to display the error message of country
  • email-address to display the error message of email address
  • first-name to display the error message of first name
  • invalid-captcha to display the error message of invalid CAPTCHA
  • invalid-fields to display the error message of invalid fields
  • last-name to display the error message of last name
  • login to display the error message of login name
  • maximum-messages-quantity-reached to display the error message of maximum messages quantity reached by the sender
  • password to display the error message of password
  • phone-number to display the error message of phone number
  • postcode to display the error message of postcode
  • subject to display the error message of subject
  • town to display the error message of town
  • unfilled-fields to display the error message of unfilled required fields
  • website-name to display the error message of website name
  • website-url to display the error message of website URL

Example:

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens, like this:

To display error messages in red, add this code to your CSS stylesheet:

4.11 Attributes Of The [error] Shortcode

All attributes (except id) of the <span> HTML tag are also available for the [error] shortcode, with an identical role.

You can set different error messages for each field of a form, like this:

by replacing name with:

  • failed-upload to enter the message of failed upload
  • invalid-email-address to enter the message of invalid email address
  • invalid-field to enter the message of invalid field
  • too-large-file to enter the message of too large file
  • unauthorized-extension to enter the message of unauthorized extension
  • unfilled-field to enter the message of unfilled field

Example:

4.12 The [label] Shortcode

The [label] shortcode has the same role as the <label> shortcode. Insert into the Code field a code like this:

by replacing name with:

  • address to link the label to the field of address
  • content to link the label to the field of content
  • country to link the label to the field of country
  • email-address to link the label to the field of email address
  • first-name to link the label to the field of first name
  • last-name to link the label to the field of last name
  • login to link the label to the field of login name
  • password to link the label to the field of password
  • phone-number to link the label to the field of phone number
  • postcode to link the label to the field of postcode
  • subject to link the label to the field of subject
  • town to link the label to the field of town
  • website-name to link the label to the field of website name
  • website-url to link the label to the field of website URL

Example:

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens, like this:

4.13 Attributes Of The [label] Shortcode

All attributes (except for) of the <label> HTML tag are also available for the [label] shortcode, with an identical role.

4.14 CAPTCHAs

You can use CAPTCHAs in forms. Insert into the Code field a code like this:

by replacing type with:

  • arithmetic to display a CAPTCHA of the Arithmetic operation type
  • question to display a CAPTCHA of the Question type
  • recaptcha to display a CAPTCHA of the reCAPTCHA type
  • reversed-string to display a CAPTCHA of the Reversed string type

To use a CAPTCHA of the reCAPTCHA type, you must get a public key and a private key here and enter these keys in the CAPTCHA module of the Options page of Contact Manager.

You can then select the theme you want to use, like this:

by replacing theme with:

  • blackglass for the Black Glass theme
  • clean for the Clean theme
  • red for the Red theme
  • white for the White theme

Example 1 (CAPTCHA of the reCAPTCHA type):

Example 2 (CAPTCHA of the Arithmetic operation type):

Example 3 (CAPTCHA of the Reversed string type):

Example 4 (CAPTCHA of the Question type):

4.15 Attributes Of The [captcha] Shortcode

All attributes of the <span> HTML tag are also available for the [captcha] shortcode, with an identical role, only if you don't use a CAPTCHA of the reCAPTCHA type.

4.16 Double Entry

You can require the double entry of a form field (email address, password, ...), like this:

by replacing name with the name of the field that the user must enter a second time.

Example:

4.17 Attachments

To display a form field allowing the user to upload an attachment, insert into the Code field a code like this:

by replacing name with the name you want, provided it contains only lowercase letters, numbers and hyphens.

Example:

You can limit the size of the file the user can upload using the maxsize attribute, like this:

by replacing N with the maximum file size in kilobytes.

You also can accept only certain files types with the extensions attribute, like this:

by separating the different extensions by /.

Example:

4.18 The Submit Button

To display a button allowing the user to submit the form, insert into the Code field a code like this:

by replacing Text of the button with the text of your button.

If you want to use an image, insert a code like this:

by replacing URL of the image with the image URL of your button and Alternative text with the text displayed when the image can not be displayed.

You can also use the <button> HTML tag, like this:

4.19 The [validation-content] Shortcode

To display a content restricted to users who have submitted the form without any error, insert into the Code field a code like this:

You can also define a content that will be displayed if the user has submitted the form and at least one error was generated, like this:

Example:

You can also define a content that will be displayed if the user has not submitted the form, like this:

5. Display Of Informations About A Form

To display an information about a form, insert into your posts/pages/widgets a code like this:

by replacing N with the form ID and information with:

  • category-id to display the category ID
  • commission-amount to display the amount of the level 1 commission
  • commission2-amount to display the amount of the level 2 commission
  • date to display the creation date
  • date-utc to display the creation date according to UTC time
  • description to display the description
  • displays-count to display the displays count
  • gift-download-url to display the gift download URL
  • gift-instructions to display the gift instructions
  • id to display the ID
  • keywords to display the keywords
  • maximum-messages-quantity to display the maximum quantity of messages registered to the database
  • maximum-messages-quantity-per-sender to display the maximum quantity of messages per sender
  • messages-count to display the messages count
  • name to display the name

This list is not complete and has only the most relevant items. You can find all possible values of information in the tables.php file of Contact Manager.

Example:

Result:

Contact

5.1 The default Attribute

You can specify a text that will be displayed instead of the information when this one is empty, using the default attribute, like this:

Don't forget to include the quotes at the beginning and the end of the default value.

5.2 The filter Attribute

You can specify a PHP function that will be applied to the information before this one is displayed, using the filter attribute, like this:

Replace function by the name of the function you want to apply.

Sometimes, the information is an English word. You can translate it into the language of your website by entering i18n as the value for the filter attribute.

It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:

The functions will be applied in the specified order.

5.3 The part Attribute

You can specify several URLs into the Gift download URL field of forms edit pages, by separating the different URLs with commas. If one of your gifts has several download URLs, you can display the n-st URL by using the part attribute, like this:

Example:

6. Display Of Informations About A Form Category

To display an information about a form category, insert into your posts/pages/widgets a code like this:

by replacing N with the ID of the form category and information with:

  • category-id to display the category ID
  • commission-amount to display the amount of the level 1 commission
  • commission2-amount to display the amount of the level 2 commission
  • date to display the creation date
  • date-utc to display the creation date according to UTC time
  • description to display the description
  • gift-download-url to display the gift download URL
  • gift-instructions to display the gift instructions
  • id to display the ID
  • keywords to display the keywords
  • maximum-messages-quantity to display the maximum quantity of messages registered to the database
  • name to display the name

This list is not complete and has only the most relevant items. You can find all possible values of information in the tables.php file of Contact Manager.

Example:

Result:

Forms

6.1 The default Attribute

You can specify a text that will be displayed instead of the information when this one is empty, using the default attribute, like this:

Don't forget to include the quotes at the beginning and the end of the default value.

6.2 The filter Attribute

You can specify a PHP function that will be applied to the information before this one is displayed, using the filter attribute, like this:

Replace function by the name of the function you want to apply.

Sometimes, the information is an English word. You can translate it into the language of your website by entering i18n as the value for the filter attribute.

It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:

The functions will be applied in the specified order.

6.3 The part Attribute

You can specify several URLs into the Gift download URL field of forms categories edit pages, by separating the different URLs with commas. If one of your gifts has several download URLs, you can display the n-st URL by using the part attribute, like this:

Example:

6.4 Display Of Informations About The Category Of A Form

You can specify a shortcode for the id attribute, provided to replace [ by ( and ] by ). It allows you to display an information about the category of a form, like this:

Don't forget to include the quotes at the beginning and the end of the shortcode.

Example:

Result:

Category of Contact: Forms

7. Display Of Informations About A Message Or A Sender

To display an information about a message or a sender, insert into your posts/pages/widgets a code like this:

or this one:

by replacing N with the message ID.

You can also insert these shortcodes in your message confirmation/notification emails. Then you don't have to use the id attribute, like this:

or:

When you don't use the id attribute, it is automatically set to the ID of the message concerned by the confirmation/notification.

Replace information with:

  • address to display the address of the sender
  • content to display the content
  • country to display the country of the sender
  • date to display the date
  • date-utc to display the date according to UTC time
  • email-address to display the email address of the sender
  • first-name to display the first name of the sender
  • form-id to display the form ID
  • id to display the ID
  • ip-address to display the IP address of the sender
  • keywords to display the keywords
  • last-name to display the last name of the sender
  • phone-number to display the phone number of the sender
  • postcode to display the postcode of the sender
  • receiver to display the receiver
  • referring-url to display the refering URL of the sender
  • subject to display the subject
  • town to display the town of the sender
  • user-agent to display the browser of the sender
  • website-name to display the website name of the sender
  • website-url to display the website URL of the sender

This list is not complete and has only the most relevant items. You can find all possible values of information in the tables.php file of Contact Manager.

Example:

Result:

Subject of the first message: Test

Outside the standard names listed above, you can also replace name with the name you want, provided it contains only lowercase letters, numbers and hyphens. If you have used a custom field name in your form, you can then display the value entered by the user for this field in the message confirmation/notification emails, with the following code:

7.1 The default Attribute

You can specify a text that will be displayed instead of the information when this one is empty, using the default attribute, like this:

Don't forget to include the quotes at the beginning and the end of the default value.

7.2 The filter Attribute

You can specify a PHP function that will be applied to the information before this one is displayed, using the filter attribute, like this:

Replace function by the name of the function you want to apply.

Sometimes, the information is an English word. You can translate it into the language of your website by entering i18n as the value for the filter attribute.

It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:

The functions will be applied in the specified order.

8. Counters

To display a counter, insert into your posts/pages/widgets a code like this:

by replacing L with a positive number and data with:

  • forms to count the number of forms
  • forms-categories to count the number of forms categories
  • messages to count the number of messages

When the limit is reached, the content between [contact-counter data=data limit=L] and [/contact-counter] disappears. You can format this content as any content of your website. The limit attribute is optional. If you don't use it, the content will not disappear:

You can insert the [number] shortcode as many times as you want between [contact-counter data=data limit=L] and [/contact-counter]. If you don't insert it, Contact Manager allows you to schedule a content disappearance without displaying a counter:

8.1 Display Of Numbers And The Limit

You are not limited to the [number] shortcode. You can use the following shortcodes:

  • [limit] to display the limit
  • [number] to display the data
  • [remaining-number] to display the difference between the limit and the data

The filter attribute (defined here) is also available for these shortcodes.

8.2 Automatic Content Substitution

If you want to schedule a content substitution, insert into your posts/pages/widgets a code like this:

by replacing L with a positive number.

Insert the content you want to substitute between [after] and [/contact-counter]. When the limit is reached, the content between [contact-counter data=data limit=L] and [after] disappears, and the content between [after] and [/contact-counter] appears. The content between [after] and [/contact-counter] is never sent to the browser until the limit is reached.

You can insert the [number] shortcode as many times as you want between [contact-counter data=data limit=L] and [after]. If you don't insert it, Contact Manager allows you to schedule a content substitution without displaying a counter:

8.3 Succession Of Counters

It is possible to specify several limits for the limit attribute, by separating the different limits by /, like this:

You can use the following shortcodes:

  • [limit] to display the current limit
  • [number] to display the difference between the current data and the previous limit
  • [remaining-number] to display the difference between the current limit and the current data
  • [total-limit] to display the last limit of the limit attribute
  • [total-number] to display the current data
  • [total-remaining-number] to display the difference between the last limit of the limit attribute and the current data

The filter attribute (defined here) is also available for these shortcodes.

8.4 The range Attribute

You can count only data recorded during a specific time range by using the range attribute, like this:

Replace range with:

  • a positive number N to count only data recorded during the N last days
  • previous-week to count only data recorded during the previous week
  • previous-half-month to count only data recorded during the previous half-month
  • previous-month to count only data recorded during the previous month
  • previous-bimester to count only data recorded during the previous bimester
  • previous-trimester to count only data recorded during the previous trimester
  • previous-quadrimester to count only data recorded during the previous quadrimester
  • previous-semester to count only data recorded during the previous semester
  • previous-year to count only data recorded during the previous year

9. Counters Of Displays And Messages

To display a counter of displays/messages, insert into your posts/pages/widgets a code like this:

by replacing L with a positive number, N with the form ID and data with:

  • displays to count the number of displays
  • messages to count the number of messages

When the limit is reached, the content between [contact-form-counter data=data limit=L id=N] and [/contact-form-counter] disappears. You can format this content as any content of your website. The limit attribute is optional. If you don't use it, the content will not disappear:

You can insert the [number] and [remaining-number] shortcodes as many times as you want between [contact-form-counter data=data limit=L id=N] and [/contact-form-counter]. If you don't insert it, Contact Manager allows you to schedule a content disappearance without displaying a counter:

9.1 Display Of Numbers And The Limit

You are not limited to the [number] and [remaining-number] shortcodes. You can use the following shortcodes:

  • [limit] to display the limit
  • [number] to display the data
  • [remaining-number] to display the difference between the limit and the data

The filter attribute (defined here) is also available for these shortcodes.

9.2 Automatic Content Substitution

If you want to schedule a content substitution, insert into your posts/pages/widgets a code like this:

by replacing L with a positive number and N with the form ID.

Insert the content you want to substitute between [after] and [/contact-form-counter]. When the limit is reached, the content between [contact-form-counter data=data limit=L id=N] and [after] disappears, and the content between [after] and [/contact-form-counter] appears. The content between [after] and [/contact-form-counter] is never sent to the browser until the limit is reached.

You can insert the [number] and [remaining-number] shortcodes as many times as you want between [contact-form-counter data=data limit=L id=N] and [/contact-form-counter]. If you don't insert it, Contact Manager allows you to schedule a content substitution without displaying a counter:

9.3 Succession Of Counters

It is possible to specify several limits for the limit attribute, by separating the different limits by /, like this:

You can use the following shortcodes:

  • [limit] to display the current limit
  • [number] to display the difference between the current data and the previous limit
  • [remaining-number] to display the difference between the current limit and the current data
  • [total-limit] to display the last limit of the limit attribute
  • [total-number] to display the current data
  • [total-remaining-number] to display the difference between the last limit of the limit attribute and the current data

The filter attribute (defined here) is also available for these shortcodes.

9.4 Cumulative Counters Of Displays And Messages

You can count the cumulative data of many of your forms, by specifying several IDs for the id attribute. Separate the different IDs by +, like this:

10. Contents Restricted To Senders

To display a content restricted to users who have sent you a message, insert into your posts/pages/widgets a code like this:

You can also define a content that will be displayed if the user has not sent you any message, like this:

Result (with a little formatting):

Content displayed if the user has not sent you any message

The user is recognized by his IP address. So that works, you must have enabled the registration of messages.

10.1 Specific Content To A Form

To display a content restricted to users who have sent you a message through one of your forms, insert into your posts/pages/widgets a code like this:

Replace N by the form ID.

10.2 Specific Content To Several Forms

It is possible to specify several IDs for the id attribute, by separating the different IDs by /, like this:

Example:

Result (avec un peu de mise en forme):

Content displayed if you have not sent any messages through one of these forms

11. Display Of The Options

To display an option of Contact Manager, insert into your posts/pages/widgets a code like this:

by replacing option with:

  • automatic-display-enabled to display the activation of automatic display (possible values: yes, no)
  • automatic-display-form-id to display the ID of the form automatically displayed in posts
  • automatic-display-location to display the location of the form automatically displayed in posts (possible values: bottom, top)
  • automatic-display-maximum-forms-quantity to display the maximum quantity of forms automatically displayed per page
  • automatic-display-only-on-single-post-pages to display the activation of automatic display only on single post pages (possible values : yes, no)
  • commission-amount to display the amount of the level 1 commission
  • commission2-amount to display the amount of the level 2 commission
  • encrypted-urls-validity-duration to display the validity duration of encrypted URLs
  • maximum-messages-quantity to display the maximum quantity of messages registered to the database
  • version to display the version of Contact Manager

This list is not complete and has only the most relevant items. You can find all possible values of option in the initial-options.php file of Contact Manager.

Example:

Result:

Messages registration enabled: no

11.1 The default Attribute

You can specify a text that will be displayed instead of the option when this one is empty, using the default attribute, like this:

Don't forget to include the quotes at the beginning and the end of the default value.

11.2 The filter Attribute

You can specify a PHP function that will be applied to the option before this one is displayed, using the filter attribute, like this:

Replace function by the name of the function you want to apply.

Sometimes, the option is an English word. You can translate it into the language of your website by entering i18n as the value for the filter attribute.

Example:

Result:

Messages registration enabled: no

It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:

The functions will be applied in the specified order.

12. Gift Offered To Sender

You can offer a gift to users who send you a message, by completing the fields of the Gift module.

For example, insert the following code in the Instructions to the sender field:

Don't forget to insert the following code wherever you want in the body of your message confirmation email:

You can also offer your gift directly to the page of the form through the [validation-content] shortcode. Insert into the Code field of the edit page of the form a code like this:

13. Encryption Of URLs

You can deliver your digital products using encrypted download URLs. The encryption key and the validity duration of encrypted URLs are configurable through the Options page of Contact Manager. Enter a random string (difficult to guess) into the Encryption key field.

To deliver your digital products using encrypted download URLs, use the following code:

instead of this one:

If your digital product has several download URLs, use the following code:

instead of this one:

In the Body field of your message confirmation email, you can insert a code like this:

You can also insert the code above into the Instructions to the sender field of the edit page of your form, and insert the following code into the Body field of your message confirmation email:

14. Emails

You can insert shortcodes into Sender, Receiver, Subject and Body fields of emails to display informations about the sender, the message and the form. These shortcodes are simply the same as those presented in Display Of Informations About A Form and Display Of Informations About A Message Or A Sender sections.

When you don't use the id attribute, it is automatically set to the ID of the form through which the message has been sent (for the [contact-form] shortcode), and the ID of the message concerned by the confirmation/notification (for the [message] shortcode).

You can also insert in these fields all shortcodes available on your website.

If you register the sender as a client, you can insert shortcodes into these fields in order to display informations (login name and password for example) about the client. These shortcodes are presented in this section.

If you register the sender to your affiliate program, you can insert shortcodes into these fields in order to display informations (login name and password for example) about the affiliate. These shortcodes are presented in this section.

If you register the sender to one or more of your members areas, you can insert shortcodes into these fields in order to display informations (login name and password for example) about the member. These shortcodes are presented in this section.

If you register the sender as a WordPress user, you can insert shortcodes into these fields in order to display informations (login name and password for example) about the user. These shortcodes are presented in this section.

You can also enter several email addresses separated with commas in the Receiver field of emails. And you can insert HTML code into the Body field of emails.

15. Autoresponders

Contact Manager allows you to subscribe the senders to an autoresponder list. You must make the settings shown in this section so that works.

For the following autoresponders, you must enter the ID of the list into the List field of the Autoresponders module:

  • AWeber
  • CyberMailing
  • MailChimp
  • SG Autorépondeur

For the other autoresponders, enter the name of the list.

You can find the ID of a MailChimp list in the List name & defaults page.

You can allow the user to choose an autoresponder list by inserting a code like this one into the Code field of your form:

Replace list1, list2, ... listN with the IDs or names of the lists.

You can also allow him to subscribe or not to an autoresponder list, by inserting a code like this one into the Code field of your form:

15.1 AWeber

You must make some adjustments so that Contact Manager works with AWeber.

Go to your AWeber account, place your pointer on List Options, click on Email Parsers in the dropdown list that appears and then click on add new at the bottom of the page.

AWeber Email Parser
AWeber Email Parser

Enter what you want into the Description field and insert this code into the Trigger Rule field:

by replacing domain with the domain name of your website (without the extension) and extension the extension of your domain name (without the dot).

If your domain name (with the extension) contains more than 35 characters, insert this code into the Trigger Rule field instead of the previous code:

Insert this code into the Rule 1 field:

In the Store In field to the right of the Rule 1 field, select Email.

Insert this code into the Rule 2 field:

In the Store In field to the right of the Rule 2 field, select Name.

Insert this code into the Rule 3 field:

In the Store In field to the right of the Rule 3 field, select Ad Tracking.

Click on Save to record your parser. Then edit it, check the Enable parser for all lists in this account box and click on Save to enable your parser for all lists of your AWeber account.

15.2 CyberMailing

You have no adjustment to make so that Contact Manager works with CyberMailing.

15.3 GetResponse

You must enter the API key of your GetResponse account in the Autoresponders integration module of the Options page of Contact Manager so that Contact Manager works with GetResponse. You can get your API key by logging into your GetResponse account.

15.4 MailChimp

You must enter the API key of your MailChimp account in the Autoresponders integration module of the Options page of Contact Manager so that Contact Manager works with MailChimp. You can get your API key by logging into your MailChimp account.

15.5 SG Autorépondeur

You must enter the ID of your SG Autorépondeur account and your additional functionalities activation code in the Autoresponders integration module of the Options page of Contact Manager so that Contact Manager works with SG Autorépondeur. You can get these informations by logging into your SG Autorépondeur account.

16. Registration As A Client

You can register senders as clients, if you have installed and activated Commerce Manager. The Autoresponders, Registration to affiliate program, Membership, WordPress and Custom instructions modules of Contact Manager supersede the modules of the same name in Commerce Manager.

If the user sends you a message while logged in as a client, or by specifying an email address identical to that of an existing client, Contact Manager will not create a new client account, but will update the category of the client, if you want to assign the sender to a client category.

Upon registration, if he has not provided a login name, the login name of the sender is his email address, if there is no client with the same login name. Otherwise, a number will be added to the end. If he has not provided a password, a random password is generated automatically.

You can give to the sender his login name and his password, by inserting a code like this one in the Body field of your message confirmation email:

The sender can always change his login name and password through the profile form of Commerce Manager.

You can insert shortcodes into the Sender, Receiver, Subject and Body fields of message confirmation/notification emails in order to display informations about the client. These shortcodes are presented in this section.

17. Registration To Affiliate Program

You can register senders to your affiliate program, if you have installed and activated Affiliation Manager. The Autoresponders, Registration as a client, Membership, WordPress and Custom instructions modules of Contact Manager supersede the modules of the same name in Affiliation Manager.

If the user sends you a message while logged in as an affiliate, or by specifying an email address identical to that of an existing affiliate, Contact Manager will not create a new affiliate account, but will update the category of the affiliate, if you want to assign the sender to an affiliate category.

Upon registration, if he has not provided a login name, the login name of the sender is the part before the @ character of his email address, if there is no affiliate with the same login name. Otherwise, a number will be added to the end. If he has not provided a password, a random password is generated automatically.

You can give to the sender his login name and his password, by inserting a code like this one in the Body field of your message confirmation email:

The sender can always change his login name and password through the profile form of Affiliation Manager.

You can insert shortcodes into the Sender, Receiver, Subject and Body fields of message confirmation/notification emails in order to display informations about the affiliate. These shortcodes are presented in this section.

18. Membership

You can register senders to one or more of your members areas, if you have installed and activated Membership Manager. The Autoresponders, Registration as a client, Registration to affiliate program, WordPress and Custom instructions modules of Contact Manager supersede the modules of the same name in Membership Manager.

If the user sends you a message while logged in as a member, or by specifying an email address identical to that of an existing member, Contact Manager will not create a new member account, but will update the account of the member. It will also update the category of the member, if you want to assign the sender to a member category.

Upon registration, if he has not provided a login name, the login name of the sender is his email address, if there is no member with the same login name. Otherwise, a number will be added to the end. If he has not provided a password, a random password is generated automatically.

You can give to the sender his login name and his password, by inserting a code like this one in the Body field of your message confirmation email:

The sender can always change his login name and password through the profile form of Membership Manager.

You can insert shortcodes into the Sender, Receiver, Subject and Body fields of message confirmation/notification emails in order to display informations about the member. These shortcodes are presented in this section.

19. WordPress

You can register senders as WordPress users. Upon registration, if he has not provided a login name, the login name of the sender is his email address, if there is no WordPress user with the same login name. Otherwise, a number will be added to the end. If he has not provided a password, a random password is generated automatically.

If the user sends you a message while logged in as a WordPress user, or by specifying an email address identical to that of an existing WordPress user, Contact Manager will not create a new WordPress user account.

You can give to the sender his login name and his password, by inserting a code like this one in the Body field of your message confirmation email:

You can insert shortcodes into the Sender, Receiver, Subject and Body fields of message confirmation/notification emails in order to display informations about the user. These shortcodes are presented in the Display Of Informations About The User section.

20. Display Of Informations About The User

To display an information about a WordPress user, insert into your posts/pages/widgets a code like this:

by replacing information with:

  • date to display the registration date
  • date-utc to display the registration date according to UTC time
  • email-address to display the email address
  • first-name to display the first name
  • id to display the ID
  • last-name to display the last name
  • login to display the login name
  • password to display the password (the true password in emails, the encrypted password in all other cases)
  • website-url to display the website URL

Example:

20.1 The default Attribute

You can specify a text that will be displayed instead of the information when this one is empty (this is generally the case when the user is not logged in as a WordPress user), using the default attribute, like this:

Don't forget to include the quotes at the beginning and the end of the default value.

20.2 The filter Attribute

You can specify a PHP function that will be applied to the information before this one is displayed, using the filter attribute, like this:

Replace function by the name of the function you want to apply.

It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:

The functions will be applied in the specified order.

21. Custom Instructions

You can add custom instructions that will be executed just after the sending of a message, or other events. This allows you, among other things, to subscribe the sender to a list of an autoresponder that is not yet supported by Contact Manager.

Some PHP skills are required. The custom instructions (for the sending of a message) are executed inside the includes/add-message.php file of Contact Manager.

You can find where the custom instructions of other events are executed by opening all files of Contact Manager with a text editor like Notepad++ and searching for the string of characters eval( in these files.

The custom instructions of form submission are executed inside the includes/forms/processing.php file of Contact Manager, only if no errors occur. You can execute different instructions depending on the form by doing a test on the $id variable set in the forms.php file of Contact Manager.

22. Affiliation

You can award a commission to the affiliate who referred a message, if you have installed and activated Affiliation Manager, and if you have enabled the registration of messages to your database.

You can pay all the commissions on messages registered during a specific time range through the Payment page of Affiliation Manager. Everything is explained here.

23. Custom Fields

You can, through the Back Office page of Contact Manager, add an unlimited number of custom fields in the Add Form, Add Form Category and Add Message pages to record additional data. Enter a name and a key for each custom field.

For example, if you want to save the favorite color of the sender, enter Favorite color as the name and favorite-color as the key.

To display a custom information about a message or a sender, insert into your posts/pages/widgets a code like this (don't forget the custom-field- prefix just before the key):

or this one:

by replacing N with the message ID and key with the key of the custom field.

To allow the sender to fill this field, insert into the Code field of your forms a code like this (don't forget the custom-field- prefix just before the key):

by replacing key with the key of the custom field.

24. Non-WordPress Static Websites

Contact Manager is designed to work with a WordPress site, but you can also use it with a non-WordPress static website, by following the instructions below.

24.1 Installation Of WordPress

Download WordPress and install it on your website. You will not use WordPress as a CMS to manage the pages of your website, but as an interface allowing you to manage your contact forms and messages.

24.2 The Files Of Your Website

If the files of your website have the extension .htm or .html, replace it with .php. Open them with a text editor like Notepadd++, click on File, and then click on Save as.... A window opens. In the Type field, select PHP and click on Save.

You can also recreate these files with the index.php model provided with Contact Manager, inside the model folder of the plugin.

24.3 Loading Of WordPress

To load WordPress functions in the files of your website, add on top of these files the following code:

Replace WordPress directory with the name of the directory where you installed WordPress. If you installed it at the root of your website, replace this line:

by this one:

Insert this line of code:

just before the </head> tag, and this line of code:

just before the </body> tag.

24.4 Using Shortcodes

The documentation of Contact Manager provides you several shortcodes. To use these shortcodes in the PHP files of your website, insert a code like this:

25. FAQ

25.1 Can I use shortcodes in fields of admin pages?

Yes. You can insert all the shortcodes available on your website in most fields of Contact Manager admin pages.

25.2 How can I use shortcodes in my WordPress theme?

Insert into the PHP files of your theme a code like this:

25.3 How can I use shortcodes in comments?

Edit the functions.php file (create it if it doesn't exist) of your WordPress theme and add this line of code:

25.4 How can I use shortcodes in attributes of shortcodes?

You can use shortcodes in most attributes of Contact Manager shortcodes, provided to replace [ by ( and ] by ), like this:

Don't forget to include the quotes at the beginning and the end of the shortcode.

25.5 How can I nest several identical shortcodes?

When you nest several identical shortcodes, you must add an integer between 1 and 3 at the end of the tags of these shortcodes, like this:

26. Changelog

  • Version 6.0
    • Improvement of the ergonomics of admin pages
  • Version 5.9.7
    • Addition of the ability to execute custom instructions just after the submission of a form
  • Version 5.9.4
    • Fixation of a bug with PHP 5.5
  • Version 5.9.2
    • Improvement of the ergonomics of admin pages
    • Optimization of the CSS styles of the admin pages for WordPress 3.9.1
  • Version 5.9.1
    • Improvement of the stability of the plugin
  • Version 5.9
    • Improvement of the ergonomics of admin pages
  • Version 5.8.6
    • Improvement of the cron
  • Version 5.8.5
    • Addition of the ability to require the double entry of some form fields (email address, password, ...)
  • Version 5.8.4
    • Addition of the support of the pattern HTML5 attribute
  • Version 5.8.3
    • Addition of the ability to set different error messages for each field of a form
  • Version 5.8.2
    • Improvement of the stability of the plugin when its folder is renamed
  • Version 5.8.1
    • Improvement of the installation of the plugin
  • Version 5.8
    • Optimization of the CSS styles of the admin pages for WordPress 3.8
    • Improvement of the uninstallation of the plugin