TheWay is a set of Perl scripts which perform the
functions of linking web sites together in a ring
or loop. Although currently the scripts are only
used to run the Infinite
Fractal Loop, they are designed to support
an arbitrary number of rings from a single server.
Commands for TheWay are constructed by referring
to the base URL for the script and adding parameters
and a command to the end. Parameters are
separated from each other and from the command by
semicolons (;) and from the base URL by a question
mark (?). Three scripts are currently used:
http://www.fractalus.com/cgi-bin/theway
This is the basic navigation script. All commands
used to move from site to site must be directed to
this script.
http://www.fractalus.com/cgi-bin/theway.admin
This is the administration script, used to add and
remove sites from the ring and its associated queue,
and to edit information for sites. This script will
rarely be accessed directly; normally it will be
used from a form.
http://www.fractalus.com/cgi-bin/theway.stats
This script parses the ring's log and tabulates
statistics for the ring. It has no other function.
General Parameters

ring=<ringname>
This parameter is required for all commands.
It specifies which ring to apply the command to.
<ringname> specifies the name
of the ring to use. Currently, only one ring (the
Infinite Fractal Loop, name "fractals") is in use.
id=<siteID>
This parameter is required for all commands which
refer to a specific site. <siteID>
is the numerical site ID for the site originating
the request (or, in the case of the go
command, the destination site).
Navigation Commands

next
This command moves to the next site in the ring,
wrapping at the end to the first site.
"Next" is determined by listing order in the ring's
database, not by numerical site ID, so sites can be
in any order.
prev
This command moves to the previous site in the ring,
wrapping at the beginning to the last site.
"Previous" is determined by listing order in the ring's
database, not by numerical site ID, so sites can be
in any order.
skip
This command moves to the site after the next site
in the ring, skipping the next site.
sprev
This command moves to the site before the previous site
in the ring, skipping the previous site.
next5
This command displays a page listing the next five
sites in the ring, wrapping at the end. The appearance
of this listing is governed by a template, not by the
script itself.
prev5
This command displays a page listing the previous
five sites in the ring, wrapping at the beginning.
The appearance of this listing is governed by a
template, not by the script itself.
random
This command moves to a random site in the ring. A
site ID is required, to insure that the site
originating the request is not selected at random.
go
This command moves directly to the site whose ID
is provided. Using the script to find the URL means
that the link does not have to be changed if the
site moves (as long as the ring database is updated).
list
This command lists all the sites in the ring. A
site ID is not required, but will be logged if it
is provided. The appearance of this listing is
governed by a template, not by the script itself.
queue
This command lists all the sites in the waiting
queue for the ring. A site ID is not required, but
will be logged if it is provided. The appearance
of this listing is governed by a template, not by the
script itself.
index
This command lists all the sites in the ring. It
is similar to list, but it uses a
different template. It is intended as a more detailed
listing of sites. A site ID
is not required, but will be logged if it is
provided. The appearance of this listing is
governed by a template, not by the script itself.
qindex
This command lists all the sites in the ring's queue. It
is similar to queue, but it uses a
different template. It is intended as a more detailed
listing of sites. A site ID
is not required, but will be logged if it is
provided. The appearance of this listing is
governed by a template, not by the script itself.
home
This command jumps to the ring's home page. A
site ID is not required, but will be logged if
it is provided.
help
This command jumps to the ring's help page. A
site ID is not required, but will be logged if
it is provided.
join
This command jumps to the ring's sign-up page. A
site ID is not required, but will be logged if
it is provided.
Administration Commands

Currently undocumented.
Statistics Commands

Currently undocumented.
Back to the IFL home
|