Be The Web - Be_Random

Be_Random - HTML Tags

After successfully installing Be_Random 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 random articles on an HTML Page.

Tags are used when you want to display the Articles on an HTML Page. There are several parameters that can be used with the tag, theses are discussed below.

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_random.cgi?mode=nossi"></SCRIPT>

Note the mode=nossi parameter.

Parameters with the 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_random.cgi?show=displayall;category=mycategory)

Paramenter	Value	Behavior
show	displayall	Displays all of the active articles (example: show=displayall)
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)
articlenum	(valid article number)	This will display the specified article (example: articlenum=20)

Use this format when you want to display a specific article, with and without Server Side Includes: *
  
  
  <SCRIPT SRC="/cgi-bin/be_random.cgi?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_random.cgi?show=displayall;mode=nossi"></SCRIPT>

Use this format when you want to display an article from a given category: *
  
  
  <SCRIPT SRC="/cgi-bin/be_random.cgi?category=xxxxx;mode=nossi"></SCRIPT>

* Replace the xx with a valid Article Number or Replace the xxxxx with a valid Category

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