$Id: readme_jp.txt,v 1.8 2005/09/15 04:25:34 ohwada Exp $

=================================================
Subject: What's New Module
Version: 1.31
Date:    2005-09-10
Author:  Kenichi OHWADA
URL:     http://linux.ohwada.jp/
Email:   webmaster@ohwada.jp
=================================================

● V1.3 からの変更内容
１．プラグインの追加
- bluesb v0.23

２．プラグインの変更
- pical
時刻の変換に、MySQL の UNIX_TIMESTAMP を使用した。

３．バグ修正
(1) strip_tags 関数では、styleタグに囲まれた部分が削除されない。
その部分も合わせて削除する関数を追加した。

(2) ブロックにてモジュール順に正しく並び替えできない


=================================================
Version: 1.3
Date:    2005-09-10
=================================================

● V1.2 からの変更内容
１．プラグイン追加
- xoopsfaq v1.10
- yomi v0.84


=================================================
Version: 1.2
Date:    2005-08-08
=================================================

● V1.1からの変更内容
１．プラグインを追加した
- pical 0.80
- smartfaq 1.04
- soapbox 1.5

２．バグ修正
(1) RDF が 文法エラーになる
dc:date must be an W3CDTF date
http://dev.xoops.org/modules/xfmod/tracker/index.php?func=detail&aid=2823&group_id=1249&atid=1171

(2) RDF/ATOM にて、W3C 違反
CDATA の中では、デルミタ "]]>" をエスケープする必要あり
http://dev.xoops.org/modules/xfmod/tracker/index.php?func=detail&aid=2824&group_id=1249&atid=1171


=================================================
Version: 1.1
Date:    2005-06-20
=================================================

● V1.0からの変更内容
１．画像の縮小表示を追加した
設定したサイズよりも大きいと、そのサイズに縮小表示される

プラグインのAPIに、width と height を追加した。

２．PDA用の画面を追加した
XOOPS_URL/pda.php に代わるもの
XOOPS_URL/modules/whatsnew/pda.php にアクセスする

URLが印刷画面(print.php)になっているモジュール
- news
- tinyd0
- xfsection

プラグインのAPIに、pda を追加した。

３．デバック表示を追加した
RSS、RDF、ATOM でエラーが起こると、XMLが表示されない。
HTML表示を追加した。

４．UTF8変換を変更した
XOOPS コアの xoops_utf8_encode 関数にて、文字コードが自動判定できないことがある。
文字コードを固定する関数を自前で持った。

５．プラグインを追加した
- WFdownloads 2.05
- WFsection 2.07

６．フランス語パックを追加した

● 追加・変更したファイル
追加したファイル
pda.php
admin/rebuild_pda.php
admin/view_atom.php
admin/view_rdf.php
admin/view_rss.php
include/func.pda.php
include/version.php
language/french/ 以下の全て
plugins/wfdownloads/data.inc.php
plugins/wfsection/data.inc.php
templates/whatsnew_pda.html

変更したファイル
index.php
xoops_version.php
admin/index.php
blocks/block.new.php
class/base_language.php
include/func.atom.php
include/func.rdf.php
include/func.rss.php
include/func.whatsnew.php
language/english/admin.php
language/english/convert_language.php
language/japanese/admin.php
language/japanese/convert_language.php
plugins/myalbum/data.inc.php
plugins/news/data.inc.php
plugins/tinyd0/data.inc.php
plugins/xoopsgallery/data.inc.php
templates/whatsnew_index.html
templates/blocks/whatsnew_block_1.html
templates/blocks/whatsnew_block_2.html

● インストールとアップデート
１．解凍とコピー
解凍すると、「whatsnew」というディレクトリが出来る。
XOOPS の modulues デ ィレクトリに下にコピーする

２．whatsnew モジュールのパーミッション
whatsnew/cache に書込み許可を与える

３．whatsnew モジュールのインストールあるいはアップデート
XOOPSの管理者画面の「モジュール管理」から、インストールあるいはアップデートする

４．whatsnew モジュールの設定
管理者画面の「一般設定」にて、設定ファイルを保存する。

５．news モジュールを使っている場合は、
news/include/data.inc.php を削除してください。
whatsnew/plugins/news/data.inc.php が最新版です。

６．xoopsGallery モジュールを使っている場合は、
xoopsgallery/include/data.inc.php を削除してください。
whatsnew/plugins/xoopsgallery/data.inc.php が最新版です。


=================================================
Version: 1.0
Date:    2005-06-06
=================================================

● 変更内容
１．本体の変更
１．１ プラグイン方式
Ryujiさんのハックを取り入れて、プラグイン方式に変更した。

whatsnew モジュールのハック
http://ryuji.be/index.php?itemid=42

最初に modules/MOD/include/data.inc.php をチェックして、
なければ、modules/whatsnew/plugins/MOD/data.inc.php を読み込みます。

