PolyMoNote文法 マニュアル
Wiki Like SYSTEM "PolyMoNote"の整形ルールの解説
Plugins/BBS
概要
| 要素 | 実行の可否 |
|---|---|
| 行頭 | 可 |
| インライン | 不可 |
| 複数の記述 | 可 |
記述した場所に掲示板を設置します。
コメントには、PolyMoNoteの文法を使うことができます。
書式
#BBS(最大表示数, フォームの表示){過去ログ保存ページ名}
設定は、すべて省略できます。
引数
- 最大表示数
-
表示する最新のログ数を数字で指定します。
コメントの投稿数が指定数を超えた場合、以前のログは「過去ログ保存ページ名」で指定されたページに過去ログとして保存されます。 - フォームの表示
-
掲示板の投稿フォームを表示するかを指定します。
表示をオフにした場合は最新のログのみが表示されます。- n, N, none, NONE
- 投稿フォームを非表示。
- 過去ログ保存ページ名
- 掲示板の過去ログを保存するページを指定します。
プラグインの設定
スクリプトに直接書き込む項目
- $hLogpageSet
-
過去ログのページの設定。
- "dont_show_pagetitle"
- ページ名を表示するかを指定、"on"で非表示・"off"で表示。
- "dont_searchindex"
- 検索エンジンのクローラのインデックスを許可するかを指定、"on"で不許可・"off"で許可。
- $CheckQuestion
- 確認キーの質問文。
- $CheckKeyword
- 確認キーのキーワード。
"プラグイン設定"から指定する項目
スパム対策として以下の項目を設定できます。
- コメントに「ひらがな」が含まれない場合は、投稿を拒否。
- 項目にチェックを入れると、コメントに"ひらがな"(あ～ん)が含まれない場合は、コメントの投稿が拒否されます。
- コメントに「、」または「。」が含まれない場合は、投稿を拒否。
- 項目にチェックを入れると、コメントに「、」または「。」が含まれない場合は、コメントの投稿が拒否されます。
- コメントにリンク(Aタグ)が含まれる場合は、投稿を拒否。
- 項目にチェックを入れると、コメントに"<a>"タグが含まれる場合は、コメントの投稿が拒否されます。
- コメントにURLが含まれる場合は、投稿を拒否。
- 項目にチェックを入れると、コメントにURLが含まれる場合は、コメントの投稿を拒否します。
- 確認キーをオンにする。
- 項目にチェックを入れると、確認キーに正しい文字列が入力されない場合に、コメントの投稿が拒否されます。
- コメント投稿フォームをJavaScriptで表示。
- コメントの投稿フォームがJavaScriptで表示され、ブラウザのJavaScriptが無効になっている場合はコメント投稿フォームが表示されなくなります。
- 指定された数字が1以上で、コメントの文字数が指定数以下の場合は投稿を拒否。
- "1"以上の数字を指定すると、コメントの文字数がその数字以上でない場合に投稿が拒否されます。
コメント・ログ
コメントのPolyMoNote文法について
コメントには、PolyMoNoteの文法を使うことができます。
これにより、掲示板のコメントでも簡単な文字装飾などをすることができます。
ただし、セキュリティ面の理由からプラグイン・タグの実行はできません。
過去ログについて
コメントの投稿数が指定された最大表示数を超えた場合、以前のログは「過去ログ保存ページ名」で指定されたページに過去ログとして保存されます。
「過去ログ保存ページ名」で指定されたページが未作成の場合は、ページの新規作成を行います。
ページが作成済みで、かつ過去ログが記述されている場合(ページの本文が作成済み)は、文章の上部に追記します。
ページ作成時および追記時に、過去ログのページの"プラグインの実行を不許可"の項目にチェックが入り、過去ログのページではプラグインを実行させない設定になります。
これは、"コメントのPolyMoNote文法について"の項目でも触れているように、セキュリティ上の理由ですので、"プラグインの実行を不許可"のチェックは外さないようにしてください。
テンプレート
掲示板の投稿フォームやログの表示スタイルを、BBSプラグイン用のテンプレートファイルを編集することで変更できます。
テンプレートファイルは、"pn/lib/plugins"ディレクトリ内にある"bbs_form.html"・"bbs_entry.html"・"bbs_entry_log.html"です。
ブックID別のテンプレート
"bbs_form_ブックID.html"のように、".html"の前に"_"(アンダーライン)＋ブックIDを付けたファイル名が存在する場合は、そのブックIDのサイトでは、そのテンプレートの表示に切り替わります。
// 掲示板投稿フォーム bbs_form.html bbs_form_sample.html // 最近のログ bbs_entry.html // 過去ログ bbs_entry_log.html bbs_entry_log_sample.html
上記のようなテンプレートファイルがあった場合、通常(ブックID"default")では以下のテンプレートファイルが利用されます。
- bbs_form.html
- bbs_entry.html
- bbs_entry_log.html
ブックID"sample"のサイトでは、以下のテンプレートファイルが利用されます。
- bbs_form_sample.html
- bbs_entry.html
- bbs_entry_log_sample.html
掲示板投稿フォームと過去ログは"sample"用のものを、最近のログはデフォルトのものがテンプレートになります。
テンプレートファイルの説明
テンプレートファイルとテンプレートタグの説明です。
テンプレートタグはページが表示された時に、説明内容のHTMLやテキストに置き換えられます。
bbs_form.html
掲示板の投稿フォームです。
- !!SCRIPT_URL!!
- PolyMoNoteの実行ファイルのURLです。
- !!SITE_ID!!
- ブックIDです。
- !!PAGE_NAME!!
- ページ名です。
- !!COMMENT_NAME!!
-
投稿者の名前(HN)です。
通常は未記入の状態になりますが、コメント投稿時に投稿者名が入力されていると、その名前に変換されます。 - !!COMMENT_FORM!!
- コメントの入力欄です。
- !!CHECKKEY_FORM!!
- 確認キーの入力欄です。
bbs_entry.html
BBSプラグインが表示する最近投稿されたコメント内容のテンプレートです。
- !!TITLE!!
- コメントのタイトルです。
- !!BODY!!
- コメントの内容です。
- !!NAME!!
- 投稿者の名前(HN)です。
- !!TIME!!
- コメントが投稿された時間です。
- !!DEL_BUTTON!!
-
コメントの削除ボタンです。
ログイン中の場合に表示されます、投稿されたコメントを削除したい場合は、こちらをクリックしてください。 - !!REMOTE_HOST!!
- 投稿者のリモートホストです。
bbs_entry_log.html
最大表示数を超えた場合に作成される過去ログを保存するページに記録するコメント内容のテンプレートです。
過去ログは通常のページの本文として作成されるので、PolyMoNote文法で記述してください。
- !!TITLE!!
- コメントのタイトルです。
- !!BODY!!
- コメントの内容です。
- !!NAME!!
- 投稿者の名前(HN)です。
- !!TIME!!
- コメントが投稿された時間です。
- !!REMOTE_HOST!!
- 投稿者のリモートホストです。
備考
各ページのデータディレクトリに"bbs.txt"という掲示板のログファイルが作成されます。