aGNeS: a threaded BBS system

aGNeS 4.2 Users Guide

Vestris Inc., Switzerland

Table of Contents

1. aGNeS Concepts

What is aGNeS?

Bulletin Board Systems Overview

aGNeS Features

Basic Conferencing
Power Options
Forum Community
Remote and Server
Legal and Support

History of aGNeS and the Name

People Behind aGNeS

Copyright Notices

2. aGNeS Server Installation

Concepts and Requirements

Hardware Requirements

Installation on UNIX

Download aGNeS
Install and Test Binary

Installation on Windows NT/2000

Download aGNeS
Install and Test Binary

First-time Configuration

Removing Banner Popups

Troubleshooting

Segmentation Fault (core dumped).
./agnes.4.2.OS: can't load library 'xxx.ld.so'.
agnes.exe has provoked an unexpected error in ???.dll
Internal Server Error or binary code in browser

3. Managing aGNeS Boards

Introduction

Creating a new BBS

The Objective - a Simple BBS
Download Sample Template Files
Create the BBS!
Troubleshooting

Managing your BBS

Accessing the Online Management
aGNeS Administration
Group Administration
List All Equivalence Structures
List All Obvious Associations

Deleting Articles and Archives

Creating Archives

Merging and Renaming Archives

Editing and Moderating Articles

Templates Cache

4. Changing aGNeS Layout

Introduction
Templates, Tags and Options
Changing Forum Layout
Inserting Pictures and Links
Changing the Fonts
Inserting an Article Count
Sorting Articles List
More Tags and Options

5. Using aGNeS Advanced Features

aGNeS Dynamic Variables

Introduction
Expression Variables
Expression Commands
Examples

Selecting Articles by Age

Articles of Several Days Old
Articles of Several Hours and Minutes Old

IP Addresses of Forum Posts

Password Protected Forums

Creating Framed Forums

Picture Faces Associated with Articles

6. aGNeS Licensing and Terms of Use

Introduction

Software Terms of Use

Free Software and Services Terms of Use

General
Limitations of Liability
Bulletin boards, Forums, Discussion Groups
Privacy
Arbitration
Disclaimer

Definition of Non-Commercial Companies

It was organized solely for non-profit purposes.
Operated solely for non-profit purposes.
No personal benefit for any member.

Software and Service Pricing

Using aGNeS Remotely
Using aGNeS on Your Server

Reseller, Source-Code and OEM Licensing

Paying for a License

Online Purchase
Email Purchase
Fax Purchase
Postal Purchase
Purchase Orders
Questions and Issues

Software Certification and Registration

Certification Mechanism

I. aGNeS Template Tags

AGNES-HEADER — articles tree
AGNES-ARTICLE — contents of an article
AGNES-POSTNEW — form for a new post
AGNES-FOLLOWUP — form to reply to an article
AGNES-NEWLINK — link for posting a new articles
AGNES-FOLLINK — link to post a reply to an article
AGNES-HOME — link to the main page
AGNES-NEXT — link to the next article
AGNES-PREV — link to the previous article
AGNES-PARENT — link to the parent of the article
AGNES-ARCHIVE — list of archives and links to archive pages
AGNES-SEARCH — search form and results
REGEXP-SEARCH — regexp search form and results
AGNES-ANAME — current archive name
ARTICLE-TITLE — article subject
ARTICLE-DATE — date of the post
ARTICLE-ARTICLE — article contents
ARTICLE-AUTHOR — author of the post
ARTICLE-AUTHOR-MAIL — email of the author
ARTICLE-PARENT — article parent header
ARTICLE-FOLLOWUPS — replies to the article
AGNES-ARTICLE-COUNT — total number of articles
AGNES-PAGES — links to pages
AGNES-PAGES-COUNT — number of available pages
AGNES-PAGE — current page number
MODERATED-POST — message for new posts

II. aGNeS General Template Options

