Paramétrage Kono/Extension/ContactPage

ContactPage ajoute l'accès à un formulaire de contact en pied de chaque page du wiki.

Généralité

Formulaire en action

Le formulaire de contact est accessible à la page :

• interlien :
  • Spécial:Contact
• lien complet :
  • https://kono.phpage.fr/index.php/Sp%C3%A9cial:Contact

Source

MediaWiki, extension ContactPage :

• https://www.mediawiki.org/wiki/Extension:ContactPage

Paramétrage

LocalSettings.php

Ajouter les paramètres suivants au fichier de configuration du wiki LocalSettings.php, pour ajouter cette fonctionnalité :

wfLoadExtension( 'ContactPage' );
$wgContactConfig['default'] = [
   'RecipientUser'    => 'fylip22',                            // Must be the name of a valid account which also has a verified e-mail-address added to it.
   'SenderName'       => 'Formulaire de contact de ' . $wgSitename,  // "Contact Form on" needs to be translated
   'SenderEmail'      => null,                                 // Defaults to $wgPasswordSender, may be changed as required
   'RequireDetails'   => true,                                 // Either "true" or "false" as required
   'IncludeIP'        => false,                                // Either "true" or "false" as required
   'MustBeLoggedIn'   => false,                                // Check if the user is logged in before rendering the form. Either "true" or "false" as required
   'AdditionalFields' => [
      'Text' => [
         'label-message' => 'contactpage-label-message',
         'type'          => 'textarea',
         'rows'          => 20,
         'required'      => true,                              // Either "true" or "false" as required
      ],
   ],
   'DisplayFormat'  => 'table',                                // See HTMLForm documentation for available values.
   'RLModules'      => [],                                     // Resource loader modules to add to the form display page.
   'RLStyleModules' => []                                      // Resource loader CSS modules to add to the form display page.
];

$wgHooks['SkinAddFooterLinks'][] = function( Skin $skin, string $key, array &$footerlinks ) {
   if ( $key === 'places' ) {
      $footerlinks['contact'] = Html::element( 'a',
         [
            'href' => 'https://kono.phpage.fr/index.php/Special:Contact',  // URL to "Special:Contact"
            'rel' => 'noreferrer noopener'                                 // not required, but recommended for security reasons
         ],
      $skin->msg( 'contactpage-label' )->text()                            // récupère le contenu de la page [[MediaWiki:Contactpage-label]]
      );
   };
};

Modifier les variables suivantes pour autoriser l'envoi par courriel des données du formulaire de contact :

$wgEnableEmail     = true;
$wgEnableUserEmail = true;

Personnalisation

La personnalisation se fait depuis les pages de l'espace de nom MediaWiki :

Elément à personnaliser	Elément dans le formulaire	Avant modification	Après modification	Commentaire
MediaWiki:Contactpage-title	Nom de la page	Nous contacter	Contacter le gestionnaire du site phpage.fr
MediaWiki:Contactpage-pagetext	Texte d'introduction au formulaire	Veuillez utiliser le formulaire ci-dessous pour nous contacter.	Veuillez compléter le formulaire ci-dessous.
MediaWiki:Contactpage-legend	Titre du formulaire	Envoyer un courriel	Envoyer un message au gestionnaire du site
MediaWiki:Contactpage-fromname	Nom	Votre nom :	Votre nom ou pseudonyme
MediaWiki:Contactpage-fromaddress	Adresse de messagerie	Votre adresse de courriel :	Votre adresse de messagerie (courriel)
MediaWiki:Contactpage-subject	-- Pas d'usage connu --
MediaWiki:Contactpage-email-label	-- Pas d'usage connu --
MediaWiki:Contactpage-defsubject	Texte par défaut de l'objet	Message de contact		Page à blanc
MediaWiki:Contactpage-label-message	Commentaire	Message :	Votre commentaire
MediaWiki:Contactpage-label	Nom du lien en bas de page	Formulaire de contact	Formulaire de contact pour le site phpage.fr

Détail :

• MediaWiki:Contactpage-label : permet de personnaliser le nom du lien en pied de page ;
  • avant modification, LocalSettings.php : 'label-message' => 'emailmessage',
  • après modification, LocalSettings.php : 'label-message' => 'contactpage-label-message', ; pour récupérer le contenu de la page MediaWiki:Contactpage-label-message

Autre :

• MediaWiki:Contactpage-pagetext-powershell : pour personnaliser le lien Spécial:Contact/powershell concernant le texte d'introduction du formulaire
• MediaWiki:Contactpage-subject-powershell : permet de personnaliser le lien Spécial:Contact/powershell concernant le texte par défaut de l'objet du formulaire

•