LOGIN ID Password Auto Login Register Now! Lost Password?
XUGJ Wiki

ModuleManuals

d3pipes anchor.png

機能
某!Pipesっぽい、シンジケーション総合モジュール
種別
動的コンテンツ
作者
GIJOE
バージョン
0.63d (2008-5/20)
動作環境
XOOPS2.0、XOOPS Cube Legacy 2.1
配布元
http://xoops.peak.ne.jp/
複製
Duplicatable V3
Page Top

概要 anchor.png

XOOPSサイト内や他のサイトから発信されるRSSを取得し、XOOPSコンテンツ内に一覧として表示をすることができます。
d3pipesでは、単にRSS情報を表示するだけではなく、ジョイント(継ぎ手)を繋ぎ合わせたパイプを構成することで様々に利用することができます。ジョイントをつなぎ合わせたパイプ同士を「連結」することで、新しいパイプをつくることもできます。

  • 外部のRSS/ATOM等を任意のアグリゲーションで表示できる
  • 外部のRSS/ATOM等を取り込む/自動的に削除する
  • 取り込んだ外部のRSS/ATOM等にマークをつける/コメントをつける
  • 内部の新着情報を任意のアグリゲーションで表示できる
  • 内外の情報をシームレスに取り扱える
  • 内外の情報いずれもRSS1/RSS2/ATOMのフォーマットで出力できる
  • 機能を徹底的に分解したジョイントモデルにより拡張も自由自在
  • エントリ絞り込み(mbregexも選択可能)
  • XML取得動作でサイト全体を重く感じさせない非同期表示ブロック搭載
  • D3モジュールなので、自由なdirnameでの複製と簡単なバージョン管理は当たり前
Page Top

インストール anchor.png

altsys 0.55 以上が必要です。必ず先にインストールしてください。

D3モジュールとして通常の方法でモジュールインストールを行います。

また XOOPS_TRUST_PATH 直下に cache ディレクトリを作り、書込を許可します。ホダ塾ディストリビューションなどでは最初から用意されていますので、この手順はスキップしてかまいません。

またXOOPSを運用しているサーバからWANにアクセスする際にproxyを経由する必要がある場合は、先に管理画面の一般設定内でproxyの設定をしておくと良いでしょう。

Page Top

アップデート anchor.png

D3モジュールとして通常の方法でモジュールアップデートを行います。 特に指定がなければ、XOOPS_TRUST_PATH側の上書きアップロードだけで構いません。

Page Top

アンインストール anchor.png

通常の方法でモジュールアンインストールを行います。

XOOPS_TRUST_PATH/cache については、これを利用するプログラムも多いので、あえて削除する必要はありません。

Page Top

知っておくべき事 anchor.png

Page Top

RSSとは何か anchor.png

RSS(Wikipedia)
http://ja.wikipedia.org/wiki/RSS

Page Top

用語 anchor.png

d3pipesには独特の用語があります。

パイプ
RSSデータが流れる1本の管。もちろん入口と出口の両方を持つ。
ジョイント
パイプの繋ぎ手。大きく13種類に分けられる。
ジョイントクラス
ジョイントの細かな実装。環境や目的に応じて使い分ける
Page Top

使用方法 anchor.png

d3pipes では「パイプ」を作成することから始まります。管理画面から「パイプ管理」を選択します。インストール直後には何も登録されていません。
パイプの作成方法としては3つの方法が用意されています。

  • RSS/Atom取得パイプ作成ウイザード
  • サイト内新着情報パイプ作成ウイザード
  • 新規パイプ作成(上級者用)

このいずれかの方法でパイプを作って、そのパイプをメインページやブロック、RSSとして出力する、という流れになります。

Page Top

RSS/Atom取得パイプ作成ウイザードによるパイプ作成 anchor.png

取得したい RSS/Atom が判っている場合はこれを利用するのが便利でしょう。

a01.gif
サイト名サイトの名称を記載します
サイトのURLサイトのURLを記載します
RSS/AtomのURLRSS/AtomのURLを記載します
RSS/AtomのエンコーディングRSS/Atomの文字コードを指定する際に記載します。通常は空欄で構わないでしょう
取得したエントリを保存する
可能な限り配信されたHTMLのまま表示する

内容確認の後、登録されます。

管理画面(パイプ一覧)

a02.gif

通常ページ(一覧)

a03.gif

通常ページ(記事詳細)

a04.gif
Page Top

サイト内新着情報パイプ作成ウイザードによるパイプ作成 anchor.png