SUBJECT — subject of an article
NAME — name of the author
MAIL — email of the author
CLEAR — text on the clear button
POST — text of the post button
PREVIEW — text of the preview button
NEW — text of the link to postnew.html
FOLLOW — text of the link to follow.html
DATE — date of the article
HOME — text of the link to header.html
FLINK — show/hide link to follow.html
POSTBY — posted by text
FMSG — followups text
COMPLETE — followups style
SEPARATOR — separator between articles
PREV — link to previous article
NEXT — link to next article
PARENT — link to parent article
NOPREV — no previous article link
NONEXT — no next article link
NOPARENT — no parent article link
REVERSE — articles order
RECENT — text for recent articles
DAYS — relative article age
PERDAY — custom recent text
BYMAIL — receive by e-mail text
ABEG — text separator start
AEND — text separator end
OPEN — insert before article link
CLOSE — insert after article link
OPEN-DATE — insert before article date
CLOSE-DATE — insert after article date
OPEN-NAME — insert before name or email address
CLOSE-NAME — insert after name or email address
SIZE — size of input box
ROWS — textarea rows
COLS — textarea columns
TIMESHIFT — timezone shifting
TWIDTH — tables width
PARENT-ROW — link to parent article
PARENT-POST — link to parent article
RE-TAG — prefix for replies
NOQUOTE-REPLY — do not quote replying
ARTICLES-PAGE — threads per page
PAGE-NEXT — link to next page
PAGE-PREV — link to previous page
GROUPBREAK — insert between threads

III. aGNeS Mail Generation Options

MAIL-HEADER — header of the followup
MAIL-WROTE — body of the followup
MAIL-FOOTER — footer of the followup

IV. aGNeS Archive Generation Options

OPEN-ARCHIVE — insert before link to archive
CLOSE-ARCHIVE — insert after link to archive
BETWEEN-ARCHIVE — insert between archive links
REVERSE-ARCHIVE — reverse archives order

V. aGNeS Search Options

SEARCH — search text
SEARCH COMMAND — search command
SEARCH CLEAR — clear command
SEARCH TITLES — search titles checkbox
SEARCH ARCHIVES — search archives checkbox
SEARCH CASESENS — search case-sensitive checkbox
SEARCH WHOLE — search whole words only checkbox
SEARCH SIZE — search input size
SEARCH THREAD — searching main thread
SEARCH IN ARCHIVE — searching in archive
SEARCH FOUND — occurrences found
SEARCH NOT FOUND — no occurrences found

VI. aGNeS Forum Integrity Options

DUCON NAME — author's name
DUCON MAIL — author's email
DUCON SUBJECT — article subject
FORCE-SUBJECT — require a subject
FORCE-NAME — require a name
FORCE-EMAIL — require an email address
HIDE-EMAIL — hide email addresses
HIDE-NAME — hide author's name
HIDE-DATE — hide dates
HIDE-IP — hide ip addresses
BAN-IP — ban ip addresses

VII. aGNeS Advanced Options

SOURCE — index frame side
TARGET — article frame side
EXTFACES — article pictures
EXTFACES-COLS — picture columns
BANNER — advertizing banners style
NOCOUNTER — no hit counter

VIII. aGNeS Moderation Options

MODERATED — enable forum moderation
MODERATED-SHOW — show moderated articles
MODERATED-SUBJECT — subject of moderated articles
MODERATED-NAME — author name of moderated articles
MODERATED-EMAIL — email of moderated articles
MODERATED-TEXT — text of moderated articles
MODERATED-POST — new post message

IX. aGNeS Thread Expansion and Collapsing Options

COLLAPSE-MORE — open collapsed thread
COLLAPSE-LESS — close expanded thread
COLLAPSE-ALL — link to a non-collapsed forum
EXPAND-THREAD — expand the current thread
NOEXPAND-THREAD — no-expand the current thread
EXPANDED-THREAD — text in front of an expanded thread