Erweiterung:ContactPage

This page is a translated version of the page Extension:ContactPage and the translation is 35% complete.
MediaWiki-Erweiterungen
ContactPage
Freigabestatus: stabil
Einbindung Spezialseite , Hook
Beschreibung Bietet ein Kontaktformular für Besucher
Autor(en) Daniel Kinzler, Sam Reed
Letzte Version Continuous updates
Kompatibilitätspolitik Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
PHP 5.4+
Datenbankänderungen Nein
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen
README
Beispiel nl.wikipedia.org
  • $wgContactConfig
Übersetze die ContactPage-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Vagrant-Rolle contactpage
Probleme Offene Aufgaben · Einen Fehler melden

Die Erweiterung ContentPage implementiert ein Kontaktformular für Besucher. It creates a special page "Special:Contact", which is similar to "Special:EmailUser", but it has a fixed recipient, and may be used without registering.

Installation und Konfiguration

  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens ContactPage im Ordner extensions/ ablegen.
    Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContactPage
    
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    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
    ];
    
  • See the README file for further options to customize and adapt as it convenes.
  •   Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
You can require a CAPTCHA test for the contact page if you have the ConfirmEdit extension installed. CAPTCHAs are enabled by adding
$wgCaptchaTriggers['contactpage'] = true;
to "LocalSettings.php" below the invocation of both extensions.


Weitere Anpassung

  1. Add the following code (with the correct URL inserted) to your LocalSettings.php file:
$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'  // not required, but recommended for security reasons
            ],
        $skin->msg( 'contactpage-label' )->text()
        );
    };
};
  1. Add the label for "Special:Contact" to system message MediaWiki:Contactpage-label.

Creating complex forms

See HTML-Formular and related pages for more information on the possibilities available to create more complex forms.

Handbuch:HTML-Formular Tutorial 3 provides more details of the values that can be used for type value of fields under AdditionalFields. For example, you can use 'type': 'usersmultiselect' to have a field that allows the selection of multiple usernames.

Probleme

Users of some hosting providers such as SiteGround and Amazon SES may get a PHP mail error or one that says that the FROM email address is not configured in the server, despite $wgPasswordSender being configured correctly and other email functionality working as expected. A fix for this issue is described here .

Siehe auch

  • Extension:EmailPage - Allows sending fully rendered articles with embedded CSS to users, groups, or contact lists
  • Erweiterung:CIForms - Forms with auto-validation, multiple choice questions and cloze tests