=================================================
Subject: What's New Module
Version: 1.11
Date:    2005-08-08
Author:  Kenichi OHWADA
URL:     http://linux2.ohwada.net/
Email:   webmaster@ohwada.net
=================================================

* Function *
change log from V1.1

1. add plugin
- pical 0.80
- smartfaq 1.04
- soapbox 1.50

2. bug fix
(1) RDF feedvalidator error
dc:date must be an W3CDTF date

(2) RDF/ATOM against w3c standard
RDF/ATOM the CDATA-section-close delimiter "]]>" MUST be escaped "]]&gt;"


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

When many modules are installed, 
the screen of web site becomes full of What's New blocks,
and is hard to see. 

This module collecte all latest reports from two or more modules,
and show it in one block, 
and show it RSS and ATOM format. 

* Function *
change log from V1.0

1. reduction size of image
If image is larger than the setup size, 
a reduction size will display. 

add param "width" and "height" to plugin API.

2. PDA page 
What is replaced with XOOPS_URL/pda.php. 
Access to XOOPS_URL/modules/whatsnew/pda.php. 

The module which URL is a print page (print.php) 
- news
- tinyd0
- xfsection

add param "pda" to plugin API.

3. debugging view 
If an error happens in RSS RDF and ATOM, 
XML will not be displayed. 
add to display in HTML format.

4. UTF8 Conversion 
The function xoops_utf8_encode of XOOPS core
may not able to work the automatic judging of the character code.
This module has the function which fixes a character code.

5. add plugin
- WFdownloads 2.05
- WFsection 2.07

6. add french pack

* added files
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/ all files
plugins/wfdownloads/data.inc.php
plugins/wfsection/data.inc.php
templates/whatsnew_pda.html

* changed files
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

* Installation and update *

1. Unzip and copy
If unzip download file,
the "whatsnew" directory be made. 
and copy it under XOOPS modules directory. 

2. Permission of Whatsnew Module 
Permit to be writable to whatsnew/cache. 

3. Installation of Whatsnew Module 
Install module from "module management" of the XOOPS admin page. 
Or update module.

4. Setup of Whatsnew Module 
Save configuration file in "Preferences" page.

6. useing news module
Please delete  news/include/data.inc.php.
whatsnew/plugins/news/data.inc.php is latest.

7. useing xoopsGallery module
Please delete xoopsgallery/include/data.inc.php.
whatsnew/plugins/xoopsgallery/data.inc.php is latest.

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

* Function *

1. What's New Report Block 
This module collect the latest reports from two or more modules, 
and show a the latest reports in block.

2. RSS/ATOM 
2.1  Output of RSS/ATOM
This module collect the latest reports from two or more modules, 
and show it RSS and ATOM format. 

2.2  Display of RSS/ATOM 
This module read XML file form URL of RSS and ATOM,
and parse and display it.
This function corresponds to RSS/ATOM Automatic Discovery.

3. weblog updte ping 
3.1 Send of Ping 
Three methods are supoorted. 

(1)  An administrator send ping manually. 
(2)  When display What's New Block, send ping. 
(3)  When you access special URL, send ping. 

3.2  Receive of Ping 
This is ping server of a debugging use. 
When ping is received, 
check the contents of a request and replay a response. 

4. corresponding modules
standard module
- system (comment)
- mydownloads
- mylinks
- newbb
- news

my devloping modules
- weblinks 0.92
- xfsection 1.07

3rd party modules
- B-Wiki 20050101
- PopnupBlog 2.1
- myAlbum-P 2.84
- simpleblog 0.21
- tinyD 2.17
- weblog 1.42
- wordpress 0.5
- xoopsgallery 1.25J
- yybbs 0.57

The selection of modules is for my using.
or other person made plugin.

Please make plugin for your need,
It is comparatively easy.

* Installation *

1. Unzip and copy
If unzip download file,
the "whatsnew" directory be made. 
and copy it under XOOPS modules directory. 

whatsnew
- admin
- bin
- blocks
- cache (permit to be writable)
- class
- images
- include
- template
- language
--- english
--- japanese
- plugins
--- bwiki
--- mylinks
--- mydownloads
--- news
--- newbb
--- weblinks
--- xfsection
--- xoopsgallery
--- system
--- popnupblog
--- simpleblog
--- tinyd0
--- weblog
--- yybbs
--- wordpress
--- myalbum

2. Permission of Whatsnew Module 
Permit to be writable to whatsnew/cache. 

3. Installation of Whatsnew Module 
Install from "module management" of the XOOPS admin page. 

4. Setup of Whatsnew Module 
Click th icon of "whatsnew" in left. 
"Preferences" page is displayed. 

You may ignore,the warning "the setting file does not exist",
it show in first time. 
Select the modules to display, and saved. 

5. Setup of What's New Block 
In XOOPS "block management" page, set "show" 
In XOOPS "group management" page, set "module access" and "block access". 

6. Check of What's New Block 
It will OK, if show block in "HOME" page. 

7. Change of a theme file 
Set RSS/ATOM Auto Discovery in theme file. 
Add the two following lines under "TITLE" tag in theme.html .

-----
<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" />
-----

8. Check of RSS/ATOM 
Click "What's New" menu in left. 
Six web links are displayed. 

(1) Click RSS" icon. 
It will OK, if a RSS of XML form is displayed. 

(2) Click "RSS Automatic Discovery". 
It will OK, if a parse result of RSS is displayed. 

(3) Click "RSS Valid" icon. 
It will OK, if "Congratulations" is displayed. 
It takes time for a while until a result is displayed. 

(4) Click "ATOM" icon. 
It will OK, if  a ATOM of XML form is displayed. 

(5) Click "ATOM Automatic Discovery" 
It will OK, if a parse result of ATOM is displayed. 

(6) Click "ATOM Valid" icon. 
It will OK, if "Congratulations" is displayed. 
It takes time for a while until a result is displayed. 

9. Check of Ping 
Click "whatsnew" icon in lef of the XOOPS admin page. 
"Preferences" page is displayed 

Click "Send of weblog update ping". 
"Sended of weblog update ping" is displayed. 

Click "Send Ping" button. 
It will OK, if the following displays come out. 
----- 
ping send - http://ping.bloggers.jp/rpc/ - OK
-----

Ping server may have a slow reaction. 
When "HTTP connect error" or "HTTP response timeout" is displayed,
you may not care if few error messages. 

* Who send ping? * 

There are four methods. 
(1)  An administrator send ping manually. 

(2)  When displaying a new report block, send ping. 
In admin "Preferences" page,
mark "Send Ping" of "What's New" block. 
Since ping server may have a slow reaction, 
a display of the part and a block becomes slow. 

(3) When you access special URL, send ping. 
It is  assumed that
this function is called periodically by wget or others. 
It is necessary to be a server's administrator." 

Add The following line to crontab. 
-----
11 * * * * usr/bin/wget http://xxx/modules/whatsnew/bin/update_ping.php?pass=??? -q -O /dev/null
-----

"???" is the password of update_ping.php,
which is set up in admin "Preferences" page.

(4)  When submit or modify a airtcle, send ping. 
This method should be given in the first time.
In order to perform this, 
it is necessary to change all the programs of the corresponding modules. 

* Where send ping? *

The following ping server is prepared by the default. 
------
http://rpc.weblogs.com/
http://xxx/modules/whatsnew/bin/server.php (debug use)
------

Since it is processing in order, 
processing time is required by the number of ping servers. 
I regard about at least three as enough. 

The last ping server is prepared for the debugging use. 
Please delete, if a response occurs will be OK. 
