Start writing a new settings page based on hoplite.
[bugdar.git] / admin / setting.php
1 <?php
2 /*=====================================================================*\
3 || ###################################################################
4 || # Bugdar
5 || # Copyright (c)2002-2007 Blue Static
6 || #
7 || # This program is free software; you can redistribute it and/or modify
8 || # it under the terms of the GNU General Public License as published by
9 || # the Free Software Foundation; version 2 of the License.
10 || #
11 || # This program is distributed in the hope that it will be useful, but
12 || # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 || # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 || # more details.
15 || #
16 || # You should have received a copy of the GNU General Public License along
17 || # with this program; if not, write to the Free Software Foundation, Inc.,
18 || # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
19 || ###################################################################
20 \*=====================================================================*/
21
22 require_once('./global.php');
23 require_once('./includes/class_sort.php');
24 require_once('./includes/functions_datastore.php');
25
26 NavLinks::optionsPages();
27 $navigator->set_focus('tab', 'options', null);
28 $navigator->set_focus('link', 'options-pages-settings', 'options-pages');
29
30 if (!can_perform('canadmintools'))
31 {
32 admin_login();
33 }
34
35 // ###################################################################
36
37 if (empty($_REQUEST['do']))
38 {
39 $_REQUEST['do'] = 'modify';
40 }
41
42 // ###################################################################
43
44 if ($_POST['do'] == 'update')
45 {
46 $updates = array();
47 foreach ($bugsys->in['setting'] AS $varname => $value)
48 {
49 if (is_array($value))
50 {
51 if ($varname == 'columnoptions')
52 {
53 $value = serialize($value);
54 }
55 else
56 {
57 $value = implode(',', $value);
58 }
59 }
60
61 $updates[] = "('" . $bugsys->escape($varname) . "', '" . $bugsys->escape($value) . "')";
62 }
63
64 $db->query("REPLACE INTO " . TABLE_PREFIX . "setting (varname, value) VALUES " . implode(',', $updates));
65
66 build_settings();
67
68 $admin->redirect('setting.php');
69 }
70
71 // ###################################################################
72
73 if ($_REQUEST['do'] == 'modify')
74 {
75 $admin->page_start(T('Settings'));
76
77 $admin->form_start('setting.php', 'update');
78
79 $IS_SETTINGS = true;
80
81 // ###################################################################
82 $admin->table_start();
83 $admin->table_head(T('General Options'));
84
85 // authmethod
86 $admin->row_span(T('Authentication Method'), 'thead');
87 $methods = $funct->scandir('./includes/auth/');
88 foreach ($methods[''] AS $path)
89 {
90 if (preg_match('#auth_(.*)\.php#', $path, $matches))
91 {
92 $admin->list_item(ucwords(str_replace('_', ' ', $matches[1])), $matches[1], ($matches[1] == $bugsys->options['authmethod']));
93 }
94 }
95 $admin->row_list(T('The authentication class to use to validate cookie data and longins. You may need to edit the actual file for certain authentication systems.'), 'setting[authmethod]');
96
97
98 // webmasteremail
99 $admin->row_span(T('Webmaster Email Address'), 'thead');
100 $admin->row_input(T('The email address from which emails will be sent out.'), 'setting[webmasteremail]', $bugsys->options['webmasteremail']);
101
102 // trackertitle
103 $admin->row_span(T('Tracker Title'), 'thead');
104 $admin->row_input(T('The global name of the bug tracker. Example: Blue Static Bug Tracker'), 'setting[trackertitle]', $bugsys->options['trackertitle']);
105
106 // trackerurl
107 $admin->row_span(T('Tracker Base URL'), 'thead');
108 $admin->row_input(T('The base URL of the tracker. This is used when creating external links to the tracker. <strong>Be sure that this does not end in a trailing slash (&quot;/&quot;).</strong><br />Example: http://www.bluestatic.org/bugs'), 'setting[trackerurl]', $bugsys->options['trackerurl']);
109
110 // dateformat
111 $admin->row_span(T('Date Format'), 'thead');
112 $admin->row_input(T('Set the date format used for bug report and comment information. This is based on PHP\'s date() function.'), 'setting[dateformat]', $bugsys->options['dateformat']);
113
114 // defaulttimezone
115 $admin->row_span(T('Default Time Zone'), 'thead');
116 $admin->row_text(T('This controls the time zone that all unregistered users view the tracker with.'), construct_option_select('setting[defaulttimezone]', $bugsys->datef->fetch_timezone_list(), $bugsys->options['defaulttimezone']), $bugsys->options['defaulttimezone']);
117
118 // defaultlanguage
119 $admin->row_span(T('Default Language'), 'thead');
120 $admin->row_text(T('You can set the default language that all new users (and guests) will use.'), construct_option_select('setting[defaultlanguage]', Bugdar::$datastore['language'], $bugsys->options['defaultlanguage'], 'languageid', 'title'), $bugsys->options['defaultlanguage']);
121
122 // syndicateditems
123 $admin->row_span(T('Number of Syndicated Items'), 'thead');
124 $admin->row_input(T('The number of bugs to be syndicated at any one time by the Atom XML feed.'), 'setting[syndicateditems]', $bugsys->options['syndicateditems']);
125
126 // redirectheaders
127 $admin->row_span(T('Use Header Redirects'), 'thead');
128 $admin->row_yesno(T('Instead of displaying an intermediate page informing the user that their action was a success and a redirect is occurring, just send the user to the next screen using HTTP headers. This can save bandwidth.'), 'setting[redirectheaders]', $bugsys->options['redirectheaders']);
129
130 $admin->table_end();
131
132 // ###################################################################
133 $admin->table_start();
134 $admin->table_head(T('Bug Reporting Options'));
135
136 // allowhtml
137 $admin->row_span(T('Allow HTML in Bug Reports'), 'thead');
138 $admin->row_yesno(T('Set this to <em>yes</em> if you want to allow users to post raw HTML in their bug reports. This is <strong>very</strong> dangerous and it is not recommended.'), 'setting[allowhtml]', $bugsys->options['allowhtml']);
139
140 // defaultseverity
141 $admin->row_span(T('Default Severity'), 'thead');
142 $admin->row_text(T('The default severity that is selected when creating a new bug report.'), construct_option_select('setting[defaultseverity]', Bugdar::$datastore['severity'], $bugsys->options['defaultseverity'], 'severityid', 'severity'));
143
144 // defaultpriority
145 $admin->row_span(T('Default Priority'), 'thead');
146 $admin->row_text(T('The default priority that will be selected when creating a new bug report. Depending on your permission setup, the user may not be able to set this in a new report so this will act as the value.'), construct_option_select('setting[defaultpriority]', Bugdar::$datastore['priority'], $bugsys->options['defaultpriority'], 'priorityid', 'priority'));
147
148 // defaultstatus
149 $admin->row_span(T('Default Status'), 'thead');
150 $admin->row_text(T('The default default that is selected when creating a new bug report. If a user can not assign a status, this will be the one inserted into the database.'), construct_option_select('setting[defaultstatus]', Bugdar::$datastore['status'], $bugsys->options['defaultstatus'], 'statusid', 'status'));
151
152 // defaultresolve
153 $admin->row_span(T('Default Resolution'), 'thead');
154 $admin->row_text(T('This is the default bug resolution. If a user is not able to change this field, setting this will act as the default value.'), construct_option_select('setting[defaultresolve]', Bugdar::$datastore['resolution'], $bugsys->options['defaultresolve'], 'resolutionid', 'resolution'));
155
156 // defaultassign
157 $admin->row_span(T('Default Bug Assignment'), 'thead');
158 $admin->row_text(T('This is the default developer new bugs will be assigned to. If a user does not have permisssion to assign bugs, this will be the default. If you don\'t want any default assignment, leave this as <em>Not Selected</em>.'), construct_option_select('setting[defaultassign]', Bugdar::$datastore['assignto'], $bugsys->options['defaultassign'], 'userid', 'displayname', 0));
159
160 // defaultcomment
161 $admin->row_span(T('Default Comment Text'), 'thead');
162 $admin->row_textarea(T('If you wish to set a template for entering the initial comment of a bug report, then you may specify this here. However, the template will only take effect on the initial report/comment. Note: the template cannot be forced on the user as there is no way to validate it.'), 'setting[defaultcomment]', $bugsys->options['defaultcomment']);
163
164 $admin->table_end();
165
166 // ###################################################################
167 $admin->table_start();
168 $admin->table_head(T('Bug Listing Display Options'));
169
170 // hidestatuses
171 $admin->row_span(T('Hide Statuses on Bug Listings'), 'thead');
172 $admin->row_text(T('Here you can specify which statuses to hide on the bug list displays. Users have options in their controls to change this from these values, and this does not affect searches or the favorites list.'), construct_option_select('setting[hidestatuses]', Bugdar::$datastore['status'], $bugsys->options['hidestatuses'], 'statusid', 'status', 0, true));
173
174 // defaultsortkey
175 $admin->row_span(T('Default Sort Column'), 'thead');
176 $admin->row_text(T('Select the column to sort bugs by on listings. This is only a default setting which users can override in their preferences.'), construct_option_select('setting[defaultsortkey]', ListSorter::fetch_by_text(false), $bugsys->options['defaultsortkey']));
177
178 // defaultsortas
179 $admin->row_span(T('Default Sort Direction'), 'thead');
180 $admin->row_text(T('Specify the default direction to sort bugs in the selected column. This works with and follows the same rules as the Sort Column.'), construct_option_select('setting[defaultsortas]', ListSorter::fetch_as_text(false), $bugsys->options['defaultsortas']));
181
182 // columnoptions
183 $admin->row_span(T('Default Column Ordering Options'), 'thead');
184 $admin->row_text(T('Specify the order of the columns for bug listings. The value 0 disables the display of a column and if two or more columns have the same position number, they will be displayed in the same column.'), ConstructColumnOptionsSetting());
185
186 $admin->table_end();
187
188 // ###################################################################
189 $admin->table_start();
190 $admin->table_head(T('Pagination Options'));
191
192 // defaultpp
193 $admin->row_span(T('Default Per-Page Amount'), 'thead');
194 $admin->row_input(T('The number of items (e.g. bugs) to be displayed on a page by default. The user will have the option of over-riding these values.'), 'setting[defaultpp]', $bugsys->options['defaultpp']);
195
196 // maxpp
197 $admin->row_span(T('Maximum Per-Page Value'), 'thead');
198 $admin->row_input(T('To prevent your server from experiencing load problems, set the maximum per page limit. Specifying a value here will make sure any user-entered value will not be higher than this, preventing server load problems.'), 'setting[maxpp]', $bugsys->options['maxpp']);
199
200 // pagelinks
201 $admin->row_span(T('Number of Page Links'), 'thead');
202 $admin->row_input(T('The number of pages that will appear in the page navigation system on either side of the current page. Set this to 0 to display all pages.'), 'setting[pagelinks]', $bugsys->options['pagelinks']);
203
204 $admin->table_end();
205
206 // ###################################################################
207 if (DEVDEBUG)
208 {
209 $admin->table_start();
210 $admin->table_head('Untouchables');
211
212 // trackerversion
213 $admin->row_span('Version Number', 'thead');
214 $admin->row_input('Version Number', 'setting[trackerversion]', $bugsys->options['trackerversion']);
215 }
216
217 // ###################################################################
218 $admin->table_start();
219 $admin->row_submit();
220 $admin->table_end();
221 $admin->form_end();
222
223 $admin->page_end();
224 }
225
226 // ###################################################################
227 /**
228 * Helper function for the $bugsys->options['columnoptions'] setting
229 *
230 * @return string Setting HTML code
231 */
232 function ConstructColumnOptionsSetting()
233 {
234 global $bugsys;
235
236 $array = ($bugsys->options['columnoptions'] == null ? array('bugid' => 1, 'summary' => 2, 'userid' => 2, 'product' => 3, 'version' => 3, 'component' => 0, 'status' => 4, 'resolution' => 4, 'priority' => 5, 'severity' => 5, 'lastpost' => 6, 'votes' => 0) : $bugsys->options['columnoptions']);
237
238 $return = '<table cellspacing="2" cellpadding="1" border="0">';
239 foreach ($bugsys->columns AS $column => $mask)
240 {
241 $return .= '<tr><td><strong>' . $bugsys->columnNames["$column"] . '</strong></td><td><input type="text" name="setting[columnoptions][' . $column . ']" size="2" maxlength="2" class="input" value="' . intval($array["$column"]) . '" /></td></tr>';
242 }
243 $return .= '</table>';
244 return $return;
245 }
246