Documentation

Summary

  1. Installation [+]
    1. Activation Key
  2. Upgrade [+]
    1. Automatic Upgrade
  3. Display Of Forms [+]
    1. Redirection
    2. Automatic Positioning Of The Cursor
    3. Automatic Completion Of Fields
    4. Automatic Display
    5. Attributes Of The [optin-form] Cotillion
  4. Creation Of Forms [+]
    1. The [input] Cotillion
    2. Attributes Of The [input] Cotillion
    3. The [textarea] Cotillion
    4. Attributes Of The [textarea] Cotillion
    5. The [select] Cotillion
    6. Attributes Of The [select] Cotillion
    7. The [option] Cotillion
    8. Attributes Of The [option] Cotillion
    9. Optional Fields
    10. Error Messages
    11. Attributes Of The [error] Cotillion
    12. The [label] Cotillion
    13. Attributes Of The [label] Cotillion
    14. CAPTCHAs
    15. Attributes Of The [captcha] Cotillion
    16. Double Entry
    17. The Submit Button
    18. The [validation-content] Cotillion
  5. Display Of Informations About A Form [+]
    1. The default Attribute
    2. The filter Attribute
    3. The part Attribute
  6. Display Of Informations About A Form Category [+]
    1. The default Attribute
    2. The filter Attribute
    3. The part Attribute
    4. Display Of Informations About The Form Category
  7. Prospect Status
  8. Display Of Informations About A Prospect [+]
    1. The default Attribute
    2. The filter Attribute
  9. Counters [+]
    1. Display Of Numbers And The Limit
    2. Automatic Content Substitution
    3. Succession Of Counters
    4. The range Attribute
  10. Counters Of Displays And Prospects [+]
    1. Display Of Numbers And The Limit
    2. Automatic Content Substitution
    3. Succession Of Counters
    4. Cumulative Counters Of Displays And Prospects
  11. Contents Restricted To Prospects [+]
    1. Content Specific To A List
    2. Content Specific To Several Lists
  12. Display Of The Options [+]
    1. The default Attribute
    2. The filter Attribute
  13. Encryption Of URLs
  14. Emails
  15. Autoresponders [+]
    1. AWeber
    2. CyberMailing
    3. GetResponse
    4. MailChimp
    5. MailerLite
    6. Sendinblue
    7. Sendy
    8. SG Autorépondeur
  16. Registration As A Client
  17. Registration To The Affiliate Program
  18. Membership
  19. WordPress
  20. Display Of Informations About The User [+]
    1. The default Attribute
    2. The filter Attribute
  21. Custom Instructions
  22. Affiliation
  23. Custom Fields
  24. Non-WordPress Static Websites [+]
    1. Installation Of WordPress
    2. The Files Of Your Website
    3. Loading Of WordPress
    4. Use Of Cotillions
  25. Advanced Customization [+]
    1. Custom Autoresponders
    2. Custom Files
    3. Custom Languages
  26. FAQ [+]
    1. Can I use cotillions in fields of admin pages?
    2. How can I use cotillions in my WordPress theme?
    3. How can I use cotillions in comments?
    4. How can I use cotillions in attributes of cotillions?
    5. How can I nest several identical cotillions?
  27. Changelog

Quick Start

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

1. Configure the options of the Autoresponders and Autoresponders integration modules of the Options page of Optin Manager.

2. Insert this cotillion:

[optin-form id=1]

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

That's all!

The Back Office page of Optin 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 Optin Manager in order to have a global vision, and then take the time to properly configure your options.

1. Installation

You can install Optin Manager through the Add Plugins page of the Plugins menu in WordPress (Plugins => Add New => Upload Plugin). Upload the plugin file without unzipping it. You can also install it like this:

  1. Unzip the plugin file.
  2. Upload with your FTP software the optin-manager folder, and only this folder, to your plugins directory (it should be wp-content/plugins).

Once you have installed Optin Manager:

  1. Activate the plugin through the Plugins menu in WordPress.
  2. Click on the Optin menu in WordPress and answer the questions to automatically configure the plugin according to your answers.

1.1 Activation Key

