History: Directory Admin

            ^Part of this page should ((merge)) with ((Directory )) and the rest should be included in the Admin Guide^
! Directory configuration

!! Activating the Directory feature 
{img imalign=right src=img/icons/admin_features.png alt=Admin_Features_Icon}The Directory feature is activated on the __Admin > Features__ page (tiki-admin.php?page=features).

To enable the Directory, check (tick) the box for __Directory__ and click __Change preferences__.

^{img src="img/wiki_up/Directory+Admin1.png" }^

!! Directory Configuration

{VERSIONS(nav=>y,title=>y,default=>2.0)}
{img src=img/icons/large/gnome-fs-server.png imalign=right alt=Admin_Directory_Icon}The overall Directory configuration is set on the __Admin > Directory__ page (tiki-admin.php?page=directory).
^::{img src="img/wiki_up/DirectoryAdmin2_20.png" }::^
---(1.9)-----------------------------
{img src=img/icons/admin_directory.png imalign=right alt=Admin_Directory_Icon}The overall Directory configuration is set on the __Admin > Directory__ page (tiki-admin.php?page=directory).
^::{img src="img/wiki_up/Directory+Admin2.png" }::^
{VERSIONS}

These are the settings to specify:
{FANCYTABLE(head=Field ~|~ Description)}
__Number of columns per page when listing categories__ ~|~ Select the number of columns (from __1__ to __6__) in which to display the directory categories. The Directory categories can be displayed in one long list (a single column) or in up to six columns.
__Links per page__  ~|~ Specify the number of directory entries to display, per page. After Tiki displays the specified number of links on the first page, it will direct the user to additional pages of links.
__Validate URLs__ ~|~ This is enabled to require links submitted by users to be validated (approved) by an admin or editor prior to being added to the Directory. If submitted links are to be immediately entered in the Directory without first being validated by an admin or editor, this should be left unchecked. %%% %%% Like other Tiki permissions, the authority to validate Directory links is given on a group basis. To enable others to validate links, the appropriate permission -- ''tiki_p_validate_links'' -- must be given to a Tiki user group on the __Admin > Groups__ page (tiki-admingroups.php) (see ((Permissions))). This group is then indicated when the Category is added or edited.
__Enable cool sites__ ~|~  This puts the __cool sites__ link on the Directory navbar and activates the "Directory ranking" page, which lists the most-visited sites in the Directory in descending order.
__Show country flag__ ~|~ Specify if the country flag is shown for each directory item. %%% %%% This option was introduced in Tiki 2.0.
__Method to open directory links__ ~|~ Specify how Tiki links to each item in the directory: %%% __Replace current window__: Close the Tiki window and open the linked site in its place. %%% __Open new window__: Put the Directory page in the background, but keeping it open %%% __Inline frame__: Display the linked web page in Tiki's center column
{FANCYTABLE}


!! Directory Administration
To open the __Directory Administration__ page (tiki-directory_admin.php), go to the __Application Menu__ and select __Admin directory__ from the __Directory__ menu items.  (See screenshot below.)
 
The top navigation bar of the Directory Admin page contains these links:
* __browse__ - Browse the Directory.
* __admin__ - Admin the entire Directory.
* __categories__ - Admin Directory categories.
* __related__ - Admin Directory category relationships.
* __sites__ - Add, delete or edit sites.
* __validate__ - Validate links submitted by users.
The admin links in the navbar (which is displayed on all Directory pages) are repeated in the admin menu at the bottom of this page, perhaps with a __settings__ link to the Tiki Admin > Directory page (tiki-admin.php?page=directory), depending on the viewer's permissions. 

