d3コメント統合の、元記事閲覧権限連動その他ハック

• 2012-8- XoopsX の X-update で導入・アップデート可能です。　最新ソースは　https://github.com/XoopsX/d3forum

• 2011-5-15　sourceforge.jpにd3forumメンテプロジェクトを立ち上げて、本ハックをマージしたバージョンを配布開始しました。こんごはそちらが最新になります。お間違えなく。

• 2010-11-01　他の機能を取り込んでバージョンアップしました。
  現在のハックバージョン：0.85_003a4
  （過去のバージョンはこちら→　0.85_001）

実装済みのサイト（参考まで）　：　d3diaryデモサイト

元ネタ：（XUGJ）d3forum-d3diary統合元モジュール閲覧権限フィルター　
（本ハックでは実装方法を少し変えています。）

d3forumのコメント統合の、元記事閲覧権限を制御する機能を使うとき、コメントのタイトルやコメント者がd3forum側で表示されてしまう気持ちが悪さを回避するためのハックをメインとし、本名表示対応やゲスト名表示、ツリー表示、テーマ色の反映などの周辺ハックを取り込んだ物です。

なお、d3forumの更に先の関連モジュールとの連携は、d3pipes（とattachfile：2010-11-2追加）を除いて手を入れていません。　（例えば、新着情報、piCalなど。。）　元記事に閲覧権限が無いコメントでも、それらには発信される可能性がありますので、ご承知おきださい。　今後手をつけるかもしれませんが、切りが無いので期待薄と思ってください。

ダウンロード

以下のファイルをダウンロード、解凍し、trust以下のフォルダを xoops_trust_path/　以下に上書き、html側のsmartyプラグインをsmarty/pluginsフォルダにアップロードして、モジュールアップデートを実行してください。

ダウンロードファイル	適応d3forum本体バージョン
d3com_auth_diff_0.85_003a5.zip 第三版-a4 最新 いくつかのバグFIXなどの最終版	0.85
d3com_auth_diff_0.85_003a.zip; 第三版-a、 「0.85_003」でのcomment_functions.phpの不具合修正。 コメント統合のクラス取得処理を改善。 （注意）smartyPlugin 「function.d3comment.php」も変更しています。	0.85
d3com_auth_diff_0.85_002.zip 第二版	0.85

機能・内容

コメント元記事の閲覧権限の継承

メインとなる機能です。　D3コメント統合を行った各モジュールの、D3commentクラス内の、「Validate_id」メソッドへの問い合わせを行って、その結果で判定します。　対象となるページは、

1. listtopics　ページ、 listtopics_over_categories　ページ
2. listtopicsブロック、listpostsブロック
3. forum検索　ページ
4. Global 検索　ページ　→　結果的に　各ユーザーの投稿ログページにも反映される。

となっています。
各モジュールへの問い合わせた結果は、そのモジュールのD3commentクラスの「validate_id」実装内容次第です。

　但し、listtopics　ページと listtopics_over_categories　ページ　については、管理者とアドミニストレータに対しては、問い合わせ結果に関わらず全て表示します。　理由は、どこか表示しておかないと、元記事が削除されたりしてモジュール間の記事リンクが切れた場合に、迷子になった記事のメンテナンスが出来なくなってしまうからです。　　今回のハックによる副作用として、このような迷子記事は　一般ユーザーやゲストからは一切見えなくなりますので、そのメリット・デメリットを考慮のうえご使用ください。

d3pipes ブロックジョイントの閲覧権限の継承

同梱したd3pipesブロックジョイント「D3pipesBlockD3forumrev」も同様に権限継承がなわれます。　（Topics/Posts　をパラメータで選択）　
このTopicsジョイントでは、d3forumオリジナルのジョイントではアサインされない、トピック内の最新コメント本文もアサインします。　今回追加したPostsジョイントも同様です。

なお、タイトル部分に[掲示板名]を付加しております。

external_link_idのアサイン

各ハックでは、テンプレートに　external_link_id　をアサインしています。
使い方としては、　各ページでの飛び先をコメント元記事に変更したりすることを想定しています。

　参考：コメント統合でブロックから元記事へリンク

block_list_posts.html、block_list_topics.html　テンプレートの中にサンプルでコメントアウトしていますので、必要に応じて内容を調整し有効化してください。

ゲスト名のアサイン

オリジナルのソースでは、ゲスト名がアサインされていなかったのを、topicslist、topics_over_categoriesでは「first_post_gname」「last_post_gname」でアサインしています。
元ネタ：（XUGJ）d3forumのlisttopicsのゲスト名

