Wacs Configuration Guide

Ninth Edition

for WACS 0.9.2

This consists of two parts: A tutorial introduction to the process of configuring WACS, and a full reference to all the configuration keywords and their uses.

B "Beaky" King

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit http://creativecommons.org/licenses/by/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Monday 9th May 2016

Revision History
Revision Ninth EditionMonday 9th May 2016
<listitem>Added detail on configuring video streaming</listitem> <listitem>Added inital DVD support fields</listitem> <listitem>Added wacsvidcomb and wacscachectl to CLI chapter</listitem>

Abstract

WACS is a tool for building Adult Web Sites; it is equally suitable for managing a private collection or building a commercial web site. It has many best of breed features including dynamic filtering, model catalogs, automatic download and powerful search engine. It comes with a powerful API (application programming interface) implemented in both Perl and PHP5 languages to allow web developers to leverage it's facilities from their own programs.

This book describes the configuration files used by the system which are all implemented in the Industry Standard eXensible Markup Language (XML). The intended audience is web developers and WACS site managers who wish to tailor an existing WACS installation to meet their precise requirements; people merely wishing to use or manage an existing WACS installation may well find the default configurations provided suffice.

The WACS source code and other documentation and support tools can all be found at the WACS website at Sourceforge and at the Wacs page at launchpad. There is a demonstration site for WACS available at PinkMetallic.com - CAUTION: contains adult material. Commercial add-ons and support options can be purchased from Bevtec Communications Ltd, see their website at Bevtec Communications.


Table of Contents

I. WACS Configuration: Introduction
1. Introduction to WACS Configuration
WACS Overview
About This Book
About The Examples
2. WACS Configuration Architecture
Architectural Overview
Quick Intro To XML
Permanent Configuration
Transient Configuration
3. Prerequisites
OS Configuration
Static IP Address And Name
ISP Requests
Port Forwarding
NFS File Sharing
Database Configuration
4. Altering The Configuration
Altering: An Introduction
Changing Colours
5. Caching And Performance Tuning
Objectives
Cacheing And Performance Tuning Techniques
The usedirect Mechanism
Using The Scaled Cache
Using Direct Access To Thumbnails
The Content Cache Mechanism
Streaming Video Content
6. Custom Configurations
Introduction
Vendor Style Menus in Wacs 0.8.x and later
Backgound Info
How To Configure Vendor Mode
Running Multiple WACS instances
Background
How To Configure Multiple WACS Instances
II. WACS Configuration: Reference
7. Database Environment
Overview: Database
wacs.cfg: Database Environment Section
Database Engine Notes
Database: MySQL 5
Database: Oracle
8. Database Tables
Overview: Tables
wacs.cfg: Database Section
9. Server Details
Overview: Server
wacs.cfg: Server Section
10. Apps Details
Overview: Apps
The Details
11. FSLoc: File System Locations
Overview: FSLoc
wacs.cfg: fsloc section
12. Security
Overview: Security
wacs.cfg: security
13. Download
Overview: Download
wacs.cfg: Download
14. Colours
Overview: Colours
wacs.cfg: Colours Section
15. Layout
Overview: Layout
wacs.cfg: Layout Section
16. Precedence
Overview: Precedence
wacs.cfg: Precedence
17. External
Overview: External
wacs.cfg: external
18. Debug
Overview: Debug
19. WACS Configuration: Menus
WACS Menu System Overview
Basic Default Menus
Menu XML tokens
Basic Menu XML Types
Sample Menu
Menu Handlers
The Special handler Menu
20. Media Settings Configuration
Overview
21. WACS Web Apps: Presentation
Presentation Applications
wacsnewmodels
wacsnewsets
wacsnewvideo
wacsshow
wacsvidshow
wacsslideshow
wacsfp
22. WACS Web Apps: Indices
Index Applications
wacsimgcats
wacsimglist
wacsvidcats
wacsvidlist
wacsphotcats
wacslistphotog
wacsstats
23. WACS Web Apps: Models
Models Applications
wacsmodelthumbs
wacsmodelindex
wacsmodelpage
wacsmpfull
wacsmpthumbs
wacsmpmini
24. WACS Web Apps: Tag
Tag Applications
wacstagsets
wacslisttags
wacstagedit
25. WACS Web Apps: Search
Search Applications
wacsimgselect
wacsvidselect
wacsmodelselect
WACS-Php Applications (Optional)
modelsel.php
The Simple Skin
26. WACS Web Infrastructure: Retrieval
Retrieval Applications
wacsfull
wacsframe
wacsimg
wacsindex
wacspage
wacsthumb
wacszip
wacsusc2257
27. WACS Web Infrastructure: Tags
Tag Infrastructure Applications
wacsaddtag
wacsdeltag
wacsmarktag
Index

List of Figures

2.1. Logical Structure

List of Tables

2.1. List of Permanent Config Files
2.2. List of Transient Config Files
3.1. Steps To Get Network Connections To Work
7.1. Configuration: Database Section
8.1. wacs.cfg: Tables
9.1. Configuration: Server
10.1. Application Names and Tokens
11.1. FSLoc: File Storage Locations
11.2. FSLoc: Icon & Glyphs
11.3. FSLoc: Applications & Documents
12.1. Security Section: wacs.cfg
13.1. Download Section: wacs.cfg
14.1. Colours Section: wacs.cfg
15.1. Layout Section: wacs.cfg
16.1. Precedence Section: wacs.cfg
17.1. External Section: wacs.cfg
19.1. The Default Menus
19.2. The Menu XML Types
23.1. URL Options to WacsModelThumbs
23.2. URL Options to WacsModelPage et Al

List of Examples

2.1. Simple WACS Configuration file
3.1. Determining The Ethernet Address
16.1. Sample Precedence Section
17.1. Sample External Section
18.1. Sample of Global Debug Setting
18.2. Sample Of Specifically Targetted Debug
19.1. Sample Menu
19.2. Sample handler Menu