Manual:フォーム
Please note: Some techniques recommended in this article require the use of extensions. Exercise caution when using them, as the status of each extension is self-assigned by its maintainer, and does not reflect the opinion of the MediaWiki development team.
ご注意ください: この記事で推奨しているテクニックの一部では、拡張機能を使用する必要があります。 各拡張機能のステータスは保守担当者によって自己申告されたものであり、MediaWiki 開発チームの見解を反映したものではないため、使用する際には注意が必要です。 |
MediaWiki エコシステム内では、フォームという概念は 3 つの異なる意味を持つことがあります:
- MediaWiki ソフトウェアに含まれる組み込みフォームで、利用者がサインイン/ログインしたり、ページのウィキテキストを編集したり、大量の特別ページを使って構造化された検索を行うことができるフォーム
- 訪問者が入力したデータをウィキ管理者に提供するための入力フォームで、通常のウィキ記事や特別ページに配置されるフォーム
- 利用者が新しいウィキ記事を作成するために構造化されたデータを入力し、そのデータを使って「プリロード」するフォームで、通常のウィキ記事や特別ページに配置される (これらのフォームは「ページ フォーム」として知られています)
組み込みフォーム
標準の MediaWiki では、ページのメンテナンスや管理機能の多くでフォーム ベースのデータ入力を使用します。 MediaWiki 記事自体は、フリー形式のウィキテキストを使って作成されます。 他の多くの MediaWiki 機能と同様に、さまざまなカスタマイズが可能です。
組み込みフォームをカスタマイズする
以下の記事を参照してください:
- Manual:インターフェイス, Help:システムメッセージ - MediaWiki で使用される組み込みフォームに表示されるテキストをカスタマイズ/地域化する方法が記載されています。
入力フォーム
入力フォームは、ウィキ記事や特別ページに設置された標準的なフォームで、訪問者が構造化されたデータ (例: 連絡先情報など) を入力でき、管理者が簡単かつ安全に送信内容にアクセスできるものです。 標準の MediaWiki にはこの機能が備わっていないため、この機能を実装する拡張機能の一覧を紹介します:
- Extension:ContactPage - 固定の特別ページ内で簡単な連絡先フォームを実装
- Extension:EmailPage - 埋め込み CSS 付きの完全な記事を利用者、グループ、または連絡先リストに送信可能
- Extension:CIForms - 自動検証、選択肢問題、クローズ テスト (cloze test) 付きのフォーム
- Extension:FlexForm - ページの作成/編集やメール送信のためのフォームを利用者が定義可能
- Extension:QuickSurveys - PHP 設定に基づいて記事に表示されるアンケート
- LimeSurvey - 外部環境で稼働する有料サービスの可能性あり
語彙素の語形
「ページ フォーム」は、標準のウィキ記事または特別ページにあるフォームです。利用者はこれを使用して構造化データを入力し、ウィキ記事を作成および/または編集したり、入力したデータを使用してそのような記事を "preload" したりできます。 "入力フォーム"と比べて違いは、入力フォームは、データを送信し、直接提供されたメールアドレス (通常システム管理者) に送信するか、権限のあるユーザーがアクセスできるデータベースに送信を保存することです。 逆に"ページフォーム"は、標準的なウィキ記事 (ウィキ上で公開アクセス可能) を構造化されたデータで満たすためにフォームの提出を使用します。 この機能を実装する拡張機能のリストです。
- Extension:InputBox - ページを作成、移動、コメントを挿入、テキスト検索するための拡張子
- Extension:Page Forms - フォームを通じて、インフォボックス様式のテンプレートを持つページを作成し編集するための拡張
- Extension:FlexForm - ページを作成し編集し、メールを送信するためのフォームを定義できます
- Extension:Form - フォームで新しい記事を作成する拡張機能
- Extension:VisualData - JSON-スケーマに基づく完全なメタデータ管理フレームワークで、簡単にウィキ上のデータの記録、整理、クエリ収集を行うことができます
このタイプのフォームの詳細については Extension:Page Forms/Related extensions を参照してください。
構造化データを使用した記事の作成/編集
構造化されたデータとフリーフォームテキストの組み合わせが含まれる。 例えば、マーケティング連絡先の記述やバグレポートを含む記事には、通常、完全な記事を作成するために常に回答しなければならない一連の質問があります。 この場合、先入りのウィキテキストを含むフォームまたは記事がより適切かもしれません。 For more information on this approach, please see Manual:テキストをプリロードしてページを作る.
編集プロセスを引き継ぐ
If you are an extension developer, and you want your extension to intercept the editing process, you might want to check the following hooks:
- AlternateEdit - action=edit で呼び出されます。 MediaWiki のインストールは編集操作に対して別の応答を提供する機会を得られます。
- EditPage::showEditForm:initial - ウィキテキストを入力するために使用されたテキストウィンドウが表示されるときに呼び出されます。 拡張子ライターには 簡単な編集ボックスに代替を定義する能力を与えます For a list of extensions that use this hook, see Category:EditPage::showEditForm:initial extensions.