A number of
HTML pages are special for MiniVend operation. Typically they are used to transmit error messages, status of search or order operations, and other out of boundary conditions.
NOTE: The distributed demo does not use all of the default values.
The names of these pages can be set with the SpecialPage
directive. The standard pages and their default locations:
- canceled (special_pages/canceled.html)
-
The page displayed by MiniVend when an order has been canceled by the user.
- catalog (special_pages/catalog.html)
-
The main catalog page presented by MiniVend when another page is not
specified.
- failed (special_pages/failed.html)
-
If the sendmail program could not be invoked to email the completed order,
the failed.html page is displayed. (Sadly we don't know if the email was
successfully delivered).
- flypage (special_pages/flypage.html)
-
If the catalog page for an item was not found when its
[item-link]
is clicked, this page is used as a template to build an on-the-fly page.
See On-the-fly Catalog Pages.
- interact (special_pages/interact.html)
-
Displayed if an unexpected response was received from the browser, such as
not getting expected fields from submitting a form. This would probably
happen from typos in the html pages, but could be a browser bug.
- missing (special_pages/missing.html)
-
This page is displayed if the
URL from the browser specifies a page that does not
have a matching .html file in the pages directory. This can happen if the
customer saved a bookmark to a page that was later removed from the
database, for example, or if there is a defect in the code.
Essentially this is the same as a 404 error in
HTTP. If you want to actually display a 404 error,
just put this in special_pages/missing.html:
[tag op=header]Status: 404 missing[/tag]
- nomatch (special_pages/nomatch.html)
-
This page is displayed if the search engine is used, but there is no match
for the search specification and no [no-match]
region found on the search page.
- noproduct (special_pages/noproduct.html)
-
This page is displayed if the
URL from the browser specifies the ordering of a
product code which is not in the products file.
- order (special_pages/order.html)
-
This page is displayed when the customer orders an item. It can contain any
or all of the customer-entered values, but is commonly used as a status
display (or ``shopping basket'').
It is normal to set this page to something in your user page space:
SpecialPage order ord/basket
- search (special_pages/search.html)
-
Contains the default output page for the search engine results. Also
required is an input page, which can be the same as search.html or an
additional page.
By convention MiniVend defines this as the page results.
SpecialPage search results
- violation (pages/violation.html)
-
Displayed if a security violation is noted, such as an attempt to access a
page denied by an
access_gate. See UserDB.