Wacs Administration Guide - SourceForge

Wacs Administration GuideSeventh Editionfor WACS 0.9.2This book contains an extensive tutorial in how to administercollections within the WACS system and includes areference section that summarises the available tools.B "Beaky" KingPublication date Friday 22nd April 2016

Wacs Administration Guideby B "Beaky" Kingfor WACS 0.9.2This book contains an extensive tutorial in how to administer collections within the WACS system and includes areference section that summarises the available tools.Publication date Friday 22nd April 2016Copyright 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 B KingAbstractWACS is a tool for building Adult Web Sites; it is equally suitable for managing a private collection or buildinga commercial web site. It has many best of breed features including dynamic filtering, model catalogs, automaticdownload and powerful search engine. It comes with a powerful API (application programming interface) implementedin both Perl and PHP5 languages to allow web developers to leverage it's facilities from their own programs.This book describes the administrative tools used to manage, catalogue and update collections of digital media (images,videos, etc) maintained within a WACS web site. It provides both a tutorial and a reference document for the variousadministration applications within the WACS system. The intended audience is WACS web site managers and supportstaff tasked with maintaining a collection within a WACS system. Some familiarity with using WACS as a normaluser is expected, carefully reading the User Guide should suffice.The WACS source code and other documentation and support tools can all be found at the WACS website atSourceforge [http://wacsip.sourceforge.net/] and at the WACS page on Launchpad [https://launchpad.net/wacs/]. Ademonstration site using WACS is available at PinkMetallic.com [http://www.pinkmetallic.com] and can be visitedfor free at the time of writing - at some future point a small charge may be levied to cover costs. Commercial add-onsand support options can be purchased from Bevtec Communications Ltd, see their website at Bevtec Communications[http://www.bevteccom.co.uk/].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.

Table of ContentsI. WACS Administration Tutorial . 11. Introduction . 5Overview . 5About This Book . 5About The Examples . 52. First Steps . 7User Class . 7Authentication Mode . 7Changing Your Role (Leases) . 8Changing Your Role (Permanent) . 9Everything Looks Different . 113. Site Design . 12Overview: Laying Out Your WACS Site . 12Simplistic Layout . 13Vendor Mode . 14Gallery Mode . 15Summary . 164. Naming Sets In WACS . 17Goals In Naming Sets . 17How It Works . 17Keyword Scoring . 18Heavily Used Keywords . 19Multiple Sets: Duplicates, Alternatives and Continuations . 21About Rank . 21Set Relations . 225. Preparing To Create A Model Record . 23Introduction . 23Headshot Image Preparation . 23Making The Big Icon . 25Making The Small Icon . 29Icon Placement . 30Determining The Site Id . 316. wacsmodelmgr - The Wacs Model Manager . 33Introduction . 33Creating A New Model . 35Basic Attributes . 37Inserting Model Records . 39Amending Model Records . 427. wacsunpackmgr - The Unpack Manager . 46About Unpacking . 46Working With Image Sets . 46Already Unpacked Warning . 50Working With Videos . 518. wacsplacemgr - The Placement Manager . 52The Placement Process . 529. Wacs Set Manager . 56Meta Data Manipulation . 56What You Can Edit . 56Doing An Update . 5810. The Info Manager . 60Managing Additional Information . 60iii

Wacs Administration GuideExample Of Using wacsinfomgr . 6111. Other Web Based Tools . 63What's Available . 63Association Manager . 63Connections Manager . 65Keyword Manager . 67Vendor Manager . 67Photographer Manager . 7012. Migration Tools . 73About Migration . 73wacsexport - Exporting Model Details . 73wacsimport - Importing Model Details . 73wacsxmlout - Exporting Set Details . 74wacsxmlin - Importing Set Details . 75wacsselout - Exporting Selections . 75wacsselin - Importing Selections . 7513. When Using Wacs For Hosting . 77Overview . 77Self Referential Download Records . 77Creating Download Records . 77Content Caching Mechanisms . 80How The Caching Works . 80The More Complex Features Of Caching . 81Using wacsvidcomb to make compilations . 82A Few Final Words About Hosting . 8214. The Download System . 84Overview . 84The Changing Face Of Downloads . 84Components Of The Download System . 85chkmodel . 85refresh . 85getarc . 86wacsdnlnext . 86Wacs Download manager . 86Configuring Automatic Download . 87Defining Sites . 87Using cron For Unattended Download . 8715. More About Model Manager . 89Additional features . 89Importing XML files in wacsmodelmgr . 89Identity Management Mode . 92Manually Adding An IDmap . 92The WACS ID Manager . 95Importing IDs From XML . 9616. The WACS Icon Manager . 98Introduction . 9817. Command Line Tools . 101Overview . 101Data Manuipulation . 102The addmodel Command . 102The addassoc Command . 104The wacsdelset Command . 104Processing Applications . 105The wacsgenimg Command (formerly generate) . 105iv

