Contact Manager

Démarrage Rapide

Contact Manager vous permet d'insérer facilement dans les articles, pages et widgets de votre site Web des formulaires de contact (avec ou sans CAPTCHA). Vous pouvez créer un nombre illimité de formulaires et les personnaliser à volonté. Si vous le souhaitez, Contact Manager enregistre également les messages dans votre base de données, et vous permet d'offrir automatiquement un cadeau aux personnes qui vous envoient un message (très utile pour obtenir des avis de vos clients sur vos produits).

WordPress Télécharger

Sommaire

  1. Installation
  2. Mise à Jour
  3. Affichage des Formulaires [+]
    1. Redirection
    2. Positionnement Automatique du Curseur
    3. Précomplétion Automatique des Champs
    4. Affichage Automatique
    5. Attributs du Shortcode [contact-form]
  4. Création des Formulaires [+]
    1. Le Shortcode [input]
    2. Attributs du Shortcode [input]
    3. Le Shortcode [textarea]
    4. Attributs du Shortcode [textarea]
    5. Le Shortcode [select]
    6. Attributs du Shortcode [select]
    7. Le Shortcode [option]
    8. Attributs du Shortcode [option]
    9. Champs Obligatoires
    10. Messages d'Erreur
    11. Attributs du Shortcode [error]
    12. Le Shortcode [label]
    13. Attributs du Shortcode [label]
    14. CAPTCHAs
    15. Attributs du Shortcode [captcha]
    16. Double Saisie
    17. Pièces Jointes
    18. Le Bouton de Soumission
    19. Le Shortcode [validation-content]
  5. Affichage des Informations Concernant un Formulaire [+]
    1. L'Attribut default
    2. L'Attribut filter
    3. L'Attribut part
  6. Affichage des Informations Concernant une Catégorie de Formulaire [+]
    1. L'Attribut default
    2. L'Attribut filter
    3. L'Attribut part
    4. Affichage des Informations Concernant la Catégorie d'un Formulaire
  7. Affichage des Informations Concernant un Message ou un Expéditeur [+]
    1. L'Attribut default
    2. L'Attribut filter
  8. Compteurs [+]
    1. Affichage des Nombres et de la Limite
    2. Substitution Automatique de Contenu
    3. Succession de Compteurs
    4. L'Attribut range
  9. Compteurs d'Affichages et de Messages [+]
    1. Affichage des Nombres et de la Limite
    2. Substitution Automatique de Contenu
    3. Succession de Compteurs
    4. Compteurs d'Affichages et de Messages Cumulés
  10. Contenus Réservés aux Expéditeurs [+]
    1. Contenu Spécifique à un Formulaire
    2. Contenu Spécifique à Plusieurs Formulaires
  11. Affichage des Options [+]
    1. L'Attribut default
    2. L'Attribut filter
  12. Cadeau Offert à l'Expéditeur
  13. Cryptage des URLs
  14. E-Mails
  15. Autorépondeurs [+]
    1. AWeber
    2. CyberMailing
    3. GetResponse
    4. MailChimp
    5. SG Autorépondeur
  16. Inscription en tant que Client
  17. Inscription au Programme d'Affiliation
  18. Espace Membre
  19. WordPress
  20. Affichage des Informations Concernant l'Utilisateur [+]
    1. L'Attribut default
    2. L'Attribut filter
  21. Instructions Personnalisées
  22. Affiliation
  23. Champs Personnalisés
  24. Sites Statiques Non Gérés Par WordPress [+]
    1. Installation de WordPress
    2. Les Fichiers de Votre Site
    3. Chargement de WordPress
    4. Utilisation des Shortcodes
  25. Personnalisation Avancée [+]
    1. Autorépondeurs Personnalisés
    2. Fichiers Personnalisés
    3. Langues Personnalisées
  26. FAQ [+]
    1. Puis-je utiliser des shortcodes dans les champs des pages d'administration ?
    2. Comment puis-je utiliser des shortcodes dans mon thème WordPress ?
    3. Comment puis-je utiliser des shortcodes dans les commentaires ?
    4. Comment puis-je utiliser des shortcodes dans les attributs des shortcodes ?
    5. Comment puis-je imbriquer plusieurs shortcodes identiques ?
  27. Améliorations

Démarrage Rapide

Voici comment mettre en place un formulaire en moins de 20 secondes :

1. Insérez ce code :

[contact-form id=1]

dans vos articles/pages/widgets afin d'afficher ce formulaire.

C'est tout !

La page Back office de Contact Manager vous permet de personnaliser votre interface. Grâce à elle, vous pourrez afficher les éléments qui vous sont utiles et faire disparaître totalement les autres. Bref, vous obtiendrez une interface qui colle précisément à vos besoins. Nous vous conseillons de parcourir rapidement les pages de Contact Manager afin d'en avoir une vision globale, et de prendre ensuite le temps de bien configurer vos options.

1. Installation

Vous pouvez installer Contact Manager via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Mettre une extension en ligne). Envoyez le fichier du plugin sans le dézipper. Vous pouvez aussi l'installer comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier contact-manager, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins).

Lorsque vous avez installé Contact Manager :

  1. Activez le plugin via le menu Extensions de WordPress.
  2. Personnalisez l'interface du plugin via la page Back office de Contact Manager.
  3. Configurez le plugin via la page Options de Contact Manager.

2. Mise à Jour

Mettre à jour Contact Manager ne vous fait perdre aucun réglage, ni aucune donnée.

Vous pouvez mettre à jour Contact Manager via le menu Extensions de WordPress, et via la page Mises à jour de WordPress du menu Tableau de bord de WordPress (Tableau de bord => Mises à jour). Vous pouvez aussi le mettre à jour comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier contact-manager, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins), sans supprimer le dossier contact-manager déjà présent dans ce répertoire.

Vous n'avez pas besoin de désactiver puis réactiver le plugin.

3. Affichage des Formulaires

Pour afficher un formulaire (vous devez au préalable en avoir créé un via la page Ajouter un formulaire de Contact Manager), insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form id=N]

en remplaçant N par l'ID du formulaire.

3.1 Redirection

Par défaut, à l'issue de l'envoi de son message, l'internaute n'est pas redirigé vers une autre page. Pour le rediriger, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form redirection=URL id=N]

en remplaçant URL par l'URL vers laquelle vous souhaitez rediriger l'internaute et N par l'ID du formulaire.

Vous pouvez aussi rediriger l'internaute vers une partie précise de la page depuis laquelle il a soumis le formulaire, comme ceci :

