system.module 37.9 KB
Newer Older
Dries Buytaert's avatar
 
Dries Buytaert committed
1
<?php
2
// $Id$
Dries Buytaert's avatar
 
Dries Buytaert committed
3

Dries Buytaert's avatar
   
Dries Buytaert committed
4
5
6
7
8
/**
 * @file
 * Configuration system that lets administrators modify the workings of the site.
 */

Dries Buytaert's avatar
   
Dries Buytaert committed
9
10
11
12
/**
 * Implementation of hook_help().
 */
function system_help($section) {
Dries Buytaert's avatar
   
Dries Buytaert committed
13
  global $base_url;
Dries Buytaert's avatar
   
Dries Buytaert committed
14

15
  switch ($section) {
16
17
    case 'admin':
      return t('<p>Welcome to the administration section. Below are the most recent system events.</p>');
18
    case 'admin/settings':
19
      return t('<p>General configuration options for your site. Set up the name of the site, e-mail address used in mail-outs, clean URL options, caching, etc.</p>');
Dries Buytaert's avatar
   
Dries Buytaert committed
20
    case 'admin/themes':
21
      return t('<p>Select which themes are available to your users and specify the default theme. To configure site-wide display settings, click the "configure" task above. Alternately, to override these settings in a specific theme, click the "configure" link for the corresponding theme.</p>');
Dries Buytaert's avatar
   
Dries Buytaert committed
22
    case 'admin/themes/settings':
23
      return t('<p>These options control the default display settings for your entire site, across all themes. Unless they have been overridden by a specific theme, these settings will be used.</p>');
Dries Buytaert's avatar
   
Dries Buytaert committed
24
25
    case 'admin/themes/settings/'. arg(3):
      $theme = array_pop(explode('.', arg(3), 2));
26
      return t('<p>These options control the display settings for the <code>%template</code> theme. When your site is displayed using this theme, these settings will be used. By clicking "Reset to defaults," you can choose to use the <a href="%global">global settings</a> for this theme.</p>', array('%template' => $theme, '%global' => url('admin/themes/settings')));
Dries Buytaert's avatar
   
Dries Buytaert committed
27
    case 'admin/modules':
28
      return t('<p>Modules are plugins for Drupal that extend its core functionality. Here you can select which modules are enabled. Click on the name of the module in the navigation menu for their individual configuration pages. Once a module is enabled, new <a href="%permissions">permissions</a> might be made available. Modules can automatically be temporarily disabled to reduce server load when your site becomes extremely busy by enabling the throttle.module and checking throttle. The auto-throttle functionality must be enabled on the <a href="%throttle">throttle configuration page</a> after having enabled the throttle module.</p>', array('%permissions' => url('admin/access/permissions'), '%throttle' => url('admin/settings/throttle')));
Dries Buytaert's avatar
   
Dries Buytaert committed
29
    case 'admin/help#system':
Dries Buytaert's avatar
   
Dries Buytaert committed
30
      return t("
Dries Buytaert's avatar
   
Dries Buytaert committed
31
32
33
34
35
36
37
      <p>Drupal comes with system-wide defaults but the setting-module provides control over many Drupal preferences, behaviours including visual and operational settings.</p>
      <h3><a id=\"cron\">Cron</a></h3>
      <p>Some modules require regularly scheduled actions, such as cleaning up logfiles.  Cron, which stands for chronograph, is a periodic command scheduler executing commands at intervals specified in seconds.  It can be used to control the execution of daily, weekly and monthly jobs (or anything with a period measured in seconds).   Automating tasks is one of the best ways to keep a system running smoothly, and if most of your administration does not require your direct involvement, cron is an ideal solution.</p>
      <p>The recommended way to set up your cron system is to set up a Unix/Linux crontab entry (see \"man crontab\") that frequently visits %cron-link.  Note that cron does not guarantee the commands will be executed at the specified interval.  However, Drupal will try its best to run the tasks as close to the specified intervals as possible.  The more you visit cron.php, the more accurate cron will be.</p>
      <p>If your hosting company does not allow you to set up crontab entries, you can always ask someone else to set up an entry for you. After all, virtually any Unix/Linux machine with access to the internet can set up a crontab entry to frequently visit %cron-link.</p>
      <p>For the Unix/Linux crontab itself, use a browser like <a href=\"%lynx\">lynx</a> or <a href=\"%wget\">wget</a> but make sure the process terminates: either use <code>/usr/bin/lynx -source %base_url/cron.php</code> or <code>/usr/bin/wget -o /dev/null -O /dev/null %cron-link</code>.  Take a look at the example scripts in the <code>scripts</code>-directory. Make sure to adjust them to fit your needs.  A good crontab line to run the cron script once every hour would be:
      <pre>     00 * * * * /home/www/drupal/scripts/cron-lynx.sh</pre>
38
      Note that it is essential to access <code>cron.php</code> using a browser on the web site's domain; do not run it using command line PHP and avoid using <code>localhost</code> or <code>127.0.0.1</code> or some of the environment variables will not be set correctly and features may not work as expected.</p>", array('%base_url' => $base_url, '%cron-link' => "<a href=\"$base_url/cron.php\">$base_url/cron.php</a>", '%lynx' => 'http://lynx.browser.org', '%wget' => 'http://www.gnu.org/software/wget/wget.html' ));
Dries Buytaert's avatar
   
Dries Buytaert committed
39
    case 'admin/modules#description':
40
      return t('Handles general site configuration for administrators.');
41
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
42
43
}

Dries Buytaert's avatar
   
Dries Buytaert committed
44
45
46
/**
 * Implementation of hook_perm().
 */
Dries Buytaert's avatar
 
Dries Buytaert committed
47
function system_perm() {
48
  return array('administer site configuration', 'access administration pages', 'bypass input data check');
Dries Buytaert's avatar
   
Dries Buytaert committed
49
50
}

Dries Buytaert's avatar
   
Dries Buytaert committed
51
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
52
 * Implementation of hook_menu().
Dries Buytaert's avatar
   
Dries Buytaert committed
53
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
54
function system_menu($may_cache) {
Dries Buytaert's avatar
   
Dries Buytaert committed
55
  $items = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
56

Dries Buytaert's avatar
   
Dries Buytaert committed
57
58
59
60
61
62
  if ($may_cache) {
    $items[] = array('path' => 'system/files', 'title' => t('file download'),
      'callback' => 'file_download',
      'access' => TRUE,
      'type' => MENU_CALLBACK);

63
64
65
66
67
68
    // Clean URL tester
    $items[] = array('path' => 'system/test',
      'callback' => 'system_test',
      'access' => TRUE,
      'type' => MENU_CALLBACK);

Dries Buytaert's avatar
   
Dries Buytaert committed
69
70
    $access = user_access('administer site configuration');

71
72
    $items[] = array('path' => 'admin', 'title' => t('administer'),
      'access' => user_access('access administration pages'),
Dries Buytaert's avatar
   
Dries Buytaert committed
73
      'callback' => 'watchdog_overview',
74
75
      'weight' => 9);

Dries Buytaert's avatar
   
Dries Buytaert committed
76
77
78
79
    // Themes:
    $items[] = array('path' => 'admin/themes', 'title' => t('themes'),
      'callback' => 'system_themes', 'access' => $access);

Dries Buytaert's avatar
   
Dries Buytaert committed
80
    $items[] = array('path' => 'admin/themes/select', 'title' => t('list'),
Dries Buytaert's avatar
   
Dries Buytaert committed
81
82
83
84
85
86
87
88
89
90
91
92
93
      'callback' => 'system_themes', 'access' => $access,
      'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -1);

    $items[] = array('path' => 'admin/themes/settings', 'title' => t('configure'),
      'callback' => 'system_theme_settings', 'access' => $access,
      'type' => MENU_LOCAL_TASK);

    // Theme configuration subtabs
    $items[] = array('path' => 'admin/themes/settings/global', 'title' => t('global settings'),
      'callback' => 'system_theme_settings', 'access' => $access,
      'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -1);

    foreach (list_themes() as $theme) {
Dries Buytaert's avatar
   
Dries Buytaert committed
94
       $items[] = array('path' => 'admin/themes/settings/'. $theme->name, 'title' => $theme->name,
95
       'callback' => 'system_theme_settings', 'callback arguments' => array($theme->name), 'access' => $access,
Dries Buytaert's avatar
   
Dries Buytaert committed
96
97
98
99
100
101
102
103
104
105
       'type' => MENU_LOCAL_TASK);
    }

    // Modules:
    $items[] = array('path' => 'admin/settings', 'title' => t('settings'),
      'callback' => 'system_site_settings', 'access' => $access);
    foreach (module_list() as $name) {
      if (module_hook($name, 'settings')) {
        $items[] = array('path' => 'admin/settings/'. $name, 'title' => t($name));
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
106
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
107
108
    $items[] = array('path' => 'admin/modules', 'title' => t('modules'),
      'callback' => 'system_modules', 'access' => $access);
Dries Buytaert's avatar
   
Dries Buytaert committed
109
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
110
111

  return $items;
Dries Buytaert's avatar
 
Dries Buytaert committed
112
113
}

114
115
116
117
/**
 * Menu callback: dummy clean URL tester.
 */
function system_test() {
118
119
  variable_set('clean_url_ok', 1);
  exit;
120
121
}

Dries Buytaert's avatar
   
Dries Buytaert committed
122
123
124
125
126
/**
 * Implementation of hook_user().
 *
 * Allows users to individually set their theme and time zone.
 */
127
128
function system_user($type, $edit, &$user, $category = NULL) {
  if ($type == 'form' && $category == 'account') {
129
130
131
132
133
134
135
136
137
138
    $allthemes = list_themes();

    // list only active themes
    foreach ($allthemes as $key => $theme) {
      if ($theme->status) {
        $themes[$key] = $theme;
      }
    }

    if (count($themes) > 1) {
Dries Buytaert's avatar
   
Dries Buytaert committed
139
      $rows = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
140
      foreach ($themes as $key => $value) {
Dries Buytaert's avatar
   
Dries Buytaert committed
141
142
143
144
        $row = array();

        // Screenshot column.
        $screenshot = dirname($value->filename) .'/screenshot.png';
145
        $row[] = file_exists($screenshot) ? theme('image', $screenshot, t('Screenshot for %theme theme', array('%theme' => $value->name)), '', array('class' => 'screenshot'), false) : t('no screenshot');
Dries Buytaert's avatar
   
Dries Buytaert committed
146
147

        // Information field.
Dries Buytaert's avatar
   
Dries Buytaert committed
148
        $field = '<strong>'. $value->name .'</strong>';
Dries Buytaert's avatar
   
Dries Buytaert committed
149
150
151
152
153
154
155
156
157
158
159
160
161
162
        $row[] = $field;

        // Reset to follow site default theme if user selects the site default
        if ($key == variable_get('theme_default', 'bluemarine')) {
          $key = '';
          if ($edit['theme'] == variable_get('theme_default', 'bluemarine')) {
            $edit['theme'] = '';
          }
        }

        // Selected column.
        $row[] = array('data' => form_radio('', 'theme', $key, ($edit['theme'] == $key) ? 1 : 0), 'align' => 'center');

        $rows[] = $row;
Dries Buytaert's avatar
   
Dries Buytaert committed
163
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
164
165
      $header = array(t('Screenshot'), t('Name'), t('Selected'));
      $data[] = array('title' => t('Theme settings'), 'data' => form_item('', theme('table', $header, $rows), t('Selecting a different theme will change the look and feel of the site.')), 'weight' => 2);
Dries Buytaert's avatar
   
Dries Buytaert committed
166
    }
167

168
    if (variable_get('configurable_timezones', 1)) {
Steven Wittens's avatar
Steven Wittens committed
169
      $zones = _system_zonelist();
Steven Wittens's avatar
Steven Wittens committed
170
      $data[] = array('title' => t('Locale settings'), 'data' => form_select(t('Time zone'), 'timezone', strlen($edit['timezone']) ? $edit['timezone'] : variable_get('date_default_timezone', 0), $zones, t('Select your current local time. Dates and times throughout this site will be displayed using this time zone.')), 'weight' => 2);
Dries Buytaert's avatar
   
Dries Buytaert committed
171
    }
172
    return $data;
Dries Buytaert's avatar
   
Dries Buytaert committed
173
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
174
175
}

Steven Wittens's avatar
Steven Wittens committed
176
177
178
179
180
181
182
183
184
185
186
function _system_zonelist() {
  $timestamp = time();
  $zonelist = array(-11, -10, -9.5, -9, -8, -7, -6, -5, -4, -3.5, -3, -2, -1, 0, 1, 2, 3, 3.5, 4, 5, 5.5, 5.75, 6, 6.5, 7, 8, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.75, 13, 14);
  $zones = array();
  foreach ($zonelist as $offset) {
    $zone = $offset * 3600;
    $zones[$zone] = format_date($timestamp, 'custom', variable_get('date_format_long', 'l, F j, Y - H:i') . ' O', $zone);
  }
  return $zones;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
187
function system_view_general() {
188
  // General settings:
189
190
191
192
193
194
195
  $group  = form_textfield(t('Name'), 'site_name', variable_get('site_name', 'drupal'), 60, 70, t('The name of this web site.'));
  $group .= form_textfield(t('E-mail address'), 'site_mail', variable_get('site_mail', ini_get('sendmail_from')), 60, 128, t('A valid e-mail address for this website, used by the auto-mailer during registration, new password requests, notifications, etc.'));
  $group .= form_textfield(t('Slogan'), 'site_slogan', variable_get('site_slogan', ''), 60, 128, t('The slogan of this website. Some themes display a slogan when available.'));
  $group .= form_textarea(t('Mission'), 'site_mission', variable_get('site_mission', ''), 60, 5, t('Your site\'s mission statement or focus.'));
  $group .= form_textarea(t('Footer message'), 'site_footer', variable_get('site_footer', ''), 60, 5, t('This text will be displayed at the bottom of each page.  Useful for adding a copyright notice to your pages.'));
  $group .= form_textfield(t('Anonymous user'), 'anonymous', variable_get('anonymous', 'Anonymous'), 60, 70, t('The name used to indicate anonymous users.'));
  $group .= form_textfield(t('Default front page'), 'site_frontpage', variable_get('site_frontpage', 'node'), 60, 70, t('The home page displays content from this relative URL.  If you are not using clean URLs, specify the part after "?q=".  If unsure, specify "node".'));
196

197
198
199
200
201
202
  // We check for clean URL support using an image on the client side.
  $group .= form_radios(t('Clean URLs'), 'clean_url', variable_get('clean_url', 0), array(t('Disabled'), t('Enabled')), t('This option makes Drupal emit clean URLs (i.e. without <code>?q=</code> in the URL). You\'ll need <code>ModRewrite</code> support for this to work. See the <code>.htaccess</code> file in Drupal\'s top-level directory for more information.'));
  variable_set('clean_url_ok', 0);
  global $base_url;
  // We will use a random URL so there is no way a proxy or a browser could cache the "no such image" answer.
  $group .= '<img style="position: relative; left: -1000em;" src="'. $base_url. '/system/test/'. user_password(20) .'.png" alt="" />';
Dries Buytaert's avatar
   
Dries Buytaert committed
203

204
  $output = form_group_collapsible(t('General settings'), $group, TRUE);
Dries Buytaert's avatar
   
Dries Buytaert committed
205

206
  // Error handling:
Dries Buytaert's avatar
   
Dries Buytaert committed
207
208
  $period = drupal_map_assoc(array(3600, 10800, 21600, 32400, 43200, 86400, 172800, 259200, 604800, 1209600, 2419200), 'format_interval');
  $period['1000000000'] = t('Never');
209
210
  $group = form_textfield(t('Default 403 (access denied) page'), 'site_403', variable_get('site_403', ''), 60, 70, t('This page is displayed when the requested document is denied to the current user.  If you are not using clean URLs, specify the part after "?q=". If unsure, specify nothing.'));
  $group .= form_textfield(t('Default 404 (not found) page'), 'site_404', variable_get('site_404', ''), 60, 70, t('This page is displayed when no other content matches the requested document.  If you are not using clean URLs, specify the part after "?q=". If unsure, specify nothing.'));
Steven Wittens's avatar
Steven Wittens committed
211
  $group .= form_select(t('Error reporting'), 'error_level', variable_get('error_level', 1), array(t('Write errors to the log'), t('Write errors to the log and to the screen')), t('Where Drupal, PHP and SQL errors are logged. On a production server it is recommended that errors are only written to the error log. On a test server it can be helpful to write logs to the screen.'));
Dries Buytaert's avatar
   
Dries Buytaert committed
212
  $group .= form_select(t('Discard log entries older than'), 'watchdog_clear', variable_get('watchdog_clear', 604800), $period, t('The time log entries should be kept.  Older entries will be automatically discarded.  Requires crontab.'));
Dries Buytaert's avatar
   
Dries Buytaert committed
213

214
  $output .= form_group_collapsible(t('Error handling'), $group, TRUE);
Dries Buytaert's avatar
 
Dries Buytaert committed
215

216
  // Caching:
217
  $group  = form_radios(t('Page cache'), 'cache', variable_get('cache', CACHE_DISABLED), array(CACHE_DISABLED => t('Disabled (low-traffic sites)'), CACHE_ENABLED_STRICT => t('Strict (medium-traffic sites)'), CACHE_ENABLED_LOOSE => t('Loose (high-traffic sites)')), t("Drupal has a caching mechanism which stores dynamically generated web pages in a database.  By caching a web page, Drupal does not have to create the page each time someone wants to view it, instead it takes only one SQL query to display it, reducing response time and the server's load.  Only pages requested by \"anonymous\" users are cached.  In order to reduce server load and save bandwidth, Drupal stores and sends cached pages compressed.  Drupal supports strict caching and loose caching.  Strict caching immediately deletes cached data as soon as it becomes invalid for any user.  Loose caching delays the deletion of cached data to provide better performance for high traffic sites."));
Dries Buytaert's avatar
   
Dries Buytaert committed
218

219
  $output .= form_group_collapsible(t('Cache settings'), $group, TRUE);
Dries Buytaert's avatar
   
Dries Buytaert committed
220

221
  // File system:
Dries Buytaert's avatar
   
Dries Buytaert committed
222
  $directory_path = variable_get('file_directory_path', 'files');
Dries Buytaert's avatar
   
Dries Buytaert committed
223
  file_check_directory($directory_path, FILE_CREATE_DIRECTORY, 'file_directory_path');
Dries Buytaert's avatar
   
Dries Buytaert committed
224

Steven Wittens's avatar
Steven Wittens committed
225
  $directory_temp = variable_get('file_directory_temp', FILE_DIRECTORY_TEMP);
226
  file_check_directory($directory_temp, FILE_CREATE_DIRECTORY, 'file_directory_temp');
Dries Buytaert's avatar
   
Dries Buytaert committed
227

228
229
  $group = form_textfield(t('File system path'), 'file_directory_path', $directory_path, 60, 255, t('A file system path where the files will be stored. This directory has to exist and be writable by Drupal. If the download method is set to public this directory has to be relative to Drupal installation directory, and be accessible over the web. When download method is set to private this directory should not be accessible over the web. Changing this location after the site has been in use will cause problems so only change this setting on an existing site if you know what you are doing.'));
  $group .= form_textfield(t('Temporary directory'), 'file_directory_temp', $directory_temp, 60, 255, t('Location where uploaded files will be kept during previews. Relative paths will be resolved relative to the file system path.'));
230
  $group .= form_radios(t('Download method'), 'file_downloads', variable_get('file_downloads', FILE_DOWNLOADS_PUBLIC), array(FILE_DOWNLOADS_PUBLIC => t('Public - files are available using http directly.'), FILE_DOWNLOADS_PRIVATE => t('Private - files are transferred by Drupal.')), t('If you want any sort of access control on the downloading of files, this needs to be set to <em>private</em>. You can change this at any time, however all download URLs will change and there may be unexpected problems so it is not recommended.'));
231
  $output .= form_group_collapsible(t('File system settings'), $group, TRUE);
Dries Buytaert's avatar
   
Dries Buytaert committed
232

233
  // Image handling:
234
235
236
  $group = '';
  $toolkits_available = image_get_available_toolkits();
  if (count($toolkits_available) > 1) {
237
      $group .= form_radios(t('Select an image processing toolkit'), 'image_toolkit', variable_get('image_toolkit', image_get_toolkit()), $toolkits_available);
238
  }
239
240
  $group .= image_toolkit_invoke('settings');
  if ($group) {
241
    $output .= form_group_collapsible(t('Image handling'), '<p>'.$group.'</p>', TRUE);
242
243
  }

244
  // Date settings:
Steven Wittens's avatar
Steven Wittens committed
245
  $zones = _system_zonelist();
246

247
  // Date settings: possible date formats
Dries Buytaert's avatar
   
Dries Buytaert committed
248
  $dateshort = array('Y-m-d H:i','m/d/Y - H:i', 'd/m/Y - H:i', 'Y/m/d - H:i',
Dries Buytaert's avatar
   
Dries Buytaert committed
249
250
251
           'm/d/Y - g:ia', 'd/m/Y - g:ia', 'Y/m/d - g:ia',
           'M j Y - H:i', 'j M Y - H:i', 'Y M j - H:i',
           'M j Y - g:ia', 'j M Y - g:ia', 'Y M j - g:ia');
Dries Buytaert's avatar
   
Dries Buytaert committed
252
253
  $datemedium = array('D, Y-m-d H:i', 'D, m/d/Y - H:i', 'D, d/m/Y - H:i',
          'D, Y/m/d - H:i', 'F j, Y - H:i', 'j F, Y - H:i', 'Y, F j - H:i',
Dries Buytaert's avatar
   
Dries Buytaert committed
254
255
256
257
          'D, m/d/Y - g:ia', 'D, d/m/Y - g:ia', 'D, Y/m/d - g:ia',
          'F j, Y - g:ia', 'j F, Y - g:ia', 'Y, F j - g:ia');
  $datelong = array('l, F j, Y - H:i', 'l, j F, Y - H:i', 'l, Y,  F j - H:i',
        'l, F j, Y - g:ia', 'l, j F, Y - g:ia', 'l, Y,  F j - g:ia');
Dries Buytaert's avatar
   
Dries Buytaert committed
258

259
  // Date settings: construct choices for user
Dries Buytaert's avatar
   
Dries Buytaert committed
260
  foreach ($dateshort as $f) {
Dries Buytaert's avatar
   
Dries Buytaert committed
261
    $dateshortchoices[$f] = format_date(time(), 'custom', $f);
Dries Buytaert's avatar
   
Dries Buytaert committed
262
263
  }
  foreach ($datemedium as $f) {
Dries Buytaert's avatar
   
Dries Buytaert committed
264
    $datemediumchoices[$f] = format_date(time(), 'custom', $f);
Dries Buytaert's avatar
   
Dries Buytaert committed
265
266
  }
  foreach ($datelong as $f) {
Dries Buytaert's avatar
   
Dries Buytaert committed
267
    $datelongchoices[$f] = format_date(time(), 'custom', $f);
Dries Buytaert's avatar
   
Dries Buytaert committed
268
269
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
270
271
272
273
274
  $group  = form_select(t('Default time zone'), 'date_default_timezone', variable_get('date_default_timezone', 0), $zones, t('Select the default site time zone.'));
  $group .= form_radios(t('Configurable time zones'), 'configurable_timezones', variable_get('configurable_timezones', 1), array(t('Disabled'), t('Enabled')), t('Enable or disable user-configurable time zones.  When enabled, users can set their own time zone and dates will be updated accordingly.'));
  $group .= form_select(t('Short date format'), 'date_format_short', variable_get('date_format_short', $dateshort[0]), $dateshortchoices, t('The short format of date display.'));
  $group .= form_select(t('Medium date format'), 'date_format_medium', variable_get('date_format_medium', $datemedium[0]), $datemediumchoices, t('The medium sized date display.'));
  $group .= form_select(t('Long date format'), 'date_format_long', variable_get('date_format_long', $datelong[0]), $datelongchoices, t('Longer date format used for detailed display.'));
275
  $group .= form_select(t('First day of week'), 'date_first_day', variable_get('date_first_day', 0), array(0 => t('Sunday'), 1 => t('Monday'), 2 => t('Tuesday'), 3 => t('Wednesday'), 4 => t('Thursday'), 5 => t('Friday'), 6 => t('Saturday')), t('The first day of the week for calendar views.'));
Dries Buytaert's avatar
   
Dries Buytaert committed
276

277
  $output .= form_group_collapsible(t('Date settings'), $group, TRUE);
Dries Buytaert's avatar
 
Dries Buytaert committed
278

Dries Buytaert's avatar
   
Dries Buytaert committed
279
280
281
  return $output;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
282
283
284
285
/**
 * Retrieves the current status of an array of files in the system table.
 */
function system_get_files_database(&$files, $type) {
Dries Buytaert's avatar
   
Dries Buytaert committed
286
  // Extract current files from database.
287
  $result = db_query("SELECT name, type, status, throttle FROM {system} WHERE type = '%s'", $type);
Dries Buytaert's avatar
   
Dries Buytaert committed
288
  while ($file = db_fetch_object($result)) {
289
    if (isset($files[$file->name]) && is_object($files[$file->name])) {
Dries Buytaert's avatar
   
Dries Buytaert committed
290
      foreach ($file as $key => $value) {
291
        if (!isset($files[$file->name]) || !isset($files[$file->name]->$key)) {
292
293
          $files[$file->name]->$key = $value;
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
294
      }
295
    }
Dries Buytaert's avatar
 
Dries Buytaert committed
296
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
297
}
Dries Buytaert's avatar
 
Dries Buytaert committed
298

Dries Buytaert's avatar
   
Dries Buytaert committed
299
300
301
/**
 * Collect data about all currently available themes
 */
302
303
304
305
function system_theme_data() {
  // Find themes
  $themes = system_listing('\.theme$', 'themes');

Dries Buytaert's avatar
   
Dries Buytaert committed
306
  // Find theme engines
307
308
309
310
311
312
313
314
315
  $engines = system_listing('\.engine$', 'themes/engines');

  // can't iterate over array itself as it uses a copy of the array items
  foreach (array_keys($themes) as $key) {
    drupal_get_filename('theme', $themes[$key]->name, $themes[$key]->filename);
    drupal_load('theme', $themes[$key]->name);
    $themes[$key]->owner = $themes[$key]->filename;
    $themes[$key]->prefix = $key;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
316

317
318
  // Remove all theme engines from the system table
  db_query("DELETE FROM {system} WHERE type = 'theme_engine'");
Dries Buytaert's avatar
   
Dries Buytaert committed
319
320

  foreach ($engines as $engine) {
Dries Buytaert's avatar
   
Dries Buytaert committed
321
    // Insert theme engine into system table
322
323
324
325
    drupal_get_filename('theme_engine', $engine->name, $engine->filename);
    drupal_load('theme_engine', $engine->name);
    db_query("INSERT INTO {system} (name, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', %d, %d, %d)", $engine->name, 'theme_engine', $engine->filename, 1, 0, 0);

Dries Buytaert's avatar
   
Dries Buytaert committed
326
    // Add templates to the site listing
327
328
329
330
331
    foreach (call_user_func($engine->name . '_templates') as $template) {
      $template->template = TRUE;
      $template->name = basename(dirname($template->filename));
      $template->owner = $engine->filename;
      $template->prefix = $engine->name;
Dries Buytaert's avatar
   
Dries Buytaert committed
332
      // do not double-insert templates with theme files in their directory
Dries Buytaert's avatar
   
Dries Buytaert committed
333
334
      if (array_key_exists($template->name, $themes)) {
        continue;
Dries Buytaert's avatar
   
Dries Buytaert committed
335
      }
336
      $themes[$template->name] = $template;
Dries Buytaert's avatar
   
Dries Buytaert committed
337
338
339
340
    }
  }

  // Find styles in each theme's directory.
341
342
  foreach ($themes as $theme) {
    foreach (file_scan_directory(dirname($theme->filename), 'style.css$') as $style) {
Dries Buytaert's avatar
   
Dries Buytaert committed
343
344
345
346
347
348
349
350
      $style->style = TRUE;
      $style->template = $theme->template;
      $style->name = basename(dirname($style->filename));
      $style->owner = $theme->filename;
      $style->prefix = $theme->template ? $theme->prefix : $theme->name;
      // do not double-insert styles with theme files in their directory
      if (array_key_exists($style->name, $themes)) {
        continue;
Dries Buytaert's avatar
   
Dries Buytaert committed
351
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
352
      $themes[$style->name] = $style;
Dries Buytaert's avatar
   
Dries Buytaert committed
353
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
354
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
355
356

  // Extract current files from database.
357
358
359
  system_get_files_database($themes, 'theme');

  db_query("DELETE FROM {system} WHERE type = 'theme'");
Dries Buytaert's avatar
   
Dries Buytaert committed
360

361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
  foreach ($themes as $theme) {
    db_query("INSERT INTO {system} (name, description, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', '%s', %d, %d, %d)", $theme->name, $theme->owner, 'theme', $theme->filename, $theme->status, 0, 0);
  }

  return $themes;
}

/**
 * Returns an array of files objects of the given type from both the
 * site-wide directory (i.e. modules/) and site-specific directory
 * (i.e. sites/somesite/modules/).  The returned array will be keyed
 * using the key specified (name, basename, filename).  Using name or
 * basename will cause site-specific files to shadow files in the
 * default directories.  That is, if a file with the same name appears
 * in both location, only the site-specific version will be included.
 *
 * @param $mask
 *   The regular expression of the files to find.
 * @param $directory
 *   The subdirectory name in which the files are found.  For example,
 *   'modules' will search in both modules/ and
 *   sites/somesite/modules/.
 * @param $key
 *   The key to be passed to file_scan_directory().
385
386
 * @param $min_depth
 *   Minimum depth of directories to return files from.
387
388
389
390
 *
 * @return
 *   An array of file objects of the specified type.
 */
391
function system_listing($mask, $directory, $key = 'name', $min_depth = 1) {
392
393
394
395
396
397
398
399
400
401
  $config = conf_init();
  $searchdir = array($directory);
  $files = array();

  if (file_exists("$config/$directory")) {
    $searchdir[] = "$config/$directory";
  }

  // Get current list of items
  foreach ($searchdir as $dir) {
402
    $files = array_merge($files, file_scan_directory($dir, $mask, array('.', '..', 'CVS'), 0, TRUE, $key, $min_depth));
403
404
405
  }

  return $files;
Dries Buytaert's avatar
   
Dries Buytaert committed
406
407
408
409
410
411
}

/**
 * Generate a list of all the available theme/style combinations.
 */
function system_theme_listing() {
412
  $themes = system_theme_data();
Dries Buytaert's avatar
   
Dries Buytaert committed
413
414
  ksort($themes);

Dries Buytaert's avatar
   
Dries Buytaert committed
415
  foreach ($themes as $info) {
416
    $info->screenshot = dirname($info->filename) . '/screenshot.png';
Dries Buytaert's avatar
   
Dries Buytaert committed
417
418
419
    $row = array();

    // Screenshot column.
420
    $row[] = file_exists($info->screenshot) ? theme('image', $info->screenshot, t('Screenshot for %theme theme', array('%theme' => $info->name)), '', array('class' => 'screenshot'), false) : t('no screenshot');
Dries Buytaert's avatar
   
Dries Buytaert committed
421
422

    // Information field.
Dries Buytaert's avatar
   
Dries Buytaert committed
423
    $row[] = "<strong>$info->name</strong><br /><em>" . dirname($info->filename) . '</em>';
Dries Buytaert's avatar
   
Dries Buytaert committed
424
425

    // enabled, default, and operations columns
426
    $row[] = array('data' => form_checkbox('', 'status]['. $info->name, 1, $info->status), 'align' => 'center');
Dries Buytaert's avatar
   
Dries Buytaert committed
427
    $row[] = array('data' => form_radio('', 'theme_default', $info->name, (variable_get('theme_default', 'bluemarine') == $info->name) ? 1 : 0), 'align' => 'center');
428
    if (function_exists($info->prefix . '_settings') || function_exists($info->prefix . '_features')) {
Dries Buytaert's avatar
   
Dries Buytaert committed
429
      $row[] = array('data' => l(t('configure'), 'admin/themes/settings/' . $info->name), 'align' => 'center');
Dries Buytaert's avatar
   
Dries Buytaert committed
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
    }
    else {
      $row[] = '';
    }
    $rows[] = $row;
  }

  $header = array(t('Screenshot'), t('Name'), t('Enabled'), t('Default'), t('Operations'));
  $output = form_hidden('type', 'theme');
  $output .= theme('table', $header, $rows);
  return $output;
}

/**
 * Generate a list of all the available modules, as well as update the system list.
 */
function system_module_listing() {
  // Get current list of modules
448
  $files = system_listing('\.module$', 'modules', 'name', 0);
Dries Buytaert's avatar
   
Dries Buytaert committed
449
450
451
452
453
454

  // Extract current files from database.
  system_get_files_database($files, 'module');

  ksort($files);

455
  $required = array('block', 'filter', 'system', 'user', 'watchdog');
456
  $throttle_required = array_merge($required, array('throttle'));
Dries Buytaert's avatar
   
Dries Buytaert committed
457

Dries Buytaert's avatar
   
Dries Buytaert committed
458
459
460
461
  $header = array(t('Name'), t('Description'), t('Enabled'));
  if (module_exist('throttle')) {
    $header[] = t('Throttle');
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
462
463

  foreach ($files as $filename => $file) {
464
465
466
467
    drupal_get_filename('module', $file->name, $file->filename);
    drupal_load('module', $file->name);

    $file->description = module_invoke($file->name, 'help', 'admin/modules#description');
Dries Buytaert's avatar
   
Dries Buytaert committed
468

Dries Buytaert's avatar
   
Dries Buytaert committed
469
470
471
472
473
474
    // log the critical hooks implemented by this module
    $bootstrap = 0;
    foreach (bootstrap_hooks() as $hook) {
      if (module_hook($file->name, $hook)) {
        $bootstrap = 1;
        break;
Dries Buytaert's avatar
   
Dries Buytaert committed
475
      }
476
477
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
478
    // Update the contents of the system table:
479
480
    db_query("DELETE FROM {system} WHERE name = '%s' AND type = '%s'", $file->name, 'module');
    db_query("INSERT INTO {system} (name, description, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', '%s', %d, %d, %d)", $file->name, $file->description, 'module', $file->filename, $file->status, $file->throttle, $bootstrap);
481

482
    $row = array($file->name, $file->description, array('data' => (in_array($file->name, $required) ? form_hidden("status][$file->name", 1) . t('required') : form_checkbox('', "status][$file->name", 1, $file->status)), 'align' => 'center'));
Dries Buytaert's avatar
   
Dries Buytaert committed
483
    if (module_exist('throttle')) {
484
      $row[] = array('data' => (in_array($file->name, $throttle_required) ? form_hidden("throttle][$file->name", 0) . t('required') : form_checkbox(NULL, "throttle][$file->name", 1, $file->throttle, NULL)), 'align' => 'center');
Dries Buytaert's avatar
   
Dries Buytaert committed
485
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
486
    $rows[] = $row;
487
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
488

Dries Buytaert's avatar
   
Dries Buytaert committed
489
  $output  = theme('table', $header, $rows);
Dries Buytaert's avatar
   
Dries Buytaert committed
490
  $output .= form_hidden('type', 'module');
Dries Buytaert's avatar
   
Dries Buytaert committed
491

Dries Buytaert's avatar
   
Dries Buytaert committed
492
  return $output;
Dries Buytaert's avatar
 
Dries Buytaert committed
493
}
Dries Buytaert's avatar
   
Dries Buytaert committed
494

495
function system_listing_save($edit = array()) {
Dries Buytaert's avatar
   
Dries Buytaert committed
496
497
  $op = $_POST['op'];
  $edit = $_POST['edit'];
Dries Buytaert's avatar
   
Dries Buytaert committed
498

Dries Buytaert's avatar
   
Dries Buytaert committed
499
500
  if ($op == t('Save configuration')) {
    db_query("UPDATE {system} SET status = 0 WHERE type = '%s'", $edit['type']);
501
    foreach ($edit['status'] as $name => $status) {
Dries Buytaert's avatar
   
Dries Buytaert committed
502
      // Make certain that the default theme is enabled to avoid user error
503
      if (($edit['type'] == 'theme') && ($edit['theme_default'] == $name)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
504
505
506
        $status = 1;
      }

507
      db_query("UPDATE {system} SET status = %d, throttle = %d WHERE type = '%s' AND name = '%s'", $status, $edit['throttle'][$name], $edit['type'], $name);
Dries Buytaert's avatar
   
Dries Buytaert committed
508
    }
509

Dries Buytaert's avatar
   
Dries Buytaert committed
510
    if ($edit['type'] == 'theme') {
511
      variable_set('theme_default', $edit['theme_default']);
512
513
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
514
    menu_rebuild();
515

Dries Buytaert's avatar
   
Dries Buytaert committed
516
    drupal_set_message(t('The configuration options have been saved.'));
Steven Wittens's avatar
Steven Wittens committed
517
    drupal_goto($_GET['q']);
518
519
520
521
  }
}

function system_settings_form($form) {
Dries Buytaert's avatar
   
Dries Buytaert committed
522
523
  $form .= form_submit(t('Save configuration'));
  $form .= form_submit(t('Reset to defaults'));
524
525
526
527
528

  return form($form);
}

function system_settings_save() {
Dries Buytaert's avatar
   
Dries Buytaert committed
529
530
  $op = $_POST['op'];
  $edit = $_POST['edit'];
Dries Buytaert's avatar
   
Dries Buytaert committed
531

Dries Buytaert's avatar
   
Dries Buytaert committed
532
  if ($op == t('Reset to defaults')) {
Dries Buytaert's avatar
   
Dries Buytaert committed
533
534
535
536
    if (is_array($edit)) {
      foreach ($edit as $name => $value) {
        variable_del($name);
      }
537
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
538
    drupal_set_message(t('The configuration options have been reset to their default values.'));
539
  }
540
  else if ($op == t('Save configuration')) {
Dries Buytaert's avatar
   
Dries Buytaert committed
541
    if (is_array($edit)) {
542
543
544
545
      if ($edit['clean_url'] && !variable_get('clean_url_ok', 0)) {
        drupal_set_message(t('It appears your host is not configured correctly for Clean URLs. Please check for <code>ModRewrite</code> support with your administrator.'), 'error');
        $edit['clean_url'] = 0;
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
546
547
548
      foreach ($edit as $name => $value) {
        variable_set($name, $value);
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
549
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
550
    drupal_set_message(t('The configuration options have been saved.'));
551
552
553
554
  }
  else {
    return;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
555
  menu_rebuild();
Steven Wittens's avatar
Steven Wittens committed
556
  drupal_goto($_GET['q']);
557
558
}

Dries Buytaert's avatar
   
Dries Buytaert committed
559
560
561
562
563
/**
 * Menu callback; displays a listing of all themes.
 */
function system_themes() {
  system_listing_save();
Dries Buytaert's avatar
   
Dries Buytaert committed
564
  $form = system_theme_listing();
Dries Buytaert's avatar
   
Dries Buytaert committed
565
  $form .= form_submit(t('Save configuration'));
Dries Buytaert's avatar
   
Dries Buytaert committed
566
  return form($form);
Dries Buytaert's avatar
   
Dries Buytaert committed
567
568
569
570
571
572
573
}

/**
 * Menu callback; displays a listing of all modules.
 */
function system_modules() {
  system_listing_save();
Dries Buytaert's avatar
   
Dries Buytaert committed
574
  $form = system_module_listing();
Dries Buytaert's avatar
   
Dries Buytaert committed
575
  $form .= form_submit(t('Save configuration'));
Dries Buytaert's avatar
   
Dries Buytaert committed
576
  return form($form);
Dries Buytaert's avatar
   
Dries Buytaert committed
577
578
}

579
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
580
 * Menu callback; displays a module's settings page.
581
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
582
function system_site_settings($module = NULL) {
583
584
  system_settings_save();

Dries Buytaert's avatar
   
Dries Buytaert committed
585
586
587
588
589
  if ($module) {
    $form = module_invoke($module, 'settings');
  }
  else {
    $form = system_view_general();
590
591
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
592
  return system_settings_form($form);
593
594
}

Dries Buytaert's avatar
   
Dries Buytaert committed
595
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
596
 * Menu callback; display theme configuration for entire site and individual themes.
Dries Buytaert's avatar
   
Dries Buytaert committed
597
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
598
function system_theme_settings($key = '') {
Dries Buytaert's avatar
   
Dries Buytaert committed
599
  system_settings_save();
Dries Buytaert's avatar
   
Dries Buytaert committed
600

Dries Buytaert's avatar
   
Dries Buytaert committed
601
  // Default settings are defined in theme_get_settings() in includes/theme.inc
Dries Buytaert's avatar
   
Dries Buytaert committed
602
  if ($key) {
603
    $settings = theme_get_settings($key);
Dries Buytaert's avatar
   
Dries Buytaert committed
604
    $var = str_replace('/', '_', 'theme_'. $key .'_settings');
605
606
    $themes = system_theme_data();
    $features = function_exists($themes[$key]->prefix . '_features') ? call_user_func($themes[$key]->prefix . '_features') : array();
Dries Buytaert's avatar
   
Dries Buytaert committed
607
608
  }
  else {
609
    $settings = theme_get_settings('');
Dries Buytaert's avatar
   
Dries Buytaert committed
610
611
612
    $var = 'theme_settings';
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
613
614
  // Check for a new uploaded logo, and use that instead.
  if ($file = file_check_upload('logo_upload')) {
615
    if ($info = image_get_info($file->filepath)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
      $parts = pathinfo($file->filename);
      $filename = ($key) ? str_replace('/', '_', $key) . '_logo.' . $parts['extension'] : 'logo.' . $parts['extension'];

      if ($file = file_save_upload('logo_upload', $filename, 1)) {
        $settings['default_logo'] = 0;
        $settings['logo_path'] = $file->filepath;

        // Update the variable table with the new settings so that they take effect immediately.
        variable_set($var, $settings);
      }
    }
    else {
      form_set_error('file_upload', t('Only JPEG, PNG and GIF images are allowed to be used as logos.'));
    }
  }

632
633
634
635
636
637
638
639
640
641
642
643
644
  // Check for a new uploaded favicon, and use that instead.
  if ($file = file_check_upload('favicon_upload')) {
    $parts = pathinfo($file->filename);
    $filename = ($key) ? str_replace('/', '_', $key) . '_favicon.' . $parts['extension'] : 'favicon.' . $parts['extension'];

    if ($file = file_save_upload('favicon_upload', $filename, 1)) {
      $settings['default_favicon'] = 0;
      $settings['favicon_path'] = $file->filepath;

      // Update the variable table with the new settings so that they take effect immediately.
      variable_set($var, $settings);
    }
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
645

Dries Buytaert's avatar
   
Dries Buytaert committed
646
647
648
649
650
  $form = '';

  // Logo settings
  if ((!$key) || in_array('logo', $features)) {
    $group = form_checkbox(t('Use the default logo'), "$var][default_logo", 1, $settings['default_logo'], t('Check here if you want the theme to use the logo supplied with it.'));
651
    $group .= form_textfield(t('Path to custom logo'), "$var][logo_path", $settings['logo_path'], 60, 128, t('The path to the file you would like to use as your logo file instead of the default logo.'));
Dries Buytaert's avatar
   
Dries Buytaert committed
652
653
654
655

    file_check_directory(variable_get('file_directory_path', 'files'), FILE_CREATE_DIRECTORY, 'file_directory_path');
    $group .= form_file(t('Upload logo image'), 'logo_upload', 40, t("If you don't have direct file access to the server, use this field to upload your logo."));

656
657
658
659
660
661
662
    $form .= form_group(t('Logo image settings'), $group);
  }

  // Icon settings
  if ((!$key) || in_array('toggle_favicon', $features)) {
    $group = t('Your shortcut icon or \'favicon\' is displayed in the address bar and bookmarks of most browsers.');
    $group .= form_checkbox(t('Use the default shortcut icon.'), "$var][default_favicon", 1, $settings['default_favicon'], t('Check here if you want the theme to use the default shortcut icon.'));
663
    $group .= form_textfield(t('Path to custom icon'), "$var][favicon_path", $settings['favicon_path'], 60, 128, t('The path to the image file you would like to use as your custom shortcut icon.'));
664
665
666

    file_check_directory(variable_get('file_directory_path', 'files'), FILE_CREATE_DIRECTORY, 'file_directory_path');
    $group .= form_file(t('Upload icon image'), 'favicon_upload', 40, t("If you don't have direct file access to the server, use this field to upload your shortcut icon."));
Dries Buytaert's avatar
   
Dries Buytaert committed
667

668
    $form .= form_group(t('Shortcut icon settings'), $group);
Dries Buytaert's avatar
   
Dries Buytaert committed
669
670
671
672
673
  }

  // System wide only settings.
  if (!$key) {
    // Menu settings
674
675
676
677
678
679

    $header = array(t('link text'), t('url'), t('description'));
    foreach (array('Primary', 'Secondary') as $utype) {
      $group = '';
      $rows = array();

680
      // Use $utype field , and strtolower() it to get the type field.. to avoid issues with ucfirst() and unicode.
681
      $type = strtolower($utype);
682
      $value = $settings[$type . '_links'];
683
684
685
686
      if (!is_array($value)) {
        $value = array();
      }

687
      // Increment the link count, if the user has requested more links.
688
689
690
691
692
      if (variable_get($type . '_links_more', false)) {
        variable_del($type . '_links_more');
        variable_set($type . '_link_count', variable_get($type . '_link_count', 5) + 5);
      }

693
      // Get the amount of links to show, possibly expanding if there are more links defined than the count specifies.
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
      $count = variable_get($type . '_link_count', 5);
      $count = ($count > sizeof($value['link'])) ? $count : sizeof($value['link']);
      if (variable_get($type . '_link_count', 5) != $count) {
        variable_set($type . '_link_count', $count);
      }

      for ($i = 0; $i < $count; $i++) {
        $row = array();
        foreach (array('text', 'link', 'description') as $field) {
          $row[] = form_textfield('', $var . '][' . $type . '_links][' . $field . '][' . $i, $value[$field][$i], 15, 90);
        }
        $rows[] = $row;
      }

      $group .= form_item('', theme("table", $header, $rows), t('You can specify your _TYPE_ links here, one link per line.<br /> The link text field is the text you want to link.<br /> The url field is the location the link points to.<br /> The description field is an optional description of where the link points.', array('_TYPE_' => $type)));
      $group .= form_checkbox(t('I need more _TYPE_ links.', array('_TYPE_' => $type)), $type . '_links_more', 1, FALSE, t('Checking this box will give you 5 additional _TYPE_ links.', array('_TYPE_' => $type)));
      $form .= form_group(t('_TYPE_ link settings', array('_TYPE_' => $utype)), $group);
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
712
713

    // Toggle node display.
714
715
716
    $node_list = module_invoke('node', 'list');
    if ($node_list) {
      $group = '';
717
      foreach ($node_list as $type => $module) {
718
719
720
        $group .= form_checkbox(node_invoke($type, 'node_name'), "$var][toggle_node_info_$type", 1, $settings["toggle_node_info_$type"]);
      }
      $form .= form_group(t('Display post information on'), $group, t('Enable or disable the "submitted by Username on date" text when displaying posts of the above type'));
Dries Buytaert's avatar
   
Dries Buytaert committed
721
722
723
724
725
726
727
728
729
730
731
732
    }
  }

  $group = '';

  // Toggle settings
  $toggles = array('toggle_name' => t('Site name'),
        'toggle_slogan' => t('Site slogan'),
        'toggle_mission' => t('Mission statement'),
        'toggle_primary_links' => t('Primary links'),
        'toggle_secondary_links' => t('Secondary links'),
        'toggle_node_user_picture' => t('User pictures in posts'),
Dries Buytaert's avatar
   
Dries Buytaert committed
733
        'toggle_comment_user_picture' => t('User pictures in comments'),
734
735
        'toggle_search' => t('Search box'),
        'toggle_favicon' => t('Shortcut icon'));
Dries Buytaert's avatar
   
Dries Buytaert committed
736
737
738

  foreach ($toggles as $name => $title) {
    if ((!$key) || in_array($name, $features)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
739
740
      // disable search box if search.module is disabled
      $group .= form_checkbox($title, "$var][$name", 1, $settings[$name], NULL, (!module_exist('search') && $name == 'toggle_search') ? array('disabled' => 'disabled') : NULL);
Dries Buytaert's avatar
   
Dries Buytaert committed
741
742
743
744
745
746
747
748
    }
  }
  if ($group) {
    $form .= form_group(t('Toggle display'), $group, t('Enable or disable the display of certain page elements.'));
  }

  if ($key) {
    // Template-specific settings
Dries Buytaert's avatar
   
Dries Buytaert committed
749
    $function = $themes[$key]->prefix .'_settings';
Dries Buytaert's avatar
   
Dries Buytaert committed
750
751
    if (function_exists($function)) {
      $group = $function();
Dries Buytaert's avatar
   
Dries Buytaert committed
752
753
754
      if ($themes[$key]->template) {
        // file is a template or a style of a template
        $form .= form_group(t('Engine-specific settings'), $group, t('These settings only exist for all the templates and styles based on the %engine theme engine.', array('%engine' => $themes[$key]->prefix)));
Dries Buytaert's avatar
   
Dries Buytaert committed
755
756
      }
      else {
Dries Buytaert's avatar
   
Dries Buytaert committed
757
758
        // file is a theme or a style of a theme
        $form .= form_group(t('Theme-specific settings'), $group, t('These settings only exist for the %theme theme and all the styles based on it.', array('%theme' => $themes[$key]->prefix)));
Dries Buytaert's avatar
   
Dries Buytaert committed
759
760
      }
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
761
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
762
763
764
  $form .= form_submit(t('Save configuration'));
  $form .= form_submit(t('Reset to defaults'));

Dries Buytaert's avatar
   
Dries Buytaert committed
765
  return form($form, 'post', null, array('enctype' => 'multipart/form-data'));
Dries Buytaert's avatar
   
Dries Buytaert committed
766

Dries Buytaert's avatar
 
Dries Buytaert committed
767
}
Dries Buytaert's avatar
   
Dries Buytaert committed
768

Dries Buytaert's avatar
   
Dries Buytaert committed
769
?>