docs.roxen.com
main | demo | docs
download | community | pike
© 2000 Roxen Internet Software
Suggestions, Comments or Complaints
manuals@roxen.com

DocsRoxen2.0Web Site Creator ManualInformation tags
   

  • <accessed>
  • <countdown>
  • <date>
  • <help>
  • <modified>
  • <number>
  • <roxen>
  • <user>
  • <accessed/>

    Generates an access counter that shows how many times the page has been accessed. A file, AccessedDB, in the logs directory is used to store the number of accesses to each page. By default the access count is only kept for files that actually contain an accessed-tag, but can also be configured to count all files of a certain type.
    <accessed/>
    221

    Attributes

    add
    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.
    case
    case={upper, lower, capitalize}
    Sets the result to upper case, lower case or with the first letter capitalized.
    cheat
    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.
    database
    Works like the since attribute, but counts from the day the first entry in the entire accessed database was made.
    factor
    factor=percent
    Multiplies the actual number of accesses by the factor. E.g. 47 displays half the actual value.
    file
    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 Roxen 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
    lang=langcodes
    Will print the result as words in the chosen language if used together with type=string.
    <accessed type="string"/>
    two hundred and twentyone

    <accessed type="string" lang="sv"/>
    tvåhundratjugoen

    per
    per={second, minute, hour, day, week, month, year}
    Shows the number of accesses per unit of time.
    <accessed per="week"/>
    12

    prec
    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 current- and sub-directories.
    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 <access> on them. <accessed file=filename> can then be used to get the access count for the page with the silent counter.
    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.
    <accessed since=""/>
    April 29th

    type
    type={number, string, roman, iso, discordian, stardate, mcdonalds, linus, ordered}
    Specifies how the count are to be presented. Some of these are only useful together with the since attribute.
    <accessed type="roman"/>
    CCXXI

    <accessed since="" type="iso"/>
    2000-04-29T15:13:10

    <accessed since="" type="discordian"/>
    Prickle-Prickle, the 45th day of Discord

    <accessed since="" type="stardate"/>
    36643.2

    <accessed type="mcdonalds"/>
    More than two hundred served.

    <accessed type="linus"/>
    221 since Tue Apr 18 14:10:49 2000

    <accessed type="ordered"/>
    221st