本名表示

管理画面に、「uname」（ユーザーID）／「name」（本名：ニックネーム）　の表示選択を付けて、全ての表示を切り替えるようにハックしました。　なお、notification機能の送信先ユーザー名（X_UNAME）についてはコア側なので変更していません。　コアがXCLでしたら、RYUSさんが公開している、RyusExmailString preloadの使用をお勧めします。

コメント統合で d3forumのツリー全表示

元ネタ - XUGJ

• function.d3comment_tree.phpを、smartyプラグインフォルダにコピーしてください。
  • コメント統合で付いたコメント。　質問内容が変わったりしてトピック分けしたりすると、d3forum側で「このトピックの投稿一覧へ」で閲覧してもトピック内の投稿しか表示されないため、同じ元記事に紐付いた他のトピックの投稿に気づかない場合があります。
    　オリジナル版では、元記事にジャンプして初めてその存在に気づくことになっていて、最大表示記事数を超えている場合は元記事側でも他のトピの投稿が流れてしまって表示されない場合もあります。　こういう時は、仕方なく「トピック表示」にしたりしますが、訪問者から見るとコメントし辛い感じ。
    　色々な案を考えてやってみたのですが、一番しっくりきたのはd3forum側で「このトピックの投稿一覧へ」を表示したときに、他のトピも含めてツリーを表示するというものです。　当該トピだけでしたら、テンプレート編集だけで行けますが、全トピのツリー表示は対策が必要です。
  • テンプレートには既に記述済みで編集不要ですが、もし応用として変更する場合は以下を参考にしてください。
    • 呼び出し例
      <{d3comment_tree forum_dirname=$mydirname forum_id=$forum.id topic_id=$topic.id external_link_id=$topic.external_link_id order="ASC" postorder=$postorder use_name=$mod_config.use_name item="tree"}>
    • 指定オプション
    1. forum_dirname：　d3forumのディレクトリ名。d3forumテンプレート内では$mydirnameでＯＫ。
    2. forum_id：　コメント統合したd3forumのforum番号。d3forumテンプレート内では$forum.idでＯＫ。
    3. topic_id：　コメント統合記事以外の時に表示トピックを限定するための、topic番号。d3forumテンプレート内では$topic.idでＯＫ。
    4. external_link_id：　コメント統合記事の外部リンク番号。d3forumテンプレート内では$topic.external_link_idでＯＫ。
    5. order：　表示の昇順／降順指定。　「ASC」＝「降順」、「DESC」＝「昇順」。　「d3forum_main_listposts.html 」内の記述では、ツリー構造順表示が標準ですので、ここでは何も指定しないでください。
    6. limit：　ツリーに表示する最大タイトル数。　指定しなければ100件までを最大として表示します。（記事自体の表示件数ではありません。）
    7. postorder：　「投稿の新しいものから」「投稿の古いものから」をクリックした時の、表示順変更のための変数。　d3forumテンプレート内では$postorderでＯＫ。
    8. use_name：　前項の本名表示をするかしないかのパラメータ。　$mod_config.use_name のままでOK。
    9. item：　テンプレート内で参照する変数名。

テーマの色調を引き継ぐ

　d3forumのテンプレート、モジュールCSSは、独自の色調を採用しており、テーマを変更するたびに　テーマの色調に調整しなければなりません。　調整箇所を集約する工夫がなされているとはいえ、結構面倒ですし、サイト訪問ユーザーが自由に切り替えられないのは困ります。
　これを、特に見づらくなる部分を重点的にテーマのCSS要素を継承する設定に変更してあります。

謝辞

d3forumの当該ソースはもちろんのこと、その他のソースも参考にさせていただきました。　GIJOEさん、ありがとうございます。

改変履歴

2011/05/15 第三版+（0.85_003a5）

• • conventional mode のd3commentの不具合修正。(thx domifara)

2010/11/05 第三版（0.85_003a）

• • comment_functions.phpの不具合修正。

2010/11/04 第三版（0.85_003）

• • コメント統合クラスのObject取得処理を改善し、ループ処理内から同一のtarget_dirnameではInstance取得とし、メモリ消費量などを改善。（のつもり）　外部のmoduleなどから「D3commentObj」クラスの再利用も可能。

2010/11/01 第二版（0.85_002）

• • コメント元閲覧権限継承のほか、別のいくつかの機能を取込み。

2009/07/03 初版（0.85_001）公開