зеркало из https://github.com/mozilla/pjs.git
1146 строки
39 KiB
Perl
1146 строки
39 KiB
Perl
# -*- Mode: perl; indent-tabs-mode: nil -*-
|
|
#
|
|
# 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): Terry Weissman <terry@mozilla.org>
|
|
# Dawn Endico <endico@mozilla.org>
|
|
# Dan Mosedale <dmose@mozilla.org>
|
|
# Joe Robins <jmrobins@tgix.com>
|
|
# Jacob Steenhagen <jake@bugzilla.org>
|
|
# J. Paul Reed <preed@sigkill.com>
|
|
# Bradley Baetz <bbaetz@student.usyd.edu.au>
|
|
#
|
|
|
|
# This file defines all the parameters that we have a GUI to edit within
|
|
# Bugzilla.
|
|
|
|
# ATTENTION!!!! THIS FILE ONLY CONTAINS THE DEFAULTS.
|
|
# You cannot change your live settings by editing this file.
|
|
# Only adding new parameters is done here. Once the parameter exists, you
|
|
# must use %baseurl%/editparams.cgi from the web to edit the settings.
|
|
|
|
# This file is included via |do|, mainly because of circular dependancy issues
|
|
# (such as globals.pl -> Bugzilla::Config -> this -> Bugzilla::Config)
|
|
# which preclude compile time loading.
|
|
|
|
# Those issues may go away at some point, and the contents of this file
|
|
# moved somewhere else. Please try to avoid more dependancies from here
|
|
# to other code
|
|
|
|
# (Note that these aren't just added directly to Bugzilla::Config, because
|
|
# the backend prefs code is separate to this...)
|
|
|
|
use strict;
|
|
use vars qw(@param_list);
|
|
use File::Spec; # for find_languages
|
|
|
|
# Checking functions for the various values
|
|
# Some generic checking functions are included in Bugzilla::Config
|
|
|
|
sub check_priority {
|
|
my ($value) = (@_);
|
|
&::GetVersionTable();
|
|
if (lsearch(\@::legal_priority, $value) < 0) {
|
|
return "Must be a legal priority value: one of " .
|
|
join(", ", @::legal_priority);
|
|
}
|
|
return "";
|
|
}
|
|
|
|
sub check_shadowdb {
|
|
my ($value) = (@_);
|
|
$value = trim($value);
|
|
if ($value eq "") {
|
|
return "";
|
|
}
|
|
|
|
if (!Param('shadowdbhost')) {
|
|
return "You need to specify a host when using a shadow database";
|
|
}
|
|
|
|
# Can't test existence of this because ConnectToDatabase uses the param,
|
|
# but we can't set this before testing....
|
|
# This can really only be fixed after we can use the DBI more openly
|
|
return "";
|
|
}
|
|
|
|
sub check_urlbase {
|
|
my ($url) = (@_);
|
|
if ($url !~ m:^http.*/$:) {
|
|
return "must be a legal URL, that starts with http and ends with a slash.";
|
|
}
|
|
return "";
|
|
}
|
|
|
|
sub check_webdotbase {
|
|
my ($value) = (@_);
|
|
$value = trim($value);
|
|
if ($value eq "") {
|
|
return "";
|
|
}
|
|
if($value !~ /^https?:/) {
|
|
if(! -x $value) {
|
|
return "The file path \"$value\" is not a valid executable. Please specify the complete file path to 'dot' if you intend to generate graphs locally.";
|
|
}
|
|
# Check .htaccess allows access to generated images
|
|
if(-e "data/webdot/.htaccess") {
|
|
open HTACCESS, "data/webdot/.htaccess";
|
|
if(! grep(/ \\\.png\$/,<HTACCESS>)) {
|
|
return "Dependency graph images are not accessible.\nAssuming that you have not modified the file, delete data/webdot/.htaccess and re-run checksetup.pl to rectify.\n";
|
|
}
|
|
close HTACCESS;
|
|
}
|
|
}
|
|
return "";
|
|
}
|
|
|
|
sub check_netmask {
|
|
my ($mask) = @_;
|
|
my $res = check_numeric($mask);
|
|
return $res if $res;
|
|
if ($mask < 0 || $mask > 32) {
|
|
return "an IPv4 netmask must be between 0 and 32 bits";
|
|
}
|
|
# Note that if we changed the netmask from anything apart from 32, then
|
|
# existing logincookies which aren't for a single IP won't work
|
|
# any more. We can't know which ones they are, though, so they'll just
|
|
# take space until they're preiodically cleared, later.
|
|
|
|
return "";
|
|
}
|
|
|
|
sub check_loginmethod {
|
|
# doeditparams traverses the list of params, and for each one it checks,
|
|
# then updates. This means that if one param checker wants to look at
|
|
# other params, it must be below that other one. So you can't have two
|
|
# params mutually dependant on each other.
|
|
# This means that if someone clears the LDAP config params after setting
|
|
# the login method as LDAP, we won't notice, but all logins will fail.
|
|
# So don't do that.
|
|
|
|
my ($method, $entry) = @_;
|
|
my $res = check_multi($method, $entry);
|
|
return $res if $res;
|
|
if ($method eq 'DB') {
|
|
# No params
|
|
} elsif ($method eq 'LDAP') {
|
|
eval "require Net::LDAP";
|
|
return "Error requiring Net::LDAP: '$@'" if $@;
|
|
return "LDAP servername is missing" unless Param("LDAPserver");
|
|
return "LDAPBaseDN is empty" unless Param("LDAPBaseDN");
|
|
} else {
|
|
return "Unknown loginmethod '$method' in check_loginmethod";
|
|
}
|
|
return "";
|
|
}
|
|
|
|
sub check_languages {
|
|
my @languages = split /,/, trim($_);
|
|
if(!scalar(@languages)) {
|
|
return "You need to specify a language tag."
|
|
}
|
|
foreach my $language (@languages) {
|
|
if( ! -d 'template/'.trim($language).'/custom'
|
|
&& ! -d 'template/'.trim($language).'/default') {
|
|
return "The template directory for $language does not exist";
|
|
}
|
|
}
|
|
return "";
|
|
}
|
|
|
|
sub find_languages {
|
|
my @languages = ();
|
|
opendir(DIR, "template") || return "Can't open 'template' directory: $!";
|
|
my @langdirs = grep { /^[a-z-]+$/i } readdir(DIR);
|
|
closedir DIR;
|
|
|
|
foreach my $lang (@langdirs) {
|
|
next if($lang =~ /^CVS$/i);
|
|
my $deft_path = File::Spec->catdir('template', $lang, 'default');
|
|
my $cust_path = File::Spec->catdir('template', $lang, 'custom');
|
|
push(@languages, $lang) if(-d $deft_path or -d $cust_path);
|
|
}
|
|
return join(', ', @languages);
|
|
}
|
|
|
|
# OK, here are the parameter definitions themselves.
|
|
#
|
|
# Each definition is a hash with keys:
|
|
#
|
|
# name - name of the param
|
|
# desc - description of the param (for editparams.cgi)
|
|
# type - see below
|
|
# choices - (optional) see below
|
|
# default - default value for the param
|
|
# checker - (optional) checking function for validating parameter entry
|
|
# It is called with the value of the param as the first arg and a
|
|
# reference to the param's hash as the second argument
|
|
#
|
|
# The type value can be one of the following:
|
|
#
|
|
# t -- A short text entry field (suitable for a single line)
|
|
# l -- A long text field (suitable for many lines)
|
|
# b -- A boolean value (either 1 or 0)
|
|
# m -- A list of values, with many selectable (shows up as a select box)
|
|
# To specify the list of values, make the 'choices' key be an array
|
|
# reference of the valid choices. The 'default' key should be an array
|
|
# reference for the list of selected values (which must appear in the
|
|
# first anonymous array), i.e.:
|
|
# {
|
|
# name => 'multiselect',
|
|
# desc => 'A list of options, choose many',
|
|
# type => 'm',
|
|
# choices => [ 'a', 'b', 'c', 'd' ],
|
|
# default => [ 'a', 'd' ],
|
|
# checker => \&check_multi
|
|
# }
|
|
#
|
|
# Here, 'a' and 'd' are the default options, and the user may pick any
|
|
# combination of a, b, c, and d as valid options.
|
|
#
|
|
# &check_multi should always be used as the param verification function
|
|
# for list (single and multiple) parameter types.
|
|
#
|
|
# s -- A list of values, with one selectable (shows up as a select box)
|
|
# To specify the list of values, make the 'choices' key be an array
|
|
# reference of the valid choices. The 'default' key should be one of
|
|
# those values, i.e.:
|
|
# {
|
|
# name => 'singleselect',
|
|
# desc => 'A list of options, choose one',
|
|
# type => 's',
|
|
# choices => [ 'a', 'b', 'c' ],
|
|
# default => 'b',
|
|
# checker => \&check_multi
|
|
# }
|
|
#
|
|
# Here, 'b' is the default option, and 'a' and 'c' are other possible
|
|
# options, but only one at a time!
|
|
#
|
|
# &check_multi should always be used as the param verification function
|
|
# for list (single and multiple) parameter types.
|
|
|
|
# XXXX - would be nice for doeditparams to 'know' about types s and m, and call
|
|
# check_multi without it having to be explicitly specified here - bbaetz
|
|
|
|
@param_list = (
|
|
{
|
|
name => 'maintainer',
|
|
desc => 'The email address of the person who maintains this installation ' .
|
|
'of Bugzilla.',
|
|
type => 't',
|
|
default => 'THE MAINTAINER HAS NOT YET BEEN SET'
|
|
},
|
|
|
|
{
|
|
name => 'urlbase',
|
|
desc => 'The URL that is the common initial leading part of all Bugzilla ' .
|
|
'URLs.',
|
|
type => 't',
|
|
default => 'http://you-havent-visited-editparams.cgi-yet/',
|
|
checker => \&check_urlbase
|
|
},
|
|
|
|
{
|
|
name => 'languages' ,
|
|
desc => 'A comma-separated list of RFC 1766 language tags. These ' .
|
|
'identify the languages in which you wish Bugzilla output ' .
|
|
'to be displayed. Note that you must install the appropriate ' .
|
|
'language pack before adding a language to this Param. The ' .
|
|
'language used is the one in this list with the highest ' .
|
|
'q-value in the user\'s Accept-Language header.<br>' .
|
|
'Available languages: ' . find_languages() ,
|
|
type => 't' ,
|
|
default => 'en' ,
|
|
checker => \&check_languages
|
|
},
|
|
|
|
{
|
|
name => 'defaultlanguage',
|
|
desc => 'The UI language Bugzilla falls back on if no suitable ' .
|
|
'language is found in the user\'s Accept-Language header.' ,
|
|
type => 't' ,
|
|
default => 'en' ,
|
|
checker => \&check_languages
|
|
},
|
|
|
|
{
|
|
name => 'cookiepath',
|
|
desc => 'Path, relative to your web document root, to which to restrict ' .
|
|
'Bugzilla cookies. Normally this is the URI portion of your URL ' .
|
|
'base. Begin with a / (single slash mark). For instance, if ' .
|
|
'Bugzilla serves from http://www.somedomain.com/bugzilla/, set ' .
|
|
'this parameter to /bugzilla/ . Setting it to / will allow ' .
|
|
'all sites served by this web server or virtual host to read ' .
|
|
'Bugzilla cookies.',
|
|
type => 't',
|
|
default => '/'
|
|
},
|
|
|
|
{
|
|
name => 'timezone',
|
|
desc => 'The timezone that your database server lives in. If set to "", ' .
|
|
'then the timezone won\'t be displayed with the timestamps.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
{
|
|
name => 'enablequips',
|
|
desc => 'Controls the appearance of quips at the top of buglists.<ul> ' .
|
|
'<li>on - Bugzilla will display a quip, and lets users add to ' .
|
|
'the list.</li><li>approved - quips can be entered, but need ' .
|
|
'be approved before shown</li><li>frozen - Bugzilla will display ' .
|
|
'a quip but not permit new additions.</li><li>off - Bugzilla ' .
|
|
'will not display quips.</li></ul>',
|
|
type => 's',
|
|
choices => ['on', 'approved', 'frozen', 'off'],
|
|
default => 'on',
|
|
checker => \&check_multi
|
|
},
|
|
|
|
{
|
|
name => 'makeproductgroups',
|
|
desc => 'If this is on, Bugzilla will associate a bug group with each ' .
|
|
'product in the database, and use it for querying bugs.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'useentrygroupdefault',
|
|
desc => 'If this is on, Bugzilla will use product bug groups by default ' .
|
|
'to restrict who can enter bugs. If this is on, users can see ' .
|
|
'any product to which they have entry access in search menus. ' .
|
|
'If this is off, users can see any product to which they have not ' .
|
|
'been excluded by a mandatory restriction.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'shadowdbhost',
|
|
desc => 'The host the shadow database is on.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
{
|
|
name => 'shadowdbport',
|
|
desc => 'The port the shadow database is on. Ignored if ' .
|
|
'<tt>shadowdbhost</tt> is blank. Note: if the host is the local ' .
|
|
'machine, then MySQL will ignore this setting, and you must ' .
|
|
'specify a socket below.',
|
|
type => 't',
|
|
default => '3306',
|
|
checker => \&check_numeric,
|
|
},
|
|
|
|
{
|
|
name => 'shadowdbsock',
|
|
desc => 'The socket used to connect to the shadow database, if the host ' .
|
|
'is the local machine. This setting is required because MySQL ' .
|
|
'ignores the port specified by the client and connects using ' .
|
|
'its compiled-in socket path (on unix machines) when connecting ' .
|
|
'from a client to a local server. If you leave this blank, and ' .
|
|
'have the database on localhost, then the <tt>shadowdbport</tt> ' .
|
|
'will be ignored.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
# This entry must be _after_ the shadowdb{host,port,sock} settings so that
|
|
# they can be used in the validation here
|
|
{
|
|
name => 'shadowdb',
|
|
desc => 'If non-empty, then this is the name of another database in ' .
|
|
'which Bugzilla will use as a read-only copy of everything. ' .
|
|
'This is done so that long slow read-only operations can be used ' .
|
|
'against this db, and not lock up things for everyone else. This ' .
|
|
'database is on the <tt>shadowdbhost</tt>, and must exist. ' .
|
|
'Bugzilla does not update it, if you use this parameter, then ' .
|
|
'you need to set up replication for your database',
|
|
type => 't',
|
|
default => '',
|
|
checker => \&check_shadowdb
|
|
},
|
|
|
|
{
|
|
name => 'LDAPserver',
|
|
desc => 'The name (and optionally port) of your LDAP server. (e.g. ' .
|
|
'ldap.company.com, or ldap.company.com:portnum)',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'LDAPbinddn',
|
|
desc => 'If your LDAP server requires that you use a binddn and password ' .
|
|
'instead of binding anonymously, enter it here ' .
|
|
'(e.g. cn=default,cn=user:password). ' .
|
|
'Leave this empty for the normal case of an anonymous bind.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'LDAPBaseDN',
|
|
desc => 'The BaseDN for authenticating users against. (e.g. ' .
|
|
'"ou=People,o=Company")',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'LDAPuidattribute',
|
|
desc => 'The name of the attribute containing the user\'s login name.',
|
|
type => 't',
|
|
default => 'uid'
|
|
},
|
|
|
|
{
|
|
name => 'LDAPmailattribute',
|
|
desc => 'The name of the attribute of a user in your directory that ' .
|
|
'contains the email address.',
|
|
type => 't',
|
|
default => 'mail'
|
|
},
|
|
|
|
{
|
|
name => 'LDAPfilter',
|
|
desc => 'LDAP filter to AND with the <tt>LDAPuidattribute</tt> for ' .
|
|
'filtering the list of valid users.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
{
|
|
name => 'loginmethod',
|
|
desc => 'The type of login authentication to use:
|
|
<dl>
|
|
<dt>DB</dt>
|
|
<dd>
|
|
Bugzilla\'s builtin authentication. This is the most common
|
|
choice.
|
|
</dd>
|
|
<dt>LDAP</dt>
|
|
<dd>
|
|
LDAP authentication using an LDAP server. This method is
|
|
experimental; please see the Bugzilla documentation for more
|
|
information. Using this method requires additional parameters
|
|
to be set above.
|
|
</dd>
|
|
</dl>',
|
|
type => 's',
|
|
choices => [ 'DB', 'LDAP' ],
|
|
default => 'DB',
|
|
checker => \&check_loginmethod
|
|
},
|
|
|
|
{
|
|
name => 'mostfreqthreshold',
|
|
desc => 'The minimum number of duplicates a bug needs to show up on the ' .
|
|
'<a href="duplicates.cgi">most frequently reported bugs page</a>. ' .
|
|
'If you have a large database and this page takes a long time to ' .
|
|
'load, try increasing this number.',
|
|
type => 't',
|
|
default => '2'
|
|
},
|
|
|
|
{
|
|
name => 'mybugstemplate',
|
|
desc => 'This is the URL to use to bring up a simple \'all of my bugs\' ' .
|
|
'list for a user. %userid% will get replaced with the login ' .
|
|
'name of a user.',
|
|
type => 't',
|
|
default => 'buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=%userid%&emailtype1=exact&emailassigned_to1=1&emailreporter1=1'
|
|
},
|
|
|
|
{
|
|
name => 'shutdownhtml',
|
|
desc => 'If this field is non-empty, then Bugzilla will be completely ' .
|
|
'disabled and this text will be displayed instead of all the ' .
|
|
'Bugzilla pages.',
|
|
type => 'l',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'sendmailnow',
|
|
desc => 'If this is on, Bugzilla will tell sendmail to send any e-mail ' .
|
|
'immediately. If you have a large number of users with a large ' .
|
|
'amount of e-mail traffic, enabling this option may dramatically ' .
|
|
'slow down Bugzilla. Best used for smaller installations of ' .
|
|
'Bugzilla.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'passwordmail',
|
|
desc => 'The email that gets sent to people to tell them their password.' .
|
|
'Within this text, %mailaddress% gets replaced by the person\'s ' .
|
|
'email address, %login% gets replaced by the person\'s login ' .
|
|
'(usually the same thing), and %password% gets replaced by their ' .
|
|
'password. %<i>anythingelse</i>% gets replaced by the ' .
|
|
'definition of that parameter (as defined on this page).',
|
|
type => 'l',
|
|
default => 'From: bugzilla-daemon
|
|
To: %mailaddress%
|
|
Subject: Your Bugzilla password.
|
|
|
|
To use the wonders of Bugzilla, you can use the following:
|
|
|
|
E-mail address: %login%
|
|
Password: %password%
|
|
|
|
To change your password, go to:
|
|
%urlbase%userprefs.cgi
|
|
'
|
|
},
|
|
|
|
{
|
|
name => 'newchangedmail',
|
|
desc => 'The email that gets sent to people when a bug changes. Within ' .
|
|
'this text, %to% gets replaced with the e-mail address of the ' .
|
|
'person recieving the mail. %bugid% gets replaced by the bug ' .
|
|
'number. %diffs% gets replaced with what\'s changed. ' .
|
|
'%neworchanged% is "New:" if this mail is reporting a new bug or ' .
|
|
'empty if changes were made to an existing one. %summary% gets ' .
|
|
'replaced by the summary of this bug. %reasonsheader% is ' .
|
|
'replaced by an abbreviated list of reasons why the user is ' .
|
|
'getting the email, suitable for use in an email header (such ' .
|
|
'as X-Bugzilla-Reason). %reasonsbody% is replaced by text that ' .
|
|
'explains why the user is getting the email in more user ' .
|
|
'friendly text than %reasonsheader%. %<i>anythingelse</i>% gets ' .
|
|
'replaced by the definition of that parameter (as defined on ' .
|
|
'this page).',
|
|
type => 'l',
|
|
default => 'From: bugzilla-daemon
|
|
To: %to%
|
|
Subject: [Bug %bugid%] %neworchanged%%summary%
|
|
X-Bugzilla-Reason: %reasonsheader%
|
|
|
|
%urlbase%show_bug.cgi?id=%bugid%
|
|
|
|
%diffs%
|
|
|
|
--%space%
|
|
Configure bugmail: %urlbase%userprefs.cgi?tab=email
|
|
%reasonsbody%'
|
|
},
|
|
|
|
{
|
|
name => 'whinedays',
|
|
desc => 'The number of days that we\'ll let a bug sit untouched in a NEW ' .
|
|
'state before our cronjob will whine at the owner.',
|
|
type => 't',
|
|
default => 7
|
|
},
|
|
|
|
{
|
|
name => 'whinemail',
|
|
desc => 'The email that gets sent to anyone who has a NEW bug that '.
|
|
'hasn\'t been touched for more than <b>whinedays</b>. Within ' .
|
|
'this text, %email% gets replaced by the offender\'s email ' .
|
|
'address. %userid% gets replaced by the offender\'s bugzilla ' .
|
|
'login (which, in most installations, is the same as the email ' .
|
|
' address.) %<i>anythingelse</i>% gets replaced by the definition ' .
|
|
'of that parameter (as defined on this page).<p> It is a good ' .
|
|
'idea to make sure this message has a valid From: address, so ' .
|
|
'that if the mail bounces, a real person can know that there are ' .
|
|
'bugs assigned to an invalid address.',
|
|
type => 'l',
|
|
default => 'From: %maintainer%
|
|
To: %email%
|
|
Subject: Your Bugzilla buglist needs attention.
|
|
|
|
[This e-mail has been automatically generated.]
|
|
|
|
You have one or more bugs assigned to you in the Bugzilla
|
|
bugsystem (%urlbase%) that require
|
|
attention.
|
|
|
|
All of these bugs are in the NEW state, and have not been touched
|
|
in %whinedays% days or more. You need to take a look at them, and
|
|
decide on an initial action.
|
|
|
|
Generally, this means one of three things:
|
|
|
|
(1) You decide this bug is really quick to deal with (like, it\'s INVALID),
|
|
and so you get rid of it immediately.
|
|
(2) You decide the bug doesn\'t belong to you, and you reassign it to someone
|
|
else. (Hint: if you don\'t know who to reassign it to, make sure that
|
|
the Component field seems reasonable, and then use the "Reassign bug to
|
|
owner of selected component" option.)
|
|
(3) You decide the bug belongs to you, but you can\'t solve it this moment.
|
|
Just use the "Accept bug" command.
|
|
|
|
To get a list of all NEW bugs, you can use this URL (bookmark it if you like!):
|
|
|
|
%urlbase%buglist.cgi?bug_status=NEW&assigned_to=%userid%
|
|
|
|
Or, you can use the general query page, at
|
|
%urlbase%query.cgi.
|
|
|
|
Appended below are the individual URLs to get to all of your NEW bugs that
|
|
haven\'t been touched for a week or more.
|
|
|
|
You will get this message once a day until you\'ve dealt with these bugs!
|
|
|
|
'
|
|
},
|
|
|
|
{
|
|
name => 'defaultquery',
|
|
desc => 'This is the default query that initially comes up when you ' .
|
|
'submit a bug. It\'s in URL parameter format, which makes it ' .
|
|
'hard to read. Sorry!',
|
|
type => 't',
|
|
default => 'bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailqa_contact2=1&order=Importance&long_desc_type=substring'
|
|
},
|
|
|
|
{
|
|
name => 'letsubmitterchoosepriority',
|
|
desc => 'If this is on, then people submitting bugs can choose an ' .
|
|
'initial priority for that bug. If off, then all bugs initially ' .
|
|
'have the default priority selected below.',
|
|
type => 'b',
|
|
default => 1
|
|
},
|
|
|
|
{
|
|
name => 'defaultpriority',
|
|
desc => 'This is the priority that newly entered bugs are set to.',
|
|
type => 't',
|
|
default => 'P2',
|
|
checker => \&check_priority
|
|
},
|
|
|
|
{
|
|
name => 'usetargetmilestone',
|
|
desc => 'Do you wish to use the Target Milestone field?',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'musthavemilestoneonaccept',
|
|
desc => 'If you are using Target Milestone, do you want to require that ' .
|
|
'the milestone be set in order for a user to ACCEPT a bug?',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'useqacontact',
|
|
desc => 'Do you wish to use the QA Contact field?',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'usestatuswhiteboard',
|
|
desc => 'Do you wish to use the Status Whiteboard field?',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'usebrowserinfo',
|
|
desc => 'Do you want bug reports to be assigned an OS & Platform based ' .
|
|
'on the browser the user makes the report from?',
|
|
type => 'b',
|
|
default => 1
|
|
},
|
|
|
|
{
|
|
name => 'usevotes',
|
|
desc => 'Do you wish to allow users to vote for bugs? Note that in order ' .
|
|
'for this to be effective, you will have to change the maximum ' .
|
|
'votes allowed in a product to be non-zero in ' .
|
|
'<a href="editproducts.cgi">the product edit page</a>.',
|
|
type => 'b',
|
|
default => 1
|
|
},
|
|
|
|
{
|
|
name => 'usebugaliases',
|
|
desc => 'Do you wish to use bug aliases, which allow you to assign bugs ' .
|
|
'an easy-to-remember name by which you can refer to them?',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'webdotbase',
|
|
desc => 'It is possible to show graphs of dependent bugs. You may set ' .
|
|
'this parameter to any of the following:
|
|
<ul>
|
|
<li>A complete file path to \'dot\' (part of <a
|
|
href="http://www.graphviz.org">GraphViz</a>) will generate the graphs
|
|
locally.</li>
|
|
<li>A URL prefix pointing to an installation of the <a
|
|
href="http://www.research.att.com/~north/cgi-bin/webdot.cgi">webdot
|
|
package</a> will generate the graphs remotely.</li>
|
|
<li>A blank value will disable dependency graphing.</li>
|
|
</ul>
|
|
The default value is a publically-accessible webdot server. If you change
|
|
this value, make certain that the webdot server can read files from your
|
|
data/webdot directory. On Apache you do this by editing the .htaccess file,
|
|
for other systems the needed measures may vary. You can run checksetup.pl
|
|
to recreate the .htaccess file if it has been lost.',
|
|
type => 't',
|
|
default => 'http://www.research.att.com/~north/cgi-bin/webdot.cgi/%urlbase%',
|
|
checker => \&check_webdotbase
|
|
},
|
|
|
|
{
|
|
name => 'emailregexp',
|
|
desc => 'This defines the regexp to use for legal email addresses. The ' .
|
|
'default tries to match fully qualified email addresses. Another ' .
|
|
'popular value to put here is <tt>^[^@]+$</tt>, which means ' .
|
|
'"local usernames, no @ allowed."',
|
|
type => 't',
|
|
default => q:^[^@]+@[^@]+\\.[^@]+$:,
|
|
checker => \&check_regexp
|
|
},
|
|
|
|
{
|
|
name => 'emailregexpdesc',
|
|
desc => 'This describes in english words what kinds of legal addresses ' .
|
|
'are allowed by the <tt>emailregexp</tt> param.',
|
|
type => 'l',
|
|
default => 'A legal address must contain exactly one \'@\', and at least ' .
|
|
'one \'.\' after the @.'
|
|
},
|
|
|
|
{
|
|
name => 'emailsuffix',
|
|
desc => 'This is a string to append to any email addresses when actually ' .
|
|
'sending mail to that address. It is useful if you have changed ' .
|
|
'the <tt>emailregexp</tt> param to only allow local usernames, ' .
|
|
'but you want the mail to be delivered to username@my.local.hostname.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'createemailregexp',
|
|
desc => 'This defines the regexp to use for email addresses that are ' .
|
|
'permitted to self-register using a "New Account" feature. The ' .
|
|
'default (.*) permits any account matching the emailregexp ' .
|
|
'to be created. If this parameter is left blank, no users ' .
|
|
'will be permitted to create their own accounts and all accounts ' .
|
|
'will have to be created by an administrator',
|
|
type => 't',
|
|
default => q:.*:,
|
|
checker => \&check_regexp
|
|
},
|
|
|
|
{
|
|
name => 'voteremovedmail',
|
|
desc => 'This is a mail message to send to anyone who gets a vote removed ' .
|
|
'from a bug for any reason. %to% gets replaced by the person who ' .
|
|
'used to be voting for this bug. %bugid% gets replaced by the ' .
|
|
'bug number. %reason% gets replaced by a short reason describing ' .
|
|
'why the vote(s) were removed. %votesremoved%, %votesold% and ' .
|
|
'%votesnew% is the number of votes removed, before and after ' .
|
|
'respectively. %votesremovedtext%, %votesoldtext% and ' .
|
|
'%votesnewtext% are these as sentences, eg "You had 2 votes on ' .
|
|
'this bug." %count% is also supported for backwards ' .
|
|
'compatibility. %<i>anythingelse</i>% gets replaced by the ' .
|
|
'definition of that parameter (as defined on this page).',
|
|
type => 'l',
|
|
default => 'From: bugzilla-daemon
|
|
To: %to%
|
|
Subject: [Bug %bugid%] Some or all of your votes have been removed.
|
|
|
|
Some or all of your votes have been removed from bug %bugid%.
|
|
|
|
%votesoldtext%
|
|
|
|
%votesnewtext%
|
|
|
|
Reason: %reason%
|
|
|
|
%urlbase%show_bug.cgi?id=%bugid%
|
|
'
|
|
},
|
|
|
|
{
|
|
name => 'allowbugdeletion',
|
|
desc => 'The pages to edit products and components and versions can delete ' .
|
|
'all associated bugs when you delete a product (or component or ' .
|
|
'version). Since that is a pretty scary idea, you have to turn on ' .
|
|
'this option before any such deletions will ever happen.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'allowemailchange',
|
|
desc => 'Users can change their own email address through the preferences. ' .
|
|
'Note that the change is validated by emailing both addresses, so ' .
|
|
'switching this option on will not let users use an invalid address.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'allowuserdeletion',
|
|
desc => 'The pages to edit users can also let you delete a user. But there ' .
|
|
'is no code that goes and cleans up any references to that user in ' .
|
|
'other tables, so such deletions are kinda scary. So, you have to ' .
|
|
'turn on this option before any such deletions will ever happen.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'browserbugmessage',
|
|
desc => 'If bugzilla gets unexpected data from the browser, in addition to ' .
|
|
'displaying the cause of the problem, it will output this HTML as ' .
|
|
'well.',
|
|
type => 'l',
|
|
default => 'this may indicate a bug in your browser.'
|
|
},
|
|
|
|
{
|
|
name => 'commentonaccept',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'he accepts the bug',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonclearresolution',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug\'s resolution is cleared',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonconfirm',
|
|
desc => 'If this option is on, the user needs to enter a short comment ' .
|
|
'when confirming a bug',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonresolve',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is resolved',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonreassign',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is reassigned',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonreassignbycomponent',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is reassigned by component',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
{
|
|
name => 'commentonreopen',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is reopened',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonverify',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is verified',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonclose',
|
|
desc => 'If this option is on, the user needs to enter a short comment if ' .
|
|
'the bug is closed',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'commentonduplicate',
|
|
desc => 'If this option is on, the user needs to enter a short comment ' .
|
|
'if the bug is marked as duplicate',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'supportwatchers',
|
|
desc => 'Support one user watching (ie getting copies of all related ' .
|
|
'email about) another\'s bugs. Useful for people going on ' .
|
|
'vacation, and QA folks watching particular developers\' bugs',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'move-enabled',
|
|
desc => 'If this is on, Bugzilla will allow certain people to move bugs ' .
|
|
'to the defined database.',
|
|
type => 'b',
|
|
default => 0
|
|
},
|
|
|
|
{
|
|
name => 'move-button-text',
|
|
desc => 'The text written on the Move button. Explain where the bug is ' .
|
|
'being moved to.',
|
|
type => 't',
|
|
default => 'Move To Bugscape'
|
|
},
|
|
|
|
{
|
|
name => 'move-to-url',
|
|
desc => 'The URL of the database we allow some of our bugs to be moved to.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'move-to-address',
|
|
desc => 'To move bugs, an email is sent to the target database. This is ' .
|
|
'the email address that database uses to listen for incoming bugs.',
|
|
type => 't',
|
|
default => 'bugzilla-import'
|
|
},
|
|
|
|
{
|
|
name => 'moved-from-address',
|
|
desc => 'To move bugs, an email is sent to the target database. This is ' .
|
|
'the email address from which this mail, and error messages are ' .
|
|
'sent.',
|
|
type => 't',
|
|
default => 'bugzilla-admin'
|
|
},
|
|
|
|
{
|
|
name => 'movers',
|
|
desc => 'A list of people with permission to move bugs and reopen moved ' .
|
|
'bugs (in case the move operation fails).',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'moved-default-product',
|
|
desc => 'Bugs moved from other databases to here are assigned to this ' .
|
|
'product.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'moved-default-component',
|
|
desc => 'Bugs moved from other databases to here are assigned to this ' .
|
|
'component.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
# The maximum size (in bytes) for patches and non-patch attachments.
|
|
# The default limit is 1000KB, which is 24KB less than mysql's default
|
|
# maximum packet size (which determines how much data can be sent in a
|
|
# single mysql packet and thus how much data can be inserted into the
|
|
# database) to provide breathing space for the data in other fields of
|
|
# the attachment record as well as any mysql packet overhead (I don't
|
|
# know of any, but I suspect there may be some.)
|
|
|
|
{
|
|
name => 'maxpatchsize',
|
|
desc => 'The maximum size (in kilobytes) of patches. Bugzilla will not ' .
|
|
'accept patches greater than this number of kilobytes in size.' .
|
|
'To accept patches of any size (subject to the limitations of ' .
|
|
'your server software), set this value to zero.',
|
|
type => 't',
|
|
default => '1000',
|
|
checker => \&check_numeric
|
|
},
|
|
|
|
{
|
|
name => 'maxattachmentsize',
|
|
desc => 'The maximum size (in kilobytes) of non-patch attachments. ' .
|
|
'Bugzilla will not accept attachments greater than this number' .
|
|
'of kilobytes in size. To accept attachments of any size ' .
|
|
'(subject to the limitations of your server software), set this ' .
|
|
'value to zero.',
|
|
type => 't',
|
|
default => '1000',
|
|
checker => \&check_numeric
|
|
},
|
|
|
|
{
|
|
name => 'insidergroup',
|
|
desc => 'The name of the group of users who can see/change private ' .
|
|
'comments and attachments.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'timetrackinggroup',
|
|
desc => 'The name of the group of users who can see/change time tracking ' .
|
|
'information.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'loginnetmask',
|
|
desc => 'The number of bits for the netmask used if a user chooses to ' .
|
|
'allow a login to be valid for more than a single IP. Setting ' .
|
|
'this to 32 disables this feature.<br>' .
|
|
'Note that enabling this may decrease the security of your system.',
|
|
type => 't',
|
|
default => '32',
|
|
checker => \&check_netmask
|
|
},
|
|
|
|
{
|
|
name => 'requirelogin',
|
|
desc => 'If this option is set, all access to the system beyond the ' .
|
|
' front page will require a login. No anonymous users will ' .
|
|
' be permitted.',
|
|
type => 'b',
|
|
default => '0'
|
|
},
|
|
|
|
{
|
|
name => 'usermatchmode',
|
|
desc => 'Allow match strings to be entered for user names when entering ' .
|
|
'and editing bugs. <p>' .
|
|
'"off" disables matching,<br> ' .
|
|
'"wildcard" allows only wildcards,<br> ' .
|
|
'and "search" allows both wildcards and substring (freetext) ' .
|
|
'matches.',
|
|
type => 's',
|
|
choices => ['off', 'wildcard', 'search'],
|
|
default => 'off'
|
|
},
|
|
|
|
{
|
|
name => 'maxusermatches',
|
|
desc => 'Search for no more than this many matches. <br>'.
|
|
'If set to "1", no users will be displayed on ambiguous matches. '.
|
|
'This is useful for user privacy purposes. <br>'.
|
|
'A value of zero means no limit.',
|
|
type => 't',
|
|
default => '1000',
|
|
checker => \&check_numeric
|
|
},
|
|
|
|
{
|
|
name => 'confirmuniqueusermatch',
|
|
desc => 'Whether a confirmation screen should be displayed when only ' .
|
|
'one user matches a search entry',
|
|
type => 'b',
|
|
default => 1,
|
|
},
|
|
|
|
# Added for Patch Viewer stuff (attachment.cgi?action=diff)
|
|
{
|
|
name => 'cvsroot',
|
|
desc => 'The <a href="http://www.cvshome.org">CVS</a> root that most ' .
|
|
'users of your system will be using for "cvs diff". Used in ' .
|
|
'Patch Viewer ("Diff" option on patches) to figure out where ' .
|
|
'patches are rooted even if users did the "cvs diff" from ' .
|
|
'different places in the directory structure. (NOTE: if your ' .
|
|
'CVS repository is remote and requires a password, you must ' .
|
|
'either ensure the Bugzilla user has done a "cvs login" or ' .
|
|
'specify the password ' .
|
|
'<a href="http://www.cvshome.org/docs/manual/cvs_2.html#SEC26">as ' .
|
|
'part of the CVS root.</a>) Leave this blank if you have no ' .
|
|
'CVS repository.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
{
|
|
name => 'cvsroot_get',
|
|
desc => 'The CVS root Bugzilla will be using to get patches from. ' .
|
|
'Some installations may want to mirror their CVS repository on ' .
|
|
'the Bugzilla server or even have it on that same server, and ' .
|
|
'thus the repository can be the local file system (and much ' .
|
|
'faster). Make this the same as cvsroot if you don\'t ' .
|
|
'understand what this is (if cvsroot is blank, make this blank ' .
|
|
'too).',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
|
|
{
|
|
name => 'bonsai_url',
|
|
desc => 'The URL to a ' .
|
|
'<a href="http://www.mozilla.org/bonsai.html">Bonsai</a> ' .
|
|
'server containing information about your CVS repository. ' .
|
|
'Patch Viewer will use this information to create links to ' .
|
|
'bonsai\'s blame for each section of a patch (it will append ' .
|
|
'"/cvsblame.cgi?..." to this url). Leave this blank if you ' .
|
|
'don\'t understand what this is.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'lxr_url',
|
|
desc => 'The URL to an ' .
|
|
'<a href="http://sourceforge.net/projects/lxr">LXR</a> server ' .
|
|
'that indexes your CVS repository. Patch Viewer will use this ' .
|
|
'information to create links to LXR for each file in a patch. ' .
|
|
'Leave this blank if you don\'t understand what this is.',
|
|
type => 't',
|
|
default => ''
|
|
},
|
|
|
|
{
|
|
name => 'lxr_root',
|
|
desc => 'Some LXR installations do not index the CVS repository from ' .
|
|
'the root--' .
|
|
'<a href="http://lxr.mozilla.org/mozilla">Mozilla\'s</a>, for ' .
|
|
'example, starts indexing under <code>mozilla/</code>. This ' .
|
|
'means URLs are relative to that extra path under the root. ' .
|
|
'Enter this if you have a similar situation. Leave it blank ' .
|
|
'if you don\'t know what this is.',
|
|
type => 't',
|
|
default => '',
|
|
},
|
|
);
|
|
|
|
1;
|
|
|