Blzut3's News Script Beta V0.8
---
Changes from 0.7
---
1. Category Support
2. Fixed bug where comments could have \" for quotes
3. Fixed bug where the ad box was in reverse if you chose txt and no multiuser support
4. Added a table prefix option in mysql
5. Fixed bug where you couldn't edit in MySQL.
6. Renamed blog table to news.
7. Using cform_template in MySQL
8. Labeled Username and Password boxes.
9. Added the ability to put the news on a page with some vars set in the url (ex. ?page=news)

---
Install:
---
To install simply run install.php in the news script directory.  
Select a database and fill in any options that may be needed for it.
See selecting a database below.

Then in the file you want to put the news output in simply add...

<?php include "pathtoscript/show.php"; ?>

...in the place in the page where you want it.  Of course you must 
first replace "pathtoscript" with the location of where the files are.

If you want to only show x amount of post per page, place $ppp = x;,
Replacing x with the number you want.  So lets say you want 5, do...

<?php
$ppp = 5;
include "pathtoscript/show.php";
?>

Replacing pathtoscript as before.

If you want to select a default category use the $_GET["cate"] var, 
say you have the category gameing and you want 5 post per page.  The 
code would be as below...

<?php
$_GET["cate"] = "gameing";
$ppp = 5;
include "pathtoscript/show.php";
?>

Again replacing pathtoscript as before.

An alternative to this would be add ?cate=gameing to the url.

If you have it on a page where you have some globals set (ex. ?page=news) 
you will need to add $_bonews["vars"] into the code, stripping the "?".  
Example with ?page=news (and all things mentioned in previous example...

<?php
$_bonews["vars"] = "page=news";
$_GET["cate"] = "gameing";
$ppp = 5;
include "pathtoscript/show.php";
?>

Remember to replace pathtoscript as before.

---
Selecting a database
---
If you can use both flatfile (.txt) and MySQL there are a few things to 
consider.  Both types have advantages and disadvantages.

Txt or Flatfile: In flatfile, you may not use the "|" chatacter (shift+\) 
anywhere as it will break the db stucture, however there are no size 
restrictions.

MySQL: In MySQL, you have size restrictions on everything but the 
contents (or textareas).  However for may use "|" (shift+\).  Some 
host will separate MySQL space and file space, so you don't need to 
worry on how much space is being taken.  However this could also mean you 
may run out of database space, and still have a ton of file space left.

---
Editing Templates
---
To edit your template you can simply use the internal template editor.  
To get there, login, and then click the template tab.  The text area 
will accept a few varaibles.

For news post:
{id} = ID number of post
{title} = The title of the post
{author} = the author of the post
{content} = the content of the post
{comment-number} = Amount of comments
{view-comments} = Link to comments
{/view-comments} = end of link to comments

For comments:
{cauthor} = Author of the comment
{cemail} = If supplied the email of the autor of the comment
{comment} = the content of the comment

For new comment form:
{form} = defines the form (MUST BE FIRST THING)
{/form} = end the form (MUST BE LAST THING)
{submit} = Submit button
{name} = Name form
{email} = email form
{textarea} = comment textarea (where you type your comment)

---
Deleting News or comments
---
Go to the news tab and select edit/delete.  The rest should be easy to follow.
When deleting comments the number on the 2nd box is how far down from the top the 
comment is.

---
Upgrading
---
Replace show.php with the new one.

---
Current Features
---
* Category Support
* Pages (How meny post per pages (post shown))
* Commenting
* Ability to delete news post and comments (however delete the comments before the post)
* Multi or single user password protection.
* Password is stored for a while.  Can't remember how long I think its 1 day.
* TXT Files can be used as a database. (no need for MySQL)
* MySQL Database support
* Easy to use tabbed GUI (what else should I call it?)
* Add News
* Edit News
* Small user administration panel.
* Internal Template editor
* Simple Template editor, use {content}, {title}, etc.  No need to understand PHP!
* Log out function

---
Upcoming Features
---
* Multitemplate support
* Archives

This is just a rough idea of whats coming up, they could vary well be in the 
next version, or, they could not.  I put version numbers as a guidline of whats 
planed, I could change them at any point.

---
Additional Notes:
---
This is just a Beta version and there are some bugs and such.  Also it should be 
wise to note that the script WILL NOT work on IE because of some limitations.

As another note, this script was created because cutenews when commercial 
so I don't plan on it ever going commercial, and if it does I will keep a 
free version around with no ads.

---
Bug Reporting & Feature Request
---
If you find any bugs please report them with a subject along the 
lines of bug report to Blzut3@zoominternet.net.  On the other hand if 
you want and feature added but don't see it on the list then email 
them to me at above stated email address with the subject along the 
lines of Feature Request.

---
End
---
Thank you for reading this file and I hope you enjoy using BitOwl news 
and plan on supporting it to become better and more powerful.

Thanks,
- Blzut3 (BitOwl Webmaster)