Extension:ContactPage

Manuel des extensions MediaWiki

ContactPage État de la version : stable
Implémentation	Page spéciale , Accroche
Description	Fournit un formulaire de contact pour les visiteurs
Auteur(s)	Daniel Kinzler, Sam Reed
Dernière version	Continuous updates
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
PHP	5.4+
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source README
Exemple	nl.wikipedia.org
Paramètres $wgContactConfig
Accroches fournies ContactForm ContactFromComplete
Traduire l’extension ContactPage sur translatewiki.net si elle y est disponible
Rôle Vagrant	contactpage
Problèmes	Tâches ouvertes · Signaler un bogue

L’extension ContactPage implémente un formulaire de contact pour les visiteurs. Elle crée une page spéciale "Special:Contact", qui est similaire à "Special:EmailUser", mais avec un destinataire fixe, et peut être utilisé sans enregistrement.

Installation et configuration

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé ContactPage dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContactPage
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'ContactPage' );
  $wgContactConfig['default'] = [
      'RecipientUser' => null, // Doit être le nom d'un compte valide qui possède aussi une adresse courriel vérifiée attachée.
      'RecipientEmail' => 'Contact Form on ' . $wgSitename,  // 'Contact Form on' doit être traduit
      'RecipientName' => null,
      'SenderEmail' => null, // La valeur par défaut est $wgPasswordSender, peut être modifié si nécessaire
      'SenderName' => null,
      'RequireDetails' => false,
      'IncludeIP' => false,
      'MustBeLoggedIn' => false,
      'MustHaveEmail' => false, // True signifie que l'utilisateur qui soumet le formulaire doit avoir une adresse courriel associée
      'NameReadonly' => false,
      'EmailReadonly' => false,
      'SubjectReadonly' => false,
      'UseCustomBlockMessage' => false,
      'Redirect' => null,
      'RLModules' => [], // Modules du chargeur de ressources à ajouter à la page qui affiche le formulaire.
      'RLStyleModules' => [], // Modules CSS du chargeur de ressources à ajouter à la page qui affiche le formulaire.
      'AdditionalFields' => [
  		'Text' => [
  			'label-message' => 'emailmessage',
  			'type' => 'textarea',
  			'required' => true
  		]
  	],
  	'FieldsMergeStrategy' => null
  ];
  

• Voir le fichier README file pour plus d'options pour personnaliser et adapter comme il convient.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Vous pouvez demander un test CAPTCHA pour la page de contact si vous avez installé l'extension ConfirmEdit . Les CAPTCHAs sont activés en ajoutant

$wgCaptchaTriggers['contactpage'] = true;

à "LocalSettings.php" en dessous de l'invocation des deux extensions.

Personnalisation supplémentaire

Ajouter un lien à la page spéciale "Contact" vers footer

1. Ajoutez le code suivant (avec l'URL correcte insérée) à votre fichier LocalSettings.php :

   $wgHooks['SkinAddFooterLinks'][] = function( Skin $skin, string $key, array &$footerlinks ) {
       if ( $key === 'places' ) {
           $footerlinks['contact'] = Html::element( 'a',
               [
                   'href' => 'https://www.example.org/wiki/Special:Contact',  // URL vers ''Special:Contact''
                   'rel' => 'noreferrer noopener'  // non requis, mais recommandé pour des raisons de sécurité
               ],
           $skin->msg( 'contactpage-label' )->text()
           );
       };
   };
   

2. Ajoutez l'étiquette "Special:Contact" au message système MediaWiki:Contactpage-label.

Création de formulaires personnalisés

Voir les pages HTMLForm et autres pour plus d'informations sur les possibilités de création de formulaires plus complexes.

Manuel:Tutoriel HTMLForm 3e partie fournit plus de détails sur les valeurs pouvant être utilisées pour la valeur type des champs sous AdditionalFields. Par exemple vous pouvez utiliser 'type': 'usersmultiselect' pour avoir un champ permettant de sélectionner plusieurs noms d'utilisateurs.

Problèmes

Les utilisateurs de certains fournisseurs d'hébergement tels que SiteGround et Amazon SES peuvent obtenir une erreur de messagerie PHP ou une erreur qui indique que l'adresse e-mail FROM n'est pas configurée sur le serveur, malgré le fait que $wgPasswordSender est correctement configuré et que d'autres fonctionnalités de messagerie fonctionnent comme prévu. Un correctif pour ce problème est décrit ici .

Voir aussi

• Extension:EmailPage - Permet d'envoyer les articles complètement générés avec le CSS inclus, vers les utilisateurs, les groupes, ou les listes de contacts
• Extension:CIForms - Formulaires avec auto-validation, questionnaires à choix multiple et tests à trous.