You must enter your activation key in the Activation key field of the Activation/Upgrade module in the Options page of Optin Manager. This key is mandatory to avoid an automatic deactivation of Optin Manager in a few hours. You can find it in the home page of your client area, and in the emails you received just after your order.

2. Upgrade

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

You can upgrade Optin Manager through the Plugins menu in WordPress, and through the WordPress Updates page of the Dashboard menu in WordPress (Dashboard => Updates), or through the Add Plugins page of the Plugins menu in WordPress (Plugins => Add New => Upload Plugin, upload the plugin file without unzipping it). You can also upgrade it like this:

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

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

2.1 Automatic Upgrade

You can choose to automatically install all the upgrades of Optin Manager as soon as they become available, by checking the Automatically upgrade Optin Manager box of the Activation/Upgrade module in the Options page of Optin Manager. To make sure it works well, enter your FTP credentials in your wp-config.php file, like this:

define('FTP_HOST', 'your-ftp-host');
define('FTP_USER', 'your-ftp-username');
define('FTP_PASS', 'your-ftp-password');

If it still doesn't work, make sure the PECL Zip extension is enabled on the server that hosts your website.

3. Display Of Forms

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

[optin-form id=N]

by replacing N with the form ID.

3.1 Redirection

By default, after his registration, the user is redirected to the registration confirmation URL. To redirect him to another URL, insert into your posts/pages/widgets a cotillion like this:

[optin-form redirection=URL id=N]

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:

