Navigation help

 
<?php
/*** Help-page - uses standard HTML-file header ***
ALWAYS has params:
fid - identifies template (file/executable)
conn - ODBC connection-identifer
qFile - pointer to single record of file-info
sFileName - should be same as fid, else default of 'index'
must also have:
cid - 'fid' (i.e. name) of caller of present template

# $Id $
# Copyright (under LGPL) (c) 2001 Xio Consulting (info@xio.com.au)
********************************/
/********************************/

$XE->page->spoofinfo(); //spoof caller's base-site and tree-info

$sCallHead=$XE->page->headline(); //pick up caller's header from spoofer
$XE->page->shortname('Help');
$XE->page->headline("Navigation help");

$XE->page->show();

print("<p align=\"center\">(Click " . $XE->utils->getlink($XE->page->cid(),"here") . " to return to '//" . $sCallHead . "'//.)
\n");

/********************************/

?>

Use the navigation-bar at the top of each page* to help you find your way round this
site:
-At the top left there's a 'structure-tree' list of links, showing where you are in the site.
-Below that, if there's more 'below' the current page, there'll be a //'[More...]'// drop-down list - though sometimes there'll be a pair of 'Previous'/'Next' buttons instead.
-Below that again, there's a //'[See also...]'// list, showing links to any 'sibling' pages at the same level as the current page, and also some key pages such as Contents and Feedback (the site home-page link is shown there as '&lt;&lt;HOME&gt;&gt;').
And if you scroll to the bottom of the page, click on the //'[to top]'// link - it'll take you straight back to the navigation-bar. There's also a
<?php
print($XE->utils->getlink("z_content&cid=" . $XE->page->cid(),"**contents page**") . ",\n");
?>
organised hierarchically, and always accessible from the //'[See also...]'// list - if in doubt,
go there!

[//*Note//: the site home-page will usually //not// use the standard navigation-bar. Instead, it will usually have a row of link-buttons, and links within the text to move to pages within the body of the site.]

----
===In more detail...===
::**Structure-tree**::To move 'up' in the structure-tree, click on the respective link in the list.
::**Previous/Next/Up**::These buttons will only be shown if a previous/next sequence is in use - such as the content of a book. Click on the button to move to the respective page; the 'Up' button, shown for the first or last page of the sequence, takes you back to the respective contents-page.
::**[More...]**::This list, if present, points to 'child' pages of the current page. Select the page from the drop-down list: you'll jump there directly if you have Javascript enabled, otherwise click on the 'Go' button to the list's right.
::**[See also...]**::This list includes links to 'sibling' pages of the current page (i.e. pages at the same level in the structure-tree), and to commonly-used pages. Sibling pages (if any) are above a separator-line in the list; common links are shown below the separator. Select the page from the drop-down list: you'll jump there directly if you have Javascript enabled, otherwise click on the 'Go' button to the list's right. The common pages are:
-//&lt;&lt;GROUP&gt;&gt;// - shared 'home-page' linking all sites in this group
-//&lt;&lt;HOME&gt;&gt;// - home-page for this site
-//Site contents// - contents-tree for this site
-//Your feedback// - your feedback to us
-//Keyword-search// - list of links organised by keyword
-//Site links// - links to other sites
-//Site news// - news about this site
-//Help// - this page

::**Add note...** //(selected pages only)//::Click on this button to add a note to the current page; after you've entered your comments on the form shown, the new note will be shown as part of the current page.
::**Add link...** //(links page only)//::Click on this button to add a link to the list of links for the site; after you've entered your link-details on the form shown, the new link to your site will be shown at the base of the list.
----
===Link-icons===
On most pages we've provided cross-references to further information, including books and other resources. If the item is elsewhere on this site, we've shown a standard link; if the resource is on another site, we've used these icons to show options for follow-up:
-[[:lnk_amzn amazon.com]] book is available from Amazon.com (we are an Amazon Associate)
-[[:lnk_book e-book]] book is available from another e-book retailer
-[[:lnk_site other web-site]] further details on another web-site
-[[:lnk_link local web-site]] further details on another site in this group (easy to find your way back here!)

----
[[#aS]]===Privacy and email addresses===
'Spam-crawlers' - unwanted web-robots trawling web-sites worldwide for email addresses - are becoming an increasing nuisance, but are almost impossible to stop. To protect privacy, the solution we've implemented has been to encrypt all mail-addresses and have mail-links open a form on the website. Apologies - but we think you'll agree it's better to do this than to have every email address on this site ending up in those wretched junk-mail lists...