OxyNews 0.4 ReadMe

Read this carefully before asking too many questions

REQUIREMENTS :
MySQL 3.2, PHP 4 or better

FEATURES :

- PHP4 scripts using a MySQL database.
- Post, edit and delete news.
- Use smileys and BB code in your posts.
- Easy to format online news and headline styles.
- Display headlines on your page.
- Secure 8 bit login system for news posters. (phpUserLogin v1.4.5, download a full version of it, which you can use in your own scripts, at Oxy's Scripts.)
- Easily add, edit and delete users.
- Full comments system, including easy admin.
- Archive feature: Displays all old posts.
- Easily "prune" news posts, by deleting all post older than a certain date or just delete them all if you are too lazy :-).
- XML news syndication, lets other sites display your headlines .
- Easy setup, installation and support from OxyNews.net.
- Unlimited post number (Well almost, the script supports 99999999999 posts, we hope it is enough. :-)

UPGRADE:
This must be done no matter what version is being upgraded to!
[1] Delete All old Files
[2] Open up "oxynews_config.php" in your favourite editor, notepad will do. Enter your database name, user and password as well as the other variables.
[3] Upload all files.
Upgrading from 0.2 to 0.3!
[4] Run install1.php - Then delete all install files..
[5] Login admin using your old login info.
Note: Since much of the script have change, data's on posts may be wrong and some users may get deleted while updating.
Upgrading from 0.3 to 0.3.2!
[4] Run install2.php - Then delete all install files.
[5] Login admin using your old login info.
Upgrading from 0.3.2 to 0.3.5 - 0.3.5-SE!
[4] Run install3.php - Then delete all install files.
[5] Login admin using your old login info.
Upgrading from 0.3.5-SE to 0.4!
[4] Run install4.php - Then delete all install files.
[5] Login admin using your old login info.
Note: There may be some small problems when deleting or editing comments from before 0.4

NEW INSTALLATION :
[1] Open up "oxynews_config.php" in your favourite editor, notepad will do. Enter your database name, user and password as well as the other variables.
[2] Connect to your webserver using FTP with the details supplied by your host or what other way your host gives you..
[3] Go to your main directory, where your web pages are.
[4] Create a directory called 'admin'. (Could be http://www.host.com/mysite/admin/)
[5] Upload all the files in the admin folder into this folder. Return to your main directory.
[6] Upload all the files which are in the same folder as this readme file to you main directory, though not readme.htm index.php and archive.php.  (Could be http://www.host.com/mysite/)
[9] Run file install.php - Then delete all install files.

INITIAL INSTALLATION COMPLETE!

You must read this even though you just updated from v0.3.5.

SETTING UP YOUR SITE :
Now we will configure your website so that OxyNews items show on your front page (You must do this not matter what kind of installation you made).

Rename your main page to .php, and put the following code in where you want the news and headlines to show:
Note: If you want to see how we have done it, look at index.php and archive.php.

NEWS :
<?php include "oxynews_view.php" ?>

HEADLINES :
<?php include "oxynews_headlines.php" ?>

In the file where you want to show the archive, write this:

ARCHIVE :
<?php include "oxynews_archive.php" ?>

To modify the layout of your news: login and click "News Styles", you must be a admin to do it though.

USING :


Goto http://yoursite.com/admin in your web browser.

When prompted for user name and password, use the following:

If you made a new install:
Username: admin
Password: admin

Now you can go about creating news posters, posting news etc. It is important to add a new admin account, then logout and login under this new account. You should then delete the account that you are not using, as it is default and a MAJOR SECURITY RISK.

If you updated:
Login with your old username and password. If they dont work you can login with username: admin password: admin.

Remember to delete the admin user, it is a default user and it will be a MAJOR SECURITY RISK to leave it there.


INFO :
This version is made by OxyTeam.
Members:
Oxy
Drakxter
Ex

I have had people asking me if its ok to make modifications or add-ons for OxyNews, well all I can say is, thats fine by me ! E-mail me your creations, and the good mods will get featured on the official OxyNews website !


BUGS :
None that we know of. The script is not so simple anymore though, so we might not have found them all. :-)

VERSION HISTORY :
v0.1 - Post, edit, delete news, ip logging, headlines.
v0.11 - Minor fix to edit.php stops date being erased when editing.
v0.12 - Fixed view.php's problem when posts got out of order.
v0.13 - Some users were frustrated by the IFRAMES, so I re-wrote the admin script.
v0.3 - To much to say, MUCH have change. :-)
v0.3.2 - Added BB code and Smileys. Also did some bug fixes.
v.0.3.5 - Some bug fixes. Added a comment system so people can makes comments to news posts, is not complete though, you can control it though the admin yet, and is not lamer secure (Lamer = Person that keeps posting the same post all the time). It will be completed in 0.4 though, that should not come so long after this version.
v0.4 - Added comment system admin, and made it lamer secure. Also added online headline style editing. XML news syndication added as a last minute addition by Oxy.

TODO LIST :
- We're running out of ideas, tell us what you want to see !

VISIT US :

http://www.oxyscripts.com
http://www.oxynews.net

IRC :

irc.openprojects.net
#oxyscripts

Contact Oxy over ICQ #103192319 if you have any problems, or send an e-mail to info@oxyscripts.com