Special Pages

### Index Up << >>

## Special Pages

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.

### Index Up << >>