第13弾/コメント登録コンポーネント version 1.0.0
金魚屋開発支援シリーズ第13弾
Joomla 1.0.x
はじめに
NAME
com_kingyoya_comment - 金魚屋コメント登録コンポーネント
Latest Version
HISTORY
2008-08-28 1.0.0
リリース
概要
コンテンツや各種コンポーネントにコメント投稿機能を持たせるためのコンポーネント。
このコンポーネント自体はフロントエンド向けの表示を持っていないので、対応するモジュールやコンポーネントなどと組み合わせて利用する。
必要なマンボット
- 金魚屋DBTable 拡張Mambot
- 管理画面HTML生成 Mambot
コメント登録の方法
下記にフォーム例
<form action="index.php" method="post"> <p><label>名前:<input type="text" name="name" size="10" maxlength="255" /></label></p> <p><label>コメント:<textarea name="comment" cols="10" rows="4"></textarea></label></p> <p><input type="submit" /></p> <input type="hidden" name="option" value="com_kingyoya_comment" /> <input type="hidden" name="task" value="save" /> <input type="hidden" name="Itemid" value="666" /> <input type="hidden" name="group" value="com_mycomponent" /> <input type="hidden" name="target" value="target_id" /> </form>
コメント管理について
コメントは「GROUP」と「TARGET」の2つで分類される。
TARGET
「TARGET」はコメントの小分類に当たる。
コンテンツにコメントを付けたい場合は、対象のコンテンツのID を指定することで、コンテンツごとのコメント付けを行える。
投稿フォームではHidden フィールドに name を target として値を設定する。
メニューの利用
このコンポーネント自体はフロントエンドのための表示を持っていないので、表示されないメニューなどを用意して、そのメニューアイテムとしてこのコンポーネントを登録する。
メニューパラメータをそれぞれ設定して、投稿フォームのHidden フィールド Itemid に、登録したメニューアイテムのID を指定することで、メニューの設定パラメータを利用できる。
メニューパラメータでのみ設定可能な項目があることに注意。
メニューパラメータ
即時公開
「はい」を選択すると、投稿したコメントが公開状態で登録される。
「いいえ」を選択するか未設定の場合は非公開状態で登録される。
コメントの公開・非公開の切り替えは管理画面から行える。
投稿メッセージ
コメント投稿時に戻り先URL のGET パラメータに設定されるメッセージ。
フォームに指定があれば、その値が優先される。
指定がなければURL にメッセージは付与されない。
エラーパラメータ
コメント投稿エラー時に、対象のエラー項目名を受け取るためのGET パラメータ名を指定する。
たとえば値が com_kingyoya_comment[error] で名前未入力の場合は、com_kingyoya_comment[error]=name というGET パラメータがURL に付与される。
フォームに指定があれば、その値が優先される。
この値が未指定の場合は何も付与されない。
フォームの要素について
* 印は必須項目
* group
コメントのGROUP(大分類)。
* target
コメントのTARGET(小分類)。
* name
コメントの投稿者名。
* comment
コメントの本文。
message
投稿メッセージ。詳細はメニューパラメータを参照。
message_key
投稿メッセージキー。詳細はメニューパラメータを参照。
return
戻り先URL。詳細はメニューパラメータを参照。
return_error
エラー戻り先URL。詳細はメニューパラメータを参照。
error_key
エラーパラメータ。詳細はメニューパラメータを参照。