パイプ管理から「サイト内新着情報パイプ作成ウイザード」に入ります。 そこでは、インストールされたモジュールの一覧が表示されますので、新着情報として表示もしくはRSS出力したいモジュール用のジョイントを選んで、チェックします。

一つのモジュールに複数のジョイントが表示されていることもありますが、ジョイント名から、どのような新着情報になるかを判断してください。

例えば、教えて!Xoo用のジョイントは、BlockPlzxooquestions と BlockPlzxooanswersの2つあります。質問の新着情報が必要なら前者を、回答の新着情報が必要なら後者を、それぞれ選択します。

登録ボタンのすぐ上にある、「これらを統合表示するパイプも作る」をチェックすると、今回チェックをいれたモジュールの各種新着情報を連結するパイプも新しく作られます。

その連結パイプを使えば、サイト全体の新着情報をブロック・メインページ・RSSとして出力することができます。

もちろん、パイプ管理から、任意のパイプを連結するパイプを後から作ることも出来ます。

Page Top
対応モジュール anchor.png
  • pico (By GIJOE)
  • xhnewbb (By GIJOE)
  • xpwiki (By nao-pon)
  • Plzxoo (By GIJOE)
  • piCal (By GIJOE)
  • News (By GIJOE)
  • NewBB (By GIJOE)
  • Mylinks (By GIJOE)
  • Mydownloads (By GIJOE)
  • myalbum-P (By GIJOE)
  • d3forum (By GIJOE)
  • Bulletin2 (By GIJOE)
  • システムコメント (By GIJOE)
  • XWords (By モーションクリエイト)
  • d3blog (By hodaka)
  • d3downloads (By toshi)
Page Top

新規パイプ作成(上級者用) anchor.png

連結のみのパイプを作る場合など、あえてこの画面から新規パイプを作成することもあります。

基本的には、管理画面のパイプの編集と同じなので、ここでは割愛します。

Page Top

作成したパイプを出力する anchor.png

パイプ管理・一覧画面から指定します。

「表示」および「リスト」をチェックすることで、そのパイプがモジュールトップからアクセス可能となります。

「集約」をチェックすると、モジュールトップ画面にそのパイプから来た情報も表示されるようになります。

ブロックに表示する場合は、「Block」列にチェックを入れた上で、ブロック管理/アクセス権限から、ブロックを編集または複製し、ブロックオプションにて、そのパイプ番号を指定します。パイプ番号は右のドロップダウンから選択することで自動的にセットされます。

Page Top

管理画面 anchor.png

Page Top

パイプ管理 anchor.png

Page Top
パイプ一覧 anchor.png
番号
パイプ番号。連結やブロック表示対象としてこの番号を指定する
種別
パイプの性格が表示されている。外部サイトのRSS取得があるか、内部取得があるか、連結のみか、などを見て判定している。
名称
パイプの名前。メインページなどに表示される。
順番
表示順
表示
メインページに表示可能かどうか
リスト
モジュールトップページにそのパイプへのリンクを表示するかどうか
集約
モジュールトップページにアグリゲーション表示する対象かどうか
RSS
RSSとして出力可能かどうか
Block
ブロック表示するかどうか(さらにブロック管理でのパイプ番号指定も必要)
SUB
メインメニューブロック等で、サブメニュー項目として表示するかどうか
更新
最後にパイプを編集した日時が表示されている
最終取得
そのパイプが最後に取得動作を行った日時が表示されている(連結のみのパイプであれば常に空欄)
操作
パイプを編集したり、パイプトップページを表示するためのリンク
Page Top
パイプの編集 anchor.png

どのウイザードで作ったパイプであっても、パイプを編集する場合は、この画面で操作することになります。

Page Top

キャッシュ管理 anchor.png

d3pipes では、XOOPS_TRUST_PATH/cache に各記事のキャッシュを保持しており、これを管理します。
機能としては以下があります。

    • TRUST_PATH/cache下の外部取得・キャッシュ・切り抜き各ジョイントのキャッシュをすべて削除する
    • 全パイプの最終取得時間をクリアする
Page Top

切り抜き管理 anchor.png

パイプ内に「ローカル保存」ジョイントを含むと、各記事が切り抜きとしてDB等に保存されますが、これを管理します。

    • コメントのついた切り抜きは保護する
    • 注目マークのついた切り抜きは保護する
    • パイプとリンクしていない切り抜きを削除する
    • 発行日が日以上前の切り抜きを削除する
