From 123a2f2d247923f70bf289b22c5df4ad21aca413 Mon Sep 17 00:00:00 2001
From: "jocuri%softhome.net" <>
Date: Fri, 4 Apr 2008 11:47:25 +0000
Subject: Patch for bug 189156: explain quip moderation in documentation.
---
docs/en/xml/administration.xml | 45 ++++++++++++++++++++++++++++++++++++++++++
1 file changed, 45 insertions(+)
(limited to 'docs/en')
diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
index 24aa18954..56de1e9bf 100644
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -629,6 +629,51 @@
+
+ Quips
+
+
+ Quips are small text messages that can be configured to appear
+ next to search results. A Bugzilla installation can have its own specific
+ quips. Whenever a quip needs to be displayed, a random selection
+ is made from the pool of already existing quips.
+
+
+
+ Quips are controlled by the enablequips parameter.
+ It has several possible values: on, approved, frozen or off.
+ In order to enable quips approval you need to set this parameter
+ to "approved". In this way, users are free to submit quips for
+ addition but an administrator must explicitly approve them before
+ they are actually used.
+
+
+
+ In order to see the user interface for the quips, it is enough to click
+ on a quip when it is displayed together with the search results. Or
+ it can be seen directly in the browser by visiting the quips.cgi URL
+ (prefixed with the usual web location of the Bugzilla installation).
+ Once the quip interface is displayed, it is enough to click the
+ "view and edit the whole quip list" in order to see the administration
+ page. A page with all the quips available in the database will
+ be displayed.
+
+
+
+ Next to each tip there is a checkbox, under the
+ "Approved" column. Quips who have this checkbox checked are
+ already approved and will appear next to the search results.
+ The ones that have it unchecked are still preserved in the
+ database but they will not appear on search results pages.
+ User submitted quips have initially the checkbox unchecked.
+
+
+
+ Also, there is a delete link next to each quip,
+ which can be used in order to permanently delete a quip.
+
+
+
Groups and Group Security
--
cgit v1.2.3-24-g4f1b