File: readme.txt

Tag Cloud
===================

Version 1.0 - January 2007
---------------------------

Copyright (C) 2007 Dmitry Sheiko

Requirements:
	PHP version 4.1.x+ (http://www.php.net) 
	MySQL 4.x.x (http://mysql.com)
	Works with UNIX and Windows both
	
The 2006 year is marked by everywhere using of tag clouds. So this package allows to add your tag cloud to an external blog, even in the case when you haven’t access to the blog’s DB and   FTP. You can install this package on your server and launch admin.php script. Than you will be able to import RSS of your blog into index DB-table and assign tags to blog’s posts. Now you should just add HTML code (see sample.html) into your external blog. You can use this package also if your blog has many users.

How to install
1) Unpack files into a folder on your server
2) Create a DB 
3) Setup configuration: open config.inc.php, assign your DB-connection data, interface language (en or ru), charset (utf-8),  authorization data of blog’s users (for admin panel), number of blog's post title per page, name of the user, whose tag clouds is shown.
4) Launch admin.php, import RSS  and assign tags to blog’s posts
5) Add HTML code (see sample.html) into your blog

How to synchronize the Tag Cloud DB with your blog DB 

Use TagCloud API to synchronize tags DB and blog’s DB:
 $TagClouds->updateRecord( $link, $title, $user ) - to add/update a record
 $TagClouds->deleteRecod( $link, $user ) - to delete a record
 $TagClouds->deleteAllRecords($user) - todelete all records


Files:
sample.html - sample of Tag Cloud integration
admin.php - administrative panel
config.inc.php - configuration script
tagcloud.lib.php - class library
showcloud.php - tag cloud generator 
tagcloud.js - JS library
en.lang.php - Englsih language of user interface
ru.lang.php - russian language of user interface
buttom.gif, left.gif, top.gif - elements of graphical design


Yours sincerely,
Dmitry Sheiko,
http://www.cmsdevelopment.com,
senior web developer at Red Graphic Systems (www.redgraphic.com)