++++++++++++++++++++++++++++++++++++++++++++++
MediaWiki-WebServiceClient: Installation guide
++++++++++++++++++++++++++++++++++++++++++++++

+----------------------------------------------------------------------+
| MediaWiki-WebServiceClient                                                  |
+----------------------------------------------------------------------+
| Copyright (C) 2005  Urs Richle
+----------------------------------------------------------------------+
| This program is free software; you can redistribute it and/or
| modify it under the terms of the GNU General Public License
| as published by the Free Software Foundation; either version 2
| of the License, or (at your option) any later version.
|
| This program is distributed in the hope that it will be useful,
| but WITHOUT ANY WARRANTY; without even the implied warranty of
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
| GNU General Public License for more details.
|
| You should have received a copy of the GNU General Public License
| along with this program; if not, write to the Free Software
| Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
| MA  02110-1301, USA.
+----------------------------------------------------------------------+
| Author: Urs Richle <mail@sheherazade.ch>                           |
+----------------------------------------------------------------------+
MediaWiki-WebServiceClient is a basic example to consume the Tecfa-MediaWiki-WebService: http://edutechwiki.unige.ch/mediawiki/extensions/WebService/
The TECFA-MediaWiki-WebService offers three methods to get semantic content of a MediaWiki platform: 

1) getTopicNames()
   This method returns the different topic names of the MediaWiki plateform. Topics can be of different types: 
   existing or wanted category, existing or wanted article, author, image. 
   The methode returns an array : (topicTypeName => array(array(name, url))).

2) getTopicLinkage($term)
   This method returns an array with the topic name, his type, the number of links to this topic, the URL 
   and an array with all links from this topic to other topics (each link is an array(name, type, url))
   types can be: existing or wanted category, existing or wanted article, author, image.

3) getTopicMap()
   This method returns the semantic content of the MediaWiki platform in XTM (Topic Maps) standardised format. 
   You can read the returned topic map with applications like TMNav and TMBrows from TM4J.org or Omnigator 
   from ontopia.net. The returned topic map file is an XML file respecting the XTM dtd with the extension "xtm".

MediaWiki-WebServiceClient uses the NuSOAP library: http://sourceforge.net/projects/nusoap

+++++++++++++++++++++++++++++++++
MediaWiki-WebService-Installation
+++++++++++++++++++++++++++++++++

PLACEMENT
1) Download MediaWiki-WebServiceClient zip, unpack and put the package "WebService" into the directory "htdocs" of your webserver (Apache for exemple)

2) Open the index.php file : http://....your_domaine.../WebServiceClient/index.php

3) Invoke the methodes with the proposed scripts.

AttentioN:
PHP5-Bug:
If you install the nusoap library on a webserver with PHP5 you have to rename the class "soapclient" in all files inside the nusoap-folder.
See this bug-report:
http://sourceforge.net/tracker/index.php?func=detail&aid=1550594&group_id=57663&atid=484965