Page Top

ジョイント初期設定 anchor.png

d3pipes では、その名の通りジョイント(継ぎ手)を繋ぎ合わせたパイプによって様々な処理が可能になります。ウイザードなどジョイントクラスが任意に選ばれるケースで、どのクラスが初期値として利用されるかをここで設定します。

外部から取得
通常はsnoopyで十分なはずです。
XML解析
RSSやAtomであれば、keithxmlのままで良いでしょう
ブロック関数からの取得/解析
この初期設定にはあまり意味がありません
コード変換(UTF8から)
mbstringが使えるなら文句なしにmbstringです。なければiconv
コード変換(UTF8へ)
同上
再割り当て
この初期設定にはあまり意味がありません。
テキスト置換
mbregexが使えるならmbregexがバイト境界も判断してくれるのでベストですが、正規表現パターンの習熟度などであえてpcreを選ぶ局面もあるでしょう。
絞り込み
同上
ローカル保存
現状では、DB保存しか実装されていません。
キャッシュ
現状では、turstpath(XOOPS_TRUST_PATH/cache)しか実装されていません。
更新Ping
xmlrpc2しか選択できません。
エントリの順序
一般的には、pubtimedscでしょう。
他パイプの連結
アグリゲーションするならmergesortでしょう。
Page Top

一般設定 anchor.png

モジュールトップで表示する最新ヘッドラインの総数
モジュールトップで表示する最新ヘッドラインに1パイプから引っ張ってくる最大数
個々のパイプページで表示するエントリ数
各パイプの切り抜き一覧表示1ページに表示するエントリ数
各パイプのRSS/ATOMで出力するエントリ数
サイトマップXML出力での最大エントリ数
切り抜きを自動削除する日数(取得日ベース)
内部エンコーディング
外部取得キャッシュ期間 (秒)
取得先URIのリダイレクトについて警告する
取得先URIの最大リダイレクト回数
外部取得に経由するProxyのホスト名(ポート番号,ユーザ名,パスワード)
サーバにて外部接続の場合でProxyの設定が必要な際に記載します。通常は空欄にします。
curlのパス (デフォルトは/usr/bin/curl)
tidyのパス (デフォルトは/usr/bin/tidy)
xsltprocのパス (デフォルトは/usr/bin/xsltproc)
更新Pingサーバ
モジュール用CSSのURI
イメージファイルディレクトリ
コメント統合するd3forumのdirname
コメント統合するフォーラムの番号
Page Top

ジョイント解説 anchor.png

Page Top

block(ブロック関数からの取得/解析) anchor.png

表示名ジョイントクラスファイル機能オプション
bulletinlistD3pipesBlockBulletinlist.class.phpbulletin2の新着記事を集めてくる対象モジュールdirname,件数
d3bloglistD3pipesBlockD3bloglist.class.phpd3blogの新着記事を集めてくる対象モジュールdirname,件数
d3downloadslistD3pipesBlockD3downloadslist.class.phpd3downloadsの新着を集めてくる対象モジュールdirname,カテゴリー絞り込み,件数,詳細情報を取得するかどうか
d3forumtopicsD3pipesBlockD3forumtopics.class.phpd3forumで動きのあったトピックを集めてくる対象モジュールdirname,カテゴリー絞り込み,件数
myalbumplistD3pipesBlockMyalbumplist.class.phpmyAlbum-Pの新着を集めてくる対象モジュールdirname,件数
mydownloadslistD3pipesBlockMydownloadslist.class.phpmydownloadsの新着を集めてくる対象モジュールdirname,件数
mylinkslistD3pipesBlockMylinkslist.class.phpmylinksの新着を集めてくる対象モジュールdirname,件数
newbb1topicsD3pipesBlockNewbb1topics.class.phpnewbb1.0で動きのあったトピックを集めてくる対象モジュールdirname,件数
newslistD3pipesBlockNewslist.class.phpnews1.1の新着記事を集めてくる対象モジュールdirname,件数
picallistD3pipesBlockPicallist.class.phppiCalの新着イベントを集めてくる対象モジュールdirname,件数
picolistD3pipesBlockPicolist.class.phppicoの新着記事を集めてくる対象モジュールdirname,カテゴリー絞り込み,件数,本文も取得するかどうか
plzxooanswersD3pipesBlockPlzxooanswers.class.php教えて!Xooの新着回答を集めてくる対象モジュールdirname,件数
plzxooqustionsD3pipesBlockPlzxooquestions.class.php教えて!Xooの新着質問を集めてくる対象モジュールdirname,件数
systemcommentsD3pipesBlockSystemcomments.class.phpXOOPSコメントシステムでの新着を集めてくる(system固定),件数
xhnewbbtopicsD3pipesBlockXhnewbbtopics.class.phpxhnewbbで動きのあったトピックを集めてくる対象モジュールdirname,件数
xpwikipagesD3pipesBlockXpwikipages.class.phpxpWikiの新着記事を集めてくる対象モジュールdirname,ベースページ,件数,権限を常にゲストとするか
Page Top

