Extension:ContactPage

MediaWiki 拡張機能マニュアル

ContactPage リリースの状態: 安定
実装	特別ページ , フック
説明	Provides a contact form for visitors
作者	Daniel Kinzler, Sam Reed
最新バージョン	Continuous updates
互換性ポリシー	Snapshots releases along with MediaWiki. master には後方互換性がありません。
MediaWiki	1.25+
PHP	5.4+
データベースの変更	いいえ
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー README
例	nl.wikipedia.org
パラメーター $wgContactConfig
提供するフック ContactForm ContactFromComplete
translatewiki.net で翻訳を利用できる場合は、ContactPage 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
Vagrant role	contactpage
問題点	未解決のタスク · バグを報告

The ContactPage extension implements a contact form for visitors. 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.

インストールと設定

• ダウンロードして、ファイルを extensions/ フォルダー内の ContactPage という名前のディレクトリ内に配置します。
• 以下のコードを LocalSettings.php の末尾に追加します:

  wfLoadExtension( 'ContactPage' );
  $wgContactConfig['default'] = array(
  	'RecipientUser' => 'WikiUser', // Must be the name of a valid account which also has a verified e-mail-address added to it.
  	'SenderName' => 'Contact Form on ' . $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' => true, // Either "true" or "false" as required
  	'MustBeLoggedIn' => true, // Check if the user is logged in before rendering the form
  	'AdditionalFields' => array(
  		'Text' => array(
  			'label-message' => 'emailmessage',
  			'type' => 'textarea',
  			'rows' => 20,
  			'required' => true,  // Either "true" or "false" as required
  		),
  	),
          // Added in MW 1.26
  	'DisplayFormat' => 'table',  // See HTMLForm documentation for available values.
  	'RLModules' => array(),  // Resource loader modules to add to the form display page.
  	'RLStyleModules' => array(),  // Resource loader CSS modules to add to the form display page.
  );
  

• See the README file for further options to customize and adapt as it convenes. Note, however, that since March 2014, it is no longer possible to prefill text from MediaWiki:Contactpage-text-[form-name].
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

MediaWiki 1.27 以前を稼働させている利用者へ:

上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.27 以前) にインストールする必要がある場合は、wfLoadExtension( 'ContactPage' ); の代わりに以下を使用する必要があります:

require_once "$IP/extensions/ContactPage/ContactPage.php";

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.

Further customization

Adding a link to special page "Contact" to the footer of your wiki

To do this add ...

1. ... the following code without changing it to your "LocalSettings.php" file:

$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function( $skin, &$template ) {
	$contactLink = Html::element( 'a', [ 'href' => $skin->msg( 'contactpage-url' )->escaped() ],
		$skin->msg( 'contactpage-label' )->text() );
	$template->set( 'contact', $contactLink );
	$template->data['footerlinks']['places'][] = 'contact';
	return true;
};

1. ... the URL of "Special:Contact" to system message MediaWiki:Contactpage-url and
2. ... the label for "Special:Contact" to system message MediaWiki:Contactpage-label.

Creating more complex forms

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