Wacs Configuration Guide

Fifth Edition

for WACS 0.8.5

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.

16th March 2010

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
The usedirect Mechanism
Using The Scaled Cache
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. FSLoc: File System Locations
Overview: FSLoc
wacs.cfg: fsloc section
11. Security
Overview: Security
wacs.cfg: security
12. Download
Overview: Download
wacs.cfg: Download
13. Colours
Overview: Colours
wacs.cfg: Colours Section
14. Layout
Overview: Layout
wacs.cfg: Layout Section
15. Precedence
Overview: Precedence
wacs.cfg: Precedence
16. Debug
Overview: Debug
17. 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
18. WACS Web Apps: Presentation
Presentation Applications
wacsnewmodels
wacsnewsets
wacsnewvideo
wacsshow
wacsvidshow
wacsslideshow
wacsfp
19. WACS Web Apps: Indices
Index Applications
wacsimgcats
wacsimglist
wacsvidcats
wacsvidlist
wacsphotcats
wacslistphotog
wacsstats
20. WACS Web Apps: Models
Models Applications
wacsmodelthumbs
wacsmodelindex
wacsmodelpage
wacsmpthumbs
wacsmpmini
21. WACS Web Apps: Tag
Tag Applications
wacstagsets
wacslisttags
22. WACS Web Apps: Search
Search Applications
wacsimgselect
wacsvidselect
wacsmodelselect
23. WACS Web Infrastructure: Retrieval
Retrieval Applications
wacsfull
wacsframe
wacsimg
wacsindex
wacspage
wacsthumb
wacszip
wacsusc2257
24. 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. FSLoc: File Storage Locations
10.2. FSLoc: Icon & Glyphs
10.3. FSLoc: Applications & Documents
11.1. Security Section: wacs.cfg
12.1. Download Section: wacs.cfg
13.1. Colours Section: wacs.cfg
14.1. Layout Section: wacs.cfg
15.1. Precedence Section: wacs.cfg
17.1. The Default Menus
17.2. The Menu XML Types
20.1. URL Options to WacsModelThumbs

List of Examples

2.1. Simple WACS Configuration file
3.1. Determining The Ethernet Address
15.1. Sample Precedence Section
16.1. Sample of Global Debug Setting
16.2. Sample Of Specifically Targetted Debug
17.1. Sample Menu
17.2. Sample handler Menu