CML Reference Guide
Chapter 4.9: Conference Organizer Information
Another family of functions relates to information about a conference
that gets set (or changed) by the conference organizer.
In all of these functions, num is the conference number.
Evaluates to the userid of the primary organizer of the conference.
- $set_co_org(num id)
Change the primary organizer of conference num to userid
id. The caller must already be the primary organizer,
or else have the MGR_BEORG manager bit.
Evaluates to the text of the "greeting" for the conference.
In the original (text) Caucus interface, the greeting was displayed
every time a person entered a conference.
Evaluates to the text of the "introduction" for the
conference. In the original Caucus, the introduction was displayed
when a person tried to join a conference for the very first time.
The introduction offers more information about the conference,
to help a person decide if they really wish to join the conference.
Evaluates to "1" if ordinary users can add an item,
or "0" otherwise.
- $set_co_add(num add)
If add is non-zero, ordinary users may add new items.
If add is "0", they may not.
Evalutes to "1" if ordinary users can change their
own responses. Otherwise "0".
- $set_co_change(num chg)
If chg is non-zero, ordinary users may change their responses.
If chg is "0" they may not.
Evaluates to "1" if conference name is visible to non-members
in conference lists. Otherwise "0".
- $set_co_visible(num vis)
If vis is non-zero, the conference name is visible. If
vis is "0", the conference is invisible to non-members.
Evaluates to the text of the conference "userlist".
The text of a simple userlist might look like:
- $set_co_userlist(num list)
Set the text of conference num's "userlist" to list.
Completely and permanently remove (delete) conference num.
Will only work for managers with permission bit MGR_RMCONF.
- $co_makeorg(num userid)
Immediately add userid as an organizer to conference num.
Will only work for managers with permission bit MGR_BEORG.
- $create_conf(name priorg org1 ...)
Create a new conference name, with primary organizer priorg,
and secondary organizers org1 etc.
Will only work for managers with permission bit MGR_CRCONF.
new conference number on success
0 if user does not have MGR_CRCONF permission
-1 if name already exists
-2 priorg not supplied
-3 internal database error
-4 if name is bad
- $co_rename(cnum newname)
Renames conference cnum to have the name newname.
Will only work for managers with permission bits MGR_CRCONF or
1 on success
0 if the user doesn't have manager permission
-1 if newname is bad
-2 if cnum doesn't exist
-3 if newname already exists!