WMNews Ver 0.2
Note: this is a draft help documentation. If you use WMNews, please
read the code of the script and don't forget to read PHP and MySQL manual.
What is WMNews?
WMNews is another PHP & MySQL news automation system for your page. WMNews
first was created for Warta Mikael site,
that is why the name of the script is WMNews, the first WM stands for Warta
Mikael. Now, you can use WMNews for your site, it's FREE under GNU General Public
License. See http://www.gnu.org/copyleft/gpl.html
for details.
WMNews not just only use to maintain your news site, it could be your products
or services catalog or else, so be creative then! Discussion board alike comment
system in WMNews will make your site live!
Features
- Easy to use.
- Customized font, color by CSS and the configuration file.
- Unlimited one level news category.
- Web base administration module included, you can manage your news with your
browser (Tested with Internet Explorer 5.x, Netscape Communicator 4.7x and
Opera 5.x)
- Create your last news, news category with generator, so you can include
the files into your .php file. Useful for your main/index page, so it could
be run faster. Two models of last news generator: center and side column display.
- Refer to a friend and printer friendly module for every display news.
- 5 (five) news for each previous and next when display news.
- News statistic, viewed, refered, printed, commented, and rated.
- Search the whole news or by category.
- Dinamic page spaning automation for the list page.
- Full threaded comment system like a discussion board with admin reply capability.
- Comment and Rating system could be set on or off.
- Top 10 popular news by viewed, refered, printed, commented, rated and by
rating.
Where can I get WMNews?
You can find WMNews at:
Requirement
You need PHP 4 or above and MySQL
3.22.xx or above installed on your system to run WMNews. WMNews was tested with
PHP 4.0.xpl1, MySQL 3.22.xx and Apache 1.3.xx under Windows 2K and Linux Red
Hat.
Installation
- Extract wmnews.zip in your local computer.
- Edit config.php in config subdir, match the variables with your system.
- Customize header.php, footer.php, leftcol.php and rightcol.php, match them
with your page.
- Upload all files and subdir you created to your webserver, remember upload
in ASCII mode, except for the images.
- Chmod your data subdir with 777.
- Log in to your MySQL server, create all tables in wmnews.sql file, if you
are a new user.
- Upgrade:
- From ver 0.1/0.1a, execute wmnews-upg-0.1.sql to upgrade
your older tables.
How to use it?
- Run administration menu from your browser ie. http://mysite.com/admin, change
'admin' if you've changed name of admin directory.
- Menu - Categories:
- Add Category:
- New Category: Name of your news category.
- Display Limit: How many last news display on the box created
by generator.
- Box Style: Two models of the box based on portal display,
center or side box.
- List: Option for display this category on the category box
or not.
- Icon: name of icon file for this category, the icon must
be in 'images/icons' directory.
- View Category:
Display all categories you have, you can change all information of this
table here.
Note: If you decide to change the name of category, you must change
the file was include the file created by generator, because the file name
based on your category name.
- Menu - News/Articles:
- Add News:
- Category: choose the category of the news you want to entry.
This category generated automaticaly from your category table.
- Title: Enter title of the news, 100 character max.
- Lead: Enter intro of your news, 255 character max.
- Message: Enter you news here, limited only by your memory
size. But you must go to the doctor, and check your brain if you fill
it with a book size of data :).
Note:
Html syntax actually are ok to be enter, but WMNews will cut the message
only for $dispchr
characters strictly, so do not put html syntax like <table>,
<ul>, <li> in the first $dispchr
characters and the close </li>, </ul> or </table>
out side the range. It will screw up the result of Menu - Generator:
Create Last News Box per Category. Use <p> for every paragraph.
Ignore " or ' if you insert html tags in your news, i.e. <table
width="100%" border="0" cellpadding="0"
cellspacing="0">, in WMNews that should be <table=100%
border=0 cellpadding=0 cellspacing=0>.
- View All News:
Just like View Category above, maintain your news with this link.
- View All News with comments:
Same like View All News above, but in this section you can maintain your
comment system.
- Menu - Generator (All files will store in your
$base_datapath
):
- Create Category Box:
This link will create all category link in the table which has value '1'
on the List entry (read List on Add Category above). The file name is
'ArticleCat.wmn'.
- Create Last News Box per Category:
This link will create the last news of each category into the file. Name
of file based on your category name. If one of your category name is 'Best
Article', the file name will be 'Best_Article.wmn
',
and 'Important message from us', should be 'Importand_message_from_us.wmn
',
etc.
- Create All Last News:
This link will create the whole last news of every category into one file
'Warta_Terakhir.wmn
'.
- Include the files created by generator menu above into your .php file, and
let WMNews handle the rest actions.
Demo
You can visit Warta Mikael site (in bahasa
Indonesia / Indonesian language) or go to Support
Forums for the real demo. If you are using WMNews for your site or have
some hacks for WMNews, please let me know. I'll put your link here, thanks.
Todo
Since WMNews ver 0.2 published, things I must to do was changed:
- Develope more features like:
- Unlimited sub categories
- Still optimize the code for better performance
- Still fix the script if any bugs found
- Image uploading
- etc..., I have so many plans with WMNews, so stay tune for the next
release of WMNews.
I always open for comments, suggestions, hacks, helps or volunteers to make
WMNews better, please e-mail me at toekangweb@wartamikael.org.
See Also
I realized there are so many php news scripts better than WMNews. For your
references, please visit hotscripts.com,
php.resourceindex.com, zend.com,
phpbuilder.com, devshed.com,
or other related sites. Hope you can find what you needs.
Copyright
© 010314, Rudy S. Ingga <toekangweb@wartamikael.org>
Last Updated: 010614
Back to top | WMScripts
Home