phpMyForm Documentation

Comment inclure un formulaire dans une page ?

Etape 1 : Code et fichiers à inclure dans cette page

code PHP

/**
 * _PMF_SCRIPT_PATH_ et _PMF_SCRIPT_URL_ sont à modifier suivant l'emplacement du dossier phpMyForm par rapport à cette page. 
 */
define('_PMF_SCRIPT_PATH_', __DIR__.'/phpMyForm');
define('_PMF_SCRIPT_URL_', '/phpMyForm');
/**
 * Le fichier connect.php est requis si utilisation de la base de données. 
 */
require(_PMF_SCRIPT_PATH_.'/include/connect.php');
/**
 * Ne pas toucher aux lignes en dessous. 
 */
require(_PMF_SCRIPT_PATH_.'/pmf-init.php');

Feuilles de style

  • phpMyForm/include/font-awesome/css/font-awesome.min.css (Font Awesome utilisé pour certaines icônes du script)
  • phpMyForm/include/css/pmf-styles.css

Fichiers javascript

phpMyForm néccéssite jQuery

  • Si utilisation (recommandée) du plugin jQuery jQuery Validation Plugin :
    • phpMyForm/include/js/jquery.validate.js
    • phpMyForm/include/js/additional-methods.js
  • Si utilisation du script jscolor :
    • phpMyForm/include/js/jscolor.min.js (à inclure en bas de page)
  • Si utilisation du script tinyMCE :
    • phpMyForm/include/tinymce/jquery.tinymce.min.js
    • phpMyForm/include/tinymce/tinymce.min.js
  • Si utilisation du plugin jQuery Masked Input Plugin :
    • phpMyForm/include/js/jquery.maskedinput.min.js
  • phpMyForm/include/js/pmf-header.js (à inclure en haut de page)
  • phpMyForm/include/js/pmf-footer.js (à inclure en bas de page)

Etape 2 : Définition des paramètres du formulaire

Créer un dossier form_name dans le dossier phpMyForm/form.
form_name à remplacer par le nom du formulaire.

Dans ce dossier, on va définir 2 fichiers ini (syntaxe simple) :

form_options.ini

Contient les différentes options du formulaire (Ce fichier est optionnel).

Exemple pour un Formulaire de contact

[options]
description=Exemple de formulaire de contact
emplacement=https://www.nonoweb.net/phpmyform/formulaire-phpmyform-dans-page-wordpress
submit_message=
jquery_validate=1
button_name=Envoyer votre message
function_after=nth_send_mail
style_form="border: 1px solid #e1e1e1;border-radius: 5px;"
field_border=1px solid #e1e1e1
class_form=nth-margin-bottom
;submit_page=https://www.nonoweb.net/phpMyForm/examples/merci.html
width=70%
;[debug]
;form=1
;fields=1

form_definition.ini

Contient les paramètres de chaques champs du formulaires.

Exemple pour un Formulaire de contact

[nth_name]
field_type=text
label=Nom
class=pmf-regular-text
rules.required.value=1
rules.required.message=Veuillez rentrer votre nom.

[nth_email]
field_type=text
label=Email De
class=pmf-regular-text
text_bottom="<i><small>Est utilisée seulement si la case <b>Recevoir une copie du message</b> est cochée.</small></i>"
rules.required.value=1
rules.required.message=Veuillez rentrer votre email.
rules.email.value=1
rules.email.message=Rentrer un email valide.

[nth_url]
field_type=text
label=Site Web
class=pmf-regular-text
rules.url.value=1

[nth_message]
field_type=textarea
label=Message
class=pmf-regular-text
rows=5
rules.required.value=1
rules.required.message=Veuillez rentrer votre message.

[nth_email_send]
field_type=text
label=Email A
class=pmf-regular-text
text_bottom="<i><small>Pour test, entrer l'adresse e-mail où sera envoyé ce message.</small></i>"
rules.required.value=1
rules.required.message=A quelle adresse e-mail envoyer ce mail?
rules.email.value=1
rules.email.message=Rentrer un email valide.

[nth_attachment]
field_type=file
;multiple=1
label=Joindre un fichier
rules.max_file_size.value=100000
rules.accept.value=pdf
text_bottom="<i><small>Fichier pdf, maximum 100Ko</small></i>"

[nth_copy]
field_type=checkbox
text_after=Recevoir une copie du message

[nth_verif]
field_type=text
text_before="37635 ÷ 39 ="
class=pmf-small-text
rules.equal.value=965
rules.required.value=1
rules.required.message=Veuillez donner le résultat de la division.
rules.equal.message=Résultat incorrect.

;[nth_recaptcha]
;field_type=google_recaptcha

Définition formulaire

Etape 3 : Instanciation de la class phpMyForm

Code à insérer :
form_name à remplacer par le nom du formulaire.

$my_form = new PhpMyForm('form_name');
$my_form->form();

Voilà, c’est tout…

Instanciation d’un formulaire en détail

Inclure un formulaire dans un article ou une page WordPress

Dans WordPress, l’intégration est un peu différente. La définition des formulaires (fichiers form_options.ini et form_definition.ini) est, par contre, identique.

Intégrer un formulaire phpMyForm dans une page ou un article WordPress

[datedemaj]