Ryujiさんの案では、
modules/whatsnew/plugins/MOD/include/data.inc.php
となっていますが、
includeディレクトリが邪魔なので、
modules/whatsnew/plugins/MOD/data.inc.php
に変更しました。

１．２ rdf 出力
hoshiyanさんのハックを取り入れて、RDF出力を追加した。

最新情報モジュール(whatsnew0.91)用RDF配信セット
http://www.hoshiba-farm.com/modules/mydownloads/singlefile.php?cid=1&lid=10

１．３ index ページ
index ページにモジュール別に最新情報を表示するようにした。

２．ブロックの追加
Hodakaさんのハックを取り入れて、モジュール別に表示するブロックを追加した。

whatsnewのモジュール別表示hack 
http://www.kuri3.net/modules/mydownloads/singlefile.php?cid=2&lid=13

(1) アクセス権限のないモジュールは表示しない。
(2) モジュール別＆記事日付別にソートして表示するブロックを追加した
    最も新しい記事のあるモジュールが常に最初に表示されます。

３．プラグインの追加
(1) system 
従来は systemモジュール には何の機能もなかったが、
コメントを収集する機能を追加した。

下記のものを追加した。
(2) PopnupBlog 2.1
(3) simpleblog 0.21
(4) tinyD 2.17
(5) weblog 1.42
(6) yybbs 0.57
(7) wordpress 0.5
(8) myAlbum-P 2.84

上記のプラグインは、
下記の方が作成されたものを、少し変更して、取り入れました。

- hoshiyan さん
http://www.hoshiba-farm.com/modules/mydownloads/singlefile.php?cid=1&lid=7

- Hodaka さん
http://www.kuri3.net/modules/mydownloads/singlefile.php?cid=2&lid=12

- wei さん
http://jp.xoops.org/modules/newbb/viewtopic.php?topic_id=6236&forum=17

- cinnamons さん
http://jp.xoops.org/modules/newbb/viewtopic.php?topic_id=6338&forum=17

４．プラグインの変更
(1) B-Wiki 20050101
タイトルだけであったが、内容も収集するように変更した

５．バグ修正
(1) mylinks が fatal error になる
http://linux.ohwada.jp/modules/newbb/viewtopic.php?topic_id=100&forum=6

６．英語版に対応した


● インストールとアップデート
１．解凍とコピー
解凍すると、「whatsnew」というディレクトリが出来る。
XOOPS の modulues デ ィレクトリに下にコピーする

*** 注意 ***
プラグイン方式に変更したので、
デイレクトリ構成が少し変わっています。

whatsnew
- admin
- bin
- blocks
- cache（書込み許可を与える）
- class
- images
- include
- template
- language
--- english
--- japanese
- plugins (ディレクトリが追加された)
--- bwiki
--- mylinks
--- mydownloads
--- news
--- newbb
--- weblinks
--- xfsection
--- xoopsgallery
--- system (以下、プラグインが追加された)
--- popnupblog
--- simpleblog
--- tinyd0
--- weblog
--- yybbs
--- wordpress
--- myalbum

２．whatsnew モジュールのパーミッション
whatsnew/cache に書込み許可を与える

３．whatsnew モジュールのインストールあるいはアップデート
XOOPSの管理者画面の「モジュール管理」から、インストールあるいはアップデートする

４．mylinks モジュールを使っている場合は、
mylinks/include/data.inc.php を削除してください。
whatsnew/plugins/mylinks/data.inc.php が最新版です。

５．bwiki モジュールを使っている場合は、
bwiki/include/data.inc.php を削除してください。
whatsnew/plugins/bwiki/data.inc.php が最新版です。

６．tinyD モジュールの複製機能を使っている場合は、
whatsnew/plugins/tinyd0 ディレクトリを同じように複製(コピー＆リネーム)してください。

７．以降は V0.9 を参照ください。

=================================================
Version: 0.9
Date:    2004/08/28
=================================================
● 機能
１．新着記事一覧ブロック
複数のモジュールから最新の記事を集めて、新着記事一覧ブロック を作成する。

２．RSS/ATOM
２．１ RSS/ATOM の作成
複数のモジュールから最新の記事を集めて、RSSとATOMを作成する。

２．２ RSS/ATOM の表示
RSSとATOM のURLを読み出して、XMLを解析し、表示します。
RSSとATOM の自動検出に対応しています。

３．weblog updte ping
３．１ ping の送信
３つの方法を提供しています。
(1) 管理者が手動で送信する
(2) 新規記事ブロックを表示するときに送信する
(3) 特定のURLのアクセスすると送信する

３．２ ping の受信
デバック用途のpingサーバーです。
ping を受信し、リクエスト内容をチェックし、レスポンスを返信します。

４．対応しているモジュール
・news
・newbb
・mylinks
・mydownloads
・xoopsgallery
・bwiki
・xfsection
・weblinks

