/************************************************************************************/
/*                                                                                  */
/* Maty Scripts Top-Sites for PHP-Nuke 6.5                                          */
/* v1.0  25-03-2003                                                                 */
/*                                                                                  */
/* Copyright  2002 by: Maty Scripts (webmaster@matyscripts.com)                    */
/* http://www.matyscripts.com                                                       */
/*                                                                                  */
/* 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.                   */
/*                                                                                  */
/************************************************************************************/

===============================================================================
                               Copyright Notice:
===============================================================================
- Our Package name and link MUST REMAIN in the credit footer of all MS script
  generated pages.
- This package CAN NOT be ported without written permission.
===============================================================================
===============================================================================


===============================================================================
1. General:
===============================================================================
MS Top-Sites v1.0 is based on DXT Top 1.0 Pro from Digital XTreme Networks
(http://www.digital-xtreme.net). Maty Scripts made a PHP-Nuke module of this
Iframe application and added various new featues to it.

MS Top-Sites lets registered users on your site automatically add their site
to your Top-Site listing. Users can put your button on their site where visitors
can vote for that site.

Upon registration a users can also define a category for his site. In the
Top-Site listing a query can be carried out to sort the sites according
the category.

For every member in this list, statistics are available displaying info like:

			* Rank
			* Registered Since
			* Average Vote Count Since
			* Votes In, Out, Today, Total, Average per Day
			* Rating

As admin you determine how MS Top-Sites will work. Following options are available:

			* How many buttons should be displayed in Top-Site List
			* How many Top-Sites in list per page
			* Send an E-mail to Admin when a new Member registers
			* How many Sites should be displayed in Block
			* How many buttons should be displayed in Block
			* Rank according total votes in or in+out
			* Log voters IP-address so that this user can only vote ONCE for each Top-Site in this list
			* Auto Reset Statistics every [xx] days

MS Top-Sites comes with a block. This block displays the top-ranking of the Top-Site
listing. The settings for this block can be configured from within the Admin menu.

===============================================================================
2. Installation:
===============================================================================

*2.1 Unzip the file and extract archive to temp dir and copy included as noted below:
     --------------------------------------------------------------------------------

Installation.txt                       Do not upload, your reading it
Credits.txt                            CREDITS for MS-Analysis v1.0
License.txt                            GNU GENERAL PUBLIC LICENSE
install directory                      Install/install_topsites_v1_0.php script

       ALL ABOVE DESCRIBED FILES DO NOT NEED TO BE UPLOADED TO YOUR HOST
       THE FOLLOWING FILES MUST BE UPLOADED:

html/blocks/*.*  --------------------> /blocks/*.*
html/modules/*.* --------------------> /modules/*.*

*2.2 First step is to install the file: install_topsites_v1_0.php
     which is located in the install dir. This will create the
     required tables for MS Top-Sites. You install it as follows:
     
     Log in as Admin. 
     If the URL of your Web-site is: http://www.mysite.com then execute this scripts as follows: 

     http://www.mysite.com/install_topsites_v1_0.php

     After running this script, DELETE it from your Site. 
     
*2.3 Upload the files as described above (*2.1)

*2.4 Log in as administrator on your site and make the module MS_TOPSITES active.
     If you like, you can also activate the block which come with MS_TopSites
     
                * block-MS_Top_Sites.php: Top Ranking of MS Top-Sites
                
     Next step is to go the the Admin Settings of MS Top-Sites and
     configure the application.
                
*2.4 To use your own LOGO for MS Top-Sites, you have to replace the file
     /modules/MS_TopSites/images/logo.gif.

     MS Top-Sites has also a 'rules' menu. Depending on your confguration
     you might want to define your own rules. These rules can be defined
     in the language file /modules/MS_TopSites/language/lang-english.php.
     Open this file and modify the text for the variable: _MSTS_TOPSITESRULES

The rest of the application will be self explaining. Have fun with it.



