summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/en/xml/administration.xml119
1 files changed, 119 insertions, 0 deletions
diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
index 4f30b6a89..dbffeb185 100644
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -1265,6 +1265,125 @@
</section> <!-- flags -->
+ <section id="custom-fields">
+ <title>Custom Fields</title>
+
+ <para>
+ One of the most requested features was the ability to add your own custom
+ fields to bugs, based on your needs. With the release of Bugzilla 3.0, this
+ dream finally comes true. Administrators can manage these fields using the
+ <quote>Custom Fields</quote> link in the footer of pages. The first thing
+ they will see is the list of existing custom fields (which is empty by default).
+ </para>
+
+ <section id="add-custom-fields">
+ <title>Adding Custom Fields</title>
+
+ <para>
+ The <quote>Add a new custom field</quote> link permits you to add a
+ new field which can be either a free text box or a drop down menu.
+ More field types will be available in future releases.
+ </para>
+
+ <para>
+ The following attributes must be set for each new custom field:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis>Name:</emphasis>
+ the name of the field, used internally. This name MUST begin
+ with <quote>cf_</quote>. If you omit this string, it will
+ be automatically added to the name you entered. This way, all
+ custom fields added to Bugzilla begin with <quote>cf_</quote>,
+ avoiding any conflict with default fields.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Description:</emphasis>
+ the string which is used as a label for this custom field.
+ That is the string that users will see, and so should be
+ short and explicit.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Type:</emphasis>
+ as mentioned above, only two types are implemented so far.
+ Free text boxes let you type any string, while drop down menus
+ only let you choose one value in the list provided. The list of
+ legal values for this field can be created and edited as soon as
+ this custom field is added to the DB. See
+ <xref linkend="edit-values-list" /> for information about editing
+ legal values.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Sortkey:</emphasis>
+ this integer determines in which order custom fields are
+ displayed in the UI, especially when viewing a bug. Fields
+ with lower values are displayed first.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Can be set on bug creation:</emphasis>
+ this boolean determines whether this field can be set on
+ bug creation or not. If not, then you have to create the
+ bug first before being able to set this field. Else you
+ can set its value at the same time you file a bug,
+ see <xref linkend="bugreports" /> about filing bugs.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Displayed in bugmail for new bugs:</emphasis>
+ this boolean determines whether the value set on this field
+ should appear in bugmail when the bug is filed. This attribute
+ has no effect if the field cannot be set on bug creation.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <emphasis>Is obsolete:</emphasis>
+ this boolean determines whether or not this field should
+ be displayed at all. Obsolete custom fields are hidden.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
+ <section id="edit-custom-fields">
+ <title>Editing Custom Fields</title>
+
+ <para>
+ As soon as a custom field is created, its name and type cannot be
+ changed. If this field is a drop down menu, its legal values can
+ be set as described in <xref linkend="edit-values-list" />. All
+ other attributes can be edited as described above.
+ </para>
+ </section>
+
+ <section id="delete-custom-fields">
+ <title>Deleting Custom Fields</title>
+
+ <para>
+ At this point, it is not possible to delete custom fields from
+ your web browser. If you don't want to make one available anymore,
+ mark it as obsolete. This way, you will preserve your DB
+ referential integrity.
+ </para>
+ </section>
+ </section>
+
<section id="edit-values">
<title>Legal Values</title>