[contact-form redirection=#votre-ancre id=N]

Pour le rediriger vers le début du formulaire, entrez simplement # comme valeur pour l'attribut redirection :

[contact-form redirection=# id=N]

Vous pouvez également le rediriger vers la page qu'il a consultée juste avant la page actuelle, si elle appartient à votre site, en entrant referring-url comme valeur pour l'attribut redirection :

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

3.2 Positionnement Automatique du Curseur

Vous pouvez décider, pour chacun de vos formulaires, si le curseur doit on non se positionner automatiquement dans le premier champ dès le chargement de la page. Cela vous permet d'améliorer sensiblement votre taux de conversion. Insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form focus=yes id=N]

en remplaçant N par l'ID du formulaire.

3.3 Précomplétion Automatique des Champs

Vous pouvez améliorer de façon importante votre taux de conversion en précomplétant automatiquement les champs du formulaire avec les informations de l'internaute dès le chargement de la page. Contact Manager vous permet de le faire lorsque le lien de la page a été envoyé via un autorépondeur, par vous ou l'un de vos affiliés.

Pour cela, ajoutez simplement :

  • ?nom-du-champ=valeur-du-champ à l'URL de votre page si celle-ci ne contient ni le caractère ?, ni le caractère #
  • &nom-du-champ=valeur-du-champ à l'URL de votre page si celle-ci contient le caractère ?, mais pas le caractère #

Exemple 1 (précomplétion automatique du prénom) :

https://www.kleor.com/your-opinion/?first-name=Nathan

Exemple 2 (précomplétion automatique de l'adresse e-mail) :

https://www.kleor.com/your-opinion/?email-address=nathanmorel@kleor.com

Exemple 3 (précomplétion automatique du prénom et de l'adresse e-mail) :

https://www.kleor.com/your-opinion/?first-name=Nathan&email-address=nathanmorel@kleor.com

Utilisez les tags dynamiques fournis par votre autorépondeur pour précompléter les champs.

3.4 Affichage Automatique

Contact Manager vous permet, via sa page Options, d'afficher automatiquement l'un de vos formulaires dans tous les articles de votre site. Vous pouvez choisir de n'afficher ce formulaire que dans les pages d'article seul. Vous pouvez également choisir le nombre maximal de formulaires affichés par page.

3.5 Attributs du Shortcode [contact-form]

Tous les attributs (sauf action, id et name) de la balise HTML <form> sont aussi disponibles pour le shortcode [contact-form], avec un rôle identique.

4. Création des Formulaires

La page Options de Contact Manager, ainsi que les pages d'édition d'un formulaire ou d'une catégorie de formulaire, comportent un champ intitulé Code. Vous devez insérer dans ce champ un code spécial. Ce code est très similaire à un code HTML de formulaire normal, à l'exception des caractéristiques suivantes :

  • La balise d'ouverture de formulaire <form>, ainsi que la balise de fermeture correspondante </form>, sont absentes.
  • Certaines balises HTML sont remplacées par des shortcodes. C'est notamment le cas de la balise <input />, remplacée par le shortcode [input].

4.1 Le Shortcode [input]

Insérez dans le champ Code un code comme celui-ci :

[input nom]

en remplaçant nom par :

  • address pour afficher un champ de formulaire permettant à l'internaute d'entrer son adresse
  • captcha pour afficher un champ de formulaire permettant à l'internaute d'entrer le CAPTCHA
  • content pour afficher un champ de formulaire permettant à l'internaute d'entrer le contenu de son message
  • country pour afficher un champ de formulaire permettant à l'internaute d'entrer son pays
  • email-address pour afficher un champ de formulaire permettant à l'internaute d'entrer son adresse e-mail
  • first-name pour afficher un champ de formulaire permettant à l'internaute d'entrer son prénom
  • last-name pour afficher un champ de formulaire permettant à l'internaute d'entrer son nom
  • login pour afficher un champ de formulaire permettant à l'internaute d'entrer son login
  • message-confirmation-email-sent pour afficher une case à cocher permettant à l'internaute de choisir de recevoir ou non un e-mail de confirmation de message
  • password pour afficher un champ de formulaire permettant à l'internaute d'entrer son mot de passe
  • phone-number pour afficher un champ de formulaire permettant à l'internaute d'entrer son numéro de téléphone
  • postcode pour afficher un champ de formulaire permettant à l'internaute d'entrer son code postal
  • subject pour afficher un champ de formulaire permettant à l'internaute d'entrer le sujet de son message
  • submit pour afficher un bouton permettant à l'internaute de soumettre le formulaire
  • town pour afficher un champ de formulaire permettant à l'internaute d'entrer sa commune
  • website-name pour afficher un champ de formulaire permettant à l'internaute d'entrer le nom de son site Web
  • website-url pour afficher un champ de formulaire permettant à l'internaute d'entrer l'URL de son site Web

Exemple :

<p><label><strong>Votre prénom :</strong> [input first-name]<br />[error first-name]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [input email-address]<br />[error email-address]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant un champ permettant à l'internaute d'entrer son prénom, un champ lui permettant d'entrer son adresse e-mail, et un bouton lui permettant de soumettre le formulaire.

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union, comme ceci :

[input votre-nom]

Vous pourrez alors afficher la valeur entrée par l'internaute pour ce champ dans les e-mails de confirmation/notification d'envoi de message, grâce au code suivant :

[message votre-nom]

4.2 Attributs du Shortcode [input]

Tous les attributs (sauf id et name) de la balise HTML <input /> sont aussi disponibles pour le shortcode [input], avec un rôle identique.

Exemple :

<p><label><strong>Votre prénom :</strong> [input first-name size=20]<br />[error first-name]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [input email-address size=30]<br />[error email-address]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant un champ d'une largeur de 20 caractères permettant à l'internaute d'entrer son prénom, un champ d'une largeur de 30 caractères lui permettant d'entrer son adresse e-mail, et un bouton lui permettant de soumettre le formulaire, dont le texte est Valider.

Vous pouvez utiliser l'attribut HTML5 pattern afin d'indiquer une syntaxe que le champ doit respecter. Dans votre expression régulière, remplacez les caractères [ et ] par leurs entités HTML correspondantes : &#91; et &#93;.

Exemple :

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

4.3 Le Shortcode [textarea]

Insérez dans le champ Code un code comme celui-ci :

[textarea nom]Contenu[/textarea]

en remplaçant Contenu par le contenu que vous souhaitez afficher dans la zone de texte avant que l'internaute complète le formulaire et nom par :

  • address pour afficher une zone de texte permettant à l'internaute d'entrer son adresse
  • captcha pour afficher une zone de texte permettant à l'internaute d'entrer le CAPTCHA
  • content pour afficher une zone de texte permettant à l'internaute d'entrer le contenu de son message
  • country pour afficher une zone de texte permettant à l'internaute d'entrer son pays
  • email-address pour afficher une zone de texte permettant à l'internaute d'entrer son adresse e-mail
  • first-name pour afficher une zone de texte permettant à l'internaute d'entrer son prénom
  • last-name pour afficher une zone de texte permettant à l'internaute d'entrer son nom
  • login pour afficher une zone de texte permettant à l'internaute d'entrer son login
  • password pour afficher une zone de texte permettant à l'internaute d'entrer son mot de passe
  • phone-number pour afficher une zone de texte permettant à l'internaute d'entrer son numéro de téléphone
  • postcode pour afficher une zone de texte permettant à l'internaute d'entrer son code postal
  • subject pour afficher une zone de texte permettant à l'internaute d'entrer le sujet de son message
  • town pour afficher une zone de texte permettant à l'internaute d'entrer sa commune
  • website-name pour afficher une zone de texte permettant à l'internaute d'entrer le nom de son site Web
  • website-url pour afficher une zone de texte permettant à l'internaute d'entrer l'URL de son site Web

Exemple :

<p><label><strong>Votre prénom :</strong> [textarea first-name][/textarea]<br />[error first-name]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [textarea email-address][/textarea]<br />[error email-address]</label></p>
<p><label><strong>Sujet de votre message :</strong> [textarea subject][/textarea]<br />[error subject]</label></p>
<p><label><strong>Contenu de votre message :</strong> [textarea content][/textarea]<br />[error content]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant une zone de texte permettant à l'internaute d'entrer son prénom, une zone de texte lui permettant d'entrer son adresse e-mail, une zone de texte lui permettant d'entrer le sujet de son message, une zone de texte lui permettant d'entrer le contenu de son message, et un bouton lui permettant de soumettre le formulaire.

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union, comme ceci :

[textarea votre-nom]Contenu[/textarea]

Vous pourrez alors afficher la valeur entrée par l'internaute pour ce champ dans les e-mails de confirmation/notification d'envoi de message, grâce au code suivant :

[message votre-nom]

4.4 Attributs du Shortcode [textarea]

Tous les attributs (sauf id et name) de la balise HTML <textarea> sont aussi disponibles pour le shortcode [textarea], avec un rôle identique.

Exemple :

<p><label><strong>Votre prénom :</strong> [textarea first-name cols=20 rows=1][/textarea]<br />[error first-name]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [textarea email-address cols=30 rows=1][/textarea]<br />[error email-address]</label></p>
<p><label><strong>Sujet de votre message :</strong> [textarea subject cols=60 rows=1][/textarea]<br />[error subject]</label></p>
<p><label><strong>Contenu de votre message :</strong> [textarea content cols=60 rows=10][/textarea]<br />[error content]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant une zone de texte de 20 colonnes et 1 ligne permettant à l'internaute d'entrer son prénom, une zone de texte de 30 colonnes et 1 ligne lui permettant d'entrer son adresse e-mail, une zone de texte de 60 colonnes et 1 ligne lui permettant d'entrer le sujet de son message, une zone de texte de 60 colonnes et 10 lignes lui permettant d'entrer le contenu de son message, et un bouton lui permettant de soumettre le formulaire.

4.5 Le Shortcode [select]

Le shortcode [select] a le même rôle que la balise HTML <select>. Insérez dans le champ Code un code comme celui-ci :

[select nom]Contenu[/select]

en remplaçant nom par :

  • country pour afficher une liste déroulante permettant à l'internaute de sélectionner son pays
  • postcode pour afficher une liste déroulante permettant à l'internaute de sélectionner son code postal
  • subject pour afficher une liste déroulante permettant à l'internaute de sélectionner le sujet de son message
  • town pour afficher une liste déroulante permettant à l'internaute de sélectionner sa commune

Exemple :

<p><label><strong>Votre pays :</strong> [select country]
[option]Canada[/option]
[option]France[/option]
[option]Suisse[/option]
[/select]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant une liste déroulante permettant à l'internaute de sélectionner son pays, et un bouton lui permettant de soumettre le formulaire.

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union, comme ceci :

[select votre-nom]Contenu[/select]

Vous pourrez alors afficher la valeur entrée par l'internaute pour ce champ dans les e-mails de confirmation/notification d'envoi de message, grâce au code suivant :

[message votre-nom]

Pour afficher très simplement une liste déroulante permettant à l'internaute de sélectionner un pays, insérez dans le champ Code le code suivant :

[country-selector]

4.6 Attributs du Shortcode [select]

Tous les attributs (sauf id et name) de la balise HTML <select> sont aussi disponibles pour les shortcodes [select] et [country-selector], avec un rôle identique.

4.7 Le Shortcode [option]

Le shortcode [option] a le même rôle que la balise HTML <option>. Insérez dans le champ Code un code comme celui-ci :

[option value="Valeur de l'option"]Nom de l'option[/option]

Si le nom et la valeur de l'option sont identiques, vous pouvez aussi insérer dans le champ Code un code comme celui-ci :

[option]Nom de l'option[/option]

Exemple :

<p><label><strong>Votre pays :</strong> [select country]
[option]Canada[/option]
[option]France[/option]
[option]Suisse[/option]
[/select]</label></p>
<div>[input submit value="Valider"]</div>

Le code ci-dessus affiche un formulaire contenant une liste déroulante permettant à l'internaute de sélectionner son pays, et un bouton lui permettant de soumettre le formulaire.

4.8 Attributs du Shortcode [option]

Tous les attributs de la balise HTML <option> sont aussi disponibles pour le shortcode [option], avec un rôle identique.

4.9 Champs Obligatoires

Par défaut, tous les champs de formulaires sont facultatifs. Pour insérer un champ obligatoire, utilisez un code comme celui-ci :

[input nom required=yes]

en remplaçant nom par l'un des éléments de cette liste ou le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union.

L'attribut required est aussi disponible pour les shortcodes [textarea], [select] et [country-selector].

4.10 Messages d'Erreur

Lorsque l'internaute ne complète pas l'un des champs obligatoires du formulaire, ou entre une adresse e-mail non valide, des messages d'erreur s'affichent. Vous pouvez personnaliser ces messages via la page Options de Contact Manager ou via la page d'édition du formulaire ou de la catégorie de formulaire.

Insérez dans le champ Code un code comme celui-ci :

[error nom]

en remplaçant nom par :

  • address pour afficher le message d'erreur d'adresse
  • content pour afficher le message d'erreur de contenu
  • country pour afficher le message d'erreur de pays
  • email-address pour afficher le message d'erreur d'adresse e-mail
  • first-name pour afficher le message d'erreur de prénom
  • invalid-captcha pour afficher le message d'erreur de CAPTCHA non valide
  • invalid-fields pour afficher le message d'erreur de champs non valides
  • last-name pour afficher le message d'erreur de nom
  • login pour afficher le message d'erreur de login
  • maximum-messages-quantity-reached pour afficher le message d'erreur de quantité maximale de messages atteinte par l'expéditeur
  • password pour afficher le message d'erreur de mot de passe
  • phone-number pour afficher le message d'erreur de numéro de téléphone
  • postcode pour afficher le message d'erreur de code postal
  • subject pour afficher le message d'erreur de sujet
  • town pour afficher le message d'erreur de commune
  • unfilled-fields pour afficher le message d'erreur de champs obligatoires non remplis
  • website-name pour afficher le message d'erreur de nom de site Web
  • website-url pour afficher le message d'erreur d'URL de site Web

Exemple :

<p><label><strong>Votre prénom :</strong> [input first-name]<br />[error first-name]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [input email-address]<br />[error email-address]</label></p>
<div>[input submit value="Valider"]</div>

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union, comme ceci :

[error votre-nom]

Pour afficher les messages d'erreur en rouge, ajoutez ce code à votre feuille de style CSS :

.error { color: #c00000; }

4.11 Attributs du Shortcode [error]

Tous les attributs (sauf id) de la balise HTML <span> sont aussi disponibles pour le shortcode [error], avec un rôle identique.

Vous pouvez configurer différents messages d'erreur pour chaque champ d'un formulaire, comme ceci :

[error champ data-nom-message="Votre message d'erreur"]

en remplaçant nom par :

  • failed-upload pour entrer le message d'échec de téléchargement
  • invalid-email-address pour entrer le message d'adresse e-mail non valide
  • invalid-field pour entrer le message de champ non valide
  • too-large-file pour entrer le message de fichier trop volumineux
  • unauthorized-extension pour entrer le message d'extension non autorisée
  • unfilled-field pour entrer le message de champ obligatoire non rempli

Exemple :

<p><label><strong>Votre prénom :</strong> [input first-name required=yes]<br />[error first-name data-unfilled-field-message="Le prénom est obligatoire."]</label></p>
<p><label><strong>Votre adresse e-mail :</strong> [input email-address]<br />[error email-address data-invalid-email-address-message="L'adresse e-mail n'est pas valide."]</label></p>
<div>[input submit value="Valider"]</div>

4.12 Le Shortcode [label]

Le shortcode [label] a le même rôle que la balise HTML <label>. Insérez dans le champ Code un code comme celui-ci :

[label nom]Contenu[/label]

en remplaçant nom par :

  • address pour relier le libellé au champ de l'adresse
  • content pour relier le libellé au champ du contenu
  • country pour relier le libellé au champ du pays
  • email-address pour relier le libellé au champ de l'adresse e-mail
  • first-name pour relier le libellé au champ du prénom
  • last-name pour relier le libellé au champ du nom
  • login pour relier le libellé au champ du login
  • password pour relier le libellé au champ du mot de passe
  • phone-number pour relier le libellé au champ du numéro de téléphone
  • postcode pour relier le libellé au champ du code postal
  • subject pour relier le libellé au champ du sujet
  • town pour relier le libellé au champ de la commune
  • website-name pour relier le libellé au champ du nom de site Web
  • website-url pour relier le libellé au champ de l'URL de site Web

Exemple :

<p>[label first-name]<strong>Votre prénom :</strong>[/label] [input first-name]<br />[error first-name]</p>
<p>[label email-address]<strong>Votre adresse e-mail :</strong>[/label] [input email-address]<br />[error email-address]</p>
<div>[input submit value="Valider"]</div>

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union, comme ceci :

[label votre-nom]Contenu[/label]

4.13 Attributs du Shortcode [label]

Tous les attributs (sauf for) de la balise HTML <label> sont aussi disponibles pour le shortcode [label], avec un rôle identique.

4.14 CAPTCHAs

Vous pouvez utiliser des CAPTCHAs dans vos formulaires. Insérez dans le champ Code un code comme celui-ci :

[captcha type=type]

en remplaçant type par :

  • arithmetic pour afficher un CAPTCHA de type Opération arithmétique
  • question pour afficher un CAPTCHA de type Question
  • recaptcha pour afficher un CAPTCHA de type reCAPTCHA
  • reversed-string pour afficher un CAPTCHA de type Chaîne inversée

Pour utiliser un CAPTCHA de type reCAPTCHA, vous devez obtenir une clé publique et une clé privée ici et les renseigner dans le module CAPTCHA de la page Options de Contact Manager.

Vous pourrez alors choisir le thème que vous souhaitez utiliser, comme ceci :

[captcha type=recaptcha theme=thème]

en remplaçant thème par :

  • blackglass pour le thème Black Glass
  • clean pour le thème Clean
  • red pour le thème Red
  • white pour le thème White

Exemple 1 (CAPTCHA de type reCAPTCHA) :

[captcha type=recaptcha theme=blackglass]

Exemple 2 (CAPTCHA de type Opération arithmétique) :

<p>[captcha type=arithmetic] = [input captcha size=3] (entrez votre réponse en chiffres)</p>

Exemple 3 (CAPTCHA de type Chaîne inversée) :

<p>Tapez les caractères suivants dans l'ordre inverse :<br />
[captcha type=reversed-string] : [input captcha size=20]</p>

Exemple 4 (CAPTCHA de type Question) :

<p>[captcha type=question question="Question" answer="Réponse correcte"] [input captcha size=20]</p>

4.15 Attributs du Shortcode [captcha]

Tous les attributs de la balise HTML <span> sont aussi disponibles pour le shortcode [captcha], avec un rôle identique, si et seulement si vous n'utilisez pas un CAPTCHA de type reCAPTCHA.

4.16 Double Saisie

Vous pouvez exiger la double saisie d'un champ du formulaire (adresse e-mail, mot de passe, etc.), comme ceci :

[input confirm-nom]

en remplaçant nom par le nom du champ que l'internaute doit saisir une seconde fois.

Exemple :

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

<p><label><strong>Confirmez votre adresse e-mail :</strong><br />
[input confirm-email-address size=40]<br />[error confirm-email-address]</label></p>

4.17 Pièces Jointes

Pour afficher un champ de formulaire permettant à l'internaute d'uploader une pièce jointe, insérez dans le champ Code un code comme celui-ci :

[input nom type=file]

en remplaçant nom par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union.

Exemple :

<p><strong>Votre fichier :</strong><br />
[input attachment type=file]<br />
[error attachment]</p>

Vous pouvez limiter la taille du fichier que l'internaute peut uploader en utilisant l'attribut maxsize, comme ceci :

[input nom type=file maxsize=N]

en remplaçant N par la taille maximale du fichier en kilo-octets.

Vous pouvez également n'accepter que certains types de fichiers grâce à l'attribut extensions, comme ceci :

[input nom type=file extensions=extension1/extension2/…/extensionN]

en séparant les différentes extensions par /.

Exemple :

<p><strong>Votre fichier :</strong><br />
[input attachment type=file extensions=jpg/jpeg/png/pdf/zip]<br />
[error attachment]</p>

4.18 Le Bouton de Soumission

Pour afficher un bouton permettant à l'internaute de soumettre le formulaire, insérez dans le champ Code un code comme celui-ci :

[input submit value="Texte du bouton"]

en remplaçant Texte du bouton par le texte de votre bouton.

Si vous souhaitez utiliser une image, insérez un code comme celui-ci :

[input submit type=image src="URL de l'image" alt="Texte alternatif"]

en remplaçant URL de l'image par l'URL de l'image de votre bouton et Texte alternatif par le texte affiché lorsque l'image ne peut pas être affichée.

Vous pouvez aussi utiliser la balise HTML <button>, comme ceci :

<button type="submit">Texte du bouton</button>

4.19 Le Shortcode [validation-content]

Pour afficher un contenu réservé aux internautes ayant soumis le formulaire sans qu'aucune erreur ne soit générée, insérez dans le champ Code un code comme celui-ci :

[validation-content]Contenu affiché si l'internaute a soumis le formulaire et si aucune erreur n'a été générée[/validation-content]

Vous pouvez aussi définir un contenu qui sera affiché si l'internaute a soumis le formulaire et si au moins une erreur a été générée, comme ceci :

[validation-content]
Contenu affiché si l'internaute a soumis le formulaire et si aucune erreur n'a été générée[other]
Contenu affiché si l'internaute a soumis le formulaire et si au moins une erreur a été générée
[/validation-content]

Exemple :

[validation-content]
<p style="color: green;">Votre message a été envoyé avec succès. S'il nécessite une réponse, nous vous répondrons normalement sous 48 heures.</p>
[other]<p style="color: red;">[error maximum-messages-quantity-reached] [error unfilled-fields] [error invalid-captcha]</p>
[/validation-content]

Vous pouvez aussi définir un contenu qui sera affiché si l'internaute n'a pas soumis le formulaire, comme ceci :

[validation-content]
Contenu affiché si l'internaute a soumis le formulaire et si aucune erreur n'a été générée[other]
Contenu affiché si l'internaute a soumis le formulaire et si au moins une erreur a été générée[other]
Contenu affiché si l'internaute n'a pas soumis le formulaire
[/validation-content]

5. Affichage des Informations Concernant un Formulaire

Pour afficher une information concernant un formulaire, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form information id=N]

en remplaçant N par l'ID du formulaire et information par :

  • category-id pour afficher l'ID de la catégorie
  • commission-amount pour afficher le montant de la commission de niveau 1
  • commission2-amount pour afficher le montant de la commission de niveau 2
  • date pour afficher la date de création
  • date-utc pour afficher la date de création par rapport au temps UTC
  • description pour afficher la description
  • displays-count pour afficher le nombre d'affichages
  • gift-download-url pour afficher l'URL de téléchargement du cadeau
  • gift-instructions pour afficher les instructions relatives au cadeau
  • id pour afficher l'ID
  • keywords pour afficher les mots clés
  • maximum-messages-quantity pour afficher la quantité maximale de messages conservés dans votre base de données
  • maximum-messages-quantity-per-sender pour afficher la quantité maximale de messages par expéditeur
  • messages-count pour afficher le nombre de messages
  • name pour afficher le nom

Cette liste n'est pas exhaustive et ne présente que les éléments les plus pertinents. Vous pouvez trouver toutes les valeurs possibles de information dans le fichier tables.php de Contact Manager.

Exemple :

[contact-form name id=1]

Résultat :

Contact

5.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'information lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[contact-form information default="texte" id=N]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

5.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'information avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[contact-form information filter=fonction id=N]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'information est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[contact-form information filter=fonction1/fonction2/…/fonctionN id=N]

Les fonctions seront appliquées dans l'ordre indiqué.

5.3 L'Attribut part

Vous pouvez entrer plusieurs URLs dans le champ URL de téléchargement du cadeau des pages d'édition de vos formulaires, en séparant les différentes URLs par des virgules. Si l'un de vos cadeaux compte plusieurs URLs de téléchargement, vous pouvez afficher la n-ième URL de téléchargement en utilisant l'attribut part, comme ceci :

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

Exemple :

Première URL de téléchargement : [contact-form gift-download-url part=1 id=N]
Deuxième URL de téléchargement : [contact-form gift-download-url part=2 id=N]
Troisième URL de téléchargement : [contact-form gift-download-url part=3 id=N]
…

6. Affichage des Informations Concernant une Catégorie de Formulaire

Pour afficher une information concernant une catégorie de formulaire, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form-category information id=N]

en remplaçant N par l'ID de la catégorie de formulaire et information par :

  • category-id pour afficher l'ID de la catégorie
  • commission-amount pour afficher le montant de la commission de niveau 1
  • commission2-amount pour afficher le montant de la commission de niveau 2
  • date pour afficher la date de création
  • date-utc pour afficher la date de création par rapport au temps UTC
  • description pour afficher la description
  • gift-download-url pour afficher l'URL de téléchargement du cadeau
  • gift-instructions pour afficher les instructions relatives au cadeau
  • id pour afficher l'ID
  • keywords pour afficher les mots clés
  • maximum-messages-quantity pour afficher la quantité maximale de messages conservés dans votre base de données
  • name pour afficher le nom

Cette liste n'est pas exhaustive et ne présente que les éléments les plus pertinents. Vous pouvez trouver toutes les valeurs possibles de information dans le fichier tables.php de Contact Manager.

Exemple :

[contact-form-category name id=1]

Résultat :

Formulaires

6.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'information lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[contact-form-category information default="texte" id=N]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

6.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'information avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[contact-form-category information filter=fonction id=N]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'information est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[contact-form-category information filter=fonction1/fonction2/…/fonctionN id=N]

Les fonctions seront appliquées dans l'ordre indiqué.

6.3 L'Attribut part

Vous pouvez entrer plusieurs URLs dans le champ URL de téléchargement du cadeau des pages d'édition de vos catégories de formulaires, en séparant les différentes URLs par des virgules. Si l'un de vos cadeaux compte plusieurs URLs de téléchargement, vous pouvez afficher la n-ième URL de téléchargement en utilisant l'attribut part, comme ceci :

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

Exemple :

Première URL de téléchargement : [contact-form-category gift-download-url part=1 id=N]
Deuxième URL de téléchargement : [contact-form-category gift-download-url part=2 id=N]
Troisième URL de téléchargement : [contact-form-category gift-download-url part=3 id=N]
…

6.4 Affichage des Informations Concernant la Catégorie d'un Formulaire

Vous pouvez entrer un shortcode pour l'attribut id, à condition de remplacer [ par ( et ] par ). Cela vous permet d'afficher une information concernant la catégorie d'un formulaire, comme ceci :

[contact-form-category information id="(votre-shortcode)"]

N'oubliez pas les guillemets au début et à la fin du shortcode.

Exemple :

Catégorie de [contact-form name id=1] : [contact-form-category name default="Aucune" id="(contact-form category-id id=1)"]

Résultat :

Catégorie de Contact : Formulaires

7. Affichage des Informations Concernant un Message ou un Expéditeur

Pour afficher une information concernant un message ou un expéditeur, insérez dans vos articles/pages/widgets un code comme celui-ci :

[message information id=N]

ou celui-ci :

[sender information id=N]

en remplaçant N par l'ID du message.

Vous pouvez aussi insérer ces shortcodes dans vos e-mails de confirmation/notification d'envoi de message. Vous n'êtes alors pas obligé d'utiliser l'attribut id, comme ceci :

[message information]

ou :

[sender information]

Lorsque vous n'utilisez pas l'attribut id, celui-ci prend automatiquement comme valeur l'ID du message faisant l'objet de la confirmation/notification.

Remplacez information par :

  • address pour afficher l'adresse de l'expéditeur
  • content pour afficher le contenu
  • country pour afficher le pays de l'expéditeur
  • date pour afficher la date
  • date-utc pour afficher la date par rapport au temps UTC
  • email-address pour afficher l'adresse e-mail de l'expéditeur
  • first-name pour afficher le prénom de l'expéditeur
  • form-id pour afficher l'ID du formulaire
  • id pour afficher l'ID
  • ip-address pour afficher l'adresse IP de l'expéditeur
  • keywords pour afficher les mots clés
  • last-name pour afficher le nom de l'expéditeur
  • phone-number pour afficher le numéro de téléphone de l'expéditeur
  • postcode pour afficher le code postal de l'expéditeur
  • receiver pour afficher le destinataire
  • referring-url pour afficher l'URL référente de l'expéditeur
  • subject pour afficher le sujet
  • town pour afficher la commune de l'expéditeur
  • user-agent pour afficher le navigateur de l'expéditeur
  • website-name pour afficher le nom du site Web de l'expéditeur
  • website-url pour afficher l'URL du site Web de l'expéditeur

Cette liste n'est pas exhaustive et ne présente que les éléments les plus pertinents. Vous pouvez trouver toutes les valeurs possibles de information dans le fichier tables.php de Contact Manager.

Exemple :

Sujet du premier message : [message subject id=1]

Résultat :

Sujet du premier message : Test

En dehors des noms standards listés plus haut, vous pouvez aussi remplacer information par le nom que vous voulez, à condition qu'il ne contienne que des lettres minuscules sans accents, chiffres et traits d'union. Si vous avez utilisé un nom de champ personnalisé dans votre formulaire, vous pouvez alors afficher la valeur entrée par l'internaute pour ce champ dans les e-mails de confirmation/notification d'envoi de message, grâce au code suivant :

[message votre-nom]

7.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'information lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[message information default="texte" id=N]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

7.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'information avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[message information filter=fonction id=N]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'information est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[message information filter=fonction1/fonction2/…/fonctionN id=N]

Les fonctions seront appliquées dans l'ordre indiqué.

8. Compteurs

Pour afficher un compteur, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-counter data=donnée limit=L]
Donnée : [number][/contact-counter]

en remplaçant L par un nombre positif et donnée par :

  • forms pour compter le nombre de formulaires
  • forms-categories pour compter le nombre de catégories de formulaires
  • messages pour compter le nombre de messages

Lorsque la donnée atteint la limite L, le contenu entre [contact-counter data=donnée limit=L] et [/contact-counter] disparaît. Vous pouvez mettre en forme ce contenu comme n'importe quel autre contenu de votre site Web. L'attribut limit est facultatif. Si vous ne l'utilisez pas, le contenu ne disparaîtra pas :

[contact-counter data=donnée]
Donnée : [number][/contact-counter]

Vous pouvez insérer le shortcode [number] autant de fois que vous le souhaitez entre [contact-counter data=donnée limit=L] et [/contact-counter]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Contact Manager vous permet de programmer une disparition de contenu sans afficher de compteur :

[contact-counter data=donnée limit=L]
Lorsque la donnée aura atteint [limit], cette phrase disparaîtra !
[/contact-counter]

8.1 Affichage des Nombres et de la Limite

Vous n'êtes pas limité au shortcode [number]. Vous pouvez utiliser les shortcodes suivants :

  • [limit] pour afficher la limite
  • [number] pour afficher la donnée
  • [remaining-number] pour afficher la différence entre la limite et la donnée

L'attribut filter (défini ici) est disponible pour ces shortcodes.

8.2 Substitution Automatique de Contenu

Si vous souhaitez programmer une substitution de contenu, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-counter data=donnée limit=L]
Donnée : [number][after]La limite a été atteinte.[/contact-counter]

en remplaçant L par un nombre positif.

Insérez le contenu que vous souhaitez substituer entre [after] et [/contact-counter]. Lorsque la donnée atteint la limite L, le contenu entre [contact-counter data=donnée limit=L] et [after] disparaît, et le contenu entre [after] et [/contact-counter] apparaît. Le contenu entre [after] et [/contact-counter] n'est jamais envoyé au navigateur avant que la limite soit atteinte.

Vous pouvez insérer le shortcode [number] autant de fois que vous le souhaitez entre [contact-counter data=donnée limit=L] et [/contact-counter]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Contact Manager vous permet de programmer une substitution de contenu sans afficher de compteur :

[contact-counter data=donnée limit=L]
La limite sera bientôt atteinte.
[after]La limite a été atteinte.[/contact-counter]

8.3 Succession de Compteurs

Il est possible de spécifier plusieurs limites pour l'attribut limit, en séparant les différentes limites par /, comme ceci :

[contact-counter data=donnée limit=50/100]
La première limite sera bientôt atteinte.
[after]La deuxième limite sera bientôt atteinte.
[after]La deuxième limite a été atteinte.[/contact-counter]

Vous pouvez utiliser les shortcodes suivants :

  • [limit] pour afficher la limite actuelle
  • [number] pour afficher la différence entre la donnée actuelle et la limite précédente
  • [remaining-number] pour afficher la différence entre la limite actuelle et la donnée actuelle
  • [total-limit] pour afficher la dernière limite de l'attribut limit
  • [total-number] pour afficher la donnée actuelle
  • [total-remaining-number] pour afficher la différence entre la dernière limite de l'attribut limit et la donnée actuelle

L'attribut filter (défini ici) est disponible pour ces shortcodes.

8.4 L'Attribut range

Vous pouvez compter uniquement les données enregistrées durant une certaine période en utilisant l'attribut range, comme ceci :

[contact-counter data=donnée range=période limit=L]
Donnée : [number][/contact-counter]

Remplacez période par :

  • un nombre positif N pour compter uniquement les données enregistrées durant les N derniers jours
  • previous-week pour compter uniquement les données enregistrées durant la semaine précédente
  • previous-half-month pour compter uniquement les données enregistrées durant le demi-mois précédent
  • previous-month pour compter uniquement les données enregistrées durant le mois précédent
  • previous-bimester pour compter uniquement les données enregistrées durant le bimestre précédent
  • previous-trimester pour compter uniquement les données enregistrées durant le trimestre précédent
  • previous-quadrimester pour compter uniquement les données enregistrées durant le quadrimestre précédent
  • previous-semester pour compter uniquement les données enregistrées durant le semestre précédent
  • previous-year pour compter uniquement les données enregistrées durant l'année précédente

9. Compteurs d'Affichages et de Messages

Pour afficher un compteur d'affichages/messages, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form-counter data=donnée limit=L id=N]
Déjà [number] messages !
Plus que [remaining-number] messages avant que la limite soit atteinte !
[/contact-form-counter]

en remplaçant L par un nombre positif, N par l'ID du formulaire et donnée par :

  • displays pour compter le nombre d'affichages
  • messages pour compter le nombre de messages

Lorsque la donnée atteint la limite L, le contenu entre [contact-form-counter data=donnée limit=L id=N] et [/contact-form-counter] disparaît. Vous pouvez mettre en forme ce contenu comme n'importe quel autre contenu de votre site Web. L'attribut limit est facultatif. Si vous ne l'utilisez pas, le contenu ne disparaîtra pas :

[contact-form-counter data=donnée id=N]
Déjà [number] messages !
[/contact-form-counter]

Vous pouvez insérer les shortcodes [number] et [remaining-number] autant de fois que vous le souhaitez entre [contact-form-counter data=donnée limit=L id=N] et [/contact-form-counter]. Vous pouvez même ne pas les insérer du tout. Dans ce cas, Contact Manager vous permet de programmer une disparition de contenu sans afficher de compteur :

[contact-form-counter data=donnée limit=L id=N]
Lorsque la donnée aura atteint [limit], cette phrase disparaîtra !
[/contact-form-counter]

9.1 Affichage des Nombres et de la Limite

Vous n'êtes pas limité aux shortcodes [number] et [remaining-number]. Vous pouvez utiliser les shortcodes suivants :

  • [limit] pour afficher la limite
  • [number] pour afficher la donnée
  • [remaining-number] pour afficher la différence entre la limite et la donnée

L'attribut filter (défini ici) est disponible pour ces shortcodes.

9.2 Substitution Automatique de Contenu

Si vous souhaitez programmer une substitution de contenu, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-form-counter data=donnée limit=L id=N]
Donnée : [number][after]La limite a été atteinte.[/contact-form-counter]