対応しているモジュールの選定は、私が使っているものです。
それ以外のモジュールへの対応は、割と簡単ですので、必要な人は作ってくださいね。

● インストール
１．解凍
解凍すると、下記のツリー構造のデイレクトリが出来る
XOOPS のツリー構造に合わせて、コピーする

html
- modulues
--- bwiki
----- include
--- mylinks
----- include
--- mydownloads
----- include
--- news
----- include
--- newbb
----- include
--- weblinks
----- include
--- xoopsgallery
----- include
--- xfsection
----- include
--- whatsnew
----- admin
----- bin
----- blocks
----- cache（書込み許可を与える）
----- class
----- images
----- include
----- template
----- language
------- english
------- japanese

２．whatsnew モジュールのパーミッション
whatsnew/cache に書込み許可を与える

３．whatsnew モジュールのインストール
XOOPSの管理者画面の「モジュール管理」から、インストールする

４．whatsnew モジュールの設定
左欄にある「whatsnew」のアイコンをクリックする
「一般設定」画面になる。
一番最初は「設定ファイルが存在していない」という警告が出るが、無視してよい。
表示するモジュールを選択して、保存する。

５．新着情報ブロックの設定
XOOPSの管理者画面の「ブロック管理」にて、「表示」に設定する
XOOPSの管理者画面の「グループ管理」にて、「モジュールアクセス権限」と「ブロックアクセス権限」を設定する

６．新着情報ブロックの確認
「ホームページ」画面にて、表示されれば、OK

７．テーマ・ファイルの修正
テーマ・ファイルに、Auto Discoveryを設定する
使用している theme.html のtitleタグの下に下記の２行を追加する
-----
<link rel="alternate" type="application/rss+xml" title="RSS" href="<{$xoops_url}>/modules/whatsnew/rss.php" />
<link rel="alternate" type="application/atom+xml" title="ATOM" href="<{$xoops_url}>/modules/whatsnew/atom.php" />
-----

８．RSS/ATOMの確認
「ホームページ」画面の左欄にある「新着情報」メニューをクリックする。
６つのリンクが表示される

(1) RSS」アイコンをクリックする。
「XML形式のRSS」が表示されれば、OK。
(2) 「RSS URL の自動検出」 をクリックする
「RSSの解析結果」が表示されれば、OK。
(3) 「RSS Valid」アイコンをクリックする。
「Congratulations!」が表示されれば、OK。
結果が表示されるまで、少し時間がかかります。

(4) 「ATOM」アイコンをクリックする。
「XML形式のfeed」が表示されれば、OK。
(5) 「ATOM URL の自動検出」 をクリックする
「ATOM の解析結果」が表示されれば、OK。
(6) 「ATOM Valid」アイコンをクリックする。
「Congratulations!」が表示されれば、OK。
結果が表示されるまで、少し時間がかかります。

９．Pingの確認
XOOPSの管理者画面の左欄にある「whatsnew」アイコンをクリックする
「一般設定」画面になる。
下段にある「weblog update ping の送信」をクリックする
「weblog update ping の送信」画面になる。
「Ping送信」ボタンをクリックする

下記のような表示が出れば、OK
-----
ping send - http://ping.bloggers.jp/rpc/ - OK
-----

ping サーバーは反応が遅いときがあります。
「HTTP connect error」や「HTTP response timeout」になることがあります。
１つくらいなら、気にしなくてもいいです。

● 誰がpingを送信するか
４つの方法があります。

(1) 管理者が手動で送信する

(2) 新規記事ブロックを表示するときに送信する
管理者の「一般設定」画面にて、新着記事ブロックの「Pingを送信する」をチェックする。
ping サーバーは反応が遅いときがあります。
その分、ブロックの表示が遅くなります。

(3) 特定のURLのアクセスすると送信する
wget などで周期的に呼び出してことを想定しています
「サーバーの管理者」である必要があります。

crontab に下記のような設定を加えます。
-----
11 * * * * usr/bin/wget http://xxx/modules/whatsnew/bin/update_ping.php?pass=??? -q -O /dev/null
-----
??? は、管理者の「一般設定」画面にて設定した「update_ping.php のパスワード」です。

(4) 記事を新設・変更したときに送信する
本来であれば、この方法が一番最初になるはずですが。
これを行うためには、該当するモジュールの該当するプログラムを全て修正する必要があります。

● どこにpingを送信するか
デフォルトで、下記のpingサーバーを用意しています。
------
http://ping.bloggers.jp/rpc/
http://ping.cocolog-nifty.com/xmlrpc
http://bulkfeeds.net/rpc
http://ping.myblog.jp/
http://blog.goo.ne.jp/XMLRPC
http://xxx/modules/whatsnew/bin/server.php （デバック用途）
------

順番に処理しているので、pingサーバーの数だけ、処理時間がかかります。
頭の３つくらいでも、充分だと思います。

最後のものは、デバック用途で用意しています。
レスポンスがOKとあれば、削除してください。