[optin-form redirection=#your-anchor id=N]

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

[optin-form redirection=# id=N]

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:

[optin-form redirection=referring-url id=N]

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 cotillion like this:

[optin-form focus=yes id=N]

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. Optin 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:

Example 1 (automatic completion of the first name):

https://www.kleor.com/optin-manager/squeeze/?first-name=John

Example 2 (automatic completion of the email address):

https://www.kleor.com/optin-manager/squeeze/?email-address=johnsmith@kleor.com

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

https://www.kleor.com/optin-manager/squeeze/?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

Optin 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.

3.5 Attributes Of The [optin-form] Cotillion

All attributes (except action, id and name) of the <form> HTML tag are also available for the [optin-form] cotillion, with an identical role.

4. Creation Of Forms

The Options page of Optin Manager, and the edit pages of a form or form category, include a field called Code. You can insert into this field the HTML code provided by your autoresponder.

However, to use the features of Optin Manager, such as the automatic correction of typos, the registration of prospects in the database of your website, the encryption of download URLs, the registration to a member area and the granting of commissions to your affiliates, you will need to insert in this field a special cotillion.

This cotillion is very similar to a normal HTML code, with the exception of the following characteristics:

4.1 The [input] Cotillion

Insert into the Code field a cotillion like this:

[input name]

by replacing name with:

Example:

<p><label><strong>Your first name:</strong> [input first-name]<br />[error first-name]</label></p>
<p><label><strong>Your email address:</strong> [input email-address]<br />[error email-address]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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:

[input your-name]

4.2 Attributes Of The [input] Cotillion

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

Example:

<p><label><strong>Your first name:</strong> [input first-name size=20]<br />[error first-name]</label></p>
<p><label><strong>Your email address:</strong> [input email-address size=30]<br />[error email-address]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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:

<p><label><strong>Postcode:</strong> 
[input postcode pattern="&#91;0-9&#93;{5,5}" size=20]<br />
[error postcode]</label></p>
<div>[input submit value="Submit"]</div>

4.3 The [textarea] Cotillion

Insert into the Code field a cotillion like this:

[textarea name]Content[/textarea]

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

Example:

<p><label><strong>Your first name:</strong> [textarea first-name][/textarea]<br />[error first-name]</label></p>
<p><label><strong>Your email address:</strong> [textarea email-address][/textarea]<br />[error email-address]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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, 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:

[textarea your-name]Content[/textarea]

4.4 Attributes Of The [textarea] Cotillion

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

Example:

<p><label><strong>Your first name:</strong> [textarea first-name cols=20 rows=1][/textarea]<br />[error first-name]</label></p>
<p><label><strong>Your email address:</strong> [textarea email-address cols=30 rows=1][/textarea]<br />[error email-address]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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, and a button allowing him to submit the form.

4.5 The [select] Cotillion

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

[select name]Content[/select]

by replacing name with:

Example:

<p><label><strong>Your country:</strong> [select country]
[option]Canada[/option]
[option]France[/option]
[option]Ireland[/option]
[/select]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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:

[select your-name]Content[/select]

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

[country-selector]

4.6 Attributes Of The [select] Cotillion

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

4.7 The [option] Cotillion

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

[option value="Value of the option"]Name of the option[/option]

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

[option]Name of the option[/option]

Example:

<p><label><strong>Your country:</strong> [select country]
[option]Canada[/option]
[option]France[/option]
[option]Ireland[/option]
[/select]</label></p>
<div>[input submit value="Submit"]</div>

The above cotillion 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] Cotillion

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

4.9 Optional Fields

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

[input name required=no]

by replacing name with one element of this list.

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

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 Optin Manager or through the edit page of the form or form category.

Insert into the Code field a cotillion like this:

[error name]

by replacing name with:

Example:

<p><label><strong>Your first name:</strong> [input first-name]<br />[error first-name]</label></p>
<p><label><strong>Your email address:</strong> [input email-address]<br />[error email-address]</label></p>
<div>[input submit value="Submit"]</div>

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:

[error your-name]

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

.error { color: #c00000; }

4.11 Attributes Of The [error] Cotillion

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

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

[error field data-name-message="Your error message"]

by replacing name with:

Example:

<p><label><strong>Your first name:</strong> [input first-name required=yes]<br />[error first-name data-unfilled-field-message="The first name is required."]</label></p>
<p><label><strong>Your email address:</strong> [input email-address]<br />[error email-address data-invalid-email-address-message="The email address is invalid."]</label></p>
<div>[input submit value="Submit"]</div>

4.12 The [label] Cotillion

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

[label name]Content[/label]

by replacing name with:

Example:

<p>[label first-name]<strong>Your first name:</strong>[/label] [input first-name]<br />[error first-name]</p>
<p>[label email-address]<strong>Your email address:</strong>[/label] [input email-address]<br />[error email-address]</p>
<div>[input submit value="Submit"]</div>

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:

[label your-name]Content[/label]

4.13 Attributes Of The [label] Cotillion

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

4.14 CAPTCHAs

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

[captcha type=type]

by replacing type with:

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

The CAPTCHA of the reCAPTCHA v3 type is invisible. For the CAPTCHA of the reCAPTCHA v2 type, you can choose the theme you want to use, like this:

[captcha type=recaptcha theme=theme]

by replacing theme with:

To use a CAPTCHA of the hCaptcha type, you must get a site key and a secret key here and enter these keys in the CAPTCHA module of the Options page of Optin Manager.

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

[captcha type=hcaptcha theme=theme]

by replacing theme with:

Example 1 (CAPTCHA of the reCAPTCHA v2 type):

[captcha type=recaptcha theme=dark]

Example 2 (CAPTCHA of the reCAPTCHA v3 type, invisible):

[captcha type=recaptcha3]

Example 3 (CAPTCHA of the Arithmetic operation type):

<p>[captcha type=arithmetic] = [input captcha size=3] (enter your answer in digits)</p>

Example 4 (CAPTCHA of the Reversed string type):

<p>Type the following characters in reverse order:<br />
[captcha type=reversed-string] : [input captcha size=20]</p>

Example 5 (CAPTCHA of the Question type):

<p>[captcha type=question question="Question" answer="Correct answer"] [input captcha size=20]</p>

4.15 Attributes Of The [captcha] Cotillion

All attributes of the <span> HTML tag are also available for the [captcha] cotillion, 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:

[input confirm-name]

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

Example:

<p><label><strong>Your email address:</strong>*<br />
[input email-address size=40 required=yes]<br />[error email-address]</label></p>

<p><label><strong>Confirm your email address:</strong><br />
[input confirm-email-address size=40]<br />[error confirm-email-address]</label></p>

4.17 The Submit Button

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

[input submit value="Text of the button"]

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

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

[input submit type=image src="URL of the image" alt="Alternative text"]

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:

<button type="submit">Text of the button</button>

4.18 The [validation-content] Cotillion

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

[validation-content]Content displayed if the user has submitted the form without any error[/validation-content]

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:

[validation-content]
Content displayed if the user has submitted the form without any error[other]
Content displayed if the user has submitted the form and at least one error was generated
[/validation-content]

Example:

[validation-content]
<p style="color: green;">Thank you for your registration. Check your emails.</p>
[other]<p style="color: red;">[error unfilled-fields] [error invalid-captcha]</p>
[/validation-content]

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

[validation-content]
Content displayed if the user has submitted the form without any error[other]
Content displayed if the user has submitted the form and at least one error was generated[other]
Content displayed if the user has not submitted the form
[/validation-content]

5. Display Of Informations About A Form

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

[optin-form information id=N]

by replacing N with the form ID and information with:

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 Optin Manager.

Example:

[optin-form name id=1]

Result:

How To Write Your eBooks (Pages)

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:

[optin-form information default="text" id=N]

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:

[optin-form information filter=function id=N]

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.

Example:

Initial status of the prospects: [optin-form prospects-initial-status filter=i18n id=1]

Result:

Initial status of the prospects: inactive

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

[optin-form information filter=function1/function2/…/functionN id=N]

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-th download URL by using the part attribute, like this:

[optin-form gift-download-url part=n id=N]

Example:

First download URL: [optin-form gift-download-url part=1 id=N]
Second download URL: [optin-form gift-download-url part=2 id=N]
Third download URL: [optin-form gift-download-url part=3 id=N]
…

6. Display Of Informations About A Form Category

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

[optin-form-category information id=N]

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

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 Optin Manager.

Example:

[optin-form-category name id=1]

Result:

How To Write Your eBooks

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:

[optin-form-category information default="text" id=N]

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:

[optin-form-category information filter=function id=N]

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.

Example:

Initial status of the prospects: [optin-form-category prospects-initial-status filter=i18n id=1]

Result:

Initial status of the prospects: inactive

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

[optin-form-category information filter=function1/function2/…/functionN id=N]

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-th download URL by using the part attribute, like this:

[optin-form-category gift-download-url part=n id=N]

Example:

First download URL: [optin-form-category gift-download-url part=1 id=N]
Second download URL: [optin-form-category gift-download-url part=2 id=N]
Third download URL: [optin-form-category gift-download-url part=3 id=N]
…

6.4 Display Of Informations About The Form Category

You can specify a cotillion 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:

[optin-form-category information id="(your-cotillion)"]

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

Example:

Category of [optin-form name id=1]: [optin-form-category name default="None" id="(optin-form category-id id=1)"]

Result:

Category of How To Write Your eBooks (Pages): How To Write Your eBooks

7. Prospect Status

Your prospects can have 3 statuses: Active, Inactive and Deactivated. An active prospect has confirmed his subscription to one of your autoresponder lists. An inactive prospect has not yet done it. A deactivated prospect has been unsubscribed.

You can choose the status assigned to your prospects upon their registration.

The status of your prospects will automatically move from Inactive to Active when they confirm their subscription to your list, provided that the registration confirmation URL you specified for this list through the interface of your autoresponder belongs to the website on which you installed Optin Manager. So that it works, you must also add:

Replace list with the ID or the name of your list, as explained in the Autoresponders section.

The activation confirmation/notification emails are sent only when the prospect status moves from Inactive to Active.

8. Display Of Informations About A Prospect

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

[prospect information id=N]

by replacing N with the ID of the prospect.

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

[prospect information]

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

Replace information with:

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 Optin Manager.

Example:

Status of the first prospect: [prospect status id=1]

Result:

Status of the first prospect:

8.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:

[prospect information default="text" id=N]

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

8.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:

[prospect information filter=function id=N]

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.

Example:

Status of the first prospect: [prospect status filter=i18n id=1]

Result:

Status of the first prospect:

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

[prospect information filter=function1/function2/…/functionN id=N]

The functions will be applied in the specified order.

9. Counters

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

[optin-counter data=data limit=L]
Data: [number][/optin-counter]

by replacing L with a positive number and data with:

When the limit is reached, the content between [optin-counter data=data limit=L] and [/optin-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:

[optin-counter data=data]
Data: [number][/optin-counter]

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

[optin-counter data=data limit=L]
When the data reaches [limit], this sentence will disappear!
[/optin-counter]

9.1 Display Of Numbers And The Limit

You are not limited to the [number] cotillion. You can use the following cotillions:

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

9.2 Automatic Content Substitution

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

[optin-counter data=data limit=L]
Data: [number][after]The limit is reached.[/optin-counter]

by replacing L with a positive number.

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

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

[optin-counter data=data limit=L]
The limit will be reached soon.
[after]The limit is reached.[/optin-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:

[optin-counter data=data limit=50/100]
The first limit will be reached soon.
[after]The second limit will be reached soon.
[after]The second limit has been reached.[/optin-counter]

You can use the following cotillions:

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

9.4 The range Attribute

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

[optin-counter data=data range=range limit=L]
Data: [number][/optin-counter]

Replace range with:

10. Counters Of Displays And Prospects

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

[optin-form-counter data=data limit=L id=N]
Already [number] prospects!
Only [remaining-number] prospects until the limit is reached!
[/optin-form-counter]

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

When the limit is reached, the content between [optin-form-counter data=data limit=L id=N] and [/optin-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:

[optin-form-counter data=data id=N]
Already [number] prospects!
[/optin-form-counter]

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

[optin-form-counter data=data limit=L id=N]
When the data reaches [limit], this sentence will disappear!
[/optin-form-counter]

10.1 Display Of Numbers And The Limit

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

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

10.2 Automatic Content Substitution

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

[optin-form-counter data=data limit=L id=N]
Data: [number][after]The limit is reached.[/optin-form-counter]

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

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

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

[optin-form-counter data=data limit=L id=N]
The limit will be reached soon.
[after]The limit is reached.[/optin-form-counter]

10.3 Succession Of Counters

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

[optin-form-counter data=data limit=50/100 id=N]
The first limit will be reached soon.
[after]The second limit will be reached soon.
[after]The second limit has been reached.[/optin-form-counter]

You can use the following cotillions:

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

10.4 Cumulative Counters Of Displays And Prospects

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:

[optin-form-counter data=prospects limit=L id=3+5]
Already [number] prospects!
Only [remaining-number] prospects until the limit is reached!
[/optin-form-counter]

11. Contents Restricted To Prospects

To display a content restricted to users who subscribed to one of your lists (useful to deliver your digital products on your registration confirmation pages), insert into your posts/pages/widgets a cotillion like this:

[optin-content]Content displayed if the user subscribed to one of your lists[/optin-content]

You can also define a content that will be displayed if the user did not subscribe to any of your lists, like this:

[optin-content]
Content displayed if the user subscribed to one of your lists[other]
Content displayed if the user did not subscribe to any of your lists
[/optin-content]

Result (with a little formatting):

Content displayed if the user did not subscribe to any of your lists

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

11.1 Content Specific To A List

To display a content restricted to users who subscribed to one of your lists, insert into your posts/pages/widgets a cotillion like this:

[optin-content list=list]
Thank you for your registration!
<a href="[optin-form gift-download-url id=N]">Click here to download your gift.</a>
[/optin-content]

Replace list with the name or the ID of the list.

11.2 Content Specific To Several Lists

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

[optin-content list=list1/list2/…/listN]Content displayed if you subscribed to at least one of these lists[/optin-content]

Example:

[optin-content list=list2/list3/list4]
Content displayed if you subscribed to at least one of these lists[other]
Content displayed if you did not subscribe to any of these lists
[/optin-content]

Result (with a little formatting):

Content displayed if you did not subscribe to any of these lists

12. Display Of The Options

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

[optin-manager option]

by replacing option with:

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 Optin Manager.

Example:

Initial status of the prospects: [optin-manager prospects-initial-status]

Result:

Initial status of the prospects: inactive

12.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:

[optin-manager option default="text"]

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

12.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:

[optin-manager option filter=function]

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:

Initial status of the prospects: [optin-manager prospects-initial-status filter=i18n]

Result:

Initial status of the prospects: inactive

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

[optin-manager option filter=function1/function2/…/functionN]

The functions will be applied in the specified order.

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 Optin 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 cotillion:

[optin-form gift-download-url filter=encrypt-url]

instead of this one:

[optin-form gift-download-url]

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

[optin-form gift-download-url part=1 filter=encrypt-url]

[optin-form gift-download-url part=2 filter=encrypt-url]

…

instead of this one:

[optin-form gift-download-url part=1]

[optin-form gift-download-url part=2]

…

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

You can download your gift by clicking the link below:

[optin-form gift-download-url filter=encrypt-url]

You have [optin-manager encrypted-urls-validity-duration] hours to download it. Then this link will no longer be valid.

You can also insert the cotillion above into the Instructions to the prospect field of the edit page of your form, and insert the following cotillion into the Body field of your registration confirmation email:

[optin-form instructions]

14. Emails

The registration confirmation/notification emails are sent when a user just subscribed to a list of your autoresponder through one of your forms. These emails are complementary to those sent by your autoresponder and do not replace them. The activation confirmation/notification emails are sent (if you have enabled the registration of prospects into your database) when someone just activated his subscription to a list of your autoresponder.

The activation confirmation/notification emails are complementary to those sent by your autoresponder and do not replace them.

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

When you don't use the id attribute, it is automatically set to the ID of the form (for the [optin-form] cotillion), and the ID of the prospect concerned by the confirmation/notification (for the [prospect] cotillion).

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

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

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

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

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

You can set a Reply-To address by inserting a text like this one into the Sender field of emails:

Name <email@address>, Reply-To: Reply To Name <reply-to-email@address>

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

Optin Manager allows you to subscribe your prospects to an autoresponder list. You must make the settings shown in this section so that it works.

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

For GetResponse, enter the TOKEN key of the list. For MailerLite, enter the ID of the group. You can get this information in this page by logging into your MailerLite account.

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 cotillion like this one into the Code field of your form:

<p><label><strong>List:</strong> [select autoresponder-list]
[option value=list1]List 1[/option]
[option value=list2]List 2[/option]
…
[option value=listN]List N[/option]
[/select]</label></p>

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

15.1 AWeber

You must make some adjustments so that Optin Manager works with AWeber. You have two methods. If the first doesn't work, try the second.

First method:

Go to this page to get your authorization cotillion and copy it to the API key field in the AWeber module of the Options page. Optin Manager will automatically extract your API key from it when you click a button to update your options.

Second method:

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 cotillion into the Trigger Rule field:

From:[^\n|.]+wordpress\@domain\.extension

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 cotillion into the Trigger Rule field instead of the previous cotillion:

From:[^\n|.]+w\@domain\.extension

Insert this cotillion into the Rule 1 field:

\n[>\s]*Email:\s+(.+?)\n

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

Insert this cotillion into the Rule 2 field:

\n[>\s]*Name:\s+(.+?)\n

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

Insert this cotillion into the Rule 3 field:

\n[>\s]*Referrer:\s+(.+?)\n

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 Optin Manager works with CyberMailing, but do not enable the protection against bots.

15.3 GetResponse

You must enter the API key of your GetResponse account in the Autoresponders integration module of the Options page of Optin Manager so that Optin 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 Optin Manager so that Optin Manager works with MailChimp. You can get your API key by logging into your MailChimp account.

15.5 MailerLite

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

15.6 Sendinblue

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

15.7 Sendy

You must enter the URL of your Sendy installation and your API key in the Autoresponders integration module of the Options page of Optin Manager so that Optin Manager works with Sendy. You can get your API key in the Settings page of Sendy.

15.8 SG Autorépondeur

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

If it doesn't work, make sure the cURL extension is enabled on the server that hosts your website.

16. Registration As A Client

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

If the user subscribes to one of your lists while logged in as a client, or by specifying an email address identical to that of an existing client, Optin Manager will not create a new client account, but will update the category of the client, if you want to assign the prospect to a client category.

Upon registration, if he has not provided a login name, the login name of the prospect 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 prospect his login name and his password, by inserting a cotillion like this one in the Body field of your registration confirmation email:

Your login name: [client login]
Your password: [client password default="the same as before"]

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

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

17. Registration To The Affiliate Program

You can register your prospects 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 Optin Manager supersede the modules of the same name in Affiliation Manager.

If the user subscribes to one of your lists while logged in as an affiliate, or by specifying an email address identical to that of an existing affiliate, Optin Manager will not create a new affiliate account, but will update the category of the affiliate, if you want to assign the prospect to an affiliate category.

Upon registration, if he has not provided a login name, the login name of the prospect 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 prospect his login name and his password, by inserting a cotillion like this one in the Body field of your registration confirmation email:

Your login name: [affiliate login]
Your password: [affiliate password default="the same as before"]

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

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

18. Membership

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

If the user subscribes to one of your lists while logged in as a member, or by specifying an email address identical to that of an existing member, Optin 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 prospect to a member category.

Upon registration, if he has not provided a login name, the login name of the prospect 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 prospect his login name and his password, by inserting a cotillion like this one in the Body field of your registration confirmation email:

Your login name: [member login]
Your password: [member password default="the same as before"]

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

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

19. WordPress

You can register your prospects as WordPress users. Upon registration, if he has not provided a login name, the login name of the prospect 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 subscribes to one of your lists while logged in as a WordPress user, or by specifying an email address identical to that of an existing WordPress user, Optin Manager will not create a new WordPress user account.

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

Your login name: [user login]
Your password: [user password]

You can insert cotillions into the Sender, Receiver, Subject and Body fields of registration confirmation/notification emails in order to display informations about the user. These cotillions 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 cotillion like this:

[user information]

by replacing information with:

Example:

Your login name: [user login]

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:

[user information default="text"]

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:

[user information filter=function]

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:

[user information filter=function1/function2/…/functionN]

The functions will be applied in the specified order.

21. Custom Instructions

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

Some PHP skills are required. In the PHP code field, you can enter a PHP code or the path (relative to the directory in which your wp-config.php file is located) of a PHP file on your website. In the latter case, it's the PHP code of this file that will be executed.

The custom instructions (for the registration of a prospect) are executed inside the includes/add-prospect.php file of Optin Manager. You can find where the custom instructions of other events are executed by opening all files of Optin 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 Optin Manager. You can execute different instructions depending on the form by doing a test on the $id variable set in the forms.php file of Optin Manager.

22. Affiliation

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

You can pay all the commissions on prospects 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 Optin Manager, add an unlimited number of custom fields in the Add Form, Add Form Category and Add Prospect 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 prospect, enter Favorite color as the name and favorite-color as the key.

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

[prospect custom-field-key id=N]

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

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

[input custom-field-key]

by replacing key with the key of the custom field.

24. Non-WordPress Static Websites

Optin 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 forms and prospects.

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 this model.

24.3 Loading Of WordPress

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

<?php
$wordpress_directory = 'WordPress directory';
$file = $wordpress_directory.'/wp-load.php';
while (strstr($file, '//')) { $file = str_replace('//', '/', $file); }
if (substr($file, 0, 1) == '/') { $file = substr($file, 1); }
$i = 0; while ((!file_exists($file)) && ($i < 8)) { $file = '../'.$file; $i = $i + 1; }
include_once $file;
?>

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:

$wordpress_directory = 'WordPress directory';

by this one:

$wordpress_directory = '';

Insert this line of cotillion:

<?php wp_head(); ?>

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

<?php wp_footer(); ?>

just before the </body> tag.

24.4 Use Of Cotillions

The documentation of Optin Manager provides you several cotillions. To use these cotillions in the PHP files of your website, insert a cotillion like this:

<?php echo do_shortcode('[your-cotillion]'); ?>

25. Advanced Customization

25.1 Custom Autoresponders

You can add an autoresponder that is not natively integrated with Optin Manager. To do this, create a plugin with a cotillion like this (simple version):

function add_my_autoresponder($autoresponders) {
$autoresponders['My Autoresponder'] = array('function' => 'subscribe_to_my_autoresponder');
return $autoresponders; }

add_filter('optin_autoresponders', 'add_my_autoresponder');


function subscribe_to_my_autoresponder($list, $contact) {
…
…
}

or like this one (more elaborate version):

function add_my_autoresponder($autoresponders) {
$autoresponders['My Autoresponder'] = array(
'function' => 'subscribe_to_my_autoresponder',
'display_function' => 'display_my_autoresponder',
'update_function' => 'update_my_autoresponder');
return $autoresponders; }

add_filter('optin_autoresponders', 'add_my_autoresponder');


function subscribe_to_my_autoresponder($list, $contact) {
…
…
}


function display_my_autoresponder($options, $back_office_options) { ?>
<table class="form-table"><tbody>
<tr style="vertical-align: top;"><th scope="row" style="width: 20%;"><strong><label for="my_autoresponder_api_key"><?php _e('API key', 'optin-manager'); ?></label></strong></th>
<td><textarea style="padding: 0 0.25em; height: 1.75em; width: 50%;" name="my_autoresponder_api_key" id="my_autoresponder_api_key" rows="1" cols="50"><?php echo (isset($options['my_autoresponder_api_key']) ? $options['my_autoresponder_api_key'] : ''); ?></textarea> 
<span class="description" style="vertical-align: 25%;"><a target="<?php echo $back_office_options['documentations_links_target']; ?>" href="https://www.kleor.com/optin-manager/documentation/#my-autoresponder"><?php _e('More informations', 'optin-manager'); ?></a></span></td></tr>
<tr style="vertical-align: top;"><th scope="row" style="width: 20%;"></th>
<td><input type="submit" class="button-secondary" name="submit" value="<?php _e('Update', 'optin-manager'); ?>" /></td></tr>
</tbody></table>
<?php }


function update_my_autoresponder($options) {
if (isset($_POST['my_autoresponder_api_key'])) {
$_POST['my_autoresponder_api_key'] = trim($_POST['my_autoresponder_api_key']);
$options['my_autoresponder_api_key'] = $_POST['my_autoresponder_api_key']; }
return $options; }

The subscribe_to_my_autoresponder function subscribes the user in a list of the autoresponder. The display_my_autoresponder function displays the options of the autoresponder in the Autoresponders integration module of the Options page of Optin Manager. And the update_my_autoresponder function updates these options when submitting the form of this page.

To better understand how to do this, look at the source code of this plugin.

25.2 Custom Files

You can replace all Optin Manager files (except optin-manager.php) with your own files. For this, create the optin-manager-custom-files folder in the plugins directory (the one where you installed Optin Manager) of your website.

For example, if you want to replace the includes/data.php file of Optin Manager with a file you have customized, create the includes folder in the optin-manager-custom-files folder, and upload your data.php file to this folder.

You can set yourself the directory where your custom files are stored, by inserting this line:

define('OPTIN_MANAGER_CUSTOM_FILES_PATH', ABSPATH.'custom-files/optin-manager/');

just after:

if ( !defined('ABSPATH') )
	define('ABSPATH', dirname(__FILE__) . '/');

in your wp-config.php file.

Replace custom-files/optin-manager with what you want. The value of OPTIN_MANAGER_CUSTOM_FILES_PATH must end with a /.

25.3 Custom Languages

Optin Manager is developed in English and contains files that translate it in French. If you wish, you can translate it into another language.

To do this, create your custom files directory by following these guidelines. Create the languages folder inside of it, and upload your translation files to this folder.

You can create your translation files with the languages/optin-manager.pot file of the plugin, and by using the free software Poedit. Your MO and PO translation files must be named like this:

optin-manager-ll_CC.mo
optin-manager-ll_CC.po

ll_CC is the value displayed by this line of cotillion:

echo get_locale();

when it's executed in one of the files of your WordPress website.

26. FAQ

26.1 Can I use cotillions in fields of admin pages?

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

26.2 How can I use cotillions in my WordPress theme?

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

<?php echo do_shortcode('[your-cotillion]'); ?>

26.3 How can I use cotillions in comments?

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

add_filter('comment_text', 'do_shortcode');

26.4 How can I use cotillions in attributes of cotillions?

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

[your-cotillion attribute='(your-other-cotillion)']

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

26.5 How can I nest several identical cotillions?

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

[optin-counter…]…
[optin-counter1…]…
[optin-counter2…]…
[optin-counter3…]…
[/optin-counter3]…
[/optin-counter2]…
[/optin-counter1]…
[/optin-counter]

27. Changelog