Tiki maintains several Directory statistics:
* __There are _ valid sites__ - The number of valid (approved) site links. These are the links that are active in the Directory. ("Valid" doesn't necessarily mean that a link works without errors, but just that it has been accepted for use in the Directory.)
* __There are _ invalid sites__ - The number of links that have not been validated (approved) by an admin or editor.
* __There are _ categories__ - The number of categories. These are specific to the directory and are not the same as Tiki ''Categories'' (see ((Category))), though they can be "Categorized" and thus come under one or more global Tiki Categories. This stat contains a link to the __Admin directory categories__ page.
* __Users have visited _ sites from the directory__ - The number of clicks by users on Directory links to other Web sites.
* __Users have searched _ times from the directory__ - The number of searches made in the Directory

^{img src="img/wiki_up/Directory+Admin3.png" }^

!! Category management 
Clicking on __categories__ opens the __Admin directory categories__ page, which displays the ''Parent category'' (a drop-down list), a form to add a new category, and a list of subcategories under the current parent category.

Note that categories are arranged as ''parents'' and ''children''. Above all the child categories is the __Top__ category. You can create subcategories under the __Top__ category or any other category by first selecting the category as the ''Parent category,'' using the drop-down menu. Then, complete and submit the ''Add a directory category'' form to make a new ''child'' category under this ''parent''.

The options are: 
* __Name__ - Category name
* __Description__ - Category description
* __Children Type__- When browsing the category tree a line of text will be displayed below the category name. You can choose what goes in this line: the most-visited subcategories, the category description, or random subcategories.
* __Maximum number of children to show__ - Once you decided what will be displayed below the category you can set up how many items will be displayed. You can choose ''none'' to eliminate the line below the category name. Note that if you decide to show the category description this option has no effect.
* __Allow sites in this category__ - Whether sites can be added to this category or not. You might prohibit sites in a category if you only want to use it to contain other subcategories.
* __Show number of sites in this category__ - If enabled the number of sites in the category will be displayed next to the category name.
* __Editor group__ - You can indicate a Tiki group that will have admin permission for this category. These ''editors'' will be able to validate sites.
* __categorize__ - In addition to the categories of the directory, Tiki also uses global categories that apply to ''all'' objects within it. This option allows you to put your directory category within a Tiki category. To do so, first click ''show categories'' to see which Tiki categories are available (as has already been done in this screen shot). Select the appropriate categories and check ''categorize this object''. See ((Category)) for more information on Tiki categories.

^::{img src="img/wiki_up/Directory+Admin4.png" }::^

At the bottom of the ''Admin directory categories'' page is a list of directory subcategories for the parent category indicated by the drop-down menu at the top of the page.

^::{img src="img/wiki_up/Directory+Admin5.png" }::^

Its columns indicate how a sub-category was configured with the ''Add a directory category'' form:
* __name__ -In this example, four names are shown.
* __cType__ -Children type (d = ''description'' in this example).
* __view__ -Maximum number of children to show.
* __allow__ - Allow sites in this category.
* __count__ - Show number of sites in this category (number of sites in parenthesis).
* __editor__ - Editor group. In this example, a group named ''editor'' has been used.
* __action__ - Buttons to relate, edit, and delete categories, respectively.

!! Related categories
In addition to a category being able to contain other categories, it can also be directly ''related'' to another. This is useful when, for example, there is some logical connection between categories and a person browsing one category would benefit from seeing the other. The related category link functions as a "''See also...''" reference.

Clicking on __related__ displays the __Admin related categories__ page. 

To create a relationship between two categories:
# Select a __Parent category__ from the drop-down list. In this instance, "Parent category" is rather a misnomer here; it simply means the category for which a relationship is to be assigned. 
# Select the to-be-related category from the __Add a related category__ drop-down list.
# Check __mutual__ if the relationship is to be indicated from both categories (A=>B, B=>A) or leave it unchecked for an unrequited bond.
# Click the __save__ button to create the relationship. 

^{img src="img/wiki_up/Directory+Admin6a.png" }^

Under ''Related categories'', you will see a drop-down list of the categories that are related to the selected "parent category". Relationships can be updated or removed here.

^::{img src="img/wiki_up/Directory+Admin6b.png" }::^

!! Admin sites
Click on __sites__ to display the __Admin sites__ page.

The __Parent category__ drop-down menu includes all categories in the Directory that can contain sites directly. (A category for which "contain sites" was not checked will not appear in this list.) Selecting "all" displays all sites, in the table below; selecting one of the categories displays the sites in that category.

^{img src="img/wiki_up/Directory+Admin7.png" }^ 



^::{img src="img/wiki_up/Directory+Admin7a.png" }::^

To add a site, enter the appropriate information for the site in the __Add or edit a site__ form. To edit a site, click its __edit__ icon. Note that a site can be added to more than one category by control-clicking each desired category. (The Parent category selection at the top of the page determines what appears in the __Sites__ section of the screen. This selection has no effect on the information input when adding a new site.)

^::{img src="img/wiki_up/Directory+Admin8.png" }::^

!! Site Validation
Clicking on __validate__ will display the __Validate sites__ page, where user-suggested sites are "validated" (approved for inclusion in the Directory -- "valid" here doesn't refer to the actual validity of the linked URL).

To validate one or several sites, check the appropriate box(es) and click the __validate__ button. A similar technique will do mass "invalidations" (removals from the Directory). Click the __edit__ icon {picture file=img/wiki_up//IconNotepad.png} to edit a site or the __delete__ icon to remove one.

^::{img src="img/wiki_up/Directory+Admin9.png" }::^

-=More documentation=-
*((Directory))
*((Directory User))
*((Directory Details))