Příručka k rozšířením MediaWiki

ContactPage Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Speciální stránka Category:Special page extensions/cs, Háček Category:Hook extensions/cs
Popis	Poskytuje kontaktní formulář pro návštěvníky
Autoři	Daniel Kinzler, Sam Reed
Nejnovější verze	Continuous updates
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
PHP	5.4+
Změny v databázi	Ne
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs README
Příklad	nl.wikipedia.org
Parametry $wgContactConfig
Poskytované háčky (hooks) ContactForm ContactFromComplete
Čtvrtletní stahování	27 (Ranked 69th)
Přeložte rozšíření ContactPage, používá-li lokalizaci z translatewiki.net
Vagrant role	contactpage
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření ContactPage implementuje kontaktní formulář pro návštěvníky. Vytvoří speciální stránku "Special:Contact", která je podobná "Special:EmailUser", ale má pevného příjemce a lze ji používat bez registrace.

Instalace a nastavení

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného ContactPage ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContactPage
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  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
  ];
  

• Podívejte se na README file pro další možnosti přizpůsobení a přizpůsobení podle potřeby.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

$wgCaptchaTriggers['contactpage'] = true;

Další přizpůsobení

$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'  // není vyžadováno, ale doporučeno z bezpečnostních důvodů
            ],
        $skin->msg( 'contactpage-label' )->text()
        );
    };
};

Problémy

Uživatelé některých poskytovatelů hostingu, jako jsou SiteGround a Amazon SES, mohou dostat chybu pošty PHP nebo takovou, která říká, že e-mailová adresa FROM není na serveru nakonfigurována, přestože je $wgPasswordSender nakonfigurován správně a ostatní e-mailové funkce fungují podle očekávání. Oprava tohoto problému je popsána zde .

Související odkazy

• Extension:EmailPage - umožňuje odesílat úplné články s vloženým CSS uživatelům, skupinám nebo seznamům kontaktů
• Extension:CIForms - formuláře s automatickým ověřováním, otázkami s výběrem odpovědí a testy uzavření

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Canasta Category:Extensions included in Canasta/cs Miraheze Category:Extensions included in Miraheze/cs ProWikiCategory:Extensions included in ProWiki/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.