[%# 1.0@bugzilla.org %]
[%# The contents of this file are subject to the Mozilla Public
  # License Version 1.1 (the "License"); you may not use this file
  # except in compliance with the License. You may obtain a copy of
  # the License at http://www.mozilla.org/MPL/
  #
  # Software distributed under the License is distributed on an "AS
  # IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  # implied. See the License for the specific language governing
  # rights and limitations under the License.
  #
  # The Original Code is the Bugzilla Bug Tracking System.
  #
  # The Initial Developer of the Original Code is Netscape Communications
  # Corporation. Portions created by Netscape are
  # Copyright (C) 1998 Netscape Communications Corporation. All
  # Rights Reserved.
  #
  # Contributor(s): Dave Miller <justdave@syndicomm.com>
  #                 Joel Peshkin <bugreport@peshkin.net>
  #                 Jacob Steenhagen <jake@bugzilla.org>
  #                 Vlad Dascalu <jocuri@softhome.net>
  #%]

[%# INTERFACE:
  # groups: array with group objects having the properties:
  #   - id: number. The ID of the group.
  #   - name: string. The name of the group.
  #   - description: string. The description of the group.
  #   - userregexp: string. The user regexp for the given group.
  #   - isactive: boolean int. Specifies if the group is active or not.
  #   - isbuggroup: boolean int. Specifies if it can be used for bugs.
  #%]

[% PROCESS global/header.html.tmpl
  title = "Edit Groups"
  h2 = "This lets you edit the groups available to put users in."
%]


<table border="1">
  <tr>
    <th>Name</th>
    <th>Description</th>
    <th>User RegExp</th>
    <th>Use For [% terms.Bugs %]</th>
    <th>Type</th>
    <th>Action</th>
  </tr>

  [% FOREACH group = groups %]
    <tr>
      <td>
        <a href="editgroups.cgi?action=changeform&amp;group=[% group.id FILTER url_quote %]">
          [% group.name FILTER html %]</a>
      </td>
      <td>[% group.description FILTER html %]</td>
      <td>[% group.userregexp FILTER html %]&nbsp;</td>

      <td align="center">
        [% IF (group.isactive != 0) && (group.isbuggroup) %]
          X
        [% ELSE %]
          &nbsp;
        [% END %]
      </td>

      <td align="center">
        [% (group.isbuggroup) ? "user" : "system" %]
      </td>

      <td align="center" valign="middle">
        [% IF (group.isbuggroup) %]
          <a href="editgroups.cgi?action=del&amp;group=[% group.id FILTER url_quote %]">Delete</a>
        [% ELSE %]
          &nbsp;
        [% END %]
      </td>
    </tr>
  [% END %]

  <tr>
    <td colspan="5"></td>
    <td><a href="editgroups.cgi?action=add">Add Group</a></td>
  </tr>
</table>

<p>
  <b>Name</b> is what is used with the UserInGroup() function in any
customized cgi files you write that use a given group.  It can also be used
by people submitting [% terms.bugs %] by email to limit [% terms.abug %]
to a certain set of groups.
</p>

<p>
  <b>Description</b> is what will be shown in the [% terms.bug %] reports
to members of the group where they can choose whether the [% terms.bug %]
will be restricted to others in the same group.
</p>

<p>
  <b>User RegExp</b> is optional, and if filled in, will automatically
grant membership to this group to anyone with an email address
that matches this perl regular expression. Do not forget
the trailing '$'.  Example '@mycompany\.com$'
</p>

<p>
  The <b>Use For [% terms.Bugs %]</b> flag determines whether or not
the group is eligible to be used for [% terms.bugs %]. If you remove
this flag, it will no longer be possible for users to add [% terms.bugs %]
to this group, although [% terms.bugs %] already in the group will remain
in the group. Doing so is a much less drastic way to stop a group
from growing than deleting the group as well as a way to maintain
lists of users without cluttering the lists of groups used
for [% terms.bug %] restrictions.
</p>

<p>
  The <b>Type</b> field identifies system groups.
</p>

[% PROCESS global/footer.html.tmpl %]