en remplaçant L par un nombre positif et N par l'ID du formulaire.

Insérez le contenu que vous souhaitez substituer entre [after] et [/contact-form-counter]. Lorsque la donnée atteint la limite L, le contenu entre [contact-form-counter data=donnée limit=L id=N] et [after] disparaît, et le contenu entre [after] et [/contact-form-counter] apparaît. Le contenu entre [after] et [/contact-form-counter] n'est jamais envoyé au navigateur avant que la limite soit atteinte.

Vous pouvez insérer les shortcodes [number] et [remaining-number] autant de fois que vous le souhaitez entre [contact-form-counter data=donnée limit=L id=N] et [/contact-form-counter]. Vous pouvez même ne pas les insérer du tout. Dans ce cas, Contact Manager vous permet de programmer une substitution de contenu sans afficher de compteur :

[contact-form-counter data=donnée limit=L id=N]
La limite sera bientôt atteinte.
[after]La limite a été atteinte.[/contact-form-counter]

9.3 Succession de Compteurs

Il est possible de spécifier plusieurs limites pour l'attribut limit, en séparant les différentes limites par /, comme ceci :

[contact-form-counter data=donnée limit=50/100 id=N]
La première limite sera bientôt atteinte.
[after]La deuxième limite sera bientôt atteinte.
[after]La deuxième limite a été atteinte.[/contact-form-counter]