cache(キャッシュ) anchor.png

表示名ジョイントクラスファイル機能オプション
この時点でのキャッシュD3pipesCacheTrustpath.class.phpXOOPS_TRUST_PATH/cache下にキャッシュを生成する。RSSなどを外部から取得するパイプではキャッシュかローカル保存のいずれかを必ず追加するキャッシュ時間(単位は秒)※最低でも300秒以上に設定しないと取得先に迷惑がかかる
Page Top

clip(ローカル保存) anchor.png

表示名ジョイントクラスファイル機能オプション
DB内へ切り抜きとして保存D3pipesClipModuledb.class.phpエントリをDBに保存する。コメントをつける場合は必須切り抜きから次へ渡す最低エントリ数,切り抜きの保存日数
Page Top

fetch(外部から取得) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

filter(絞り込み) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

parse(XML解析) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

ping(更新Ping) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

reassign(再割り当て) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

replace(テキスト置換) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

sort(エントリの順序) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

union(他パイプの連結) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

utf8from(コード変換 UTF-8へ) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

utf8to(コード変換 UTF-8から) anchor.png

表示名ジョイントクラスファイル機能オプション
Page Top

ブロック anchor.png

ブロック名テンプレート説明ブロック複製ブロックオプション
同期パイプ一覧ブロックd3pipes_block_sync.html×
非同期パイプ一覧ブロックd3pipes_block_async.html×
Page Top

テンプレートセット anchor.png

(ブロックと基本の区別は不要)

(テンプレート名)(テンプレートの説明)
d3pipes_admin_cache.html
d3pipes_admin_clipping.html
d3pipes_admin_joint.html
d3pipes_admin_pipe_edit.html
d3pipes_admin_pipe_list.html
d3pipes_admin_wizard_fetch.html
d3pipes_admin_wizard_inner.html
d3pipes_blockedit_async.html
d3pipes_block_async.html
d3pipes_block_sync.html
d3pipes_block_sync_big.html
d3pipes_inc_entries.html
d3pipes_independent_atom.html
d3pipes_independent_rss10.html
d3pipes_independent_rss20.html
d3pipes_independent_sitemap.html
d3pipes_main.css
d3pipes_main_cliplist.html
d3pipes_main_clipping.html
d3pipes_main_eachpipe.html
d3pipes_main_index.html
d3pipes_main_jsbackend.html
d3pipes_main_xmlrpc2extendedping.html
d3pipes_main_xmlrpc2ping.html
Page Top

イベント通知の種類 anchor.png

イベント通知機能はありません。

Page Top

Tips anchor.png

(意外と知られていない機能など、追記したいことを書く)

Page Top

よくある質問 anchor.png

Page Top

ライセンス anchor.png

GPLv2

Page Top

関連モジュール anchor.png

モジュール名説明配布先
altsys必須モジュールですhttp://xoops.peak.ne.jp/
d3forumd3pipesでコメント機能を使うときに必要なフォーラムモジュールhttp://xoops.peak.ne.jp/
picohttp://xoops.peak.ne.jp/
xhldhttp://xoops.peak.ne.jp/
xoopsheadline

添付ファイル:
filea02.gif 512件 [詳細] filea01.gif 539件 [詳細] filea04.gif 511件 [詳細] filea03.gif 512件 [詳細]

トップ   凍結 差分 バックアップ 複製 名前変更 リロード印刷に適した表示   ページ新規作成 全ページ一覧 単語検索 最新ページの一覧   ヘルプ   最新ページのRSS 1.0 最新ページのRSS 2.0 最新ページのRSS Atom Powered by xpWiki
Counter: 25116, today: 3, yesterday: 3
初版日時: 2007-12-07 (金) 03:49:29
最終更新: 2014-01-13 (月) 22:06:01 (JST) (1349d) by chika3
Back to Page Top
MainMenu
Manuals
Search
XOOPS Official & Dev.
XOOPS Communities