Set-up Auditorium

Add new Auditorium object

Goto wherever you want to create new Auditorium and add new object using new item menu as usually in Plone (see pic. 1).

pic. 1 - Add Auditorium object

Set attributes of Auditorium

Fill in Auditorium attributes and click on save button in the bottom of the edit form. For attributes description see auditorium fields list [1]. After that you will get new Auditorium discussion like on the following picture.

pic. 2 - New Auditorium

Start Auditorium

Next step is to determine who is the Auditorium for. You can choose from 3 predefined workflow states: published, restricted and custom. Do it by clicking on matching transition in Plone workflow state menu (see pic. 3).

• published (open) - Public Auditorium where Anonymous can list the Auditorium posts and Members can add new posts.
• restricted (restrict) - Auditorium only for Members where only Members can list the Auditorium and add new posts.
• custom (customeze) - This state is dedicated for those cases where you can make your custom workflow, just select this state and redefine it's permissions for security roles in Workflow tool in ZMI.

pic. 3 - Auditorium states

Adding first posts

When the Auditorium is started users with permitted roles can add new posts by entering their messages into text-area in the top of Auditorium view and clicking on "Add post" button. Faster way is to enter message, hit the Tab and then Enter key. Posts are displayed in the Auditorium posts list in the moment.

Under text-area for adding new messages is displayed list of Allowed HTML tags, which can be used for basic messages body text formating as you can see on the pic. 4.

pic. 4 - First posts in Auditorium

On the following picture you can se example of how will be rendered hyper-text ling defined in message body (see pic. 4).

pic. 5 - Rendering of HTML tags

Masking explicit lyrics

You can define masking of unfair words which will be masked by it's defined replacements when displaying Auditorium Posts. Manager or Auditorium Moderator can switch masking on/off in moderated Auditorium.

To define forbidden words open Auditorium object for editting and go to "Masking" schema (link in the top of the form). There you can define default "Cover String" which will be used for masking for words which hasn't defined it's own replacement string. After that you can define list of words and it's replacements as you can on pic. 5.

pic. 6 - Banned words definition

[1]Auditorium fields list:

Default Schema

• Short Name - Should not contain spaces, underscores or mixed case. Short Name is part of the item's web address.
• Title - Main title of the Auditorium.
• Description - Short description of the Auditorium in plain text.
• Auditorium icon - Image representing the Auditorim.
• Portraits size - User's portraits can be displayed in 3 different sizes: Small (32x32), Medium (64x64) and Large (100x100).
• Date formats - Date of post creation can be displayed in 2 different formats: Short (2005-05-06) and Long (2005-05-06 11:55).
• Default page size - This is number of posts which will be listed in Auditorium per page. It can be temporarelly changed by user during Auditorium browsing.
• Max. Post body length - This is maximum number of characters used in post's body by it's author.
• Moderated Auditorium - This puts the Auditorium into moderated mode where every post has to be approved by Auditorium Moderator before it is published to others.
• Allowed HTML tags - This is list of HTML tags which can be used in post's body to make it more nice and readable to others. Usefull for hyper-text links and other basic formating.

Masking Schema

• Cover string - This is default string which will be used to replace forbidden words in post's body.
• Banned words - Here you can define forbidden words to be used in post's body. Additionally you can define different replace word for every forbidden one. If you will not define replacement for some of the forbidden word, it will be masked by Cover string (see above).