### WebLinks Administrator's Manual

This page explain how to use WebLinks which is different from other module,
and some matter unclear just for a moment.

#### 1. the link method to a map site

1.1 US
The US map site is http://maps.yahoo.com/ .
This site requires ZIP code, state, city, address.
The template is set up as follows.
<form action="http ://us.rd.yahoo.com/maps/home/submit_a/*-http://maps.yahoo.com/maps" target="_blank" method=get>
<input type="hidden" name="addr" value="<{$link.address}>">
<input type="hidden" name="csz" value="<{$link.city}>, <{$link.state}> <{$link.zip}>">
<input type="hidden" name="country" value="us">
<input type=hidden name=srchtype value=a>
<input type=submit name="getmap" value="Map">
</form>
Yahoo! Maps Terms of Use
1.2 others
the author of WebLinks does not know the map sites without U.S and Japan.
When you hack it,
please have a look The difference by the country or the language.

#### 2. RSS/ATOM related block

2.1 Latest RSS/ATOM feeds of Web links
This is a similar function to viewfeed.php.
It displays RSS/ATOM feeds which stored in atomfeed table from the latest order of date.
It only displays, dont get a new RSS/ATOM feeds.
Please look at "How to get RSS/ATOM feeds".
2.2 Show blog of Web links
It displays the specific link's RSS/ATOM feeds which stored in atomfeed table from the latest order of date.
It only displays, dont get a new RSS/ATOM feeds same as 2.1 .
When show this block,
click edit of "Show blog of Web links" at "Blocks Administration",
and fill in "Link ID" which is 0 in default.
2.3 show blog in custom block.
This is a similar function to 2.2.
There are two differences to 2.2.
(1) you can show two or more blogs in individual.
(2) it get new RSS feeds, when show this block.
select PHP script in Content Type of custom block.
and fill in as follows.
include_once XOOPS_ROOT_PATH."/modules/weblinks/include/atomfeed.inc.php";
weblinks_view_blog(???);
??? is Link ID

#### 3. Check of broken link

What trigger start to check broken link ?
There are three methods.
3.1 When the user has noticed, report a broken link.
It is same as mylinks.
3.2 Admin check manually.
3.3 Check periodically in the command line mode.
The setting method..
(1) be writable in cache directory
(2) From the administrator page of Weblinks,
click "other functions".
and click and excute "create config file for bin".
(3) change $XOOPS_ROOT_PATH in bin/link_check.php,
united your environment.
(4) added to crontab as follows.
11 2 * * 0 /usr/bin/php4 -q -f /home/***/html/modules/weblinks/bin/link_check.php

#### 4. How to get RSS/ATOM feeds

What trigger start to get new RSS/ATOM feeds ?
There are four methods.
4.1 When show a link detail in singlelink.php, get from this link.
It excute automatically, even if not set up.
Admin can set up "Cache time of RSS/ATOM feeds" from admin page.
default is 24 hours.
4.2 When show a blog in custom block, get from this blog.
4.3 Admin get from all links manually.
4.4 Get periodically in the command line mode.
The setting method.
(1) be writable in cache directory
(2) From the administrator page of Weblinks,
click "other functions".
and click and excute "create config file for bin".
(3) change $XOOPS_ROOT_PATH in rss_refresh_link.php,
united your environment.
(4) added to crontab as follows.
22 3 * * * /usr/bin/php4 -q -f /home/***/html/modules/weblinks/bin/rss_refresh.php
In addition, bin/rss_refresh_site.php is
the command which updates the sites set up at "RSS search site" in "Module Configuration 2" .
4.5 another one
When show "Latest RSS/ATOM feeds of Web links" block, get from all links.
It is not supporting.
It maybe carries out a timeout, if there are many RSS/ATOM links

INDEX
$Id: admin_1.html,v 1.1 2005/07/19 03:54:34 ohwada Exp $