Be The Web - Be_News

Be_News - HTML Tags

After successfully installing Be_News on your website, you are ready to begin using Be_News. You need to begin by placing HTML tags in your existing web pages. The HTML tags are used when you want to display the News Articles on an HTML Page.

Headline Tags

Headline tags are used when you want to display the just the headlines on an HTML Page. You can then have the Headline tag include the article tag, so when the user clicks on the Headline, it will jump them to the article.

Use this format when you have Server Side Includes: *
  
  

Use this format when you do not have Server Side Includes: *
  <SCRIPT SRC="/cgi-bin/be_news.cgi?mode=nossi"></SCRIPT>

Note the mode=nossi parameter.

Parameters with the Headline Tags
Parameters can be added to the Tags, this will change the default behavior of the script. Running the script with no parameters (or just the mode=nossi) will get you one random article. You can use multiple parameters, however, they must be separated by an ampersand ";".
(example: be_news.cgi?show=displayall;category=mycategory)

Paramenter	Value	Behavior
category	(any valid category)	Displays articles from the specified category (example: category=mycategory)
articlenum	(valid article number)	This will display the specified article headline (example: articlenum=20)
order	fifo lifo	This will change the display order of the article headlines: fifo - First in first out - oldest article displayed first lifo - Last in first out (Default) - newest article displayed first (example: order=fifo)
top	(number between 1 and total number of articles)	This will display the specified number of headlines (example: top=5)
usetemplate	(existing template file)	This will allow you to override the default display template. The template must exist in the data directory. (the same directory that the data files are in) (example: usetemplate=mynewtemplate.html)

Note: If you have renamed your CGI program be_news.cgi so it is compatible with your server, just change be_news or be_news.cgi above to be_news.pl.

Article Tags

The Article Tags can be used have an article directly accessable or displayed on an HTML Page. This tag will create a link to the specified article.

Use this format when you want to have a link to an article: *
<a href="/cgi-bin/be_news.cgi?show=article;articlenum=xx">
Put Headline Here
</a>

Use this format when you want to display an article using Server Side Includes: *


Use this format when you want to display an article and do not have Server Side Includes: *
<SCRIPT SRC="/cgi-bin/be_news.cgi?show=display;mode=nossi;articlenum=xx"></SCRIPT>

Use this format when you want to display all articles: *
(You can also include the Category Parameter)

<SCRIPT SRC="/cgi-bin/be_news.cgi?show=displayall;mode=nossi"></SCRIPT>



*Replace the xx with a valid Article Number

Parameters with the Article Tags

Parameters can be added to the Tags, this will change the default behavior of the script. Running the script with no parameters (or just the mode=nossi) will get you one random article. You can use multiple parameters, however, they must be separated by an ampersand ";".
(example: be_news.cgi?show=displayall;category=mycategory)

Paramenter	Value	Behavior
show	displayall	Displays all of the active articles (example: show=displayall)
show	display	Displays an articles and must be used with parameter articlenum (example: show=display&articlenum=20)
show	displaymultiple	Displays all of the active articles in a page (example: show=displaymultiple)
show	catlist	Displays all of the active articles under their corresponding category title (example: show=catlist)
category	(any valid category)	Displays an article from the specified category If combined with the show parameter you can display all articles in a given category. (example: category=mycategory)
catgroup	(any valid category group code)	Limits the categories to only those that match the specified category group (only works with the "show=catlist" parameter) (example: catgroup=mycatgroup)
articlenum	(valid article number)	This will display the specified article (example: articlenum=20)
order	fifo lifo	This will change the display order of the articles: fifo - First in first out - oldest article displayed first lifo - Last in first out (Default) - newest article displayed first (example: order=fifo)
top	(number between 1 and total number of articles)	This will display the specified number of headlines (example: top=5)
usetemplate	(existing template file)	This will allow you to override the default display template. The template must exist in the data directory. (the same directory that the data files are in) (example: usetemplate=mynewtemplate.html)

Other Tags

These tags are used when you want to display a select box for the available categories. There are two options for this tag "categories" and "categoriesall"
"categories" will display all the categories in the Be_news category list
"categoriesall" will display all the categories and have an option for "{ All Articles }"

Use this format when you have Server Side Includes:*





Use this format when you do not have Server Side Includes:*
<SCRIPT SRC="/cgi-bin/be_news.cgi?show=categories&mode=nossi"></SCRIPT>
<SCRIPT SRC="/cgi-bin/be_news.cgi?show=categoriesall&mode=nossi"></SCRIPT>

Note the mode=nossi parameter.

You can also use these tags with an HTML Form to allow the user to select a category of articles to be viewed:  (Pro Version Only)

<form ACTION="/cgi-bin/be_news.cgi" METHOD="POST">
  <input type=hidden name=show value="displaymultiple">
  <input type=hidden name=mode value="ssi">
  Select Category:
  <SCRIPT SRC="/cgi-bin/be_news.cgi?show=categoriesall;mode=nossi"></SCRIPT>
  <input type=submit name=Submit value="List">
</form>

Note: If you have renamed your CGI program be_news.cgi so it is compatible with your server, just change be_news or be_news.cgi above to be_news.pl.