Vous pouvez utiliser les shortcodes suivants :

  • [limit] pour afficher la limite actuelle
  • [number] pour afficher la différence entre la donnée actuelle et la limite précédente
  • [remaining-number] pour afficher la différence entre la limite actuelle et la donnée actuelle
  • [total-limit] pour afficher la dernière limite de l'attribut limit
  • [total-number] pour afficher la donnée actuelle
  • [total-remaining-number] pour afficher la différence entre la dernière limite de l'attribut limit et la donnée actuelle

L'attribut filter (défini ici) est disponible pour ces shortcodes.

9.4 Compteurs d'Affichages et de Messages Cumulés

Vous pouvez compter les données cumulées de plusieurs de vos formulaires, en spécifiant plusieurs IDs pour l'attribut id. Séparez les différents IDs par le signe +, comme ceci :

[contact-form-counter data=messages limit=L id=3+5]
Déjà [number] messages !
Plus que [remaining-number] messages avant que la limite soit atteinte !
[/contact-form-counter]

10. Contenus Réservés aux Expéditeurs

Pour afficher un contenu réservé aux internautes qui vous ont envoyé un message, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-content]Contenu affiché si l'internaute vous a envoyé un message[/contact-content]

Vous pouvez aussi définir un contenu qui sera affiché si l'internaute ne vous a envoyé aucun message, comme ceci :

