History: Directory User

            ! Directory User

!! Accessing the Directory
The Directory at a TikiWiki Web site is at the URL [tiki-directory_browse.php], generally accessed via the __Directory__ menu item.

^{SPLIT()}{img src="img/wiki_up/Directory+User1.png" desc=Menu}---{img src="img/wiki_up/Directory+User2aa.jpg" desc=Browse_Directory }{SPLIT}^

!! Browsing the Directory

At the top of the Directory page is a navigation bar that offers options for using the Directory. The navbar contains these links:
* __new sites__ - These are recently added links, in descending order.
* __cool sites__ - If this option is activated by the admin, these are links that have received the most visits, in descending order.
* __add a site__ - This will be displayed if the user has the permission to submit sites for the Directory.

Click a navbar link to __browse__ categories of links, see __new sites__ or __cool sites__ or __add a site__ (submit a suggestion for a new site).

^::{img src="img/wiki_up/Directory+User2b.png" desc=Navbar_links}::^

!!! Category
Below the navbar is the name of the current category. The Tiki Directory is organized into a hierarchy of link categories, each of which may have categories within it. The uppermost category, displayed just below the navigation bar, is the __Top__ category.  

!!! Subcategories
The categories under __Top__ are indicated below it. Appearing along with each category name can be a category description, names of the most-visited subcategories, or names of random subcategories. (The term "subcategory" is used simply to indicate a category below (within) another category.) The number of web site links in the category may be shown in parentheses. A category may contain either links itself or subcategories that contain links, or both. The information accompanying each category name on the Browse Directory page is determined by the admin.

^::{img src="img/wiki_up/Directory+User2c.png" desc=Categories }::^

As the user navigates down through the categories, the current category is displayed beneath the navigation bar at the end of a "breadcrumbs" path of categories down from __Top__. For example:

* __===Top=== >> ===Tiki CMS===__ - The category names are links to the respective parent categories.

The search form -- __Find:__ -- can also be used to search for sites throughout the Directory or only in the current category. Site names, descriptions, and URLs are included in searches.

The screenshot below shows the Directory browser in the category ''TikiCMS'' category, under the ''Top'' category. Note the path of live category links at the top and the list of links in the ''TikiCMS'' category. 

!!! Links
The links section of a Directory-browsing page includes a drop-down list and the links themselves. The drop-down list can be used to sort the links list in ascending (A to Z) or descending (Z to A) order and by:
* __hits__ - Number of times the linked page has been visited
* __name__ - The site link name
* __creation date__ - When the link was added to the directory
* __last updated__ - When the link information was last updated

The information for each link includes:
* __Nation__ - The national flag may reflect the language of the site or site content, etc., as determined by the admin.
* __Web site name__ 
* __Site description__ - The description as entered by the admin.
* __Category or categories__ - The site may be in one or more categories; in the case of a subcategory, the full category path is indicated.
* __Date added to the Directory__ 
* __Date last updated__

Click on a site's name to access the page. If the site is down or there is some other error, try the __cache__ link. Tiki saves, or ''caches'', a copy of each linked page in its Directory. This enables viewing a page even if the original is not available. In addition to providing its own cache, Tiki also links to the Google cache (see [http://www.google.com/help/features.html#cached]) for each page.

Beneath the list of site links is a list of categories related to the current category, if any, as determined by the site admin or other link submitter.

^::{img src="img/wiki_up/Directory+User3.png" desc=Categories_and_links}::^

!!! Statistics
Finally, statistics about the Directory, its content and activity, are displayed:

* __Total categories__
* __Total links__
* __Links to validate__ (i.e., links that have been suggested, but not yet approved, or that have been made inactive for some reason)
* __Searches performed__
* __Total links visited__

^::{img src="img/wiki_up/Directory+User2d.png" desc=Statistics}::^

!! New Sites - Cool Sites

The __new sites__ and __cool sites__ links open a __Directory Ranking__ page and display rankings of the latest sites added to the directory and the directory's most-accessed sites.

These rankings include, for the linked sites, this information:
* __name__
* __url__
* __country__
* __hits__
The column headings are links and can be clicked to re-order the listings.

^::{img src="img/wiki_up/Directory+User4.png" desc=Rankings}::^

!! Adding a site

Consistent with the collaborative ethos underlying Tiki, users can submit site link suggestions, depending on the permission granted by the admin. To suggest a site, click the __add a site__ link and use the form to enter the site information.

Enter the site's ''Name'', ''Description'', and ''URL'' (Web address), pick an appropriate directory category for it, and indicate its ''Country'' -- national orientation or language. You may select more than one category by control-clicking your choices -- hold down the Control key on your keyboard while clicking (Command key on Macintosh). If you select a ''Country'' for the site, a country flag will appear in its directory listings.

Click __save__ to submit the link. The site link may not immediately appear if the Directory has been configured to have new link submissions first validated by an editor or the site admin.

^::{img src="img/wiki_up/Directory+User5.png" desc=Adding_a_site}::^

!! Directory-Related Modules
A Tiki site may also have side-column or in-page modules activated to display __Directory Last Sites__ (sites most recently added), __Directory Top Sites__ (most-visited sites), or __Directory Stats__ (numbers of sites, sites to validate, site categories, searches, and visited links).

^::{img src="img/wiki_up/Directory+User6.png" desc=Modules}::^

!! Calendar Reporting of New Sites
New sites added to the Directory are also reported in Tiki's Calendar, for users who have Calendar-viewing permission. The Calendar is accessed by clicking the date at the top of the page, or via the menu.

^::{img src="img/wiki_up/Directory+User7.png" desc=Calendar_and_site_additions}::^

-=Tips=-
* When putting a link in a wiki page, if the link warrants greater exposure, consider first adding the link to the site Directory and then using the Directory's redirect link in the wiki page. That way, the Directory provides another means for users to know about the site, and the Directory also keeps track of the number of hits the link receives.

-=More Documentation=-
* ((Directory)) - Overview of the Directory. 
* ((Directory Admin)) - How to activate and configure the Directory, including determining its organization and page display, and setting appropriate permissions. 
* ((Directory Details)) - Details on Directory internals, including information on related files, permissions, database tables and CSS selectors.