自作プラグイン/mailform.inc.php

mailform.inc.php†

カスタマイズ可能なメールフォームを設置し、入力内容をプラグイン内で設定したメールアドレス宛に送信することができます。主に問い合わせフォームとしての使用を想定しています。
デフォルト状態では名前、メールアドレス、件名、問い合わせ内容の4項目が表示され、設定ページを編集することでメールアドレスと件名の間に自由に追加項目を増やせます。

主な機能†

• メールフォームを設置する。
  • 入力内容の確認画面や自動返信メールの送信機能などもあり。
  • モダンな見た目でレスポンシブ対応。
• 入力項目は設定ページを編集することでカスタマイズ可能。
  • 使用可能な項目 (v1.0)
    • text textarea number email radio checkbox select date time datetime-local hidden
  • 任意項目と必須項目の設定も可能。
  • テキスト入力の場合は文字数の上限を視覚的に表示する。
• セキュリティ面にも配慮済み。
  • 各種項目のバリデーション、二重送信の防止、クリックジャッキング、XSS、CSRF、メールヘッダ・インジェクション対策など。

ダウンロード†

• github.com:kanateko/pukiwiki-plugin/tree/master/plugin-mailform

セットアップ†

1. GitHubにある「plugin-mailform」フォルダをダウンロードし、中身をそのままpukiwikiのディレクトリに放り込む。
   • 配置の見本
     ┣ skin
     ┃ ┣ css (フォルダ)
     ┃ ┗ js (フォルダ)
     ┗ plugin
     　 ┣ mailform (フォルダ)
     　 ┗ mailform.inc.php
2. プラグイン設定のメールアドレスを自分用に書き換える。 (詳細は下記参照)
3. 設定ページ (デフォルトでは:config/plugin/mailform) を作成して凍結しておく。

プラグインの設定†

ADMIN_ADDRとAUTOREPLY_ADDRは必ず変更すること。

使用方法†

メールフォームを表示したいページに#mailformとブロック型で記述する。

• 設置例：https://jpngamerswiki.com/?a937b7b923
  • ※デモページなどではなく、自サイトの実際の問い合わせ用ページ

オプション†

引数で文字列を渡すと読み込む設定ページを変更できる。 なお、読み込めるのはプラグイン設定で指定したページの子ページのみ。

例)

• 引数がない場合：#mailform → :config/plugin/mailform を読み込む
• 引数がある場合：#mailform(sub) → :config/plugin/mailform/sub を読み込む

設定ページの書き方†

追加項目の設定を定義リストで一行ずつ書いていく。

基本的な書き方†

わかりやすく途中にスペースを入れているが実際には不要。

: <項目の表示名> , <name> | <type> , [オプション]

必須項目にしたい場合は表示名の前に「*」 (アスタリスク) を書く。

name属性が重複している場合はエラーになる。 また、デフォルトの項目で使用している name、mail、subject、body の4つはname属性として設定できない。

typeは

• text textarea number email radio checkbox select date time datetime-local

のいずれかを指定可能。

各typeごとのオプション†

不要なオプションは省略可能。それぞれの指定はカンマで区切る。

text, textarea, email

[プレースホルダー] , [初期値] , [文字数の最大]

number

[プレースホルダー] , [初期値] , [文字数の最大] , [値の最小] , [値の最大]

radio, checkbox, select

< 選択肢1 | 選択肢2 | ... | 選択肢n > , [初期値]

date, time, datetime-local

[初期値] , [最小] , [最大]

オプション指定時のフォーマットはそれぞれ以下のようになる。

• date → Y-m-d (例：2022-01-01)
• time → H:i:s or H:i (例：06:30:00 or 06:30)
• datetime-local → Y-m-d\TH:i:s (例：2022-01-01T06:30)

参考：https://developer.mozilla.org/ja/docs/Web/HTML/Element/input

また、各オプションは相対的な指定も行える。
例) : 日時 , datetime | datetime-local , now , -1 month , last day of december this year

参考：https://www.php.net/manual/ja/datetime.formats.relative.php

hidden

<value>

設定ページの例†

表示

*住所,address

text,例) 京都府京都市伏見区淀水垂町509-16

*配達日,date

date,now,tomorrow,+7 days

*時間指定,time

radio,希望なし|午前|午後,希望なし

サイズ,size

hidden,120サイズ

ソース

:*住所,address|text,例) 京都府京都市伏見区淀水垂町509-16
:*配達日,date|date,now,tomorrow,+7 days
:*時間指定,time|radio,希望なし|午前|午後,希望なし
:サイズ,size|hidden,120サイズ

メールの内容†

メールフォームから送信があった場合、プラグイン設定で指定したメールアドレス宛に以下のようなメールが届く。

以下の内容でお問い合わせがありました。
------------------------------
【送信日時】2022-06-12 (日) 23:14:54
【お名前】鈴木太郎
【メールアドレス】example@gmail.com
【件名】送信テスト

【お問い合わせ内容】
これはメールフォーム送信テストです。

------------------------------
PAGE: mailform
URL: xxx.com/?mailform
IP: ***.***.***.***
UA: ～～～

また、送信者が確認画面で「確認用メールを送信する」にチェックをしていた場合、フォームに入力したメールアドレスに以下のような自動返信メールが届く。

以下の内容でお問い合わせを受け付けました。
------------------------------
【送信日時】2022-06-12 (日) 23:14:54
【お名前】鈴木太郎
【メールアドレス】example@gmail.com
【件名】送信テスト

【お問い合わせ内容】
これはメールフォーム送信テストです。

------------------------------
※このメールは自動返信によって送信されています。
サイトURL: xxx.com/

※自動返信メールの内容にhiddenの値は含まれない。

参考リンク†

• https://jpngamerswiki.com/?fe6cd3458c (配布元)

ライセンス†

GPL v3

• PukiWikiについて
  • ダウンロード
  • インストール
  • セキュリティ
  • 活用事例
  • 動作実績
  • プラグイン
    • 欲しい...
    • 自作...
  • スキン
    • 自作スキン

• はじめてのPukiWiki
• FAQ
• Q＆A
• Books
• 質問箱
  • 1 2 3 4 5

• PukiWikiを使おう
• 雑談
• メーリングリスト
• 関連ツール
• リンク集
• InterWikiName

• Info in English

• このサイトについて
  • WebTrack
  • Web委員日誌

• お試し
  • PukiWiki 1.5

最新の16件