[contact-content]
Contenu affiché si l'internaute vous a envoyé un message[other]
Contenu affiché si l'internaute ne vous a envoyé aucun message
[/contact-content]

Résultat (avec un peu de mise en forme) :

Contenu affiché si l'internaute ne vous a envoyé aucun message

L'internaute est reconnu grâce à son adresse IP. Pour que cela fonctionne, vous devez avoir activé l'enregistrement des messages.

10.1 Contenu Spécifique à un Formulaire

Pour afficher un contenu réservé aux internautes qui vous ont envoyé un message via l'un de vos formulaires, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-content id=N]
Merci ! <a href="[contact-form gift-download-url id=N]">Cliquez ici pour télécharger votre cadeau.</a>
[/contact-content]

Remplacez N par l'ID du formulaire.

10.2 Contenu Spécifique à Plusieurs Formulaires

Il est possible de spécifier plusieurs IDs pour l'attribut id, en séparant les différents IDs par /, comme ceci :

[contact-content id=id1/id2/…/idN]Contenu affiché si vous avez envoyé un message via au moins 1 de ces formulaires[/contact-content]

Exemple :

[contact-content id=2/3/4]
Contenu affiché si vous avez envoyé un message via au moins 1 de ces formulaires[other]
Contenu affiché si vous n'avez envoyé aucun message via l'un de ces formulaires
[/contact-content]

Résultat (avec un peu de mise en forme) :

Contenu affiché si vous n'avez envoyé aucun message via l'un de ces formulaires

11. Affichage des Options

Pour afficher une option de Contact Manager, insérez dans vos articles/pages/widgets un code comme celui-ci :

[contact-manager option]

