news-tnk
version 1.2.3
2002 April 13
http://www.linux-sottises.net/software.php
author Thierry Nkaoua tnka@linux-sottises.net

Hi!

Thank you for testing (or using ;-) ) news-tnk! For any questions or comments, you can email me at tnka@linux-sottises.net


COPYING
This software is developped under the GNU General Public Licence (GPL). 
Please refer to the COPYING file in this directory.


REQUIREMENTS
On the server side:
- a web server with PHP4 or PHP3 enabled
- a mysql database

On the client side:
- web browser
- cookies enabled for remembering users data
- javascript enabled for insertion of smileys and html tags
- cookies for admin page


FEATURES
- php script to propose and show news on a website
- full admin web page to validate, modify, comment or delete news
- cookies for users data (to avoid them typing again name email and 
web site)
- insertion by point and click of smileys icons in the news
- "simplified" html can be used within the news
- insertion of simplified HTML tags by point and click
- keeps the line breaks in the news
- Available in english, french, dutch, spanish and german at present time


UPGRADE FROM A PREVIOUS VERSION
- replace the old files and directories by the news ones
- mysql database and table remain the same



INSTALL
- Create a database "news" in mysql (or whatever name, but change the 
name in include/config_news.php) or use an already existing database.

- use news.sql to create the table news_list (with phpmyadmin for example)

- choose the files in php3 or php4 directory according to your php version

- php3 users, in all that follow, replace .php by .php3, naturally!

- at the root of your web server (or at the same location as the file where you want
to show news), you must put news_post.php, news_admin.php, include and icons_board.
If you use board-tnk, icon_board is exactly the same directory. If you already have
an include directory, just copy the files from the news-tnk include directory to
you own one. 

- a test file news_test.php (to be placed also at the same place than the others files)
is provided. You can test news-tnk by entering /news_test.php in you browser after
finishing the configuration of news-tnk.
This file contains information on how to include news-tnk to you own web
page: there are only three lines to include to your php file, one before the
top of your file (for config and cookies), one in the head part and one in the body.

- edit include/config_news.php
* set up mysql user, password  and database
* define an admin password
* choose the validity time for admin page (konqueror users 
kde <=2.2.1, choose a longer time than 30 minutes, konqueror bug...)
* choose the number of news to show per page
* chose to receive or not an email for each new news
* you can change the colors used by news-tnk
* choose a language:  french, english, spanish and german  at this time


USE
- when you add the three lines mentionned above to you own php file,
news are shown and visitors can submit news
- for just testing type in you browser http://your_domain/news_test.php
- for administration, type in your browser http://your_domain/news_admin.php 
enter your admin password, from here you can validate, un-validate, delete and
comment news.

Enjoy!
