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 [?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code README
Exemple	nl.wikipedia.org
Paramètres $wgContactConfig
Accroches fournies ContactForm ContactFromComplete
Téléchargements trimestriels	42 (Ranked 90th)
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. Il crée une page spéciale "Special:Contact", qui est similaire à "Special:EmailUser", mais il a 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, // Must be the name of a valid account which also has a verified e-mail-address added to it.
      'RecipientEmail' => 'Contact Form on ' . $wgSitename,  // 'Contact Form on' needs to be translated
      'RecipientName' => null,
      'SenderEmail' => null, // Defaults to $wgPasswordSender, may be changed as required
      'SenderName' => null,
      'RequireDetails' => false,
      'IncludeIP' => false,
      'MustBeLoggedIn' => false,
      'MustHaveEmail' => false, // True means the user submitting the form must have an associated email address
      'NameReadonly' => false,
      'EmailReadonly' => false,
      'SubjectReadonly' => false,
      'UseCustomBlockMessage' => false,
      'Redirect' => null,
      'RLModules' => [], // Resource loader modules to add to the form display page.
      'RLStyleModules' => [], // Resource loader CSS modules to add to the form display page.
      '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 to "Special:Contact"
                'rel' => 'noreferrer noopener'  // non requis, mais recommandé pour des raisons de sécurité
            ],
        $skin->msg( 'contactpage-label' )->text()
        );
    };
};

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

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.