Wacs Administration GuideThe wacsgenvid Command (formerly genvideo) . 106The wacsupdinfo Command (formerly updateinfo) . 106The wacsvidcomb Command . 106The wacscachectl Command . 107Automatic Collection Maintenance Tools . 107The wacsupdstat Command (formerly updatestats) . 107The wacsblogctl Command . 10818. Customisation . 110Introduction . 110Creating The XML File . 110How to set the Usage rules . 111The Completed XML file . 11219. Simple Tasks In SQL . 113What is SQL? . 113Example Tasks in SQL . 113Adding A New Type Of Attire . 113Creating A Video Download Record . 11420. Using SQL: Advanced Topics . 115Introduction . 115Merging Models . 115II. WACS Admin Tools Reference . 11821. Collection Management . 120Web Based Tools . 120wacsmodelmgr - Wacs model manager . 120wacssetmgr - Wacs set manager . 120wacsinfomgr - Wacs info manager . 121wacsiconmgr Wacs Icon manager . 121wacsidmgr - Wacs ID manager . 121wacsunpackmgr - Wacs unpack manager . 121wacsplacemgr - Wacs placement manager . 121wacsaddassoc - Wacs association manager . 121wacsconnmgr - Wacs connection manager . 12222. Lookup Data Management . 123Web Based Tools . 123wacsvendmgr - Wacs Vendor Manager . 123wacsphotmgr - Wacs Photographer Manager . 124wacskeywordmgr - Wacs Keyword Manager . 124wacsusermgr - Wacs User Account Manager . 124wacsuserlist - Wacs User Database Account List . 125wacsdnlmgr - Wacs Download Manager . 125wacsdnlreg - Wacs Download Registration . 125wacsdnllist - Wacs Download Status List . 125wacsdnlframe - Wacs Download Frame . 126wacsdnlnext - Wacs Download Next Prompter . 12623. Utilities Reference . 127Command Line Tools . 127The wacsblogctl command . 127The wacsvidcomb command . 127The wacscachectl command . 12724. Database Population Tools . 128Command Line Tools . 128The wacspop command . 128vendors.xml - Vendor database initial load . 128photographers.xml - Photographer database initial load . 128v

Wacs Administration Guidekeywords.xml - Keyword database initial load .attib.xml - Attributes database initial load .users.xml - users database initial load .Updating XML Files For wacspop .Index .vi129129129129131

List of Tables4.1. Clothing Related Keywords . 204.2. Set Ranks . 215.1. Final Example Headshot Icons . 315.2. Typical Site Identity Information . 326.1. Breast Size: Our Take . 3815.1. Current and Planned Features in Model Manager . 8917.1. Command Line Tools . 10117.2. Attribute Names And Legal Values In addmodel . 10319.1. SQL Command line interpreters . 11320.1. Tables That Reference Model Numbers . 11622.1. Substitution List For Vendor URLs . 12324.1. New XML Elements For wacspop . 130vii

List of Examples2.1. Sample wacs.acl file giving admin rights to local users . 92.2. A Sample wacs.acl file for a local office network . 1013.1. Layout of Cache Files . 8117.1. Sample Feature Article HTML Document . 10819.1. Using SQL to set Attire . 113viii

Part I. WACS Administration TutorialThis part of the WACS Administration Guide is designed to introduce you to managing collections of image setsand videos using the WACS tools. In order to work through the examples, you will almost certainly need access toa non-production WACS server and a reasonable collection of sample content. Since 2010 the WACS developershave made available a small set of sample content through our WACS demonstration site, PinkMetallic.com [http://www.pinkmetallic.com] which at the time of writing can be accessed for free. At some future time a small charge maybe levied to cover running costs.Chapter 1, IntroductionChapter 2, First StepsChapter 3, Site DesignChapter 4, Naming Sets In WACSChapter 5, Preparing To Create A Model RecordChapter 6, wacsmodelmgr - The Wacs Model ManagerChapter 7, wacsunpackmgr - The Unpack ManagerChapter 8, wacsplacemgr - The Placement ManagerChapter 9, Wacs Set ManagerChapter 10, The Info ManagerChapter 11, Other Web Based ToolsChapter 12, Migration ToolsChapter 13, When Using Wacs For HostingChapter 14, The Download SystemChapter 15, More About Model ManagerChapter 16, The WACS Icon ManagerChapter 17, Command Line ToolsChapter 18, CustomisationChapter 19, Simple Tasks In SQLChapter 20, Using SQL: Advanced Topics

Table of Contents1. Introduction . 5Overview . 5About This Book . 5About The Examples . 52. First Steps . 7User Class . 7Authentication Mode . 7Changing Your Role (Leases) . 8Changing Your Role (Permanent) . 9Everything Looks Different . 113. Site Design . 12Overview: Laying Out Your WACS Site . 12Simplistic Layout . 13Vendor Mode . 14Gallery Mode . 15Summary . 164. Naming Sets In WACS . 17Goals In Naming Sets . 17How It Works . 17Keyword Scoring . 18Heavily Used Keywords . 19Multiple Sets: Duplicates, Alternatives and Continuations . 21About Rank . 21Set Relations . 225. Preparing To Create A Model Record . 23Introduction . 23Headshot Image Preparation . 23Making The Big Icon . 25Making The Small Icon . 29Icon Placement . 30Determining The Site Id . 316. wacsmodelmgr - The Wacs Model Manager . 33Introduction . 33Creating A New Model . 35Basic Attributes . 37Inserting Model Records . 39Amending Model Records . 427. wacsunpackmgr - The Unpack Manager . 46About Unpacking . 46Working With Image Sets . 46Already Unpacked Warning . 50Working With Videos . 518. wacsplacemgr - The Placement Manager . 52The Placement Process . 529. Wacs Set Manager . 56Meta Data Manipulation . 56What You Can Edit . 56Doing An Update . 5810. The Info Manager . 60Managing Additional Information . 60Example Of Using wacsinfomgr . 612

WACS Administration Tutorial11. Other Web Based Tools . 63What's Available . 63Association Manager . 63Connections Manager . 65Keyword Manager .

in both Perl and PHP5 languages to allow web developers to leverage it's facilities from their own programs. This book describes the administrative tools used to manage, catalogue and update collections of digital media (images, videos, etc) maintained within a WACS web site. It provides both a tutorial and a reference document for the various