1
[%# 1.0@bugzilla.org %]
2
[%# The contents of this file are subject to the Mozilla Public
3
# License Version 1.1 (the "License"); you may not use this file
4
# except in compliance with the License. You may obtain a copy of
5
# the License at http://www.mozilla.org/MPL/
7
# Software distributed under the License is distributed on an "AS
8
# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
9
# implied. See the License for the specific language governing
10
# rights and limitations under the License.
12
# The Original Code is the Bugzilla Bug Tracking System.
14
# The Initial Developer of the Original Code is Netscape Communications
15
# Corporation. Portions created by Netscape are
16
# Copyright (C) 1998 Netscape Communications Corporation. All
19
# Contributor(s): Dave Miller <justdave@bugzilla.org>
20
# Frédéric Buclin <LpSolit@gmail.com>
24
title = "Required Settings"
25
desc = "Settings that are required for proper operation of $terms.Bugzilla"
29
maintainer => "The email address of the person who maintains this installation " _
30
"of ${terms.Bugzilla}.",
32
urlbase => "The URL that is the common initial leading part of all $terms.Bugzilla " _
35
docs_urlbase => "The URL that is the common initial leading part of all " _
36
"$terms.Bugzilla documentation URLs. " _
37
"It may be an absolute URL, or a URL relative to urlbase " _
39
"Leave this empty to suppress links to the documentation.",
41
sslbase => "The URL that is the common initial leading part of all HTTPS " _
42
"(SSL) $terms.Bugzilla URLs.",
44
ssl => "Controls when $terms.Bugzilla should enforce sessions to use HTTPS by " _
45
"using <tt>sslbase</tt>.",
47
cookiedomain => "The domain for $terms.Bugzilla cookies. Normally blank. " _
48
"If your website is at 'www.foo.com', setting this to " _
49
"'.foo.com' will also allow 'bar.foo.com' to access " _
50
"$terms.Bugzilla cookies. This is useful if you have more than " _
51
"one hostname pointing at the same web server, and you " _
52
"want them to share the $terms.Bugzilla cookie.",
54
cookiepath => "Path, relative to your web document root, to which to restrict " _
55
"$terms.Bugzilla cookies. Normally this is the URI portion of your URL " _
56
"base. Begin with a / (single slash mark). For instance, if " _
57
"$terms.Bugzilla serves from 'http://www.somedomain.com/bugzilla/', set " _
58
"this parameter to /bugzilla/. Setting it to / will allow " _
59
"all sites served by this web server or virtual host to read " _
60
"$terms.Bugzilla cookies.",
62
timezone => "The timezone that your database server lives in. If set to '', " _
63
"then the timezone will not be displayed with the timestamps.",
65
utf8 => "Use UTF-8 (Unicode) encoding for all text in ${terms.Bugzilla}. New " _
66
"installations should set this to true to avoid character encoding " _
67
"problems. <strong>Existing databases should set this to true " _
68
" only after the data has been converted from existing legacy " _
69
" character encodings to UTF-8, using the " _
70
" <kbd>contrib/recode.pl</kbd> script</strong>. <br><br> Note " _
71
" that if you turn this parameter from "off" to " _
72
" "on", you must re-run checksetup.pl immediately " _
75
shutdownhtml => "If this field is non-empty, then $terms.Bugzilla will be completely " _
76
"disabled and this text will be displayed instead of all the " _
77
"$terms.Bugzilla pages.",
79
announcehtml => "If this field is non-empty, then $terms.Bugzilla will " _
80
"display whatever is in this field at the top of every " _
81
"HTML page. The HTML you put in this field is not " _
82
"wrapped or enclosed in anything; you might want to " _
83
"wrap it inside a <tt><div></tt>. Give the div " _
84
"<em>id=message</em> to get green text inside a " _
85
"red box, or <em>class=bz_private</em> for dark " _
86
"red on a red background. Anything defined in " _
87
"<tt>skins/standard/global.css</tt> or " _
88
"<tt>skins/custom/global.css</tt> will work. To get " _
89
"centered text, use <em>style=\"text-align: " _
92
proxy_url => "$terms.Bugzilla may have to access the web to get notifications about new " _
93
"releases, see the <tt>upgrade_notification</tt> parameter. In case you are " _
94
"behind a proxy, it may be necessary to enter its URL if the web server " _
95
"group cannot access the HTTP_PROXY environment variable. If you have to " _
96
"authenticate, use the <code>http://user:pass@proxy_url/</code> syntax.",
98
upgrade_notification => "<p>$terms.Bugzilla can inform you when a new release is available. " _
99
"The notification will appear on the $terms.Bugzilla homepage, " _
100
"for administrators only.</p>" _
101
"<ul><li>'development_snapshot' notifies you about the latest " _
102
"release on the trunk, i.e. development snapshots.</li>" _
103
"<li>'latest_stable_release' notifies you about the most recent release " _
104
"available on the most recent stable branch. This branch may be " _
105
"different from the branch your installation is based on.</li>" _
106
"<li>'stable_branch_release' notifies you only about new releases " _
107
"corresponding to the branch your installation is based on. " _
108
"If you are running a release candidate, you will get " _
109
"a notification for newer release candidates too.</li>" _
110
"<li>'disabled' will never notify you about new releases and no " _
111
"connection will be established to a remote server.</li></ul>" }