en remplaçant option par :

  • automatic-display-enabled pour afficher l'activation de l'affichage automatique (valeurs possibles : yes, no)
  • automatic-display-form-id pour afficher l'ID du formulaire affiché automatiquement dans tous les articles
  • automatic-display-location pour afficher la position du formulaire affiché automatiquement dans tous les articles (valeurs possibles : bottom, top)
  • automatic-display-maximum-forms-quantity pour afficher la quantité maximale de formulaires automatiquement affichés par page
  • automatic-display-only-on-single-post-pages pour afficher l'activation de l'affichage automatique uniquement sur les pages d'article seul (valeurs possibles : yes, no)
  • commission-amount pour afficher le montant de la commission de niveau 1
  • commission2-amount pour afficher le montant de la commission de niveau 2
  • encrypted-urls-validity-duration pour afficher la durée de validité des URLs cryptées
  • maximum-messages-quantity pour afficher la quantité maximale de messages conservés dans votre base de données
  • version pour afficher la version de Contact Manager

Cette liste n'est pas exhaustive et ne présente que les éléments les plus pertinents. Vous pouvez trouver toutes les valeurs possibles de option dans le fichier initial-options.php de Contact Manager.

Exemple :

Enregistrement des messages activé : [contact-manager messages-registration-enabled]

Résultat :

Enregistrement des messages activé : no

11.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'option lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[contact-manager option default="texte"]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

11.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'option avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[contact-manager option filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'option est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Exemple :

Enregistrement des messages activé : [contact-manager messages-registration-enabled filter=i18n]

Résultat :

