Introduction
  Publishing web pages
  RXML
  Information tags
    <accept-language>
    <accessed>
    <clientname>
    <configurl>
    <configimage>
    <countdown>
    <date>
    <file>
    <help>
    <available_languages>
    <language>
    <unavailable_language>
    <line>
    <list-tags>
    <modified>
    <number>
    <pr>
    <referrer>
    <user>
    <version>
  String tags
  Variable tags
  URL tags
  If tags
  Graphics tags
  Database tags
  LDAP
  Programming tags
  SSI tags
  Image maps
  IntraSeek
  LogView
  Templates
  Navigation
  SiteBuilder tags
  Supports system
  Security
  Appendix
 
<accessed> Main RXML parser

 

<accessed> generates an access counter that shows how many times the page has been accessed. In combination with the <gtext> tag you can generate one of those popular graphical counters.

A file, AccessedDB, in the logs directory is used to store the number of accesses to each page. Thus it will use more resources than most other tags and can therefore be deactivated in the Main RXML parser module. By default the access count is only kept for files that actually contain an <accessed> tag, but that can also be configured.

 

Attributes

add=number
Increments the number of accesses with this number instead of one, each time the page is accessed.

addreal
Prints the real number of accesses as an HTML comment. Useful if you use the cheat attribute and still want to keep track of the real number of accesses.

capitalize
Capitalizes the first letter of the result.

cheat=number
Adds this number of accesses to the actual number of accesses before printing the result. If your page has been accessed 72 times and you add <accessed cheat=100> the result will be 172.

factor=percent
Multiplies the actual number of accesses by this factor.

file=filename
Shows the number of times the page filename has been accessed instead of how many times the current page has been accessed. If the filename does not begin with "/", it is assumed to be a URL relative to the directory containing the page with the <accessed> tag. Note, that you have to type in the full name of the file. If there is a file named tmp/index.html, you cannot shorten the name to tmp/, even if you've set Challenger up to use index.html as a default page. The filename refers to the virtual filesystem.

One limitation is that you cannot reference a file that does not have its own <accessed> tag. You can use <accessed silent> on a page if you want it to be possible to count accesses to it, but don't want an access counter to show on the page itself.

lang=ca es_CA hr cs nl en fi fr de hu it jp mi no pt ru sr si es sv
Will print the result as words in the chosen language if used together with type=string. Available languages are ca, es_CA (Catala), hr (Croatian), cs (Czech), nl (Dutch), en (English), fi (Finnish), fr (French), de (German), hu (Hungarian), it (Italian), jp (Japanese), mi (Maori), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), si (Slovenian), es (Spanish) and sv (Swedish).

lower
Prints the result in lowercase.

per=second minute hour day week month
Shows the number of accesses per unit of time.

prec=number
Rounds the number of accesses to this number of significant digits. If prec=2 show 12000 instead of 12148.

reset
Resets the counter. This should probably only be done under very special conditions, maybe within an <if> statement.

This can be used together with the file argument, but it is limited to files in the currentd directory and subdirectories.

silent
Print nothing. The access count will be updated but not printed. This option is useful because the access count is normally only kept for pages with actual <accessed> tags on them. <accessed file=filename> can then be used to get the access count for the page with the silent counter.

upper
Print the result in uppercase.

since
Inserts the date that the access count started. The language will depend on the lang tag, default is English. All normal date related attributes can be used. See the <date> tag.

type=number string roman iso discordian stardate
Specifies how the count are to be presented. Some of these are only useful together with the since attribute.

 

Example


This page has been accessed
<accessed type=string cheat=90 addreal>
 times since <accessed since>.

This page has been accessed one hundred and fiftyone times since August 16th.