|
<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.
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 |
|
|
|