Chapter 19. WACS Configuration: Menus

Table of Contents

WACS Menu System Overview
Basic Default Menus
Menu XML tokens
Basic Menu XML Types
Sample Menu
Menu Handlers
The Special handler Menu

WACS Menu System Overview

One of the cornerstones of the WACS philosophy is that there are a number of free standing applications, each of which has a number of optional behaviour modifiers, which combine together to build the final web environment. This means that the entire behaviour of the WACS system can be modified by how these various parts interact with each other, and how they interconnect. You can configure your WACS server to group together the links in the way you want them to appear, interacting both with the provided WACS applications and with any of your own you wish to add, written in either Perl or PHP.

Each WACS web application has a title bar with a number of menus shown on it; these menus are derived from entries in a single menu file or in their absence from some basic default menus. All WACS applications then add the appropriate menu to the title bar with either the default options, or the customised menu depending on what is present in the menu configuration file. By convention, the right-hand most menu on a WACS application is one called navigation, which provides links to the Main menu (front page), recent additions pages, the alphabetical list of models and the saved searches.

Each menu has a distinct name, which can be either one of the standard ones listed below or any other menu you care to define in the menu.cfg file. If a given menu is defined both as a default and in the menu.cfg file, the one defined in the menu.cfg file takes precidence.

Basic Default Menus

There are currently seven general default menus which can always be assumed to exist in a WACS configuration - these menus are available in both the Perl and PHP versions of the API and are used by most of the standard Wacs tools.

Table 19.1. The Default Menus

NameTitleDescription
navigationNavigationStandard navigation menu: main menu, new additions, alphabetic model index, and saved searches.
searchSearchSearching menu: saved searches, image search, video clip search, and model search.
favouritesFavouritesModels can be classed by a number of categories of Favourite: Cuties, Solo, Straight, Lesbian and Current Featured - this provides links to these categories.
newrelatedRelated ListsLinks to relevant things related to new items: the new videos page, the new images page, and the same pages for the previous week.
alternativesAlternativesAlternative views of the same model details.
tagsaltAlternativesAlternative activities for a pre-existing tag set.
adminAdminMenu of collection administration tools