Enregistrement des messages activé : non

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[contact-manager option filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

12. Cadeau Offert à l'Expéditeur

Vous pouvez offrir un cadeau aux internautes qui vous envoient un message, en complétant les champs du module Cadeau.

Par exemple, entrez ceci dans le champ Instructions pour l'expéditeur :

Cliquez sur le lien ci-dessous pour télécharger votre cadeau :

[contact-form gift-download-url]

N'oubliez pas d'insérer le code suivant où vous le souhaitez dans le corps de votre e-mail de confirmation d'envoi de message :

[contact-form gift-instructions]

Vous pouvez aussi offrir votre cadeau directement sur la page sur laquelle se trouve le formulaire grâce au shortcode [validation-content]. Insérez dans le champ Code de la page d'édition du formulaire un code comme celui-ci :

[validation-content]
Merci ! <a href="[contact-form gift-download-url]">Cliquez ici pour télécharger votre cadeau.</a>
[/validation-content]

13. Cryptage des URLs

Vous pouvez livrer vos produits numériques à l'aide d'URLs de téléchargement cryptées. La clé de cryptage ainsi que la durée de validité des URLs cryptées sont configurables via la page Options de Contact Manager. Entrez une chaîne de caractères difficile à deviner dans le champ Clé de cryptage.

Pour livrer vos produits numériques à l'aide d'URLs de téléchargement cryptées, utilisez le code suivant :

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

à la place de celui-ci :

[contact-form gift-download-url]

Si votre produit numérique compte plusieurs URLs de téléchargement, utilisez le code suivant :

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

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

…

à la place de celui-ci :

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

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

…

Dans le champ Corps de votre e-mail de confirmation d'envoi de message, vous pouvez par exemple insérer un code comme celui-ci :

Vous pouvez télécharger votre cadeau en cliquant sur le lien ci-dessous :

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

Il vous reste [contact-manager encrypted-urls-validity-duration] heures pour le faire. Ensuite, ce lien ne sera plus valide.

Vous pouvez aussi insérer le code ci-dessus dans le champ Instructions pour l'expéditeur de la page d'édition de votre formulaire, et insérer le code suivant dans le le champ Corps de votre e-mail de confirmation d'envoi de message :

[contact-form gift-instructions]

14. E-Mails

Vous pouvez insérer des shortcodes dans les champs Expéditeur, Destinataire, Sujet et Corps des e-mails afin d'afficher des informations concernant l'expéditeur, le message et le formulaire. Ces shortcodes sont tout simplement les mêmes que ceux présentés dans les sections Affichage des Informations Concernant un Formulaire et Affichage des Informations Concernant un Message ou un Expéditeur.

Lorsque vous n'utilisez pas l'attribut id, celui-ci prend automatiquement comme valeur l'ID du formulaire via lequel le message a été envoyé pour le shortcode [contact-form], et l'ID du message faisant l'objet de la confirmation/notification pour le shortcode [message].

Vous pouvez plus généralement insérer dans ces champs tous les shortcodes disponibles sur votre site.

Si vous inscrivez l'expéditeur en tant que client, vous pouvez insérer dans ces champs des shortcodes afin d'afficher des informations (login et mot de passe notamment) concernant le client. Ces shortcodes sont présentés dans cette section.

Si vous inscrivez l'expéditeur à votre programme d'affiliation, vous pouvez insérer dans ces champs des shortcodes afin d'afficher des informations (login et mot de passe notamment) concernant l'affilié. Ces shortcodes sont présentés dans cette section.

Si vous inscrivez l'expéditeur dans un ou plusieurs de vos espaces membres, vous pouvez insérer dans ces champs des shortcodes afin d'afficher des informations (login et mot de passe notamment) concernant le membre. Ces shortcodes sont présentés dans cette section.

Si vous inscrivez l'expéditeur en tant qu'utilisateur WordPress, vous pouvez insérer dans ces champs des shortcodes afin d'afficher des informations (login et mot de passe notamment) concernant l'utilisateur. Ces shortcodes sont présentés dans cette section.

Vous pouvez aussi entrer plusieurs adresses e-mail séparées par des virgules dans le champ Destinataire des e-mails. Vous pouvez également insérer du code HTML dans le champ Corps des e-mails.

15. Autorépondeurs

Contact Manager vous permet d'inscrire les expéditeurs dans une liste d'autorépondeur. Vous devez effectuer les réglages indiqués dans cette section pour que cela fonctionne.

Pour les autorépondeurs suivants, vous devez entrer l'ID de la liste dans le champ Liste du module Autorépondeurs :

  • AWeber
  • CyberMailing
  • MailChimp
  • SG Autorépondeur

Pour les autres autorépondeurs, entrez le nom de la liste.

Vous pouvez trouver l'ID d'une liste MailChimp dans la page List name & defaults.

Vous pouvez permettre à l'internaute de choisir une liste d'autorépondeur en insérant un code comme celui-ci dans le champ Code de votre formulaire :

<p><label><strong>Liste :</strong> [select autoresponder-list]
[option value=liste1]Liste 1[/option]
[option value=liste2]Liste 2[/option]
…
[option value=listeN]Liste N[/option]
[/select]</label></p>

Remplacez liste1, liste2listeN par les IDs ou noms des listes.

Vous pouvez aussi lui permettre de choisir de s'inscrire ou non dans une liste d'autorépondeur, en insérant un code comme celui-ci dans le champ Code de votre formulaire :

<p><label>[input subscribed-to-autoresponder value=yes] M'inscrire dans cette liste</label></p>

15.1 AWeber

Vous devez effectuer quelques réglages afin que Contact Manager fonctionne avec AWeber. Vous avez deux méthodes. Si la première ne fonctionne pas, essayez la seconde.

Première méthode :

Allez sur cette page afin de récupérer votre code d'autorisation et copiez-le dans le champ Clé API du module AWeber de la page Options. Contact Manager en extraira automatiquement votre clé API lorsque vous cliquerez sur l'un des boutons pour mettre à jour vos options.

Seconde méthode :

Allez dans votre compte AWeber, placez votre pointeur sur List Options, cliquez sur Email Parsers dans la liste déroulante qui apparaît puis sur add new en bas de la page à droite de Custom Parsers.

Email Parser d'AWeber
Email Parser d'AWeber

Entrez ce que vous voulez dans le champ Description et insérez ce code dans le champ Trigger Rule :

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

en remplaçant domaine par le nom de domaine de votre site (sans l'extension) et extension par l'extension de votre nom de domaine (sans le point).

Si votre nom de domaine (avec l'extension) contient plus de 35 caractères, insérez plutôt ce code dans le champ Trigger Rule :

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

Insérez ce code dans le champ Rule 1 :

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

Dans le champ Store In situé à droite du champ Rule 1, sélectionnez Email.

Insérez ce code dans le champ Rule 2 :

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

Dans le champ Store In situé à droite du champ Rule 2, sélectionnez Name.

Insérez ce code dans le champ Rule 3 :

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

Dans le champ Store In situé à droite du champ Rule 3, sélectionnez Ad Tracking.

Cliquez sur Save pour enregistrer votre parser. Ensuite, modifiez-le, cochez la case Enable parser for all lists in this account et cliquez sur Save afin d'activer votre parser pour toutes les listes de votre compte AWeber.

15.2 CyberMailing

Vous n'avez aucun réglage à effectuer pour que Contact Manager fonctionne avec CyberMailing.

15.3 GetResponse

Vous devez renseigner la clé API de votre compte GetResponse dans le module Intégration des autorépondeurs de la page Options de Contact Manager pour que Contact Manager fonctionne avec GetResponse. Vous pouvez obtenir votre clé API en vous connectant à votre compte GetResponse.

15.4 MailChimp

Vous devez renseigner la clé API de votre compte MailChimp dans le module Intégration des autorépondeurs de la page Options de Contact Manager pour que Contact Manager fonctionne avec MailChimp. Vous pouvez obtenir votre clé API en vous connectant à votre compte MailChimp.

15.5 SG Autorépondeur

Vous devez renseigner l'ID de votre compte SG Autorépondeur ainsi que votre code d'activation des fonctionnalités supplémentaires dans le module Intégration des autorépondeurs de la page Options de Contact Manager pour que Contact Manager fonctionne avec SG Autorépondeur. Vous pouvez obtenir ces informations en vous connectant à votre compte SG Autorépondeur. Votre ID se trouve tout en haut de la colonne de gauche. Et votre code d'activation des fonctionnalités supplémentaires se trouve tout en bas de la page Options diverses du menu Mon compte.

Si ça ne fonctionne pas, assurez-vous que l'extension cURL est bien activée sur le serveur qui héberge votre site Web.

16. Inscription en tant que Client

Vous pouvez inscrire les expéditeurs en tant que clients, si vous avez installé et activé Commerce Manager. Les options des modules Autorépondeurs, Inscription au programme d'affiliation, Espace membre, WordPress et Instructions personnalisées de Contact Manager annulent et remplacent les options des modules du même nom dans Commerce Manager.

Si l'internaute vous envoie un message tout en étant connecté en tant que client, ou en indiquant une adresse e-mail identique à celle d'un client déjà existant, Contact Manager ne créera pas de nouveau compte client, mais mettra à jour la catégorie du client, si vous souhaitez affecter l'expéditeur à une catégorie de client.

Lors de son inscription, s'il n'a pas fourni de login, le login de l'expéditeur est son adresse e-mail, s'il n'existe aucun client ayant le même login. Dans le cas contraire, un nombre entier sera ajouté à la fin. S'il n'a pas fourni de mot de passe, un mot de passe aléatoire est généré automatiquement.

Vous pouvez communiquer à l'expéditeur son login et son mot de passe de client, en insérant un code comme celui-ci dans le champ Corps de votre e-mail de confirmation de message :

Votre login : [client login]
Votre mot de passe : [client password default="le même qu'avant"]

L'expéditeur pourra à tout moment modifier son login et son mot de passe de client via le formulaire de modification de profil de Commerce Manager.

Vous pouvez insérer dans les champs Expéditeur, Destinataire, Sujet et Corps des e-mails de confirmation/notification de message des shortcodes afin d'afficher des informations concernant le client. Ces shortcodes sont présentés dans cette section.

17. Inscription au Programme d'Affiliation

Vous pouvez inscrire les expéditeurs à votre programme d'affiliation, si vous avez installé et activé Affiliation Manager. Les options des modules Autorépondeurs, Inscription en tant que client, Espace membre, WordPress et Instructions personnalisées de Contact Manager annulent et remplacent les options des modules du même nom dans Affiliation Manager.

Si l'internaute vous envoie un message tout en étant connecté en tant qu'affilié, ou en indiquant une adresse e-mail identique à celle d'un affilié déjà existant, Contact Manager ne créera pas de nouveau compte d'affilié, mais mettra à jour la catégorie de l'affilié, si vous souhaitez affecter l'expéditeur à une catégorie d'affilié.

Lors de son inscription, s'il n'a pas fourni de login, le login de l'expéditeur est la partie précédent le caractère @ de son adresse e-mail, s'il n'existe aucun affilié ayant le même login. Dans le cas contraire, un nombre entier sera ajouté à la fin. S'il n'a pas fourni de mot de passe, un mot de passe aléatoire est généré automatiquement.

Vous pouvez communiquer à l'expéditeur son login et son mot de passe d'affilié, en insérant un code comme celui-ci dans le champ Corps de votre e-mail de confirmation de message :

Votre login : [affiliate login]
Votre mot de passe : [affiliate password default="le même qu'avant"]

L'expéditeur pourra à tout moment modifier son login et son mot de passe d'affilié via le formulaire de modification de profil d'Affiliation Manager.

Vous pouvez insérer dans les champs Expéditeur, Destinataire, Sujet et Corps des e-mails de confirmation/notification de message des shortcodes afin d'afficher des informations concernant l'affilié. Ces shortcodes sont présentés dans cette section.

18. Espace Membre

Vous pouvez inscrire les expéditeurs dans un ou plusieurs de vos espaces membres, si vous avez installé et activé Membership Manager. Les options des modules Autorépondeurs, Inscription en tant que client, Inscription au programme d'affiliation, WordPress et Instructions personnalisées de Contact Manager annulent et remplacent les options des modules du même nom dans Membership Manager.

Si l'internaute vous envoie un message tout en étant connecté en tant que membre, ou en indiquant une adresse e-mail identique à celle d'un membre déjà existant, Contact Manager ne créera pas de nouveau compte de membre, mais mettra à jour le compte du membre pour qu'il puisse accéder aux espaces membres que vous avez indiqués dans le champ Espaces membres. Il mettra aussi à jour la catégorie du membre, si vous souhaitez affecter l'expéditeur à une catégorie de membre.

Lors de son inscription, s'il n'a pas fourni de login, le login de l'expéditeur est son adresse e-mail, s'il n'existe aucun membre ayant le même login. Dans le cas contraire, un nombre entier sera ajouté à la fin. S'il n'a pas fourni de mot de passe, un mot de passe aléatoire est généré automatiquement.

Vous pouvez communiquer à l'expéditeur son login et son mot de passe de membre, en insérant un code comme celui-ci dans le champ Corps de votre e-mail de confirmation de message :

Votre login : [member login]
Votre mot de passe : [member password default="le même qu'avant"]

L'expéditeur pourra à tout moment modifier son login et son mot de passe de membre via le formulaire de modification de profil de Membership Manager.

Vous pouvez insérer dans les champs Expéditeur, Destinataire, Sujet et Corps des e-mails de confirmation/notification de message des shortcodes afin d'afficher des informations concernant le membre. Ces shortcodes sont présentés dans cette section.

19. WordPress

Vous pouvez inscrire les expéditeurs en tant qu'utilisateurs WordPress. Lors de son inscription, s'il n'a pas fourni de login, le login de l'expéditeur est son adresse e-mail, s'il n'existe aucun utilisateur ayant le même login. Dans le cas contraire, un nombre entier sera ajouté à la fin. S'il n'a pas fourni de mot de passe, un mot de passe aléatoire est généré automatiquement.

Si l'internaute vous envoie un message tout en étant connecté en tant qu'utilisateur, ou en indiquant une adresse e-mail identique à celle d'un utilisateur déjà existant, Contact Manager ne créera pas de nouveau compte d'utilisateur.

Vous pouvez communiquer à l'expéditeur son login et son mot de passe d'utilisateur, en insérant un code comme celui-ci dans le champ Corps de votre e-mail de confirmation de message :

Votre login : [user login]
Votre mot de passe : [user password]

Vous pouvez insérer dans les champs Expéditeur, Destinataire, Sujet et Corps des e-mails de confirmation/notification d'envoi de message des shortcodes afin d'afficher des informations concernant l'utilisateur. Ces shortcodes sont tout simplement les mêmes que ceux présentés dans la section Affichage des Informations Concernant l'Utilisateur.

20. Affichage des Informations Concernant l'Utilisateur

Pour afficher une information concernant l'utilisateur WordPress, insérez dans vos articles/pages/widgets un code comme celui-ci :

[user information]

en remplaçant information par :

  • date pour afficher la date d'inscription
  • date-utc pour afficher la date d'inscription par rapport au temps UTC
  • email-address pour afficher l'adresse e-mail
  • first-name pour afficher le prénom
  • id pour afficher l'ID
  • last-name pour afficher le nom
  • login pour afficher le login
  • password pour afficher le mot de passe (uniquement dans les e-mails)
  • website-url pour afficher l'URL du site Web

Exemple :

Votre login : [user login]

20.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'information lorsque celle-ci est vide (ce qui est le cas la plupart du temps lorsque l'internaute n'est pas connecté en tant qu'utilisateur), en utilisant l'attribut default, comme ceci :

[user information default="texte"]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

20.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'information avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[user information filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[user information filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

21. Instructions Personnalisées

Vous pouvez ajouter des instructions personnalisées qui seront exécutées immédiatement après l'envoi d'un message, ou d'autres événements. Cela vous permet, entre autres, d'inscrire l'expéditeur dans une liste d'un autorépondeur qui n'est pas encore pris en charge par Contact Manager.

Quelques compétences en PHP sont nécessaires. Les instructions personnalisées (pour l'envoi d'un message) sont exécutées en dernier à l'intérieur du fichier includes/add-message.php de Contact Manager.

Vous pouvez trouver où sont exécutées les instructions personnalisées des autres événements en ouvrant tous les fichiers de Contact Manager avec un éditeur de texte comme Notepad++ et en recherchant la chaîne de caractères eval( dans ces fichiers.

Les instructions personnalisées de soumission de formulaire sont exécutées à l'intérieur du fichier includes/forms/processing.php de Contact Manager. Vous pouvez exécuter différentes instructions suivant le formulaire en effectuant un test sur la variable $id définie dans le fichier forms.php de Contact Manager.

22. Affiliation

Vous pouvez attribuer une commission à l'affilié ayant référé le message, si vous avez installé et activé Affiliation Manager, et si vous avez activé l'enregistrement des messages dans votre base de données.

Vous pouvez payer en une seule fois les commissions sur les messages référés durant une période donnée via la page Paiement d'Affiliation Manager. Tout est expliqué ici.

23. Champs Personnalisés

Vous pouvez, via la page Back office de Contact Manager, ajouter un nombre illimité de champs personnalisés dans les pages Ajouter un formulaire, Ajouter une catégorie de formulaire et Ajouter un message afin d'enregistrer des données supplémentaires. Entrez un nom et une clé pour chaque champ personnalisé.

Par exemple, si vous souhaitez enregistrer la couleur préférée de l'expéditeur, entrez Couleur préférée comme nom et couleur-preferee comme clé.

Pour afficher une information personnalisée concernant un message ou un expéditeur, insérez dans vos articles/pages/widgets un code comme celui-ci (n'oubliez pas le préfixe custom-field- juste avant la clé) :

[message custom-field-clé id=N]

ou celui-ci :

[sender custom-field-clé id=N]

en remplaçant N par l'ID du message et clé par la clé du champ personnalisé.

Pour permettre à l'expéditeur de compléter ce champ, insérez dans le champ Code de vos formulaires un code comme celui-ci (n'oubliez pas le préfixe custom-field- juste avant la clé) :

[input custom-field-clé]

en remplaçant clé par la clé du champ personnalisé.

24. Sites Statiques Non Gérés Par WordPress

Contact Manager est conçu pour fonctionner avec un site WordPress, mais vous pouvez aussi l'utiliser avec un site statique non géré par WordPress, en suivant les instructions suivantes.

24.1 Installation de WordPress

Téléchargez WordPress et installez-le sur votre site. Vous n'utiliserez pas WordPress en tant que CMS pour gérer les pages de votre site, mais comme une interface vous permettant de gérer vos formulaires de contact et messages.

24.2 Les Fichiers de Votre Site

Si les fichiers générant les pages de votre site ont pour extension .htm ou .html, renommez cette extension en .php. Ouvrez-les avec un éditeur de texte comme Notepad++, cliquez sur Fichier, puis sur Enregistrer sous…. Une fenêtre s'ouvre. Dans le champ Type, sélectionnez PHP et cliquez sur Enregistrer.

Vous pouvez également recréer les fichiers générant les pages de votre site en partant de ce modèle.

24.3 Chargement de WordPress

Pour charger les fonctions de WordPress dans les fichiers PHP de votre site, ajoutez tout en haut de ces fichiers le code suivant :

<?php
$wordpress_directory = 'Répertoire de WordPress';
$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;
?>

Remplacez Répertoire de WordPress par le nom du répertoire dans lequel vous avez installé WordPress. Si vous l'avez installé à la racine de votre site, remplacez cette ligne :

$wordpress_directory = 'Répertoire de WordPress';

par celle-ci :

$wordpress_directory = '';

Insérez cette ligne de code :

<?php wp_head(); ?>

juste avant la balise </head>, et cette ligne de code :

<?php wp_footer(); ?>

juste avant la balise </body>.

24.4 Utilisation des Shortcodes

La documentation de Contact Manager vous fournit des shortcodes permettant par exemple d'afficher dynamiquement des options de Contact Manager. Pour les utiliser dans les fichiers PHP de votre site, insérez un code comme celui-ci :

<?php echo do_shortcode('[votre-shortcode]'); ?>

25. Personnalisation Avancée

25.1 Autorépondeurs Personnalisés

Vous pouvez ajouter un autorépondeur qui n'est pas nativement intégré à Contact Manager. Pour cela, créez un plugin avec un code comme celui-ci (version simple) :

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

add_filter('contact_autoresponders', 'add_my_autoresponder');


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

ou comme celui-ci (version plus élaborée) :

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('contact_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', 'contact-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/contact-manager/#my-autoresponder"><?php _e('More informations', 'contact-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', 'contact-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; }

La fonction subscribe_to_my_autoresponder inscrit l'internaute dans une liste de l'autorépondeur. La fonction display_my_autoresponder affiche les options de l'autorépondeur dans le module Intégration des autorépondeurs de la page Options de Contact Manager. Et la fonction update_my_autoresponder met à jour ces options lorsqu'on soumet le formulaire de cette page.

Pour mieux comprendre comment faire, regardez le code source de ce plugin.

25.2 Fichiers Personnalisés

Vous pouvez remplacer tous les fichiers de Contact Manager (sauf contact-manager.php) par vos propres fichiers. Pour cela, créez le dossier contact-manager-custom-files dans le répertoire des plugins (celui dans lequel vous avez installé Contact Manager) de votre site Web.

Par exemple, si vous souhaitez remplacer le fichier includes/data.php de Contact Manager par un fichier que vous avez personnalisé, créez le dossier includes dans le dossier contact-manager-custom-files, et uploadez votre fichier data.php dans ce dossier.

Vous pouvez définir vous-même le répertoire dans lequel sont stockés vos fichiers personnalisés, en insérant cette ligne :

define('CONTACT_MANAGER_CUSTOM_FILES_PATH', ABSPATH.'custom-files/contact-manager/');

juste après :

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

dans votre fichier wp-config.php.

Remplacez custom-files/contact-manager par ce que vous voulez. La valeur de CONTACT_MANAGER_CUSTOM_FILES_PATH doit se terminer par un /.

25.3 Langues Personnalisées

Contact Manager est développé en anglais et contient des fichiers qui le traduisent en français. Si vous le souhaitez, vous pouvez le traduire dans une autre langue.

Pour cela, créez votre répertoire de fichiers personnalisés en suivant ces indications. Créez le dossier languages à l'intérieur de celui-ci, et uploadez vos fichiers de traduction dans ce dossier.

Vous pouvez créer vos fichiers de traduction grâce au fichier languages/contact-manager.pot du plugin, et en utilisant le logiciel gratuit Poedit. Vos deux fichiers de traduction MO et PO doivent être nommés comme ceci :

contact-manager-ll_CC.mo
contact-manager-ll_CC.po

ll_CC est la valeur affichée par cette ligne de code :

echo get_locale();

lorsqu'elle est exécutée dans l'un des fichiers de votre site WordPress.

26. FAQ

26.1 Puis-je utiliser des shortcodes dans les champs des pages d'administration ?

Oui. Vous pouvez insérer tous les shortcodes disponibles sur votre site dans la plupart des champs des pages d'administration de Contact Manager.

26.2 Comment puis-je utiliser des shortcodes dans mon thème WordPress ?

Insérez dans les fichiers PHP de votre thème un code comme celui-ci :

<?php echo do_shortcode('[votre-shortcode]'); ?>

26.3 Comment puis-je utiliser des shortcodes dans les commentaires ?

Modifiez le fichier functions.php (créez-le s'il n'existe pas) de votre thème WordPress et ajoutez cette ligne de code :

add_filter('comment_text', 'do_shortcode');

26.4 Comment puis-je utiliser des shortcodes dans les attributs des shortcodes ?

Vous pouvez entrer des shortcodes pour la plupart des attributs des shortcodes de Contact Manager, à condition de remplacer [ par ( et ] par ), comme ceci :

[votre-shortcode attribut='(votre-autre-shortcode)']

N'oubliez pas les guillemets simples au début et à la fin du shortcode.

26.5 Comment puis-je imbriquer plusieurs shortcodes identiques ?

Lorsque vous imbriquez plusieurs shortcodes identiques, vous devez ajouter un nombre entier entre 1 et 3 à la fin des tags de ces shortcodes afin qu'ils fonctionnent correctement, comme ceci :

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

27. Améliorations

  • Version 6.8.7
    • Amélioration de l'intégration avec SG Autorépondeur
  • Version 6.8.4
    • Création automatique d'un formulaire quand le plugin est installé pour la première fois
  • Version 6.8.3
    • Nouvelle API de SG Autorépondeur
  • Version 6.8.2
    • Amélioration de l'enregistrement en tant qu'utilisateur
  • Version 6.7.6
    • Nouvelle API de SG Autorépondeur
  • Version 6.7
    • Ajout de la possibilité d'utiliser des langues personnalisées
  • Version 6.6
    • Ajout de la possibilité d'utiliser des fichiers personnalisés
  • Version 6.5.2
    • Amélioration de quelques shortcodes
  • Version 6.5
    • Ajout de la possibilité d'ajouter un autorépondeur personnalisé
    • Amélioration de la fonction contact_mail
  • Version 6.3.5
    • Optimisation des styles CSS des pages d'administration pour WordPress 4.4
  • Version 6.3
    • Adaptation à WordPress 4.3
  • Version 6.2.2
    • Amélioration du support d'AWeber
  • Version 6.2
    • Amélioration de la sécurité des instructions personnalisées
    • Amélioration de l'ergonomie des pages d'administration
  • Version 6.1.2
    • Amélioration du générateur de mot de passe
  • Version 6.1.1
    • Amélioration de l'ergonomie des pages d'administration
  • Version 6.1
    • Amélioration du module Capacités de la page Back office
  • Version 6.0.3
    • Ajout du champ country_code dans la table des messages
  • Version 6.0
    • Amélioration de l'ergonomie des pages d'administration
  • Version 5.9.7
    • Ajout de la possibilité d'exécuter des instructions personnalisées immédiatement après la soumission d'un formulaire
  • Version 5.9.4
    • Correction d'un bug avec PHP 5.5
  • Version 5.9.2
    • Amélioration de l'ergonomie des pages d'administration
    • Optimisation des styles CSS des pages d'administration pour WordPress 3.9.1
  • Version 5.9.1
    • Amélioration de la stabilité du plugin
  • Version 5.9
    • Amélioration de l'ergonomie des pages d'administration
  • Version 5.8.6
    • Amélioration du cron
  • Version 5.8.5
    • Ajout de la possibilité d'exiger la double saisie de certains champs de formulaires (adresse e-mail, mot de passe, etc.)
  • Version 5.8.4
    • Ajout du support de l'attribut HTML5 pattern
  • Version 5.8.3
    • Ajout de la possibilité de configurer différents messages d'erreur pour chaque champ d'un formulaire
  • Version 5.8.2
    • Amélioration de la stabilité du plugin quand son dossier est renommé
  • Version 5.8.1
    • Amélioration de l'installation du plugin
  • Version 5.8
    • Optimisation des styles CSS des pages d'administration pour WordPress 3.8
    • Amélioration de la désinstallation du plugin