Projet

Général

Profil

Paste
Télécharger (140 ko) Statistiques
| Branche: | Révision:

root / drupal7 / modules / system / system.module @ bd0d4c5c

1
<?php
2

    
3
/**
4
 * @file
5
 * Configuration system that lets administrators modify the workings of the site.
6
 */
7

    
8
/**
9
 * Maximum age of temporary files in seconds.
10
 */
11
define('DRUPAL_MAXIMUM_TEMP_FILE_AGE', 21600);
12

    
13
/**
14
 * Default interval for automatic cron executions in seconds.
15
 */
16
define('DRUPAL_CRON_DEFAULT_THRESHOLD', 10800);
17

    
18
/**
19
 * New users will be set to the default time zone at registration.
20
 */
21
define('DRUPAL_USER_TIMEZONE_DEFAULT', 0);
22

    
23
/**
24
 * New users will get an empty time zone at registration.
25
 */
26
define('DRUPAL_USER_TIMEZONE_EMPTY', 1);
27

    
28
/**
29
 * New users will select their own timezone at registration.
30
 */
31
define('DRUPAL_USER_TIMEZONE_SELECT', 2);
32

    
33
 /**
34
 * Disabled option on forms and settings
35
 */
36
define('DRUPAL_DISABLED', 0);
37

    
38
/**
39
 * Optional option on forms and settings
40
 */
41
define('DRUPAL_OPTIONAL', 1);
42

    
43
/**
44
 * Required option on forms and settings
45
 */
46
define('DRUPAL_REQUIRED', 2);
47

    
48
/**
49
 * Maximum number of values in a weight select element.
50
 *
51
 * If the number of values is over the maximum, a text field is used instead.
52
 */
53
define('DRUPAL_WEIGHT_SELECT_MAX', 100);
54

    
55
/**
56
 * Return only visible regions.
57
 *
58
 * @see system_region_list()
59
 */
60
define('REGIONS_VISIBLE', 'visible');
61

    
62
/**
63
 * Return all regions.
64
 *
65
 * @see system_region_list()
66
 */
67
define('REGIONS_ALL', 'all');
68

    
69
/**
70
 * Implements hook_help().
71
 */
72
function system_help($path, $arg) {
73
  global $base_url;
74

    
75
  switch ($path) {
76
    case 'admin/help#system':
77
      $output = '';
78
      $output .= '<h3>' . t('About') . '</h3>';
79
      $output .= '<p>' . t('The System module is integral to the site, and provides basic but extensible functionality for use by other modules and themes. Some integral elements of Drupal are contained in and managed by the System module, including caching, enabling and disabling modules and themes, preparing and displaying the administrative page, and configuring fundamental site settings. A number of key system maintenance operations are also part of the System module. For more information, see the online handbook entry for <a href="@system">System module</a>.', array('@system' => 'http://drupal.org/documentation/modules/system')) . '</p>';
80
      $output .= '<h3>' . t('Uses') . '</h3>';
81
      $output .= '<dl>';
82
      $output .= '<dt>' . t('Managing modules') . '</dt>';
83
      $output .= '<dd>' . t('The System module allows users with the appropriate permissions to enable and disable modules on the <a href="@modules">Modules administration page</a>. Drupal comes with a number of core modules, and each module provides a discrete set of features and may be enabled or disabled depending on the needs of the site. Many additional modules contributed by members of the Drupal community are available for download at the <a href="@drupal-modules">Drupal.org module page</a>.', array('@modules' => url('admin/modules'), '@drupal-modules' => 'http://drupal.org/project/modules')) . '</dd>';
84
      $output .= '<dt>' . t('Managing themes') . '</dt>';
85
      $output .= '<dd>' . t('The System module allows users with the appropriate permissions to enable and disable themes on the <a href="@themes">Appearance administration page</a>. Themes determine the design and presentation of your site. Drupal comes packaged with several core themes, and additional contributed themes are available at the <a href="@drupal-themes">Drupal.org theme page</a>.', array('@themes' => url('admin/appearance'), '@drupal-themes' => 'http://drupal.org/project/themes')) . '</dd>';
86
      $output .= '<dt>' . t('Managing caching') . '</dt>';
87
      $output .= '<dd>' . t("The System module allows users with the appropriate permissions to manage caching on the <a href='@cache-settings'>Performance settings page</a>. Drupal has a robust caching system that allows the efficient re-use of previously-constructed web pages and web page components. Pages requested by anonymous users are stored in a compressed format; depending on your site configuration and the amount of your web traffic tied to anonymous visitors, the caching system may significantly increase the speed of your site.", array('@cache-settings' => url('admin/config/development/performance'))) . '</dd>';
88
      $output .= '<dt>' . t('Performing system maintenance') . '</dt>';
89
      $output .= '<dd>' . t('In order for the site and its modules to continue to operate well, a set of routine administrative operations must run on a regular basis. The System module manages this task by making use of a system cron job. You can verify the status of cron tasks by visiting the <a href="@status">Status report page</a>. For more information, see the online handbook entry for <a href="@handbook">configuring cron jobs</a>. You can set up cron job by visiting <a href="@cron">Cron configuration</a> page', array('@status' => url('admin/reports/status'), '@handbook' => 'http://drupal.org/cron', '@cron' => url('admin/config/system/cron'))) . '</dd>';
90
      $output .= '<dt>' . t('Configuring basic site settings') . '</dt>';
91
      $output .= '<dd>' . t('The System module also handles basic configuration options for your site, including <a href="@date-time-settings">Date and time settings</a>, <a href="@file-system">File system settings</a>, <a href="@clean-url">Clean URL support</a>, <a href="@site-info">Site name and other information</a>, and a <a href="@maintenance-mode">Maintenance mode</a> for taking your site temporarily offline.', array('@date-time-settings' => url('admin/config/regional/date-time'), '@file-system' => url('admin/config/media/file-system'), '@clean-url' => url('admin/config/search/clean-urls'), '@site-info' => url('admin/config/system/site-information'), '@maintenance-mode' => url('admin/config/development/maintenance'))) . '</dd>';
92
      $output .= '<dt>' . t('Configuring actions') . '</dt>';
93
      $output .= '<dd>' . t('Actions are individual tasks that the system can do, such as unpublishing a piece of content or banning a user. Modules, such as the <a href="@trigger-help">Trigger module</a>, can fire these actions when certain system events happen; for example, when a new post is added or when a user logs in. Modules may also provide additional actions. Visit the <a href="@actions">Actions page</a> to configure actions.', array('@trigger-help' => url('admin/help/trigger'), '@actions' => url('admin/config/system/actions'))) . '</dd>';
94
      $output .= '</dl>';
95
      return $output;
96
    case 'admin/index':
97
      return '<p>' . t('This page shows you all available administration tasks for each module.') . '</p>';
98
    case 'admin/appearance':
99
      $output = '<p>' . t('Set and configure the default theme for your website.  Alternative <a href="@themes">themes</a> are available.', array('@themes' => 'http://drupal.org/project/themes')) . '</p>';
100
      return $output;
101
    case 'admin/appearance/settings/' . $arg[3]:
102
      $theme_list = list_themes();
103
      $theme = $theme_list[$arg[3]];
104
      return '<p>' . t('These options control the display settings for the %name theme. When your site is displayed using this theme, these settings will be used.', array('%name' => $theme->info['name'])) . '</p>';
105
    case 'admin/appearance/settings':
106
      return '<p>' . t('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>';
107
    case 'admin/modules':
108
      $output = '<p>' . t('Download additional <a href="@modules">contributed modules</a> to extend Drupal\'s functionality.', array('@modules' => 'http://drupal.org/project/modules')) . '</p>';
109
      if (module_exists('update')) {
110
        if (update_manager_access()) {
111
          $output .= '<p>' . t('Regularly review and install <a href="@updates">available updates</a> to maintain a secure and current site. Always run the <a href="@update-php">update script</a> each time a module is updated.', array('@update-php' => $base_url . '/update.php', '@updates' => url('admin/reports/updates'))) . '</p>';
112
        }
113
        else {
114
          $output .= '<p>' . t('Regularly review <a href="@updates">available updates</a> to maintain a secure and current site. Always run the <a href="@update-php">update script</a> each time a module is updated.', array('@update-php' => $base_url . '/update.php', '@updates' => url('admin/reports/updates'))) . '</p>';
115
        }
116
      }
117
      else {
118
        $output .= '<p>' . t('Regularly review available updates to maintain a secure and current site. Always run the <a href="@update-php">update script</a> each time a module is updated. Enable the Update manager module to update and install modules and themes.', array('@update-php' => $base_url . '/update.php')) . '</p>';
119
      }
120
      return $output;
121
    case 'admin/modules/uninstall':
122
      return '<p>' . t('The uninstall process removes all data related to a module. To uninstall a module, you must first disable it on the main <a href="@modules">Modules page</a>.', array('@modules' => url('admin/modules'))) . '</p>';
123
    case 'admin/structure/block/manage':
124
      if ($arg[4] == 'system' && $arg[5] == 'powered-by') {
125
        return '<p>' . t('The <em>Powered by Drupal</em> block is an optional link to the home page of the Drupal project. While there is absolutely no requirement that sites feature this link, it may be used to show support for Drupal.') . '</p>';
126
      }
127
      break;
128
    case 'admin/config/development/maintenance':
129
      global $user;
130
      if ($user->uid == 1) {
131
        return '<p>' . t('If you are upgrading to a newer version of Drupal or upgrading contributed modules or themes, you may need to run the <a href="@update-php">update script</a>.', array('@update-php' => $base_url . '/update.php')) . '</p>';
132
      }
133
      break;
134
    case 'admin/config/system/actions':
135
    case 'admin/config/system/actions/manage':
136
      $output = '';
137
      $output .= '<p>' . t('There are two types of actions: simple and advanced. Simple actions do not require any additional configuration, and are listed here automatically. Advanced actions need to be created and configured before they can be used, because they have options that need to be specified; for example, sending an e-mail to a specified address, or unpublishing content containing certain words. To create an advanced action, select the action from the drop-down list in the advanced action section below and click the <em>Create</em> button.') . '</p>';
138
      if (module_exists('trigger')) {
139
        $output .= '<p>' . t('You may proceed to the <a href="@url">Triggers</a> page to assign these actions to system events.', array('@url' => url('admin/structure/trigger'))) . '</p>';
140
      }
141
      return $output;
142
    case 'admin/config/system/actions/configure':
143
      return t('An advanced action offers additional configuration options which may be filled out below. Changing the <em>Description</em> field is recommended, in order to better identify the precise action taking place. This description will be displayed in modules such as the Trigger module when assigning actions to system events, so it is best if it is as descriptive as possible (for example, "Send e-mail to Moderation Team" rather than simply "Send e-mail").');
144
    case 'admin/config/people/ip-blocking':
145
      return '<p>' . t('IP addresses listed here are blocked from your site. Blocked addresses are completely forbidden from accessing the site and instead see a brief message explaining the situation.') . '</p>';
146
    case 'admin/reports/status':
147
      return '<p>' . t("Here you can find a short overview of your site's parameters as well as any problems detected with your installation. It may be useful to copy and paste this information into support requests filed on drupal.org's support forums and project issue queues.") . '</p>';
148
  }
149
}
150

    
151
/**
152
 * Implements hook_theme().
153
 */
154
function system_theme() {
155
  return array_merge(drupal_common_theme(), array(
156
    'system_themes_page' => array(
157
      'variables' => array('theme_groups' => NULL),
158
      'file' => 'system.admin.inc',
159
    ),
160
    'system_settings_form' => array(
161
      'render element' => 'form',
162
    ),
163
    'confirm_form' => array(
164
      'render element' => 'form',
165
    ),
166
    'system_modules_fieldset' => array(
167
      'render element' => 'form',
168
      'file' => 'system.admin.inc',
169
    ),
170
    'system_modules_incompatible' => array(
171
      'variables' => array('message' => NULL),
172
      'file' => 'system.admin.inc',
173
    ),
174
    'system_modules_uninstall' => array(
175
      'render element' => 'form',
176
      'file' => 'system.admin.inc',
177
    ),
178
    'status_report' => array(
179
      'render element' => 'requirements',
180
      'file' => 'system.admin.inc',
181
    ),
182
    'admin_page' => array(
183
      'variables' => array('blocks' => NULL),
184
      'file' => 'system.admin.inc',
185
    ),
186
    'admin_block' => array(
187
      'variables' => array('block' => NULL),
188
      'file' => 'system.admin.inc',
189
    ),
190
    'admin_block_content' => array(
191
      'variables' => array('content' => NULL),
192
      'file' => 'system.admin.inc',
193
    ),
194
    'system_admin_index' => array(
195
      'variables' => array('menu_items' => NULL),
196
      'file' => 'system.admin.inc',
197
    ),
198
    'system_powered_by' => array(
199
      'variables' => array(),
200
    ),
201
    'system_compact_link' => array(
202
      'variables' => array(),
203
    ),
204
    'system_date_time_settings' => array(
205
      'render element' => 'form',
206
      'file' => 'system.admin.inc',
207
    ),
208
  ));
209
}
210

    
211
/**
212
 * Implements hook_permission().
213
 */
214
function system_permission() {
215
  return array(
216
    'administer modules' => array(
217
      'title' => t('Administer modules'),
218
    ),
219
    'administer site configuration' => array(
220
      'title' => t('Administer site configuration'),
221
      'restrict access' => TRUE,
222
    ),
223
    'administer themes' => array(
224
      'title' => t('Administer themes'),
225
    ),
226
    'administer software updates' => array(
227
      'title' => t('Administer software updates'),
228
      'restrict access' => TRUE,
229
    ),
230
    'administer actions' => array(
231
      'title' => t('Administer actions'),
232
    ),
233
    'access administration pages' => array(
234
      'title' => t('Use the administration pages and help'),
235
    ),
236
    'access site in maintenance mode' => array(
237
      'title' => t('Use the site in maintenance mode'),
238
    ),
239
    'view the administration theme' => array(
240
      'title' => t('View the administration theme'),
241
      'description' => variable_get('admin_theme') ? '' : t('This is only used when the site is configured to use a separate administration theme on the <a href="@appearance-url">Appearance</a> page.', array('@appearance-url' => url('admin/appearance'))),
242
    ),
243
    'access site reports' => array(
244
      'title' => t('View site reports'),
245
      'restrict access' => TRUE,
246
    ),
247
    'block IP addresses' => array(
248
      'title' => t('Block IP addresses'),
249
    ),
250
  );
251
}
252

    
253
/**
254
 * Implements hook_hook_info().
255
 */
256
function system_hook_info() {
257
  $hooks['token_info'] = array(
258
    'group' => 'tokens',
259
  );
260
  $hooks['token_info_alter'] = array(
261
    'group' => 'tokens',
262
  );
263
  $hooks['tokens'] = array(
264
    'group' => 'tokens',
265
  );
266
  $hooks['tokens_alter'] = array(
267
    'group' => 'tokens',
268
  );
269

    
270
  return $hooks;
271
}
272

    
273
/**
274
 * Implements hook_entity_info().
275
 */
276
function system_entity_info() {
277
  return array(
278
    'file' => array(
279
      'label' => t('File'),
280
      'base table' => 'file_managed',
281
      'entity keys' => array(
282
        'id' => 'fid',
283
        'label' => 'filename',
284
      ),
285
      'static cache' => FALSE,
286
    ),
287
  );
288
}
289

    
290
/**
291
 * Implements hook_element_info().
292
 */
293
function system_element_info() {
294
  // Top level elements.
295
  $types['form'] = array(
296
    '#method' => 'post',
297
    '#action' => request_uri(),
298
    '#theme_wrappers' => array('form'),
299
  );
300
  $types['page'] = array(
301
    '#show_messages' => TRUE,
302
    '#theme' => 'page',
303
    '#theme_wrappers' => array('html'),
304
  );
305
  // By default, we don't want Ajax commands being rendered in the context of an
306
  // HTML page, so we don't provide defaults for #theme or #theme_wrappers.
307
  // However, modules can set these properties (for example, to provide an HTML
308
  // debugging page that displays rather than executes Ajax commands).
309
  $types['ajax'] = array(
310
    '#header' => TRUE,
311
    '#commands' => array(),
312
    '#error' => NULL,
313
  );
314
  $types['html_tag'] = array(
315
    '#theme' => 'html_tag',
316
    '#pre_render' => array('drupal_pre_render_conditional_comments'),
317
    '#attributes' => array(),
318
    '#value' => NULL,
319
  );
320
  $types['styles'] = array(
321
    '#items' => array(),
322
    '#pre_render' => array('drupal_pre_render_styles'),
323
    '#group_callback' => 'drupal_group_css',
324
    '#aggregate_callback' => 'drupal_aggregate_css',
325
  );
326

    
327
  // Input elements.
328
  $types['submit'] = array(
329
    '#input' => TRUE,
330
    '#name' => 'op',
331
    '#button_type' => 'submit',
332
    '#executes_submit_callback' => TRUE,
333
    '#limit_validation_errors' => FALSE,
334
    '#process' => array('ajax_process_form'),
335
    '#theme_wrappers' => array('button'),
336
  );
337
  $types['button'] = array(
338
    '#input' => TRUE,
339
    '#name' => 'op',
340
    '#button_type' => 'submit',
341
    '#executes_submit_callback' => FALSE,
342
    '#limit_validation_errors' => FALSE,
343
    '#process' => array('ajax_process_form'),
344
    '#theme_wrappers' => array('button'),
345
  );
346
  $types['image_button'] = array(
347
    '#input' => TRUE,
348
    '#button_type' => 'submit',
349
    '#executes_submit_callback' => TRUE,
350
    '#limit_validation_errors' => FALSE,
351
    '#process' => array('ajax_process_form'),
352
    '#return_value' => TRUE,
353
    '#has_garbage_value' => TRUE,
354
    '#src' => NULL,
355
    '#theme_wrappers' => array('image_button'),
356
  );
357
  $types['textfield'] = array(
358
    '#input' => TRUE,
359
    '#size' => 60,
360
    '#maxlength' => 128,
361
    '#autocomplete_path' => FALSE,
362
    '#process' => array('form_process_autocomplete', 'ajax_process_form'),
363
    '#theme' => 'textfield',
364
    '#theme_wrappers' => array('form_element'),
365
  );
366
  $types['machine_name'] = array(
367
    '#input' => TRUE,
368
    '#default_value' => NULL,
369
    '#required' => TRUE,
370
    '#maxlength' => 64,
371
    '#size' => 60,
372
    '#autocomplete_path' => FALSE,
373
    '#process' => array('form_process_machine_name', 'ajax_process_form'),
374
    '#element_validate' => array('form_validate_machine_name'),
375
    '#theme' => 'textfield',
376
    '#theme_wrappers' => array('form_element'),
377
    // Use the same value callback as for textfields; this ensures that we only
378
    // get string values.
379
    '#value_callback' => 'form_type_textfield_value',
380
  );
381
  $types['password'] = array(
382
    '#input' => TRUE,
383
    '#size' => 60,
384
    '#maxlength' => 128,
385
    '#process' => array('ajax_process_form'),
386
    '#theme' => 'password',
387
    '#theme_wrappers' => array('form_element'),
388
    // Use the same value callback as for textfields; this ensures that we only
389
    // get string values.
390
    '#value_callback' => 'form_type_textfield_value',
391
  );
392
  $types['password_confirm'] = array(
393
    '#input' => TRUE,
394
    '#process' => array('form_process_password_confirm', 'user_form_process_password_confirm'),
395
    '#theme_wrappers' => array('form_element'),
396
  );
397
  $types['textarea'] = array(
398
    '#input' => TRUE,
399
    '#cols' => 60,
400
    '#rows' => 5,
401
    '#resizable' => TRUE,
402
    '#process' => array('ajax_process_form'),
403
    '#theme' => 'textarea',
404
    '#theme_wrappers' => array('form_element'),
405
  );
406
  $types['radios'] = array(
407
    '#input' => TRUE,
408
    '#process' => array('form_process_radios'),
409
    '#theme_wrappers' => array('radios'),
410
    '#pre_render' => array('form_pre_render_conditional_form_element'),
411
  );
412
  $types['radio'] = array(
413
    '#input' => TRUE,
414
    '#default_value' => NULL,
415
    '#process' => array('ajax_process_form'),
416
    '#theme' => 'radio',
417
    '#theme_wrappers' => array('form_element'),
418
    '#title_display' => 'after',
419
  );
420
  $types['checkboxes'] = array(
421
    '#input' => TRUE,
422
    '#process' => array('form_process_checkboxes'),
423
    '#theme_wrappers' => array('checkboxes'),
424
    '#pre_render' => array('form_pre_render_conditional_form_element'),
425
  );
426
  $types['checkbox'] = array(
427
    '#input' => TRUE,
428
    '#return_value' => 1,
429
    '#theme' => 'checkbox',
430
    '#process' => array('form_process_checkbox', 'ajax_process_form'),
431
    '#theme_wrappers' => array('form_element'),
432
    '#title_display' => 'after',
433
  );
434
  $types['select'] = array(
435
    '#input' => TRUE,
436
    '#multiple' => FALSE,
437
    '#process' => array('form_process_select', 'ajax_process_form'),
438
    '#theme' => 'select',
439
    '#theme_wrappers' => array('form_element'),
440
  );
441
  $types['weight'] = array(
442
    '#input' => TRUE,
443
    '#delta' => 10,
444
    '#default_value' => 0,
445
    '#process' => array('form_process_weight', 'ajax_process_form'),
446
  );
447
  $types['date'] = array(
448
    '#input' => TRUE,
449
    '#element_validate' => array('date_validate'),
450
    '#process' => array('form_process_date'),
451
    '#theme' => 'date',
452
    '#theme_wrappers' => array('form_element'),
453
  );
454
  $types['file'] = array(
455
    '#input' => TRUE,
456
    '#size' => 60,
457
    '#theme' => 'file',
458
    '#theme_wrappers' => array('form_element'),
459
  );
460
  $types['tableselect'] = array(
461
    '#input' => TRUE,
462
    '#js_select' => TRUE,
463
    '#multiple' => TRUE,
464
    '#process' => array('form_process_tableselect'),
465
    '#options' => array(),
466
    '#empty' => '',
467
    '#theme' => 'tableselect',
468
  );
469

    
470
  // Form structure.
471
  $types['item'] = array(
472
    '#markup' => '',
473
    '#pre_render' => array('drupal_pre_render_markup'),
474
    '#theme_wrappers' => array('form_element'),
475
  );
476
  $types['hidden'] = array(
477
    '#input' => TRUE,
478
    '#process' => array('ajax_process_form'),
479
    '#theme' => 'hidden',
480
  );
481
  $types['value'] = array(
482
    '#input' => TRUE,
483
  );
484
  $types['markup'] = array(
485
    '#markup' => '',
486
    '#pre_render' => array('drupal_pre_render_markup'),
487
  );
488
  $types['link'] = array(
489
    '#pre_render' => array('drupal_pre_render_link', 'drupal_pre_render_markup'),
490
  );
491
  $types['fieldset'] = array(
492
    '#collapsible' => FALSE,
493
    '#collapsed' => FALSE,
494
    '#value' => NULL,
495
    '#process' => array('form_process_fieldset', 'ajax_process_form'),
496
    '#pre_render' => array('form_pre_render_fieldset'),
497
    '#theme_wrappers' => array('fieldset'),
498
  );
499
  $types['vertical_tabs'] = array(
500
    '#theme_wrappers' => array('vertical_tabs'),
501
    '#default_tab' => '',
502
    '#process' => array('form_process_vertical_tabs'),
503
  );
504

    
505
  $types['container'] = array(
506
    '#theme_wrappers' => array('container'),
507
    '#process' => array('form_process_container'),
508
  );
509
  $types['actions'] = array(
510
    '#theme_wrappers' => array('container'),
511
    '#process' => array('form_process_actions', 'form_process_container'),
512
    '#weight' => 100,
513
  );
514

    
515
  $types['token'] = array(
516
    '#input' => TRUE,
517
    '#theme' => 'hidden',
518
  );
519

    
520
  return $types;
521
}
522

    
523
/**
524
 * Implements hook_menu().
525
 */
526
function system_menu() {
527
  $items['system/files'] = array(
528
    'title' => 'File download',
529
    'page callback' => 'file_download',
530
    'page arguments' => array('private'),
531
    'access callback' => TRUE,
532
    'type' => MENU_CALLBACK,
533
  );
534
  $items['system/temporary'] = array(
535
    'title' => 'Temporary files',
536
    'page callback' => 'file_download',
537
    'page arguments' => array('temporary'),
538
    'access callback' => TRUE,
539
    'type' => MENU_CALLBACK,
540
  );
541
  $items['system/ajax'] = array(
542
    'title' => 'AHAH callback',
543
    'page callback' => 'ajax_form_callback',
544
    'delivery callback' => 'ajax_deliver',
545
    'access callback' => TRUE,
546
    'theme callback' => 'ajax_base_page_theme',
547
    'type' => MENU_CALLBACK,
548
    'file path' => 'includes',
549
    'file' => 'form.inc',
550
  );
551
  $items['system/timezone'] = array(
552
    'title' => 'Time zone',
553
    'page callback' => 'system_timezone',
554
    'access callback' => TRUE,
555
    'type' => MENU_CALLBACK,
556
    'file' => 'system.admin.inc',
557
  );
558
  $items['admin'] = array(
559
    'title' => 'Administration',
560
    'access arguments' => array('access administration pages'),
561
    'page callback' => 'system_admin_menu_block_page',
562
    'weight' => 9,
563
    'menu_name' => 'management',
564
    'file' => 'system.admin.inc',
565
  );
566
  $items['admin/compact'] = array(
567
    'title' => 'Compact mode',
568
    'page callback' => 'system_admin_compact_page',
569
    'access arguments' => array('access administration pages'),
570
    'type' => MENU_CALLBACK,
571
    'file' => 'system.admin.inc',
572
  );
573
  $items['admin/tasks'] = array(
574
    'title' => 'Tasks',
575
    'type' => MENU_DEFAULT_LOCAL_TASK,
576
    'weight' => -20,
577
  );
578
  $items['admin/index'] = array(
579
    'title' => 'Index',
580
    'page callback' => 'system_admin_index',
581
    'access arguments' => array('access administration pages'),
582
    'type' => MENU_LOCAL_TASK,
583
    'weight' => -18,
584
    'file' => 'system.admin.inc',
585
  );
586

    
587
  // Menu items that are basically just menu blocks.
588
  $items['admin/structure'] = array(
589
    'title' => 'Structure',
590
    'description' => 'Administer blocks, content types, menus, etc.',
591
    'position' => 'right',
592
    'weight' => -8,
593
    'page callback' => 'system_admin_menu_block_page',
594
    'access arguments' => array('access administration pages'),
595
    'file' => 'system.admin.inc',
596
  );
597
  // Appearance.
598
  $items['admin/appearance'] = array(
599
    'title' => 'Appearance',
600
    'description' => 'Select and configure your themes.',
601
    'page callback' => 'system_themes_page',
602
    'access arguments' => array('administer themes'),
603
    'position' => 'left',
604
    'weight' => -6,
605
    'file' => 'system.admin.inc',
606
  );
607
  $items['admin/appearance/list'] = array(
608
    'title' => 'List',
609
    'description' => 'Select and configure your theme',
610
    'type' => MENU_DEFAULT_LOCAL_TASK,
611
    'weight' => -1,
612
    'file' => 'system.admin.inc',
613
  );
614
  $items['admin/appearance/enable'] = array(
615
    'title' => 'Enable theme',
616
    'page callback' => 'system_theme_enable',
617
    'access arguments' => array('administer themes'),
618
    'type' => MENU_CALLBACK,
619
    'file' => 'system.admin.inc',
620
  );
621
  $items['admin/appearance/disable'] = array(
622
    'title' => 'Disable theme',
623
    'page callback' => 'system_theme_disable',
624
    'access arguments' => array('administer themes'),
625
    'type' => MENU_CALLBACK,
626
    'file' => 'system.admin.inc',
627
  );
628
  $items['admin/appearance/default'] = array(
629
    'title' => 'Set default theme',
630
    'page callback' => 'system_theme_default',
631
    'access arguments' => array('administer themes'),
632
    'type' => MENU_CALLBACK,
633
    'file' => 'system.admin.inc',
634
  );
635
  $items['admin/appearance/settings'] = array(
636
    'title' => 'Settings',
637
    'description' => 'Configure default and theme specific settings.',
638
    'page callback' => 'drupal_get_form',
639
    'page arguments' => array('system_theme_settings'),
640
    'access arguments' => array('administer themes'),
641
    'type' => MENU_LOCAL_TASK,
642
    'file' => 'system.admin.inc',
643
    'weight' => 20,
644
  );
645
  // Theme configuration subtabs.
646
  $items['admin/appearance/settings/global'] = array(
647
    'title' => 'Global settings',
648
    'type' => MENU_DEFAULT_LOCAL_TASK,
649
    'weight' => -1,
650
  );
651

    
652
  foreach (list_themes() as $theme) {
653
    $items['admin/appearance/settings/' . $theme->name] = array(
654
      'title' => $theme->info['name'],
655
      'page arguments' => array('system_theme_settings', $theme->name),
656
      'type' => MENU_LOCAL_TASK,
657
      'access callback' => '_system_themes_access',
658
      'access arguments' => array($theme),
659
      'file' => 'system.admin.inc',
660
    );
661
  }
662

    
663
  // Modules.
664
  $items['admin/modules'] = array(
665
    'title' => 'Modules',
666
    'description' => 'Extend site functionality.',
667
    'page callback' => 'drupal_get_form',
668
    'page arguments' => array('system_modules'),
669
    'access arguments' => array('administer modules'),
670
    'file' => 'system.admin.inc',
671
    'weight' => -2,
672
  );
673
  $items['admin/modules/list'] = array(
674
    'title' => 'List',
675
    'type' => MENU_DEFAULT_LOCAL_TASK,
676
  );
677
  $items['admin/modules/list/confirm'] = array(
678
    'title' => 'List',
679
    'access arguments' => array('administer modules'),
680
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
681
  );
682
  $items['admin/modules/uninstall'] = array(
683
    'title' => 'Uninstall',
684
    'page arguments' => array('system_modules_uninstall'),
685
    'access arguments' => array('administer modules'),
686
    'type' => MENU_LOCAL_TASK,
687
    'file' => 'system.admin.inc',
688
    'weight' => 20,
689
  );
690
  $items['admin/modules/uninstall/confirm'] = array(
691
    'title' => 'Uninstall',
692
    'access arguments' => array('administer modules'),
693
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
694
    'file' => 'system.admin.inc',
695
  );
696

    
697
  // Configuration.
698
  $items['admin/config'] = array(
699
    'title' => 'Configuration',
700
    'description' => 'Administer settings.',
701
    'page callback' => 'system_admin_config_page',
702
    'access arguments' => array('access administration pages'),
703
    'file' => 'system.admin.inc',
704
  );
705

    
706
  // IP address blocking.
707
  $items['admin/config/people/ip-blocking'] = array(
708
    'title' => 'IP address blocking',
709
    'description' => 'Manage blocked IP addresses.',
710
    'page callback' => 'system_ip_blocking',
711
    'access arguments' => array('block IP addresses'),
712
    'file' => 'system.admin.inc',
713
    'weight' => 10,
714
  );
715
  $items['admin/config/people/ip-blocking/delete/%blocked_ip'] = array(
716
    'title' => 'Delete IP address',
717
    'page callback' => 'drupal_get_form',
718
    'page arguments' => array('system_ip_blocking_delete', 5),
719
    'access arguments' => array('block IP addresses'),
720
    'file' => 'system.admin.inc',
721
  );
722

    
723
  // Media settings.
724
  $items['admin/config/media'] = array(
725
    'title' => 'Media',
726
    'description' => 'Media tools.',
727
    'position' => 'left',
728
    'weight' => -10,
729
    'page callback' => 'system_admin_menu_block_page',
730
    'access arguments' => array('access administration pages'),
731
    'file' => 'system.admin.inc',
732
  );
733
  $items['admin/config/media/file-system'] = array(
734
    'title' => 'File system',
735
    'description' => 'Tell Drupal where to store uploaded files and how they are accessed.',
736
    'page callback' => 'drupal_get_form',
737
    'page arguments' => array('system_file_system_settings'),
738
    'access arguments' => array('administer site configuration'),
739
    'weight' => -10,
740
    'file' => 'system.admin.inc',
741
  );
742
  $items['admin/config/media/image-toolkit'] = array(
743
    'title' => 'Image toolkit',
744
    'description' => 'Choose which image toolkit to use if you have installed optional toolkits.',
745
    'page callback' => 'drupal_get_form',
746
    'page arguments' => array('system_image_toolkit_settings'),
747
    'access arguments' => array('administer site configuration'),
748
    'weight' => 20,
749
    'file' => 'system.admin.inc',
750
  );
751

    
752
  // Service settings.
753
  $items['admin/config/services'] = array(
754
    'title' => 'Web services',
755
    'description' => 'Tools related to web services.',
756
    'position' => 'right',
757
    'weight' => 0,
758
    'page callback' => 'system_admin_menu_block_page',
759
    'access arguments' => array('access administration pages'),
760
    'file' => 'system.admin.inc',
761
  );
762
  $items['admin/config/services/rss-publishing'] = array(
763
    'title' => 'RSS publishing',
764
    'description' => 'Configure the site description, the number of items per feed and whether feeds should be titles/teasers/full-text.',
765
    'page callback' => 'drupal_get_form',
766
    'page arguments' => array('system_rss_feeds_settings'),
767
    'access arguments' => array('administer site configuration'),
768
    'file' => 'system.admin.inc',
769
  );
770

    
771
  // Development settings.
772
  $items['admin/config/development'] = array(
773
    'title' => 'Development',
774
    'description' => 'Development tools.',
775
    'position' => 'right',
776
    'weight' => -10,
777
    'page callback' => 'system_admin_menu_block_page',
778
    'access arguments' => array('access administration pages'),
779
    'file' => 'system.admin.inc',
780
  );
781
  $items['admin/config/development/maintenance'] = array(
782
    'title' => 'Maintenance mode',
783
    'description' => 'Take the site offline for maintenance or bring it back online.',
784
    'page callback' => 'drupal_get_form',
785
    'page arguments' => array('system_site_maintenance_mode'),
786
    'access arguments' => array('administer site configuration'),
787
    'file' => 'system.admin.inc',
788
    'weight' => -10,
789
  );
790
  $items['admin/config/development/performance'] = array(
791
    'title' => 'Performance',
792
    'description' => 'Enable or disable page caching for anonymous users and set CSS and JS bandwidth optimization options.',
793
    'page callback' => 'drupal_get_form',
794
    'page arguments' => array('system_performance_settings'),
795
    'access arguments' => array('administer site configuration'),
796
    'file' => 'system.admin.inc',
797
    'weight' => -20,
798
  );
799
  $items['admin/config/development/logging'] = array(
800
    'title' => 'Logging and errors',
801
    'description' => "Settings for logging and alerts modules. Various modules can route Drupal's system events to different destinations, such as syslog, database, email, etc.",
802
    'page callback' => 'drupal_get_form',
803
    'page arguments' => array('system_logging_settings'),
804
    'access arguments' => array('administer site configuration'),
805
    'file' => 'system.admin.inc',
806
    'weight' => -15,
807
  );
808

    
809
  // Regional and date settings.
810
  $items['admin/config/regional'] = array(
811
    'title' => 'Regional and language',
812
    'description' => 'Regional settings, localization and translation.',
813
    'position' => 'left',
814
    'weight' => -5,
815
    'page callback' => 'system_admin_menu_block_page',
816
    'access arguments' => array('access administration pages'),
817
    'file' => 'system.admin.inc',
818
  );
819
  $items['admin/config/regional/settings'] = array(
820
    'title' => 'Regional settings',
821
    'description' => "Settings for the site's default time zone and country.",
822
    'page callback' => 'drupal_get_form',
823
    'page arguments' => array('system_regional_settings'),
824
    'access arguments' => array('administer site configuration'),
825
    'weight' => -20,
826
    'file' => 'system.admin.inc',
827
  );
828
  $items['admin/config/regional/date-time'] = array(
829
    'title' => 'Date and time',
830
    'description' => 'Configure display formats for date and time.',
831
    'page callback' => 'drupal_get_form',
832
    'page arguments' => array('system_date_time_settings'),
833
    'access arguments' => array('administer site configuration'),
834
    'weight' => -15,
835
    'file' => 'system.admin.inc',
836
  );
837
  $items['admin/config/regional/date-time/types'] = array(
838
    'title' => 'Types',
839
    'description' => 'Configure display formats for date and time.',
840
    'page callback' => 'drupal_get_form',
841
    'page arguments' => array('system_date_time_settings'),
842
    'access arguments' => array('administer site configuration'),
843
    'type' => MENU_DEFAULT_LOCAL_TASK,
844
    'weight' => -10,
845
    'file' => 'system.admin.inc',
846
  );
847
  $items['admin/config/regional/date-time/types/add'] = array(
848
    'title' => 'Add date type',
849
    'description' => 'Add new date type.',
850
    'page callback' => 'drupal_get_form',
851
    'page arguments' => array('system_add_date_format_type_form'),
852
    'access arguments' => array('administer site configuration'),
853
    'type' => MENU_LOCAL_ACTION,
854
    'weight' => -10,
855
    'file' => 'system.admin.inc',
856
  );
857
  $items['admin/config/regional/date-time/types/%/delete'] = array(
858
    'title' => 'Delete date type',
859
    'description' => 'Allow users to delete a configured date type.',
860
    'page callback' => 'drupal_get_form',
861
    'page arguments' => array('system_delete_date_format_type_form', 5),
862
    'access arguments' => array('administer site configuration'),
863
    'file' => 'system.admin.inc',
864
  );
865
  $items['admin/config/regional/date-time/formats'] = array(
866
    'title' => 'Formats',
867
    'description' => 'Configure display format strings for date and time.',
868
    'page callback' => 'system_date_time_formats',
869
    'access arguments' => array('administer site configuration'),
870
    'type' => MENU_LOCAL_TASK,
871
    'weight' => -9,
872
    'file' => 'system.admin.inc',
873
  );
874
  $items['admin/config/regional/date-time/formats/add'] = array(
875
    'title' => 'Add format',
876
    'description' => 'Allow users to add additional date formats.',
877
    'type' => MENU_LOCAL_ACTION,
878
    'page callback' => 'drupal_get_form',
879
    'page arguments' => array('system_configure_date_formats_form'),
880
    'access arguments' => array('administer site configuration'),
881
    'weight' => -10,
882
    'file' => 'system.admin.inc',
883
  );
884
  $items['admin/config/regional/date-time/formats/%/edit'] = array(
885
    'title' => 'Edit date format',
886
    'description' => 'Allow users to edit a configured date format.',
887
    'page callback' => 'drupal_get_form',
888
    'page arguments' => array('system_configure_date_formats_form', 5),
889
    'access arguments' => array('administer site configuration'),
890
    'file' => 'system.admin.inc',
891
  );
892
  $items['admin/config/regional/date-time/formats/%/delete'] = array(
893
    'title' => 'Delete date format',
894
    'description' => 'Allow users to delete a configured date format.',
895
    'page callback' => 'drupal_get_form',
896
    'page arguments' => array('system_date_delete_format_form', 5),
897
    'access arguments' => array('administer site configuration'),
898
    'file' => 'system.admin.inc',
899
  );
900
  $items['admin/config/regional/date-time/formats/lookup'] = array(
901
    'title' => 'Date and time lookup',
902
    'page callback' => 'system_date_time_lookup',
903
    'access arguments' => array('administer site configuration'),
904
    'type' => MENU_CALLBACK,
905
    'file' => 'system.admin.inc',
906
  );
907

    
908
  // Search settings.
909
  $items['admin/config/search'] = array(
910
    'title' => 'Search and metadata',
911
    'description' => 'Local site search, metadata and SEO.',
912
    'position' => 'left',
913
    'weight' => -10,
914
    'page callback' => 'system_admin_menu_block_page',
915
    'access arguments' => array('access administration pages'),
916
    'file' => 'system.admin.inc',
917
  );
918
  $items['admin/config/search/clean-urls'] = array(
919
    'title' => 'Clean URLs',
920
    'description' => 'Enable or disable clean URLs for your site.',
921
    'page callback' => 'drupal_get_form',
922
    'page arguments' => array('system_clean_url_settings'),
923
    'access arguments' => array('administer site configuration'),
924
    'file' => 'system.admin.inc',
925
    'weight' => 5,
926
  );
927
  $items['admin/config/search/clean-urls/check'] = array(
928
    'title' => 'Clean URL check',
929
    'page callback' => 'drupal_json_output',
930
    'page arguments' => array(array('status' => TRUE)),
931
    'access callback' => TRUE,
932
    'type' => MENU_CALLBACK,
933
    'file' => 'system.admin.inc',
934
  );
935

    
936
  // System settings.
937
  $items['admin/config/system'] = array(
938
    'title' => 'System',
939
    'description' => 'General system related configuration.',
940
    'position' => 'right',
941
    'weight' => -20,
942
    'page callback' => 'system_admin_menu_block_page',
943
    'access arguments' => array('access administration pages'),
944
    'file' => 'system.admin.inc',
945
  );
946
  $items['admin/config/system/actions'] = array(
947
    'title' => 'Actions',
948
    'description' => 'Manage the actions defined for your site.',
949
    'access arguments' => array('administer actions'),
950
    'page callback' => 'system_actions_manage',
951
    'file' => 'system.admin.inc',
952
  );
953
  $items['admin/config/system/actions/manage'] = array(
954
    'title' => 'Manage actions',
955
    'description' => 'Manage the actions defined for your site.',
956
    'page callback' => 'system_actions_manage',
957
    'type' => MENU_DEFAULT_LOCAL_TASK,
958
    'weight' => -2,
959
    'file' => 'system.admin.inc',
960
  );
961
  $items['admin/config/system/actions/configure'] = array(
962
    'title' => 'Configure an advanced action',
963
    'page callback' => 'drupal_get_form',
964
    'page arguments' => array('system_actions_configure'),
965
    'access arguments' => array('administer actions'),
966
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
967
    'file' => 'system.admin.inc',
968
  );
969
  $items['admin/config/system/actions/delete/%actions'] = array(
970
    'title' => 'Delete action',
971
    'description' => 'Delete an action.',
972
    'page callback' => 'drupal_get_form',
973
    'page arguments' => array('system_actions_delete_form', 5),
974
    'access arguments' => array('administer actions'),
975
    'file' => 'system.admin.inc',
976
  );
977
  $items['admin/config/system/actions/orphan'] = array(
978
    'title' => 'Remove orphans',
979
    'page callback' => 'system_actions_remove_orphans',
980
    'access arguments' => array('administer actions'),
981
    'type' => MENU_CALLBACK,
982
    'file' => 'system.admin.inc',
983
  );
984
  $items['admin/config/system/site-information'] = array(
985
    'title' => 'Site information',
986
    'description' => 'Change site name, e-mail address, slogan, default front page, and number of posts per page, error pages.',
987
    'page callback' => 'drupal_get_form',
988
    'page arguments' => array('system_site_information_settings'),
989
    'access arguments' => array('administer site configuration'),
990
    'file' => 'system.admin.inc',
991
    'weight' => -20,
992
  );
993
  $items['admin/config/system/cron'] = array(
994
    'title' => 'Cron',
995
    'description' => 'Manage automatic site maintenance tasks.',
996
    'page callback' => 'drupal_get_form',
997
    'page arguments' => array('system_cron_settings'),
998
    'access arguments' => array('administer site configuration'),
999
    'file' => 'system.admin.inc',
1000
    'weight' => 20,
1001
  );
1002
  // Additional categories
1003
  $items['admin/config/user-interface'] = array(
1004
    'title' => 'User interface',
1005
    'description' => 'Tools that enhance the user interface.',
1006
    'position' => 'right',
1007
    'page callback' => 'system_admin_menu_block_page',
1008
    'access arguments' => array('access administration pages'),
1009
    'file' => 'system.admin.inc',
1010
    'weight' => -15,
1011
  );
1012
  $items['admin/config/workflow'] = array(
1013
    'title' => 'Workflow',
1014
    'description' => 'Content workflow, editorial workflow tools.',
1015
    'position' => 'right',
1016
    'weight' => 5,
1017
    'page callback' => 'system_admin_menu_block_page',
1018
    'access arguments' => array('access administration pages'),
1019
    'file' => 'system.admin.inc',
1020
  );
1021
  $items['admin/config/content'] = array(
1022
    'title' => 'Content authoring',
1023
    'description' => 'Settings related to formatting and authoring content.',
1024
    'position' => 'left',
1025
    'weight' => -15,
1026
    'page callback' => 'system_admin_menu_block_page',
1027
    'access arguments' => array('access administration pages'),
1028
    'file' => 'system.admin.inc',
1029
  );
1030

    
1031
  // Reports.
1032
  $items['admin/reports'] = array(
1033
    'title' => 'Reports',
1034
    'description' => 'View reports, updates, and errors.',
1035
    'page callback' => 'system_admin_menu_block_page',
1036
    'access arguments' => array('access site reports'),
1037
    'weight' => 5,
1038
    'position' => 'left',
1039
    'file' => 'system.admin.inc',
1040
  );
1041
  $items['admin/reports/status'] = array(
1042
    'title' => 'Status report',
1043
    'description' => "Get a status report about your site's operation and any detected problems.",
1044
    'page callback' => 'system_status',
1045
    'weight' => -60,
1046
    'access arguments' => array('administer site configuration'),
1047
    'file' => 'system.admin.inc',
1048
  );
1049
  $items['admin/reports/status/run-cron'] = array(
1050
    'title' => 'Run cron',
1051
    'page callback' => 'system_run_cron',
1052
    'access arguments' => array('administer site configuration'),
1053
    'type' => MENU_CALLBACK,
1054
    'file' => 'system.admin.inc',
1055
  );
1056
  $items['admin/reports/status/php'] = array(
1057
    'title' => 'PHP',
1058
    'page callback' => 'system_php',
1059
    'access arguments' => array('administer site configuration'),
1060
    'type' => MENU_CALLBACK,
1061
    'file' => 'system.admin.inc',
1062
  );
1063

    
1064
  // Default page for batch operations.
1065
  $items['batch'] = array(
1066
    'page callback' => 'system_batch_page',
1067
    'access callback' => TRUE,
1068
    'theme callback' => '_system_batch_theme',
1069
    'type' => MENU_CALLBACK,
1070
    'file' => 'system.admin.inc',
1071
  );
1072
  return $items;
1073
}
1074

    
1075
/**
1076
 * Theme callback for the default batch page.
1077
 */
1078
function _system_batch_theme() {
1079
  // Retrieve the current state of the batch.
1080
  $batch = &batch_get();
1081
  if (!$batch && isset($_REQUEST['id'])) {
1082
    require_once DRUPAL_ROOT . '/includes/batch.inc';
1083
    $batch = batch_load($_REQUEST['id']);
1084
  }
1085
  // Use the same theme as the page that started the batch.
1086
  if (!empty($batch['theme'])) {
1087
    return $batch['theme'];
1088
  }
1089
}
1090

    
1091
/**
1092
 * Implements hook_library().
1093
 */
1094
function system_library() {
1095
  // Drupal's Ajax framework.
1096
  $libraries['drupal.ajax'] = array(
1097
    'title' => 'Drupal AJAX',
1098
    'website' => 'http://api.drupal.org/api/drupal/includes--ajax.inc/group/ajax/7',
1099
    'version' => VERSION,
1100
    'js' => array(
1101
      'misc/ajax.js' => array('group' => JS_LIBRARY, 'weight' => 2),
1102
    ),
1103
    'dependencies' => array(
1104
      array('system', 'drupal.progress'),
1105
    ),
1106
  );
1107

    
1108
  // Drupal's batch API.
1109
  $libraries['drupal.batch'] = array(
1110
    'title' => 'Drupal batch API',
1111
    'version' => VERSION,
1112
    'js' => array(
1113
      'misc/batch.js' => array('group' => JS_DEFAULT, 'cache' => FALSE),
1114
    ),
1115
    'dependencies' => array(
1116
      array('system', 'drupal.progress'),
1117
    ),
1118
  );
1119

    
1120
  // Drupal's progress indicator.
1121
  $libraries['drupal.progress'] = array(
1122
    'title' => 'Drupal progress indicator',
1123
    'version' => VERSION,
1124
    'js' => array(
1125
      'misc/progress.js' => array('group' => JS_DEFAULT),
1126
    ),
1127
  );
1128

    
1129
  // Drupal's form library.
1130
  $libraries['drupal.form'] = array(
1131
    'title' => 'Drupal form library',
1132
    'version' => VERSION,
1133
    'js' => array(
1134
      'misc/form.js' => array('group' => JS_LIBRARY, 'weight' => 1),
1135
    ),
1136
  );
1137

    
1138
  // Drupal's states library.
1139
  $libraries['drupal.states'] = array(
1140
    'title' => 'Drupal states',
1141
    'version' => VERSION,
1142
    'js' => array(
1143
      'misc/states.js' => array('group' => JS_LIBRARY, 'weight' => 1),
1144
    ),
1145
  );
1146

    
1147
  // Drupal's collapsible fieldset.
1148
  $libraries['drupal.collapse'] = array(
1149
    'title' => 'Drupal collapsible fieldset',
1150
    'version' => VERSION,
1151
    'js' => array(
1152
      'misc/collapse.js' => array('group' => JS_DEFAULT),
1153
    ),
1154
    'dependencies' => array(
1155
      // collapse.js relies on drupalGetSummary in form.js
1156
      array('system', 'drupal.form'),
1157
    ),
1158
  );
1159

    
1160
  // Drupal's resizable textarea.
1161
  $libraries['drupal.textarea'] = array(
1162
    'title' => 'Drupal resizable textarea',
1163
    'version' => VERSION,
1164
    'js' => array(
1165
      'misc/textarea.js' => array('group' => JS_DEFAULT),
1166
    ),
1167
  );
1168

    
1169
  // Drupal's autocomplete widget.
1170
  $libraries['drupal.autocomplete'] = array(
1171
    'title' => 'Drupal autocomplete',
1172
    'version' => VERSION,
1173
    'js' => array(
1174
      'misc/autocomplete.js' => array('group' => JS_DEFAULT),
1175
    ),
1176
  );
1177

    
1178
  // jQuery.
1179
  $libraries['jquery'] = array(
1180
    'title' => 'jQuery',
1181
    'website' => 'http://jquery.com',
1182
    'version' => '1.4.4',
1183
    'js' => array(
1184
      'misc/jquery.js' => array('group' => JS_LIBRARY, 'weight' => -20),
1185
      // This includes a security fix, so assign a weight that makes this load
1186
      // as soon after jquery.js is loaded as possible.
1187
      'misc/jquery-extend-3.4.0.js' => array('group' => JS_LIBRARY, 'weight' => -19),
1188
    ),
1189
  );
1190

    
1191
  // jQuery Once.
1192
  $libraries['jquery.once'] = array(
1193
    'title' => 'jQuery Once',
1194
    'website' => 'http://plugins.jquery.com/project/once',
1195
    'version' => '1.2',
1196
    'js' => array(
1197
      'misc/jquery.once.js' => array('group' => JS_LIBRARY, 'weight' => -19),
1198
    ),
1199
  );
1200

    
1201
  // jQuery Form Plugin.
1202
  $libraries['jquery.form'] = array(
1203
    'title' => 'jQuery Form Plugin',
1204
    'website' => 'http://malsup.com/jquery/form/',
1205
    'version' => '2.52',
1206
    'js' => array(
1207
      'misc/jquery.form.js' => array(),
1208
    ),
1209
    'dependencies' => array(
1210
      array('system', 'jquery.cookie'),
1211
    ),
1212
  );
1213

    
1214
  // jQuery BBQ plugin.
1215
  $libraries['jquery.bbq'] = array(
1216
    'title' => 'jQuery BBQ',
1217
    'website' => 'http://benalman.com/projects/jquery-bbq-plugin/',
1218
    'version' => '1.2.1',
1219
    'js' => array(
1220
      'misc/jquery.ba-bbq.js' => array(),
1221
    ),
1222
  );
1223

    
1224
  // Vertical Tabs.
1225
  $libraries['drupal.vertical-tabs'] = array(
1226
    'title' => 'Vertical Tabs',
1227
    'website' => 'http://drupal.org/node/323112',
1228
    'version' => '1.0',
1229
    'js' => array(
1230
      'misc/vertical-tabs.js' => array(),
1231
    ),
1232
    'css' => array(
1233
      'misc/vertical-tabs.css' => array(),
1234
    ),
1235
    'dependencies' => array(
1236
      // Vertical tabs relies on drupalGetSummary in form.js
1237
      array('system', 'drupal.form'),
1238
    ),
1239
  );
1240

    
1241
  // Farbtastic.
1242
  $libraries['farbtastic'] = array(
1243
    'title' => 'Farbtastic',
1244
    'website' => 'http://code.google.com/p/farbtastic/',
1245
    'version' => '1.2',
1246
    'js' => array(
1247
      'misc/farbtastic/farbtastic.js' => array(),
1248
    ),
1249
    'css' => array(
1250
      'misc/farbtastic/farbtastic.css' => array(),
1251
    ),
1252
  );
1253

    
1254
  // Cookie.
1255
  $libraries['jquery.cookie'] = array(
1256
    'title' => 'Cookie',
1257
    'website' => 'http://plugins.jquery.com/project/cookie',
1258
    'version' => '1.0',
1259
    'js' => array(
1260
      'misc/jquery.cookie.js' => array(),
1261
    ),
1262
  );
1263

    
1264
  // jQuery UI.
1265
  $libraries['ui'] = array(
1266
    'title' => 'jQuery UI: Core',
1267
    'website' => 'http://jqueryui.com',
1268
    'version' => '1.8.7',
1269
    'js' => array(
1270
      'misc/ui/jquery.ui.core.min.js' => array('group' => JS_LIBRARY, 'weight' => -11),
1271
    ),
1272
    'css' => array(
1273
      'misc/ui/jquery.ui.core.css' => array(),
1274
      'misc/ui/jquery.ui.theme.css' => array(),
1275
    ),
1276
  );
1277
  $libraries['ui.accordion'] = array(
1278
    'title' => 'jQuery UI: Accordion',
1279
    'website' => 'http://jqueryui.com/demos/accordion/',
1280
    'version' => '1.8.7',
1281
    'js' => array(
1282
      'misc/ui/jquery.ui.accordion.min.js' => array(),
1283
    ),
1284
    'css' => array(
1285
      'misc/ui/jquery.ui.accordion.css' => array(),
1286
    ),
1287
    'dependencies' => array(
1288
      array('system', 'ui.widget'),
1289
    ),
1290
  );
1291
  $libraries['ui.autocomplete'] = array(
1292
    'title' => 'jQuery UI: Autocomplete',
1293
    'website' => 'http://jqueryui.com/demos/autocomplete/',
1294
    'version' => '1.8.7',
1295
    'js' => array(
1296
      'misc/ui/jquery.ui.autocomplete.min.js' => array(),
1297
    ),
1298
    'css' => array(
1299
      'misc/ui/jquery.ui.autocomplete.css' => array(),
1300
    ),
1301
    'dependencies' => array(
1302
      array('system', 'ui.widget'),
1303
      array('system', 'ui.position'),
1304
    ),
1305
  );
1306
  $libraries['ui.button'] = array(
1307
    'title' => 'jQuery UI: Button',
1308
    'website' => 'http://jqueryui.com/demos/button/',
1309
    'version' => '1.8.7',
1310
    'js' => array(
1311
      'misc/ui/jquery.ui.button.min.js' => array(),
1312
    ),
1313
    'css' => array(
1314
      'misc/ui/jquery.ui.button.css' => array(),
1315
    ),
1316
    'dependencies' => array(
1317
      array('system', 'ui.widget'),
1318
    ),
1319
  );
1320
  $libraries['ui.datepicker'] = array(
1321
    'title' => 'jQuery UI: Date Picker',
1322
    'website' => 'http://jqueryui.com/demos/datepicker/',
1323
    'version' => '1.8.7',
1324
    'js' => array(
1325
      'misc/ui/jquery.ui.datepicker.min.js' => array(),
1326
    ),
1327
    'css' => array(
1328
      'misc/ui/jquery.ui.datepicker.css' => array(),
1329
    ),
1330
    'dependencies' => array(
1331
      array('system', 'ui'),
1332
    ),
1333
  );
1334
  $libraries['ui.dialog'] = array(
1335
    'title' => 'jQuery UI: Dialog',
1336
    'website' => 'http://jqueryui.com/demos/dialog/',
1337
    'version' => '1.8.7',
1338
    'js' => array(
1339
      'misc/ui/jquery.ui.dialog.min.js' => array(),
1340
    ),
1341
    'css' => array(
1342
      'misc/ui/jquery.ui.dialog.css' => array(),
1343
    ),
1344
    'dependencies' => array(
1345
      array('system', 'ui.widget'),
1346
      array('system', 'ui.button'),
1347
      array('system', 'ui.draggable'),
1348
      array('system', 'ui.mouse'),
1349
      array('system', 'ui.position'),
1350
      array('system', 'ui.resizable'),
1351
    ),
1352
  );
1353
  $libraries['ui.draggable'] = array(
1354
    'title' => 'jQuery UI: Draggable',
1355
    'website' => 'http://jqueryui.com/demos/draggable/',
1356
    'version' => '1.8.7',
1357
    'js' => array(
1358
      'misc/ui/jquery.ui.draggable.min.js' => array(),
1359
    ),
1360
    'dependencies' => array(
1361
      array('system', 'ui.widget'),
1362
      array('system', 'ui.mouse'),
1363
    ),
1364
  );
1365
  $libraries['ui.droppable'] = array(
1366
    'title' => 'jQuery UI: Droppable',
1367
    'website' => 'http://jqueryui.com/demos/droppable/',
1368
    'version' => '1.8.7',
1369
    'js' => array(
1370
      'misc/ui/jquery.ui.droppable.min.js' => array(),
1371
    ),
1372
    'dependencies' => array(
1373
      array('system', 'ui.widget'),
1374
      array('system', 'ui.mouse'),
1375
      array('system', 'ui.draggable'),
1376
    ),
1377
  );
1378
  $libraries['ui.mouse'] = array(
1379
    'title' => 'jQuery UI: Mouse',
1380
    'website' => 'http://docs.jquery.com/UI/Mouse',
1381
    'version' => '1.8.7',
1382
    'js' => array(
1383
      'misc/ui/jquery.ui.mouse.min.js' => array(),
1384
    ),
1385
    'dependencies' => array(
1386
      array('system', 'ui.widget'),
1387
    ),
1388
  );
1389
  $libraries['ui.position'] = array(
1390
    'title' => 'jQuery UI: Position',
1391
    'website' => 'http://jqueryui.com/demos/position/',
1392
    'version' => '1.8.7',
1393
    'js' => array(
1394
      'misc/ui/jquery.ui.position.min.js' => array(),
1395
    ),
1396
  );
1397
  $libraries['ui.progressbar'] = array(
1398
    'title' => 'jQuery UI: Progress Bar',
1399
    'website' => 'http://jqueryui.com/demos/progressbar/',
1400
    'version' => '1.8.7',
1401
    'js' => array(
1402
      'misc/ui/jquery.ui.progressbar.min.js' => array(),
1403
    ),
1404
    'css' => array(
1405
      'misc/ui/jquery.ui.progressbar.css' => array(),
1406
    ),
1407
    'dependencies' => array(
1408
      array('system', 'ui.widget'),
1409
    ),
1410
  );
1411
  $libraries['ui.resizable'] = array(
1412
    'title' => 'jQuery UI: Resizable',
1413
    'website' => 'http://jqueryui.com/demos/resizable/',
1414
    'version' => '1.8.7',
1415
    'js' => array(
1416
      'misc/ui/jquery.ui.resizable.min.js' => array(),
1417
    ),
1418
    'css' => array(
1419
      'misc/ui/jquery.ui.resizable.css' => array(),
1420
    ),
1421
    'dependencies' => array(
1422
      array('system', 'ui.widget'),
1423
      array('system', 'ui.mouse'),
1424
    ),
1425
  );
1426
  $libraries['ui.selectable'] = array(
1427
    'title' => 'jQuery UI: Selectable',
1428
    'website' => 'http://jqueryui.com/demos/selectable/',
1429
    'version' => '1.8.7',
1430
    'js' => array(
1431
      'misc/ui/jquery.ui.selectable.min.js' => array(),
1432
    ),
1433
    'css' => array(
1434
      'misc/ui/jquery.ui.selectable.css' => array(),
1435
    ),
1436
    'dependencies' => array(
1437
      array('system', 'ui.widget'),
1438
      array('system', 'ui.mouse'),
1439
    ),
1440
  );
1441
  $libraries['ui.slider'] = array(
1442
    'title' => 'jQuery UI: Slider',
1443
    'website' => 'http://jqueryui.com/demos/slider/',
1444
    'version' => '1.8.7',
1445
    'js' => array(
1446
      'misc/ui/jquery.ui.slider.min.js' => array(),
1447
    ),
1448
    'css' => array(
1449
      'misc/ui/jquery.ui.slider.css' => array(),
1450
    ),
1451
    'dependencies' => array(
1452
      array('system', 'ui.widget'),
1453
      array('system', 'ui.mouse'),
1454
    ),
1455
  );
1456
  $libraries['ui.sortable'] = array(
1457
    'title' => 'jQuery UI: Sortable',
1458
    'website' => 'http://jqueryui.com/demos/sortable/',
1459
    'version' => '1.8.7',
1460
    'js' => array(
1461
      'misc/ui/jquery.ui.sortable.min.js' => array(),
1462
    ),
1463
    'dependencies' => array(
1464
      array('system', 'ui.widget'),
1465
      array('system', 'ui.mouse'),
1466
    ),
1467
  );
1468
  $libraries['ui.tabs'] = array(
1469
    'title' => 'jQuery UI: Tabs',
1470
    'website' => 'http://jqueryui.com/demos/tabs/',
1471
    'version' => '1.8.7',
1472
    'js' => array(
1473
      'misc/ui/jquery.ui.tabs.min.js' => array(),
1474
    ),
1475
    'css' => array(
1476
      'misc/ui/jquery.ui.tabs.css' => array(),
1477
    ),
1478
    'dependencies' => array(
1479
      array('system', 'ui.widget'),
1480
    ),
1481
  );
1482
  $libraries['ui.widget'] = array(
1483
    'title' => 'jQuery UI: Widget',
1484
    'website' => 'http://docs.jquery.com/UI/Widget',
1485
    'version' => '1.8.7',
1486
    'js' => array(
1487
      'misc/ui/jquery.ui.widget.min.js' => array('group' => JS_LIBRARY, 'weight' => -10),
1488
    ),
1489
    'dependencies' => array(
1490
      array('system', 'ui'),
1491
    ),
1492
  );
1493
  $libraries['effects'] = array(
1494
    'title' => 'jQuery UI: Effects',
1495
    'website' => 'http://jqueryui.com/demos/effect/',
1496
    'version' => '1.8.7',
1497
    'js' => array(
1498
      'misc/ui/jquery.effects.core.min.js' => array('group' => JS_LIBRARY, 'weight' => -9),
1499
    ),
1500
  );
1501
  $libraries['effects.blind'] = array(
1502
    'title' => 'jQuery UI: Effects Blind',
1503
    'website' => 'http://jqueryui.com/demos/effect/',
1504
    'version' => '1.8.7',
1505
    'js' => array(
1506
      'misc/ui/jquery.effects.blind.min.js' => array(),
1507
    ),
1508
    'dependencies' => array(
1509
      array('system', 'effects'),
1510
    ),
1511
  );
1512
  $libraries['effects.bounce'] = array(
1513
    'title' => 'jQuery UI: Effects Bounce',
1514
    'website' => 'http://jqueryui.com/demos/effect/',
1515
    'version' => '1.8.7',
1516
    'js' => array(
1517
      'misc/ui/jquery.effects.bounce.min.js' => array(),
1518
    ),
1519
    'dependencies' => array(
1520
      array('system', 'effects'),
1521
    ),
1522
  );
1523
  $libraries['effects.clip'] = array(
1524
    'title' => 'jQuery UI: Effects Clip',
1525
    'website' => 'http://jqueryui.com/demos/effect/',
1526
    'version' => '1.8.7',
1527
    'js' => array(
1528
      'misc/ui/jquery.effects.clip.min.js' => array(),
1529
    ),
1530
    'dependencies' => array(
1531
      array('system', 'effects'),
1532
    ),
1533
  );
1534
  $libraries['effects.drop'] = array(
1535
    'title' => 'jQuery UI: Effects Drop',
1536
    'website' => 'http://jqueryui.com/demos/effect/',
1537
    'version' => '1.8.7',
1538
    'js' => array(
1539
      'misc/ui/jquery.effects.drop.min.js' => array(),
1540
    ),
1541
    'dependencies' => array(
1542
      array('system', 'effects'),
1543
    ),
1544
  );
1545
  $libraries['effects.explode'] = array(
1546
    'title' => 'jQuery UI: Effects Explode',
1547
    'website' => 'http://jqueryui.com/demos/effect/',
1548
    'version' => '1.8.7',
1549
    'js' => array(
1550
      'misc/ui/jquery.effects.explode.min.js' => array(),
1551
    ),
1552
    'dependencies' => array(
1553
      array('system', 'effects'),
1554
    ),
1555
  );
1556
  $libraries['effects.fade'] = array(
1557
    'title' => 'jQuery UI: Effects Fade',
1558
    'website' => 'http://jqueryui.com/demos/effect/',
1559
    'version' => '1.8.7',
1560
    'js' => array(
1561
      'misc/ui/jquery.effects.fade.min.js' => array(),
1562
    ),
1563
    'dependencies' => array(
1564
      array('system', 'effects'),
1565
    ),
1566
  );
1567
  $libraries['effects.fold'] = array(
1568
    'title' => 'jQuery UI: Effects Fold',
1569
    'website' => 'http://jqueryui.com/demos/effect/',
1570
    'version' => '1.8.7',
1571
    'js' => array(
1572
      'misc/ui/jquery.effects.fold.min.js' => array(),
1573
    ),
1574
    'dependencies' => array(
1575
      array('system', 'effects'),
1576
    ),
1577
  );
1578
  $libraries['effects.highlight'] = array(
1579
    'title' => 'jQuery UI: Effects Highlight',
1580
    'website' => 'http://jqueryui.com/demos/effect/',
1581
    'version' => '1.8.7',
1582
    'js' => array(
1583
      'misc/ui/jquery.effects.highlight.min.js' => array(),
1584
    ),
1585
    'dependencies' => array(
1586
      array('system', 'effects'),
1587
    ),
1588
  );
1589
  $libraries['effects.pulsate'] = array(
1590
    'title' => 'jQuery UI: Effects Pulsate',
1591
    'website' => 'http://jqueryui.com/demos/effect/',
1592
    'version' => '1.8.7',
1593
    'js' => array(
1594
      'misc/ui/jquery.effects.pulsate.min.js' => array(),
1595
    ),
1596
    'dependencies' => array(
1597
      array('system', 'effects'),
1598
    ),
1599
  );
1600
  $libraries['effects.scale'] = array(
1601
    'title' => 'jQuery UI: Effects Scale',
1602
    'website' => 'http://jqueryui.com/demos/effect/',
1603
    'version' => '1.8.7',
1604
    'js' => array(
1605
      'misc/ui/jquery.effects.scale.min.js' => array(),
1606
    ),
1607
    'dependencies' => array(
1608
      array('system', 'effects'),
1609
    ),
1610
  );
1611
  $libraries['effects.shake'] = array(
1612
    'title' => 'jQuery UI: Effects Shake',
1613
    'website' => 'http://jqueryui.com/demos/effect/',
1614
    'version' => '1.8.7',
1615
    'js' => array(
1616
      'misc/ui/jquery.effects.shake.min.js' => array(),
1617
    ),
1618
    'dependencies' => array(
1619
      array('system', 'effects'),
1620
    ),
1621
  );
1622
  $libraries['effects.slide'] = array(
1623
    'title' => 'jQuery UI: Effects Slide',
1624
    'website' => 'http://jqueryui.com/demos/effect/',
1625
    'version' => '1.8.7',
1626
    'js' => array(
1627
      'misc/ui/jquery.effects.slide.min.js' => array(),
1628
    ),
1629
    'dependencies' => array(
1630
      array('system', 'effects'),
1631
    ),
1632
  );
1633
  $libraries['effects.transfer'] = array(
1634
    'title' => 'jQuery UI: Effects Transfer',
1635
    'website' => 'http://jqueryui.com/demos/effect/',
1636
    'version' => '1.8.7',
1637
    'js' => array(
1638
      'misc/ui/jquery.effects.transfer.min.js' => array(),
1639
    ),
1640
    'dependencies' => array(
1641
      array('system', 'effects'),
1642
    ),
1643
  );
1644

    
1645
  // These library names are deprecated. Earlier versions of Drupal 7 didn't
1646
  // consistently namespace their libraries, so these names are included for
1647
  // backwards compatibility with those versions.
1648
  $libraries['once'] = &$libraries['jquery.once'];
1649
  $libraries['form'] = &$libraries['jquery.form'];
1650
  $libraries['jquery-bbq'] = &$libraries['jquery.bbq'];
1651
  $libraries['vertical-tabs'] = &$libraries['drupal.vertical-tabs'];
1652
  $libraries['cookie'] = &$libraries['jquery.cookie'];
1653

    
1654
  return $libraries;
1655
}
1656

    
1657
/**
1658
 * Implements hook_stream_wrappers().
1659
 */
1660
function system_stream_wrappers() {
1661
  $wrappers = array(
1662
    'public' => array(
1663
      'name' => t('Public files'),
1664
      'class' => 'DrupalPublicStreamWrapper',
1665
      'description' => t('Public local files served by the webserver.'),
1666
      'type' => STREAM_WRAPPERS_LOCAL_NORMAL,
1667
    ),
1668
    'temporary' => array(
1669
      'name' => t('Temporary files'),
1670
      'class' => 'DrupalTemporaryStreamWrapper',
1671
      'description' => t('Temporary local files for upload and previews.'),
1672
      'type' => STREAM_WRAPPERS_LOCAL_HIDDEN,
1673
    ),
1674
  );
1675

    
1676
  // Only register the private file stream wrapper if a file path has been set.
1677
  if (variable_get('file_private_path', FALSE)) {
1678
    $wrappers['private'] = array(
1679
      'name' => t('Private files'),
1680
      'class' => 'DrupalPrivateStreamWrapper',
1681
      'description' => t('Private local files served by Drupal.'),
1682
      'type' => STREAM_WRAPPERS_LOCAL_NORMAL,
1683
    );
1684
  }
1685

    
1686
  return $wrappers;
1687
}
1688

    
1689
/**
1690
 * Retrieve a blocked IP address from the database.
1691
 *
1692
 * @param $iid integer
1693
 *   The ID of the blocked IP address to retrieve.
1694
 *
1695
 * @return
1696
 *   The blocked IP address from the database as an array.
1697
 */
1698
function blocked_ip_load($iid) {
1699
  return db_query("SELECT * FROM {blocked_ips} WHERE iid = :iid", array(':iid' => $iid))->fetchAssoc();
1700
}
1701

    
1702
/**
1703
 * Menu item access callback - only admin or enabled themes can be accessed.
1704
 */
1705
function _system_themes_access($theme) {
1706
  return user_access('administer themes') && drupal_theme_access($theme);
1707
}
1708

    
1709
/**
1710
 * @defgroup authorize Authorized operations
1711
 * @{
1712
 * Functions to run operations with elevated privileges via authorize.php.
1713
 *
1714
 * Because of the Update manager functionality included in Drupal core, there
1715
 * is a mechanism for running operations with elevated file system privileges,
1716
 * the top-level authorize.php script. This script runs at a reduced Drupal
1717
 * bootstrap level so that it is not reliant on the entire site being
1718
 * functional. The operations use a FileTransfer class to manipulate code
1719
 * installed on the system as the user that owns the files, not the user that
1720
 * the httpd is running as.
1721
 *
1722
 * The first setup is to define a callback function that should be authorized
1723
 * to run with the elevated privileges. This callback should take a
1724
 * FileTransfer as its first argument, although you can define an array of
1725
 * other arguments it should be invoked with. The callback should be placed in
1726
 * a separate .inc file that will be included by authorize.php.
1727
 *
1728
 * To run the operation, certain data must be saved into the SESSION, and then
1729
 * the flow of control should be redirected to the authorize.php script. There
1730
 * are two ways to do this, either to call system_authorized_run() directly,
1731
 * or to call system_authorized_init() and then redirect to authorize.php,
1732
 * using the URL from system_authorized_get_url(). Redirecting yourself is
1733
 * necessary when your authorized operation is being triggered by a form
1734
 * submit handler, since calling drupal_goto() in a submit handler is a bad
1735
 * idea, and you should instead set $form_state['redirect'].
1736
 *
1737
 * Once the SESSION is setup for the operation and the user is redirected to
1738
 * authorize.php, they will be prompted for their connection credentials (core
1739
 * provides FTP and SSH by default, although other connection classes can be
1740
 * added via contributed modules). With valid credentials, authorize.php will
1741
 * instantiate the appropriate FileTransfer object, and then invoke the
1742
 * desired operation passing in that object. The authorize.php script can act
1743
 * as a Batch API processing page, if the operation requires a batch.
1744
 *
1745
 * @see authorize.php
1746
 * @see FileTransfer
1747
 * @see hook_filetransfer_info()
1748
 */
1749

    
1750
/**
1751
 * Setup a given callback to run via authorize.php with elevated privileges.
1752
 *
1753
 * To use authorize.php, certain variables must be stashed into $_SESSION. This
1754
 * function sets up all the necessary $_SESSION variables. The calling function
1755
 * should then redirect to authorize.php, using the full path returned by
1756
 * system_authorized_get_url(). That initiates the workflow that will eventually
1757
 * lead to the callback being invoked. The callback will be invoked at a low
1758
 * bootstrap level, without all modules being invoked, so it needs to be careful
1759
 * not to assume any code exists. Example (system_authorized_run()):
1760
 * @code
1761
 *   system_authorized_init($callback, $file, $arguments, $page_title);
1762
 *   drupal_goto(system_authorized_get_url());
1763
 * @endcode
1764
 * Example (update_manager_install_form_submit()):
1765
 * @code
1766
 *  system_authorized_init('update_authorize_run_install',
1767
 *    drupal_get_path('module', 'update') . '/update.authorize.inc',
1768
 *    $arguments, t('Update manager'));
1769
 *  $form_state['redirect'] = system_authorized_get_url();
1770
 * @endcode
1771
 *
1772
 * @param $callback
1773
 *   The name of the function to invoke once the user authorizes the operation.
1774
 * @param $file
1775
 *   The full path to the file where the callback function is implemented.
1776
 * @param $arguments
1777
 *   Optional array of arguments to pass into the callback when it is invoked.
1778
 *   Note that the first argument to the callback is always the FileTransfer
1779
 *   object created by authorize.php when the user authorizes the operation.
1780
 * @param $page_title
1781
 *   Optional string to use as the page title once redirected to authorize.php.
1782
 * @return
1783
 *   Nothing, this function just initializes variables in the user's session.
1784
 */
1785
function system_authorized_init($callback, $file, $arguments = array(), $page_title = NULL) {
1786
  // First, figure out what file transfer backends the site supports, and put
1787
  // all of those in the SESSION so that authorize.php has access to all of
1788
  // them via the class autoloader, even without a full bootstrap.
1789
  $_SESSION['authorize_filetransfer_info'] = drupal_get_filetransfer_info();
1790

    
1791
  // Now, define the callback to invoke.
1792
  $_SESSION['authorize_operation'] = array(
1793
    'callback' => $callback,
1794
    'file' => $file,
1795
    'arguments' => $arguments,
1796
  );
1797

    
1798
  if (isset($page_title)) {
1799
    $_SESSION['authorize_operation']['page_title'] = $page_title;
1800
  }
1801
}
1802

    
1803
/**
1804
 * Return the URL for the authorize.php script.
1805
 *
1806
 * @param array $options
1807
 *   Optional array of options to pass to url().
1808
 * @return
1809
 *   The full URL to authorize.php, using HTTPS if available.
1810
 *
1811
 * @see system_authorized_init()
1812
 */
1813
function system_authorized_get_url(array $options = array()) {
1814
  global $base_url;
1815
  // Force HTTPS if available, regardless of what the caller specifies.
1816
  $options['https'] = TRUE;
1817
  // We prefix with $base_url so we get a full path even if clean URLs are
1818
  // disabled.
1819
  return url($base_url . '/authorize.php', $options);
1820
}
1821

    
1822
/**
1823
 * Returns the URL for the authorize.php script when it is processing a batch.
1824
 */
1825
function system_authorized_batch_processing_url() {
1826
  return system_authorized_get_url(array('query' => array('batch' => '1')));
1827
}
1828

    
1829
/**
1830
 * Setup and invoke an operation using authorize.php.
1831
 *
1832
 * @see system_authorized_init()
1833
 */
1834
function system_authorized_run($callback, $file, $arguments = array(), $page_title = NULL) {
1835
  system_authorized_init($callback, $file, $arguments, $page_title);
1836
  drupal_goto(system_authorized_get_url());
1837
}
1838

    
1839
/**
1840
 * Use authorize.php to run batch_process().
1841
 *
1842
 * @see batch_process()
1843
 */
1844
function system_authorized_batch_process() {
1845
  $finish_url = system_authorized_get_url();
1846
  $process_url = system_authorized_batch_processing_url();
1847
  batch_process($finish_url, $process_url);
1848
}
1849

    
1850
/**
1851
 * @} End of "defgroup authorize".
1852
 */
1853

    
1854
/**
1855
 * Implements hook_updater_info().
1856
 */
1857
function system_updater_info() {
1858
  return array(
1859
    'module' => array(
1860
      'class' => 'ModuleUpdater',
1861
      'name' => t('Update modules'),
1862
      'weight' => 0,
1863
    ),
1864
    'theme' => array(
1865
      'class' => 'ThemeUpdater',
1866
      'name' => t('Update themes'),
1867
      'weight' => 0,
1868
    ),
1869
  );
1870
}
1871

    
1872
/**
1873
 * Implements hook_filetransfer_info().
1874
 */
1875
function system_filetransfer_info() {
1876
  $backends = array();
1877

    
1878
  // This is the default, will be available on most systems.
1879
  if (function_exists('ftp_connect')) {
1880
    $backends['ftp'] = array(
1881
      'title' => t('FTP'),
1882
      'class' => 'FileTransferFTP',
1883
      'file' => 'ftp.inc',
1884
      'file path' => 'includes/filetransfer',
1885
      'weight' => 0,
1886
    );
1887
  }
1888

    
1889
  // SSH2 lib connection is only available if the proper PHP extension is
1890
  // installed.
1891
  if (function_exists('ssh2_connect')) {
1892
    $backends['ssh'] = array(
1893
      'title' => t('SSH'),
1894
      'class' => 'FileTransferSSH',
1895
      'file' => 'ssh.inc',
1896
      'file path' => 'includes/filetransfer',
1897
      'weight' => 20,
1898
    );
1899
  }
1900
  return $backends;
1901
}
1902

    
1903
/**
1904
 * Implements hook_init().
1905
 */
1906
function system_init() {
1907
  $path = drupal_get_path('module', 'system');
1908
  // Add the CSS for this module. These aren't in system.info, because they
1909
  // need to be in the CSS_SYSTEM group rather than the CSS_DEFAULT group.
1910
  drupal_add_css($path . '/system.base.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
1911
  if (path_is_admin(current_path())) {
1912
    drupal_add_css($path . '/system.admin.css', array('group' => CSS_SYSTEM));
1913
  }
1914
  drupal_add_css($path . '/system.menus.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
1915
  drupal_add_css($path . '/system.messages.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
1916
  drupal_add_css($path . '/system.theme.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
1917

    
1918
  // Ignore slave database servers for this request.
1919
  //
1920
  // In Drupal's distributed database structure, new data is written to the
1921
  // master and then propagated to the slave servers.  This means there is a
1922
  // lag between when data is written to the master and when it is available on
1923
  // the slave. At these times, we will want to avoid using a slave server
1924
  // temporarily. For example, if a user posts a new node then we want to
1925
  // disable the slave server for that user temporarily to allow the slave
1926
  // server to catch up. That way, that user will see their changes immediately
1927
  // while for other users we still get the benefits of having a slave server,
1928
  // just with slightly stale data.  Code that wants to disable the slave
1929
  // server should use the db_ignore_slave() function to set
1930
  // $_SESSION['ignore_slave_server'] to the timestamp after which the slave
1931
  // can be re-enabled.
1932
  if (isset($_SESSION['ignore_slave_server'])) {
1933
    if ($_SESSION['ignore_slave_server'] >= REQUEST_TIME) {
1934
      Database::ignoreTarget('default', 'slave');
1935
    }
1936
    else {
1937
      unset($_SESSION['ignore_slave_server']);
1938
    }
1939
  }
1940

    
1941
  // Add CSS/JS files from module .info files.
1942
  system_add_module_assets();
1943
}
1944

    
1945
/**
1946
 * Adds CSS and JavaScript files declared in module .info files.
1947
 */
1948
function system_add_module_assets() {
1949
  foreach (system_get_info('module') as $module => $info) {
1950
    if (!empty($info['stylesheets'])) {
1951
      foreach ($info['stylesheets'] as $media => $stylesheets) {
1952
        foreach ($stylesheets as $stylesheet) {
1953
          drupal_add_css($stylesheet, array('every_page' => TRUE, 'media' => $media));
1954
        }
1955
      }
1956
    }
1957
    if (!empty($info['scripts'])) {
1958
      foreach ($info['scripts'] as $script) {
1959
        drupal_add_js($script, array('every_page' => TRUE));
1960
      }
1961
    }
1962
  }
1963
}
1964

    
1965
/**
1966
 * Implements hook_custom_theme().
1967
 */
1968
function system_custom_theme() {
1969
  if (user_access('view the administration theme') && path_is_admin(current_path())) {
1970
    return variable_get('admin_theme');
1971
  }
1972
}
1973

    
1974
/**
1975
 * Implements hook_form_FORM_ID_alter().
1976
 */
1977
function system_form_user_profile_form_alter(&$form, &$form_state) {
1978
  if ($form['#user_category'] == 'account') {
1979
    if (variable_get('configurable_timezones', 1)) {
1980
      system_user_timezone($form, $form_state);
1981
    }
1982
    return $form;
1983
  }
1984
}
1985

    
1986
/**
1987
 * Implements hook_form_FORM_ID_alter().
1988
 */
1989
function system_form_user_register_form_alter(&$form, &$form_state) {
1990
  if (variable_get('configurable_timezones', 1)) {
1991
    if (variable_get('user_default_timezone', DRUPAL_USER_TIMEZONE_DEFAULT) == DRUPAL_USER_TIMEZONE_SELECT) {
1992
      system_user_timezone($form, $form_state);
1993
    }
1994
    else {
1995
      $form['account']['timezone'] = array(
1996
        '#type' => 'hidden',
1997
        '#value' => variable_get('user_default_timezone', DRUPAL_USER_TIMEZONE_DEFAULT) ? '' : variable_get('date_default_timezone', ''),
1998
      );
1999
    }
2000
    return $form;
2001
  }
2002
}
2003

    
2004
/**
2005
 * Implements hook_user_login().
2006
 */
2007
function system_user_login(&$edit, $account) {
2008
  // If the user has a NULL time zone, notify them to set a time zone.
2009
  if (!$account->timezone && variable_get('configurable_timezones', 1) && variable_get('empty_timezone_message', 0)) {
2010
    drupal_set_message(t('Configure your <a href="@user-edit">account time zone setting</a>.', array('@user-edit' => url("user/$account->uid/edit", array('query' => drupal_get_destination(), 'fragment' => 'edit-timezone')))));
2011
  }
2012
}
2013

    
2014
/**
2015
 * Add the time zone field to the user edit and register forms.
2016
 */
2017
function system_user_timezone(&$form, &$form_state) {
2018
  global $user;
2019

    
2020
  $account = $form['#user'];
2021

    
2022
  $form['timezone'] = array(
2023
    '#type' => 'fieldset',
2024
    '#title' => t('Locale settings'),
2025
    '#weight' => 6,
2026
    '#collapsible' => TRUE,
2027
  );
2028
  $form['timezone']['timezone'] = array(
2029
    '#type' => 'select',
2030
    '#title' => t('Time zone'),
2031
    '#default_value' => isset($account->timezone) ? $account->timezone : ($account->uid == $user->uid ? variable_get('date_default_timezone', '') : ''),
2032
    '#options' => system_time_zones($account->uid != $user->uid),
2033
    '#description' => t('Select the desired local time and time zone. Dates and times throughout this site will be displayed using this time zone.'),
2034
  );
2035
  if (!isset($account->timezone) && $account->uid == $user->uid && empty($form_state['input']['timezone'])) {
2036
    $form['timezone']['timezone']['#attributes'] = array('class' => array('timezone-detect'));
2037
    drupal_add_js('misc/timezone.js');
2038
  }
2039
}
2040

    
2041
/**
2042
 * Implements hook_block_info().
2043
 */
2044
function system_block_info() {
2045
  $blocks['main'] = array(
2046
    'info' => t('Main page content'),
2047
     // Cached elsewhere.
2048
    'cache' => DRUPAL_NO_CACHE,
2049
    // Auto-enable in 'content' region by default, which always exists.
2050
    // @see system_themes_page(), drupal_render_page()
2051
    'status' => 1,
2052
    'region' => 'content',
2053
  );
2054
  $blocks['powered-by'] = array(
2055
    'info' => t('Powered by Drupal'),
2056
    'weight' => '10',
2057
    'cache' => DRUPAL_NO_CACHE,
2058
  );
2059
  $blocks['help'] = array(
2060
    'info' => t('System help'),
2061
    'weight' => '5',
2062
    'cache' => DRUPAL_NO_CACHE,
2063
    // Auto-enable in 'help' region by default, if the theme defines one.
2064
    'status' => 1,
2065
    'region' => 'help',
2066
  );
2067
  // System-defined menu blocks.
2068
  foreach (menu_list_system_menus() as $menu_name => $title) {
2069
    $blocks[$menu_name]['info'] = t($title);
2070
    // Menu blocks can't be cached because each menu item can have
2071
    // a custom access callback. menu.inc manages its own caching.
2072
    $blocks[$menu_name]['cache'] = DRUPAL_NO_CACHE;
2073
  }
2074
  return $blocks;
2075
}
2076

    
2077
/**
2078
 * Implements hook_block_view().
2079
 *
2080
 * Generate a block with a promotional link to Drupal.org and
2081
 * all system menu blocks.
2082
 */
2083
function system_block_view($delta = '') {
2084
  $block = array();
2085
  switch ($delta) {
2086
    case 'main':
2087
      $block['subject'] = NULL;
2088
      $block['content'] = drupal_set_page_content();
2089
      return $block;
2090
    case 'powered-by':
2091
      $block['subject'] = NULL;
2092
      $block['content'] = theme('system_powered_by');
2093
      return $block;
2094
    case 'help':
2095
      $block['subject'] = NULL;
2096
      $block['content'] = menu_get_active_help();
2097
      return $block;
2098
    default:
2099
      // All system menu blocks.
2100
      $system_menus = menu_list_system_menus();
2101
      if (isset($system_menus[$delta])) {
2102
        $block['subject'] = t($system_menus[$delta]);
2103
        $block['content'] = menu_tree($delta);
2104
        return $block;
2105
      }
2106
      break;
2107
  }
2108
}
2109

    
2110
/**
2111
 * Implements hook_preprocess_block().
2112
 */
2113
function system_preprocess_block(&$variables) {
2114
  // System menu blocks should get the same class as menu module blocks.
2115
  if ($variables['block']->module == 'system' && in_array($variables['block']->delta, array_keys(menu_list_system_menus()))) {
2116
    $variables['classes_array'][] = 'block-menu';
2117
  }
2118
}
2119

    
2120
/**
2121
 * Provide a single block on the administration overview page.
2122
 *
2123
 * @param $item
2124
 *   The menu item to be displayed.
2125
 */
2126
function system_admin_menu_block($item) {
2127
  $cache = &drupal_static(__FUNCTION__, array());
2128
  // If we are calling this function for a menu item that corresponds to a
2129
  // local task (for example, admin/tasks), then we want to retrieve the
2130
  // parent item's child links, not this item's (since this item won't have
2131
  // any).
2132
  if ($item['tab_root'] != $item['path']) {
2133
    $item = menu_get_item($item['tab_root_href']);
2134
  }
2135

    
2136
  if (!isset($item['mlid'])) {
2137
    $item += db_query("SELECT mlid, menu_name FROM {menu_links} ml WHERE ml.router_path = :path AND module = 'system'", array(':path' => $item['path']))->fetchAssoc();
2138
  }
2139

    
2140
  if (isset($cache[$item['mlid']])) {
2141
    return $cache[$item['mlid']];
2142
  }
2143

    
2144
  $content = array();
2145
  $query = db_select('menu_links', 'ml', array('fetch' => PDO::FETCH_ASSOC));
2146
  $query->join('menu_router', 'm', 'm.path = ml.router_path');
2147
  $query
2148
    ->fields('ml')
2149
    // Weight should be taken from {menu_links}, not {menu_router}.
2150
    ->fields('m', array_diff(drupal_schema_fields_sql('menu_router'), array('weight')))
2151
    ->condition('ml.plid', $item['mlid'])
2152
    ->condition('ml.menu_name', $item['menu_name'])
2153
    ->condition('ml.hidden', 0);
2154

    
2155
  foreach ($query->execute() as $link) {
2156
    _menu_link_translate($link);
2157
    if ($link['access']) {
2158
      // The link description, either derived from 'description' in
2159
      // hook_menu() or customized via menu module is used as title attribute.
2160
      if (!empty($link['localized_options']['attributes']['title'])) {
2161
        $link['description'] = $link['localized_options']['attributes']['title'];
2162
        unset($link['localized_options']['attributes']['title']);
2163
      }
2164
      // Prepare for sorting as in function _menu_tree_check_access().
2165
      // The weight is offset so it is always positive, with a uniform 5-digits.
2166
      $key = (50000 + $link['weight']) . ' ' . drupal_strtolower($link['title']) . ' ' . $link['mlid'];
2167
      $content[$key] = $link;
2168
    }
2169
  }
2170
  ksort($content);
2171
  $cache[$item['mlid']] = $content;
2172
  return $content;
2173
}
2174

    
2175
/**
2176
 * Checks the existence of the directory specified in $form_element.
2177
 *
2178
 * This function is called from the system_settings form to check all core
2179
 * file directories (file_public_path, file_private_path, file_temporary_path).
2180
 *
2181
 * @param $form_element
2182
 *   The form element containing the name of the directory to check.
2183
 */
2184
function system_check_directory($form_element) {
2185
  $directory = $form_element['#value'];
2186
  if (strlen($directory) == 0) {
2187
    return $form_element;
2188
  }
2189

    
2190
  if (!is_dir($directory) && !drupal_mkdir($directory, NULL, TRUE)) {
2191
    // If the directory does not exists and cannot be created.
2192
    form_set_error($form_element['#parents'][0], t('The directory %directory does not exist and could not be created.', array('%directory' => $directory)));
2193
    watchdog('file system', 'The directory %directory does not exist and could not be created.', array('%directory' => $directory), WATCHDOG_ERROR);
2194
  }
2195

    
2196
  if (is_dir($directory) && !is_writable($directory) && !drupal_chmod($directory)) {
2197
    // If the directory is not writable and cannot be made so.
2198
    form_set_error($form_element['#parents'][0], t('The directory %directory exists but is not writable and could not be made writable.', array('%directory' => $directory)));
2199
    watchdog('file system', 'The directory %directory exists but is not writable and could not be made writable.', array('%directory' => $directory), WATCHDOG_ERROR);
2200
  }
2201
  elseif (is_dir($directory)) {
2202
    if ($form_element['#name'] == 'file_public_path') {
2203
      // Create public .htaccess file.
2204
      file_create_htaccess($directory, FALSE);
2205
    }
2206
    else {
2207
      // Create private .htaccess file.
2208
      file_create_htaccess($directory);
2209
    }
2210
  }
2211

    
2212
  return $form_element;
2213
}
2214

    
2215
/**
2216
 * Retrieves the current status of an array of files in the system table.
2217
 *
2218
 * @param $files
2219
 *   An array of files to check.
2220
 * @param $type
2221
 *   The type of the files.
2222
 */
2223
function system_get_files_database(&$files, $type) {
2224
  // Extract current files from database.
2225
  $result = db_query("SELECT filename, name, type, status, schema_version, weight FROM {system} WHERE type = :type", array(':type' => $type));
2226
  foreach ($result as $file) {
2227
    if (isset($files[$file->name]) && is_object($files[$file->name])) {
2228
      $file->uri = $file->filename;
2229
      foreach ($file as $key => $value) {
2230
        if (!isset($files[$file->name]->$key)) {
2231
          $files[$file->name]->$key = $value;
2232
        }
2233
      }
2234
    }
2235
  }
2236
}
2237

    
2238
/**
2239
 * Updates the records in the system table based on the files array.
2240
 *
2241
 * @param $files
2242
 *   An array of files.
2243
 * @param $type
2244
 *   The type of the files.
2245
 */
2246
function system_update_files_database(&$files, $type) {
2247
  $result = db_query("SELECT * FROM {system} WHERE type = :type", array(':type' => $type));
2248

    
2249
  // Add all files that need to be deleted to a DatabaseCondition.
2250
  $delete = db_or();
2251
  foreach ($result as $file) {
2252
    if (isset($files[$file->name]) && is_object($files[$file->name])) {
2253
      // Keep the old filename from the database in case the file has moved.
2254
      $old_filename = $file->filename;
2255

    
2256
      $updated_fields = array();
2257

    
2258
      // Handle info specially, compare the serialized value.
2259
      $serialized_info = serialize($files[$file->name]->info);
2260
      if ($serialized_info != $file->info) {
2261
        $updated_fields['info'] = $serialized_info;
2262
      }
2263
      unset($file->info);
2264

    
2265
      // Scan remaining fields to find only the updated values.
2266
      foreach ($file as $key => $value) {
2267
        if (isset($files[$file->name]->$key) && $files[$file->name]->$key != $value) {
2268
          $updated_fields[$key] = $files[$file->name]->$key;
2269
        }
2270
      }
2271

    
2272
      // Update the record.
2273
      if (count($updated_fields)) {
2274
        db_update('system')
2275
          ->fields($updated_fields)
2276
          ->condition('filename', $old_filename)
2277
          ->execute();
2278
      }
2279

    
2280
      // Indicate that the file exists already.
2281
      $files[$file->name]->exists = TRUE;
2282
    }
2283
    else {
2284
      // File is not found in file system, so delete record from the system table.
2285
      $delete->condition('filename', $file->filename);
2286
    }
2287
  }
2288

    
2289
  if (count($delete) > 0) {
2290
    // Delete all missing files from the system table, but only if the plugin
2291
    // has never been installed.
2292
    db_delete('system')
2293
      ->condition($delete)
2294
      ->condition('schema_version', -1)
2295
      ->execute();
2296
  }
2297

    
2298
  // All remaining files are not in the system table, so we need to add them.
2299
  $query = db_insert('system')->fields(array('filename', 'name', 'type', 'owner', 'info'));
2300
  foreach ($files as &$file) {
2301
    if (isset($file->exists)) {
2302
      unset($file->exists);
2303
    }
2304
    else {
2305
      $query->values(array(
2306
        'filename' => $file->uri,
2307
        'name' => $file->name,
2308
        'type' => $type,
2309
        'owner' => isset($file->owner) ? $file->owner : '',
2310
        'info' => serialize($file->info),
2311
      ));
2312
      $file->type = $type;
2313
      $file->status = 0;
2314
      $file->schema_version = -1;
2315
    }
2316
  }
2317
  $query->execute();
2318

    
2319
  // If any module or theme was moved to a new location, we need to reset the
2320
  // system_list() cache or we will continue to load the old copy, look for
2321
  // schema updates in the wrong place, etc.
2322
  system_list_reset();
2323
}
2324

    
2325
/**
2326
 * Returns an array of information about enabled modules or themes.
2327
 *
2328
 * This function returns the information from the {system} table corresponding
2329
 * to the cached contents of the .info file for each active module or theme.
2330
 *
2331
 * @param $type
2332
 *   Either 'module' or 'theme'.
2333
 * @param $name
2334
 *   (optional) The name of a module or theme whose information shall be
2335
 *   returned. If omitted, all records for the provided $type will be returned.
2336
 *   If $name does not exist in the provided $type or is not enabled, an empty
2337
 *   array will be returned.
2338
 *
2339
 * @return
2340
 *   An associative array of module or theme information keyed by name, or only
2341
 *   information for $name, if given. If no records are available, an empty
2342
 *   array is returned.
2343
 *
2344
 * @see system_rebuild_module_data()
2345
 * @see system_rebuild_theme_data()
2346
 */
2347
function system_get_info($type, $name = NULL) {
2348
  $info = array();
2349
  if ($type == 'module') {
2350
    $type = 'module_enabled';
2351
  }
2352
  $list = system_list($type);
2353
  foreach ($list as $shortname => $item) {
2354
    if (!empty($item->status)) {
2355
      $info[$shortname] = $item->info;
2356
    }
2357
  }
2358
  if (isset($name)) {
2359
    return isset($info[$name]) ? $info[$name] : array();
2360
  }
2361
  return $info;
2362
}
2363

    
2364
/**
2365
 * Helper function to scan and collect module .info data.
2366
 *
2367
 * @return
2368
 *   An associative array of module information.
2369
 */
2370
function _system_rebuild_module_data() {
2371
  // Find modules
2372
  $modules = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN . '\.module$/', 'modules', 'name', 0);
2373

    
2374
  // Include the installation profile in modules that are loaded.
2375
  $profile = drupal_get_profile();
2376
  $modules[$profile] = new stdClass();
2377
  $modules[$profile]->name = $profile;
2378
  $modules[$profile]->uri = 'profiles/' . $profile . '/' . $profile . '.profile';
2379
  $modules[$profile]->filename = $profile . '.profile';
2380

    
2381
  // Installation profile hooks are always executed last.
2382
  $modules[$profile]->weight = 1000;
2383

    
2384
  // Set defaults for module info.
2385
  $defaults = array(
2386
    'dependencies' => array(),
2387
    'description' => '',
2388
    'package' => 'Other',
2389
    'version' => NULL,
2390
    'php' => DRUPAL_MINIMUM_PHP,
2391
    'files' => array(),
2392
    'bootstrap' => 0,
2393
  );
2394

    
2395
  // Read info files for each module.
2396
  foreach ($modules as $key => $module) {
2397
    // The module system uses the key 'filename' instead of 'uri' so copy the
2398
    // value so it will be used by the modules system.
2399
    $modules[$key]->filename = $module->uri;
2400

    
2401
    // Look for the info file.
2402
    $module->info = drupal_parse_info_file(dirname($module->uri) . '/' . $module->name . '.info');
2403

    
2404
    // Skip modules that don't provide info.
2405
    if (empty($module->info)) {
2406
      unset($modules[$key]);
2407
      continue;
2408
    }
2409

    
2410
    // Add the info file modification time, so it becomes available for
2411
    // contributed modules to use for ordering module lists.
2412
    $module->info['mtime'] = filemtime(dirname($module->uri) . '/' . $module->name . '.info');
2413

    
2414
    // Merge in defaults and save.
2415
    $modules[$key]->info = $module->info + $defaults;
2416

    
2417
    // The "name" key is required, but to avoid a fatal error in the menu system
2418
    // we set a reasonable default if it is not provided.
2419
    $modules[$key]->info += array('name' => $key);
2420

    
2421
    // Prefix stylesheets and scripts with module path.
2422
    $path = dirname($module->uri);
2423
    if (isset($module->info['stylesheets'])) {
2424
      $module->info['stylesheets'] = _system_info_add_path($module->info['stylesheets'], $path);
2425
    }
2426
    if (isset($module->info['scripts'])) {
2427
      $module->info['scripts'] = _system_info_add_path($module->info['scripts'], $path);
2428
    }
2429

    
2430
    // Installation profiles are hidden by default, unless explicitly specified
2431
    // otherwise in the .info file.
2432
    if ($key == $profile && !isset($modules[$key]->info['hidden'])) {
2433
      $modules[$key]->info['hidden'] = TRUE;
2434
    }
2435

    
2436
    // Invoke hook_system_info_alter() to give installed modules a chance to
2437
    // modify the data in the .info files if necessary.
2438
    $type = 'module';
2439
    drupal_alter('system_info', $modules[$key]->info, $modules[$key], $type);
2440
  }
2441

    
2442
  if (isset($modules[$profile])) {
2443
    // The installation profile is required, if it's a valid module.
2444
    $modules[$profile]->info['required'] = TRUE;
2445
    // Add a default distribution name if the profile did not provide one. This
2446
    // matches the default value used in install_profile_info().
2447
    if (!isset($modules[$profile]->info['distribution_name'])) {
2448
      $modules[$profile]->info['distribution_name'] = 'Drupal';
2449
    }
2450
  }
2451

    
2452
  return $modules;
2453
}
2454

    
2455
/**
2456
 * Rebuild, save, and return data about all currently available modules.
2457
 *
2458
 * @return
2459
 *   Array of all available modules and their data.
2460
 */
2461
function system_rebuild_module_data() {
2462
  $modules_cache = &drupal_static(__FUNCTION__);
2463
  // Only rebuild once per request. $modules and $modules_cache cannot be
2464
  // combined into one variable, because the $modules_cache variable is reset by
2465
  // reference from system_list_reset() during the rebuild.
2466
  if (!isset($modules_cache)) {
2467
    $modules = _system_rebuild_module_data();
2468
    ksort($modules);
2469
    system_get_files_database($modules, 'module');
2470
    system_update_files_database($modules, 'module');
2471
    $modules = _module_build_dependencies($modules);
2472
    $modules_cache = $modules;
2473
  }
2474
  return $modules_cache;
2475
}
2476

    
2477
/**
2478
 * Refresh bootstrap column in the system table.
2479
 *
2480
 * This is called internally by module_enable/disable() to flag modules that
2481
 * implement hooks used during bootstrap, such as hook_boot(). These modules
2482
 * are loaded earlier to invoke the hooks.
2483
 */
2484
function _system_update_bootstrap_status() {
2485
  $bootstrap_modules = array();
2486
  foreach (bootstrap_hooks() as $hook) {
2487
    foreach (module_implements($hook) as $module) {
2488
      $bootstrap_modules[] = $module;
2489
    }
2490
  }
2491
  $query = db_update('system')->fields(array('bootstrap' => 0));
2492
  if ($bootstrap_modules) {
2493
    db_update('system')
2494
      ->fields(array('bootstrap' => 1))
2495
      ->condition('name', $bootstrap_modules, 'IN')
2496
      ->execute();
2497
    $query->condition('name', $bootstrap_modules, 'NOT IN');
2498
  }
2499
  $query->execute();
2500
  // Reset the cached list of bootstrap modules.
2501
  system_list_reset();
2502
}
2503

    
2504
/**
2505
 * Helper function to scan and collect theme .info data and their engines.
2506
 *
2507
 * @return
2508
 *   An associative array of themes information.
2509
 */
2510
function _system_rebuild_theme_data() {
2511
  // Find themes
2512
  $themes = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN . '\.info$/', 'themes');
2513
  // Allow modules to add further themes.
2514
  if ($module_themes = module_invoke_all('system_theme_info')) {
2515
    foreach ($module_themes as $name => $uri) {
2516
      // @see file_scan_directory()
2517
      $themes[$name] = (object) array(
2518
        'uri' => $uri,
2519
        'filename' => pathinfo($uri, PATHINFO_FILENAME),
2520
        'name' => $name,
2521
      );
2522
    }
2523
  }
2524

    
2525
  // Find theme engines
2526
  $engines = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN . '\.engine$/', 'themes/engines');
2527
  // Allow modules to add further theme engines.
2528
  if ($module_engines = module_invoke_all('system_theme_engine_info')) {
2529
    foreach ($module_engines as $name => $theme_engine_path) {
2530
      $engines[$name] = (object) array(
2531
        'uri' => $theme_engine_path,
2532
        'filename' => basename($theme_engine_path),
2533
        'name' => $name,
2534
      );
2535
    }
2536
  }
2537

    
2538
  // Set defaults for theme info.
2539
  $defaults = array(
2540
    'engine' => 'phptemplate',
2541
    'regions' => array(
2542
      'sidebar_first' => 'Left sidebar',
2543
      'sidebar_second' => 'Right sidebar',
2544
      'content' => 'Content',
2545
      'header' => 'Header',
2546
      'footer' => 'Footer',
2547
      'highlighted' => 'Highlighted',
2548
      'help' => 'Help',
2549
      'page_top' => 'Page top',
2550
      'page_bottom' => 'Page bottom',
2551
    ),
2552
    'description' => '',
2553
    'features' => _system_default_theme_features(),
2554
    'screenshot' => 'screenshot.png',
2555
    'php' => DRUPAL_MINIMUM_PHP,
2556
    'stylesheets' => array(),
2557
    'scripts' => array(),
2558
  );
2559

    
2560
  $sub_themes = array();
2561
  // Read info files for each theme
2562
  foreach ($themes as $key => $theme) {
2563
    $themes[$key]->filename = $theme->uri;
2564
    $themes[$key]->info = drupal_parse_info_file($theme->uri) + $defaults;
2565

    
2566
    // The "name" key is required, but to avoid a fatal error in the menu system
2567
    // we set a reasonable default if it is not provided.
2568
    $themes[$key]->info += array('name' => $key);
2569

    
2570
    // Add the info file modification time, so it becomes available for
2571
    // contributed modules to use for ordering theme lists.
2572
    $themes[$key]->info['mtime'] = filemtime($theme->uri);
2573

    
2574
    // Invoke hook_system_info_alter() to give installed modules a chance to
2575
    // modify the data in the .info files if necessary.
2576
    $type = 'theme';
2577
    drupal_alter('system_info', $themes[$key]->info, $themes[$key], $type);
2578

    
2579
    if (!empty($themes[$key]->info['base theme'])) {
2580
      $sub_themes[] = $key;
2581
    }
2582
    if ($themes[$key]->info['engine'] == 'theme') {
2583
      $filename = dirname($themes[$key]->uri) . '/' . $themes[$key]->name . '.theme';
2584
      if (file_exists($filename)) {
2585
        $themes[$key]->owner = $filename;
2586
        $themes[$key]->prefix = $key;
2587
      }
2588
    }
2589
    else {
2590
      $engine = $themes[$key]->info['engine'];
2591
      if (isset($engines[$engine])) {
2592
        $themes[$key]->owner = $engines[$engine]->uri;
2593
        $themes[$key]->prefix = $engines[$engine]->name;
2594
        $themes[$key]->template = TRUE;
2595
      }
2596
    }
2597

    
2598
    // Prefix stylesheets and scripts with module path.
2599
    $path = dirname($theme->uri);
2600
    $theme->info['stylesheets'] = _system_info_add_path($theme->info['stylesheets'], $path);
2601
    $theme->info['scripts'] = _system_info_add_path($theme->info['scripts'], $path);
2602

    
2603
    // Give the screenshot proper path information.
2604
    if (!empty($themes[$key]->info['screenshot'])) {
2605
      $themes[$key]->info['screenshot'] = $path . '/' . $themes[$key]->info['screenshot'];
2606
    }
2607
  }
2608

    
2609
  // Now that we've established all our master themes, go back and fill in data
2610
  // for subthemes.
2611
  foreach ($sub_themes as $key) {
2612
    $themes[$key]->base_themes = drupal_find_base_themes($themes, $key);
2613
    // Don't proceed if there was a problem with the root base theme.
2614
    if (!current($themes[$key]->base_themes)) {
2615
      continue;
2616
    }
2617
    $base_key = key($themes[$key]->base_themes);
2618
    foreach (array_keys($themes[$key]->base_themes) as $base_theme) {
2619
      $themes[$base_theme]->sub_themes[$key] = $themes[$key]->info['name'];
2620
    }
2621
    // Copy the 'owner' and 'engine' over if the top level theme uses a theme
2622
    // engine.
2623
    if (isset($themes[$base_key]->owner)) {
2624
      if (isset($themes[$base_key]->info['engine'])) {
2625
        $themes[$key]->info['engine'] = $themes[$base_key]->info['engine'];
2626
        $themes[$key]->owner = $themes[$base_key]->owner;
2627
        $themes[$key]->prefix = $themes[$base_key]->prefix;
2628
      }
2629
      else {
2630
        $themes[$key]->prefix = $key;
2631
      }
2632
    }
2633
  }
2634

    
2635
  return $themes;
2636
}
2637

    
2638
/**
2639
 * Rebuild, save, and return data about all currently available themes.
2640
 *
2641
 * @return
2642
 *   Array of all available themes and their data.
2643
 */
2644
function system_rebuild_theme_data() {
2645
  $themes = _system_rebuild_theme_data();
2646
  ksort($themes);
2647
  system_get_files_database($themes, 'theme');
2648
  system_update_files_database($themes, 'theme');
2649
  return $themes;
2650
}
2651

    
2652
/**
2653
 * Prefixes all values in an .info file array with a given path.
2654
 *
2655
 * This helper function is mainly used to prefix all array values of an .info
2656
 * file property with a single given path (to the module or theme); e.g., to
2657
 * prefix all values of the 'stylesheets' or 'scripts' properties with the file
2658
 * path to the defining module/theme.
2659
 *
2660
 * @param $info
2661
 *   A nested array of data of an .info file to be processed.
2662
 * @param $path
2663
 *   A file path to prepend to each value in $info.
2664
 *
2665
 * @return
2666
 *   The $info array with prefixed values.
2667
 *
2668
 * @see _system_rebuild_module_data()
2669
 * @see _system_rebuild_theme_data()
2670
 */
2671
function _system_info_add_path($info, $path) {
2672
  foreach ($info as $key => $value) {
2673
    // Recurse into nested values until we reach the deepest level.
2674
    if (is_array($value)) {
2675
      $info[$key] = _system_info_add_path($info[$key], $path);
2676
    }
2677
    // Unset the original value's key and set the new value with prefix, using
2678
    // the original value as key, so original values can still be looked up.
2679
    else {
2680
      unset($info[$key]);
2681
      $info[$value] = $path . '/' . $value;
2682
    }
2683
  }
2684
  return $info;
2685
}
2686

    
2687
/**
2688
 * Returns an array of default theme features.
2689
 */
2690
function _system_default_theme_features() {
2691
  return array(
2692
    'logo',
2693
    'favicon',
2694
    'name',
2695
    'slogan',
2696
    'node_user_picture',
2697
    'comment_user_picture',
2698
    'comment_user_verification',
2699
    'main_menu',
2700
    'secondary_menu',
2701
  );
2702
}
2703

    
2704
/**
2705
 * Find all the base themes for the specified theme.
2706
 *
2707
 * This function has been deprecated in favor of drupal_find_base_themes().
2708
 */
2709
function system_find_base_themes($themes, $key, $used_keys = array()) {
2710
  return drupal_find_base_themes($themes, $key, $used_keys);
2711
}
2712

    
2713
/**
2714
 * Get a list of available regions from a specified theme.
2715
 *
2716
 * @param $theme_key
2717
 *   The name of a theme.
2718
 * @param $show
2719
 *   Possible values: REGIONS_ALL or REGIONS_VISIBLE. Visible excludes hidden
2720
 *   regions.
2721
 * @param bool $labels
2722
 *   (optional) Boolean to specify whether the human readable machine names
2723
 *   should be returned or not. Defaults to TRUE, but calling code can set
2724
 *   this to FALSE for better performance, if it only needs machine names.
2725
 *
2726
 * @return array
2727
 *   An associative array of regions in the form $region['name'] = 'description'
2728
 *   if $labels is set to TRUE, or $region['name'] = 'name', if $labels is set
2729
 *   to FALSE.
2730
 */
2731
function system_region_list($theme_key, $show = REGIONS_ALL, $labels = TRUE) {
2732
  $themes = list_themes();
2733
  if (!isset($themes[$theme_key])) {
2734
    return array();
2735
  }
2736

    
2737
  $list = array();
2738
  $info = $themes[$theme_key]->info;
2739
  // If requested, suppress hidden regions. See block_admin_display_form().
2740
  foreach ($info['regions'] as $name => $label) {
2741
    if ($show == REGIONS_ALL || !isset($info['regions_hidden']) || !in_array($name, $info['regions_hidden'])) {
2742
      if ($labels) {
2743
        $list[$name] = t($label);
2744
      }
2745
      else {
2746
        $list[$name] = $name;
2747
      }
2748
    }
2749
  }
2750
  return $list;
2751
}
2752

    
2753
/**
2754
 * Implements hook_system_info_alter().
2755
 */
2756
function system_system_info_alter(&$info, $file, $type) {
2757
  // Remove page-top and page-bottom from the blocks UI since they are reserved for
2758
  // modules to populate from outside the blocks system.
2759
  if ($type == 'theme') {
2760
    $info['regions_hidden'][] = 'page_top';
2761
    $info['regions_hidden'][] = 'page_bottom';
2762
  }
2763
}
2764

    
2765
/**
2766
 * Get the name of the default region for a given theme.
2767
 *
2768
 * @param $theme
2769
 *   The name of a theme.
2770
 *
2771
 * @return
2772
 *   A string that is the region name.
2773
 */
2774
function system_default_region($theme) {
2775
  $regions = system_region_list($theme, REGIONS_VISIBLE, FALSE);
2776
  return $regions ? reset($regions) : '';
2777
}
2778

    
2779
/**
2780
 * Sets up a form to save information automatically.
2781
 *
2782
 * This function adds a submit handler and a submit button to a form array. The
2783
 * submit function saves all the data in the form, using variable_set(), to
2784
 * variables named the same as the keys in the form array. Note that this means
2785
 * you should normally prefix your form array keys with your module name, so
2786
 * that they are unique when passed into variable_set().
2787
 *
2788
 * If you need to manipulate the data in a custom manner, you can either put
2789
 * your own submission handler in the form array before calling this function,
2790
 * or just use your own submission handler instead of calling this function.
2791
 *
2792
 * @param $form
2793
 *   An associative array containing the structure of the form.
2794
 *
2795
 * @return
2796
 *   The form structure.
2797
 *
2798
 * @see system_settings_form_submit()
2799
 *
2800
 * @ingroup forms
2801
 */
2802
function system_settings_form($form) {
2803
  $form['actions']['#type'] = 'actions';
2804
  $form['actions']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration'));
2805

    
2806
  if (!empty($_POST) && form_get_errors()) {
2807
    drupal_set_message(t('The settings have not been saved because of the errors.'), 'error');
2808
  }
2809
  $form['#submit'][] = 'system_settings_form_submit';
2810
  // By default, render the form using theme_system_settings_form().
2811
  if (!isset($form['#theme'])) {
2812
    $form['#theme'] = 'system_settings_form';
2813
  }
2814
  return $form;
2815
}
2816

    
2817
/**
2818
 * Form submission handler for system_settings_form().
2819
 *
2820
 * If you want node type configure style handling of your checkboxes,
2821
 * add an array_filter value to your form.
2822
 */
2823
function system_settings_form_submit($form, &$form_state) {
2824
  // Exclude unnecessary elements.
2825
  form_state_values_clean($form_state);
2826

    
2827
  foreach ($form_state['values'] as $key => $value) {
2828
    if (is_array($value) && isset($form_state['values']['array_filter'])) {
2829
      $value = array_keys(array_filter($value));
2830
    }
2831
    variable_set($key, $value);
2832
  }
2833

    
2834
  drupal_set_message(t('The configuration options have been saved.'));
2835
}
2836

    
2837
/**
2838
 * Helper function to sort requirements.
2839
 */
2840
function _system_sort_requirements($a, $b) {
2841
  if (!isset($a['weight'])) {
2842
    if (!isset($b['weight'])) {
2843
      return strcasecmp($a['title'], $b['title']);
2844
    }
2845
    return -$b['weight'];
2846
  }
2847
  return isset($b['weight']) ? $a['weight'] - $b['weight'] : $a['weight'];
2848
}
2849

    
2850
/**
2851
 * Generates a form array for a confirmation form.
2852
 *
2853
 * This function returns a complete form array for confirming an action. The
2854
 * form contains a confirm button as well as a cancellation link that allows a
2855
 * user to abort the action.
2856
 *
2857
 * If the submit handler for a form that implements confirm_form() is invoked,
2858
 * the user successfully confirmed the action. You should never directly
2859
 * inspect $_POST to see if an action was confirmed.
2860
 *
2861
 * Note - if the parameters $question, $description, $yes, or $no could contain
2862
 * any user input (such as node titles or taxonomy terms), it is the
2863
 * responsibility of the code calling confirm_form() to sanitize them first with
2864
 * a function like check_plain() or filter_xss().
2865
 *
2866
 * @param $form
2867
 *   Additional elements to add to the form. These can be regular form elements,
2868
 *   #value elements, etc., and their values will be available to the submit
2869
 *   handler.
2870
 * @param $question
2871
 *   The question to ask the user (e.g. "Are you sure you want to delete the
2872
 *   block <em>foo</em>?"). The page title will be set to this value.
2873
 * @param $path
2874
 *   The page to go to if the user cancels the action. This can be either:
2875
 *   - A string containing a Drupal path.
2876
 *   - An associative array with a 'path' key. Additional array values are
2877
 *     passed as the $options parameter to l().
2878
 *   If the 'destination' query parameter is set in the URL when viewing a
2879
 *   confirmation form, that value will be used instead of $path.
2880
 * @param $description
2881
 *   Additional text to display. Defaults to t('This action cannot be undone.').
2882
 * @param $yes
2883
 *   A caption for the button that confirms the action (e.g. "Delete",
2884
 *   "Replace", ...). Defaults to t('Confirm').
2885
 * @param $no
2886
 *   A caption for the link which cancels the action (e.g. "Cancel"). Defaults
2887
 *   to t('Cancel').
2888
 * @param $name
2889
 *   The internal name used to refer to the confirmation item.
2890
 *
2891
 * @return
2892
 *   The form array.
2893
 */
2894
function confirm_form($form, $question, $path, $description = NULL, $yes = NULL, $no = NULL, $name = 'confirm') {
2895
  $description = isset($description) ? $description : t('This action cannot be undone.');
2896

    
2897
  // Prepare cancel link.
2898
  if (isset($_GET['destination'])) {
2899
    $options = drupal_parse_url($_GET['destination']);
2900
  }
2901
  elseif (is_array($path)) {
2902
    $options = $path;
2903
  }
2904
  else {
2905
    $options = array('path' => $path);
2906
  }
2907

    
2908
  drupal_set_title($question, PASS_THROUGH);
2909

    
2910
  $form['#attributes']['class'][] = 'confirmation';
2911
  $form['description'] = array('#markup' => $description);
2912
  $form[$name] = array('#type' => 'hidden', '#value' => 1);
2913

    
2914
  $form['actions'] = array('#type' => 'actions');
2915
  $form['actions']['submit'] = array(
2916
    '#type' => 'submit',
2917
    '#value' => $yes ? $yes : t('Confirm'),
2918
  );
2919
  $form['actions']['cancel'] = array(
2920
    '#type' => 'link',
2921
    '#title' => $no ? $no : t('Cancel'),
2922
    '#href' => $options['path'],
2923
    '#options' => $options,
2924
  );
2925
  // By default, render the form using theme_confirm_form().
2926
  if (!isset($form['#theme'])) {
2927
    $form['#theme'] = 'confirm_form';
2928
  }
2929
  return $form;
2930
}
2931

    
2932
/**
2933
 * Determines whether the current user is in compact mode.
2934
 *
2935
 * Compact mode shows certain administration pages with less description text,
2936
 * such as the configuration page and the permissions page.
2937
 *
2938
 * Whether the user is in compact mode is determined by a cookie, which is set
2939
 * for the user by system_admin_compact_page().
2940
 *
2941
 * If the user does not have the cookie, the default value is given by the
2942
 * system variable 'admin_compact_mode', which itself defaults to FALSE. This
2943
 * does not have a user interface to set it: it is a hidden variable which can
2944
 * be set in the settings.php file.
2945
 *
2946
 * @return
2947
 *   TRUE when in compact mode, FALSE when in expanded mode.
2948
 */
2949
function system_admin_compact_mode() {
2950
  // PHP converts dots into underscores in cookie names to avoid problems with
2951
  // its parser, so we use a converted cookie name.
2952
  return isset($_COOKIE['Drupal_visitor_admin_compact_mode']) ? $_COOKIE['Drupal_visitor_admin_compact_mode'] : variable_get('admin_compact_mode', FALSE);
2953
}
2954

    
2955
/**
2956
 * Menu callback; Sets whether the admin menu is in compact mode or not.
2957
 *
2958
 * @param $mode
2959
 *   Valid values are 'on' and 'off'.
2960
 */
2961
function system_admin_compact_page($mode = 'off') {
2962
  user_cookie_save(array('admin_compact_mode' => ($mode == 'on')));
2963
  drupal_goto();
2964
}
2965

    
2966
/**
2967
 * Generate a list of tasks offered by a specified module.
2968
 *
2969
 * @param $module
2970
 *   Module name.
2971
 * @param $info
2972
 *   The module's information, as provided by system_get_info().
2973
 *
2974
 * @return
2975
 *   An array of task links.
2976
 */
2977
function system_get_module_admin_tasks($module, $info) {
2978
  $links = &drupal_static(__FUNCTION__);
2979

    
2980
  if (!isset($links)) {
2981
    $links = array();
2982
    $query = db_select('menu_links', 'ml', array('fetch' => PDO::FETCH_ASSOC));
2983
    $query->join('menu_router', 'm', 'm.path = ml.router_path');
2984
    $query
2985
      ->fields('ml')
2986
      // Weight should be taken from {menu_links}, not {menu_router}.
2987
      ->fields('m', array_diff(drupal_schema_fields_sql('menu_router'), array('weight')))
2988
      ->condition('ml.link_path', 'admin/%', 'LIKE')
2989
      ->condition('ml.hidden', 0, '>=')
2990
      ->condition('ml.module', 'system')
2991
      ->condition('m.number_parts', 1, '>')
2992
      ->condition('m.page_callback', 'system_admin_menu_block_page', '<>');
2993
    foreach ($query->execute() as $link) {
2994
      _menu_link_translate($link);
2995
      if ($link['access']) {
2996
        $links[$link['router_path']] = $link;
2997
      }
2998
    }
2999
  }
3000

    
3001
  $admin_tasks = array();
3002
  $titles = array();
3003
  if ($menu = module_invoke($module, 'menu')) {
3004
    foreach ($menu as $path => $item) {
3005
      if (isset($links[$path])) {
3006
        $task = $links[$path];
3007
        // The link description, either derived from 'description' in
3008
        // hook_menu() or customized via menu module is used as title attribute.
3009
        if (!empty($task['localized_options']['attributes']['title'])) {
3010
          $task['description'] = $task['localized_options']['attributes']['title'];
3011
          unset($task['localized_options']['attributes']['title']);
3012
        }
3013

    
3014
        // Check the admin tasks for duplicate names. If one is found,
3015
        // append the parent menu item's title to differentiate.
3016
        $duplicate_path = array_search($task['title'], $titles);
3017
        if ($duplicate_path !== FALSE) {
3018
          if ($parent = menu_link_load($task['plid'])) {
3019
            // Append the parent item's title to this task's title.
3020
            $task['title'] = t('@original_title (@parent_title)', array('@original_title' => $task['title'], '@parent_title' => $parent['title']));
3021
          }
3022
          if ($parent = menu_link_load($admin_tasks[$duplicate_path]['plid'])) {
3023
            // Append the parent item's title to the duplicated task's title.
3024
            // We use $links[$duplicate_path] in case there are triplicates.
3025
            $admin_tasks[$duplicate_path]['title'] = t('@original_title (@parent_title)', array('@original_title' => $links[$duplicate_path]['title'], '@parent_title' => $parent['title']));
3026
          }
3027
        }
3028
        else {
3029
          $titles[$path] = $task['title'];
3030
        }
3031

    
3032
        $admin_tasks[$path] = $task;
3033
      }
3034
    }
3035
  }
3036

    
3037
  // Append link for permissions.
3038
  if (module_hook($module, 'permission')) {
3039
    $item = menu_get_item('admin/people/permissions');
3040
    if (!empty($item['access'])) {
3041
      $item['link_path'] = $item['href'];
3042
      $item['title'] = t('Configure @module permissions', array('@module' => $info['name']));
3043
      unset($item['description']);
3044
      $item['localized_options']['fragment'] = 'module-' . $module;
3045
      $admin_tasks["admin/people/permissions#module-$module"] = $item;
3046
    }
3047
  }
3048

    
3049
  return $admin_tasks;
3050
}
3051

    
3052
/**
3053
 * Implements hook_cron().
3054
 *
3055
 * Remove older rows from flood and batch table. Remove old temporary files.
3056
 */
3057
function system_cron() {
3058
  // Cleanup the flood.
3059
  db_delete('flood')
3060
    ->condition('expiration', REQUEST_TIME, '<')
3061
    ->execute();
3062

    
3063
  // Remove temporary files that are older than DRUPAL_MAXIMUM_TEMP_FILE_AGE.
3064
  // Use separate placeholders for the status to avoid a bug in some versions
3065
  // of PHP. See http://drupal.org/node/352956.
3066
  $result = db_query('SELECT fid FROM {file_managed} WHERE status <> :permanent AND timestamp < :timestamp', array(
3067
    ':permanent' => FILE_STATUS_PERMANENT,
3068
    ':timestamp' => REQUEST_TIME - DRUPAL_MAXIMUM_TEMP_FILE_AGE
3069
  ));
3070
  foreach ($result as $row) {
3071
    if ($file = file_load($row->fid)) {
3072
      $references = file_usage_list($file);
3073
      if (empty($references)) {
3074
        if (!file_delete($file)) {
3075
          watchdog('file system', 'Could not delete temporary file "%path" during garbage collection', array('%path' => $file->uri), WATCHDOG_ERROR);
3076
        }
3077
      }
3078
      else {
3079
        watchdog('file system', 'Did not delete temporary file "%path" during garbage collection, because it is in use by the following modules: %modules.', array('%path' => $file->uri, '%modules' => implode(', ', array_keys($references))), WATCHDOG_INFO);
3080
      }
3081
    }
3082
  }
3083

    
3084
  // Delete expired cache entries.
3085
  // Avoid invoking hook_flush_cashes() on every cron run because some modules
3086
  // use this hook to perform expensive rebuilding operations (which are only
3087
  // designed to happen on full cache clears), rather than just returning a
3088
  // list of cache tables to be cleared.
3089
  $cache_object = cache_get('system_cache_tables');
3090
  if (empty($cache_object)) {
3091
    $core = array('cache', 'cache_path', 'cache_filter', 'cache_page', 'cache_form', 'cache_menu');
3092
    $cache_tables = array_merge(module_invoke_all('flush_caches'), $core);
3093
    cache_set('system_cache_tables', $cache_tables);
3094
  }
3095
  else {
3096
    $cache_tables = $cache_object->data;
3097
  }
3098
  foreach ($cache_tables as $table) {
3099
    cache_clear_all(NULL, $table);
3100
  }
3101

    
3102
  // Cleanup the batch table and the queue for failed batches.
3103
  db_delete('batch')
3104
    ->condition('timestamp', REQUEST_TIME - 864000, '<')
3105
    ->execute();
3106
  db_delete('queue')
3107
    ->condition('created', REQUEST_TIME - 864000, '<')
3108
    ->condition('name', 'drupal_batch:%', 'LIKE')
3109
    ->execute();
3110

    
3111
  // Reset expired items in the default queue implementation table. If that's
3112
  // not used, this will simply be a no-op.
3113
  db_update('queue')
3114
    ->fields(array(
3115
      'expire' => 0,
3116
    ))
3117
    ->condition('expire', 0, '<>')
3118
    ->condition('expire', REQUEST_TIME, '<')
3119
    ->execute();
3120
}
3121

    
3122
/**
3123
 * Implements hook_flush_caches().
3124
 */
3125
function system_flush_caches() {
3126
  // Rebuild list of date formats.
3127
  system_date_formats_rebuild();
3128
  // Reset the menu static caches.
3129
  menu_reset_static_cache();
3130
}
3131

    
3132
/**
3133
 * Implements hook_action_info().
3134
 */
3135
function system_action_info() {
3136
  return array(
3137
    'system_message_action' => array(
3138
      'type' => 'system',
3139
      'label' => t('Display a message to the user'),
3140
      'configurable' => TRUE,
3141
      'triggers' => array('any'),
3142
    ),
3143
    'system_send_email_action' => array(
3144
      'type' => 'system',
3145
      'label' => t('Send e-mail'),
3146
      'configurable' => TRUE,
3147
      'triggers' => array('any'),
3148
    ),
3149
    'system_block_ip_action' => array(
3150
      'type' => 'user',
3151
      'label' => t('Ban IP address of current user'),
3152
      'configurable' => FALSE,
3153
      'triggers' => array('any'),
3154
    ),
3155
    'system_goto_action' => array(
3156
      'type' => 'system',
3157
      'label' => t('Redirect to URL'),
3158
      'configurable' => TRUE,
3159
      'triggers' => array('any'),
3160
    ),
3161
  );
3162
}
3163

    
3164
/**
3165
 * Return a form definition so the Send email action can be configured.
3166
 *
3167
 * @param $context
3168
 *   Default values (if we are editing an existing action instance).
3169
 *
3170
 * @return
3171
 *   Form definition.
3172
 *
3173
 * @see system_send_email_action_validate()
3174
 * @see system_send_email_action_submit()
3175
 */
3176
function system_send_email_action_form($context) {
3177
  // Set default values for form.
3178
  if (!isset($context['recipient'])) {
3179
    $context['recipient'] = '';
3180
  }
3181
  if (!isset($context['subject'])) {
3182
    $context['subject'] = '';
3183
  }
3184
  if (!isset($context['message'])) {
3185
    $context['message'] = '';
3186
  }
3187

    
3188
  $form['recipient'] = array(
3189
    '#type' => 'textfield',
3190
    '#title' => t('Recipient'),
3191
    '#default_value' => $context['recipient'],
3192
    '#maxlength' => '254',
3193
    '#description' => t('The email address to which the message should be sent OR enter [node:author:mail], [comment:author:mail], etc. if you would like to send an e-mail to the author of the original post.'),
3194
  );
3195
  $form['subject'] = array(
3196
    '#type' => 'textfield',
3197
    '#title' => t('Subject'),
3198
    '#default_value' => $context['subject'],
3199
    '#maxlength' => '254',
3200
    '#description' => t('The subject of the message.'),
3201
  );
3202
  $form['message'] = array(
3203
    '#type' => 'textarea',
3204
    '#title' => t('Message'),
3205
    '#default_value' => $context['message'],
3206
    '#cols' => '80',
3207
    '#rows' => '20',
3208
    '#description' => t('The message that should be sent. You may include placeholders like [node:title], [user:name], and [comment:body] to represent data that will be different each time message is sent. Not all placeholders will be available in all contexts.'),
3209
  );
3210
  return $form;
3211
}
3212

    
3213
/**
3214
 * Validate system_send_email_action form submissions.
3215
 */
3216
function system_send_email_action_validate($form, $form_state) {
3217
  $form_values = $form_state['values'];
3218
  // Validate the configuration form.
3219
  if (!valid_email_address($form_values['recipient']) && strpos($form_values['recipient'], ':mail') === FALSE) {
3220
    // We want the literal %author placeholder to be emphasized in the error message.
3221
    form_set_error('recipient', t('Enter a valid email address or use a token e-mail address such as %author.', array('%author' => '[node:author:mail]')));
3222
  }
3223
}
3224

    
3225
/**
3226
 * Process system_send_email_action form submissions.
3227
 */
3228
function system_send_email_action_submit($form, $form_state) {
3229
  $form_values = $form_state['values'];
3230
  // Process the HTML form to store configuration. The keyed array that
3231
  // we return will be serialized to the database.
3232
  $params = array(
3233
    'recipient' => $form_values['recipient'],
3234
    'subject'   => $form_values['subject'],
3235
    'message'   => $form_values['message'],
3236
  );
3237
  return $params;
3238
}
3239

    
3240
/**
3241
 * Sends an e-mail message.
3242
 *
3243
 * @param object $entity
3244
 *   An optional node object, which will be added as $context['node'] if
3245
 *   provided.
3246
 * @param array $context
3247
 *   Array with the following elements:
3248
 *   - 'recipient': E-mail message recipient. This will be passed through
3249
 *     token_replace().
3250
 *   - 'subject': The subject of the message. This will be passed through
3251
 *     token_replace().
3252
 *   - 'message': The message to send. This will be passed through
3253
 *     token_replace().
3254
 *   - Other elements will be used as the data for token replacement.
3255
 *
3256
 * @ingroup actions
3257
 */
3258
function system_send_email_action($entity, $context) {
3259
  if (empty($context['node'])) {
3260
    $context['node'] = $entity;
3261
  }
3262

    
3263
  $recipient = token_replace($context['recipient'], $context);
3264

    
3265
  // If the recipient is a registered user with a language preference, use
3266
  // the recipient's preferred language. Otherwise, use the system default
3267
  // language.
3268
  $recipient_account = user_load_by_mail($recipient);
3269
  if ($recipient_account) {
3270
    $language = user_preferred_language($recipient_account);
3271
  }
3272
  else {
3273
    $language = language_default();
3274
  }
3275
  $params = array('context' => $context);
3276

    
3277
  if (drupal_mail('system', 'action_send_email', $recipient, $language, $params)) {
3278
    watchdog('action', 'Sent email to %recipient', array('%recipient' => $recipient));
3279
  }
3280
  else {
3281
    watchdog('error', 'Unable to send email to %recipient', array('%recipient' => $recipient));
3282
  }
3283
}
3284

    
3285
/**
3286
 * Implements hook_mail().
3287
 */
3288
function system_mail($key, &$message, $params) {
3289
  $context = $params['context'];
3290

    
3291
  $subject = token_replace($context['subject'], $context);
3292
  $body = token_replace($context['message'], $context);
3293

    
3294
  $message['subject'] .= str_replace(array("\r", "\n"), '', $subject);
3295
  $message['body'][] = $body;
3296
}
3297

    
3298
function system_message_action_form($context) {
3299
  $form['message'] = array(
3300
    '#type' => 'textarea',
3301
    '#title' => t('Message'),
3302
    '#default_value' => isset($context['message']) ? $context['message'] : '',
3303
    '#required' => TRUE,
3304
    '#rows' => '8',
3305
    '#description' => t('The message to be displayed to the current user. You may include placeholders like [node:title], [user:name], and [comment:body] to represent data that will be different each time message is sent. Not all placeholders will be available in all contexts.'),
3306
  );
3307
  return $form;
3308
}
3309

    
3310
function system_message_action_submit($form, $form_state) {
3311
  return array('message' => $form_state['values']['message']);
3312
}
3313

    
3314
/**
3315
 * Sends a message to the current user's screen.
3316
 *
3317
 * @param object $entity
3318
 *   An optional node object, which will be added as $context['node'] if
3319
 *   provided.
3320
 * @param array $context
3321
 *   Array with the following elements:
3322
 *   - 'message': The message to send. This will be passed through
3323
 *     token_replace().
3324
 *   - Other elements will be used as the data for token replacement in
3325
 *     the message.
3326
 *
3327
 * @ingroup actions
3328
 */
3329
function system_message_action(&$entity, $context = array()) {
3330
  if (empty($context['node'])) {
3331
    $context['node'] = $entity;
3332
  }
3333

    
3334
  $context['message'] = token_replace(filter_xss_admin($context['message']), $context);
3335
  drupal_set_message($context['message']);
3336
}
3337

    
3338
/**
3339
 * Settings form for system_goto_action().
3340
 */
3341
function system_goto_action_form($context) {
3342
  $form['url'] = array(
3343
    '#type' => 'textfield',
3344
    '#title' => t('URL'),
3345
    '#description' => t('The URL to which the user should be redirected. This can be an internal path like node/1234 or an external URL like http://example.com.'),
3346
    '#default_value' => isset($context['url']) ? $context['url'] : '',
3347
    '#required' => TRUE,
3348
  );
3349
  return $form;
3350
}
3351

    
3352
function system_goto_action_submit($form, $form_state) {
3353
  return array(
3354
    'url' => $form_state['values']['url']
3355
  );
3356
}
3357

    
3358
/**
3359
 * Redirects to a different URL.
3360
 *
3361
 * @param $entity
3362
 *   Ignored.
3363
 * @param array $context
3364
 *   Array with the following elements:
3365
 *   - 'url': URL to redirect to. This will be passed through
3366
 *     token_replace().
3367
 *   - Other elements will be used as the data for token replacement.
3368
 *
3369
 * @ingroup actions
3370
 */
3371
function system_goto_action($entity, $context) {
3372
  drupal_goto(token_replace($context['url'], $context));
3373
}
3374

    
3375
/**
3376
 * Blocks the current user's IP address.
3377
 *
3378
 * @ingroup actions
3379
 */
3380
function system_block_ip_action() {
3381
  $ip = ip_address();
3382
  db_merge('blocked_ips')
3383
    ->key(array('ip' => $ip))
3384
    ->fields(array('ip' => $ip))
3385
    ->execute();
3386
  watchdog('action', 'Banned IP address %ip', array('%ip' => $ip));
3387
}
3388

    
3389
/**
3390
 * Generate an array of time zones and their local time&date.
3391
 *
3392
 * @param $blank
3393
 *   If evaluates true, prepend an empty time zone option to the array.
3394
 */
3395
function system_time_zones($blank = NULL) {
3396
  $zonelist = timezone_identifiers_list();
3397
  $zones = $blank ? array('' => t('- None selected -')) : array();
3398
  foreach ($zonelist as $zone) {
3399
    // Because many time zones exist in PHP only for backward compatibility
3400
    // reasons and should not be used, the list is filtered by a regular
3401
    // expression.
3402
    if (preg_match('!^((Africa|America|Antarctica|Arctic|Asia|Atlantic|Australia|Europe|Indian|Pacific)/|UTC$)!', $zone)) {
3403
      $zones[$zone] = t('@zone: @date', array('@zone' => t(str_replace('_', ' ', $zone)), '@date' => format_date(REQUEST_TIME, 'custom', variable_get('date_format_long', 'l, F j, Y - H:i') . ' O', $zone)));
3404
    }
3405
  }
3406
  // Sort the translated time zones alphabetically.
3407
  asort($zones);
3408
  return $zones;
3409
}
3410

    
3411
/**
3412
 * Checks whether the server is capable of issuing HTTP requests.
3413
 *
3414
 * The function sets the drupal_http_request_fail system variable to TRUE if
3415
 * drupal_http_request() does not work and then the system status report page
3416
 * will contain an error.
3417
 *
3418
 * @return
3419
 *  TRUE if this installation can issue HTTP requests.
3420
 */
3421
function system_check_http_request() {
3422
  // Try to get the content of the front page via drupal_http_request().
3423
  $result = drupal_http_request(url('', array('absolute' => TRUE)), array('max_redirects' => 0));
3424
  // We only care that we get a http response - this means that Drupal
3425
  // can make a http request.
3426
  $works = isset($result->code) && ($result->code >= 100) && ($result->code < 600);
3427
  variable_set('drupal_http_request_fails', !$works);
3428
  return $works;
3429
}
3430

    
3431
/**
3432
 * Menu callback; Retrieve a JSON object containing a suggested time zone name.
3433
 */
3434
function system_timezone($abbreviation = '', $offset = -1, $is_daylight_saving_time = NULL) {
3435
  // An abbreviation of "0" passed in the callback arguments should be
3436
  // interpreted as the empty string.
3437
  $abbreviation = $abbreviation ? $abbreviation : '';
3438
  $timezone = timezone_name_from_abbr($abbreviation, intval($offset), $is_daylight_saving_time);
3439
  drupal_json_output($timezone);
3440
}
3441

    
3442
/**
3443
 * Returns HTML for the Powered by Drupal text.
3444
 *
3445
 * @ingroup themeable
3446
 */
3447
function theme_system_powered_by() {
3448
  return '<span>' . t('Powered by <a href="@poweredby">Drupal</a>', array('@poweredby' => 'https://www.drupal.org')) . '</span>';
3449
}
3450

    
3451
/**
3452
 * Returns HTML for a link to show or hide inline help descriptions.
3453
 *
3454
 * @ingroup themeable
3455
 */
3456
function theme_system_compact_link() {
3457
  $output = '<div class="compact-link">';
3458
  if (system_admin_compact_mode()) {
3459
    $output .= l(t('Show descriptions'), 'admin/compact/off', array('attributes' => array('title' => t('Expand layout to include descriptions.')), 'query' => drupal_get_destination()));
3460
  }
3461
  else {
3462
    $output .= l(t('Hide descriptions'), 'admin/compact/on', array('attributes' => array('title' => t('Compress layout by hiding descriptions.')), 'query' => drupal_get_destination()));
3463
  }
3464
  $output .= '</div>';
3465

    
3466
  return $output;
3467
}
3468

    
3469
/**
3470
 * Implements hook_image_toolkits().
3471
 */
3472
function system_image_toolkits() {
3473
  include_once DRUPAL_ROOT . '/' . drupal_get_path('module', 'system') . '/' . 'image.gd.inc';
3474
  return array(
3475
    'gd' => array(
3476
      'title' => t('GD2 image manipulation toolkit'),
3477
      'available' => function_exists('image_gd_check_settings') && image_gd_check_settings(),
3478
    ),
3479
  );
3480
}
3481

    
3482
/**
3483
 * Attempts to get a file using drupal_http_request and to store it locally.
3484
 *
3485
 * @param string $url
3486
 *   The URL of the file to grab.
3487
 * @param string $destination
3488
 *   Stream wrapper URI specifying where the file should be placed. If a
3489
 *   directory path is provided, the file is saved into that directory under
3490
 *   its original name. If the path contains a filename as well, that one will
3491
 *   be used instead.
3492
 *   If this value is omitted, the site's default files scheme will be used,
3493
 *   usually "public://".
3494
 * @param bool $managed
3495
 *   If this is set to TRUE, the file API hooks will be invoked and the file is
3496
 *   registered in the database.
3497
 * @param int $replace
3498
 *   Replace behavior when the destination file already exists:
3499
 *   - FILE_EXISTS_REPLACE: Replace the existing file.
3500
 *   - FILE_EXISTS_RENAME: Append _{incrementing number} until the filename is
3501
 *     unique.
3502
 *   - FILE_EXISTS_ERROR: Do nothing and return FALSE.
3503
 *
3504
 * @return mixed
3505
 *   One of these possibilities:
3506
 *   - If it succeeds and $managed is FALSE, the location where the file was
3507
 *     saved.
3508
 *   - If it succeeds and $managed is TRUE, a \Drupal\file\FileInterface
3509
 *     object which describes the file.
3510
 *   - If it fails, FALSE.
3511
 */
3512
function system_retrieve_file($url, $destination = NULL, $managed = FALSE, $replace = FILE_EXISTS_RENAME) {
3513
  $parsed_url = parse_url($url);
3514
  if (!isset($destination)) {
3515
    $path = file_build_uri(drupal_basename($parsed_url['path']));
3516
  }
3517
  else {
3518
    if (is_dir(drupal_realpath($destination))) {
3519
      // Prevent URIs with triple slashes when glueing parts together.
3520
      $path = str_replace('///', '//', "$destination/") . drupal_basename($parsed_url['path']);
3521
    }
3522
    else {
3523
      $path = $destination;
3524
    }
3525
  }
3526
  $result = drupal_http_request($url);
3527
  if ($result->code != 200) {
3528
    drupal_set_message(t('HTTP error @errorcode occurred when trying to fetch @remote.', array('@errorcode' => $result->code, '@remote' => $url)), 'error');
3529
    return FALSE;
3530
  }
3531
  $local = $managed ? file_save_data($result->data, $path, $replace) : file_unmanaged_save_data($result->data, $path, $replace);
3532
  if (!$local) {
3533
    drupal_set_message(t('@remote could not be saved to @path.', array('@remote' => $url, '@path' => $path)), 'error');
3534
  }
3535

    
3536
  return $local;
3537
}
3538

    
3539
/**
3540
 * Implements hook_page_alter().
3541
 */
3542
function system_page_alter(&$page) {
3543
  // Find all non-empty page regions, and add a theme wrapper function that
3544
  // allows them to be consistently themed.
3545
  foreach (system_region_list($GLOBALS['theme'], REGIONS_ALL, FALSE) as $region) {
3546
    if (!empty($page[$region])) {
3547
      $page[$region]['#theme_wrappers'][] = 'region';
3548
      $page[$region]['#region'] = $region;
3549
    }
3550
  }
3551
}
3552

    
3553
/**
3554
 * Run the automated cron if enabled.
3555
 */
3556
function system_run_automated_cron() {
3557
  // If the site is not fully installed, suppress the automated cron run.
3558
  // Otherwise it could be triggered prematurely by Ajax requests during
3559
  // installation.
3560
  if (($threshold = variable_get('cron_safe_threshold', DRUPAL_CRON_DEFAULT_THRESHOLD)) > 0 && variable_get('install_task') == 'done') {
3561
    $cron_last = variable_get('cron_last', NULL);
3562
    if (!isset($cron_last) || (REQUEST_TIME - $cron_last > $threshold)) {
3563
      drupal_cron_run();
3564
    }
3565
  }
3566
}
3567

    
3568
/**
3569
 * Gets the list of available date types and attributes.
3570
 *
3571
 * @param $type
3572
 *   (optional) The date type name.
3573
 *
3574
 * @return
3575
 *   An associative array of date type information keyed by the date type name.
3576
 *   Each date type information array has the following elements:
3577
 *   - type: The machine-readable name of the date type.
3578
 *   - title: The human-readable name of the date type.
3579
 *   - locked: A boolean indicating whether or not this date type should be
3580
 *     configurable from the user interface.
3581
 *   - module: The name of the module that defined this date type in its
3582
 *     hook_date_format_types(). An empty string if the date type was
3583
 *     user-defined.
3584
 *   - is_new: A boolean indicating whether or not this date type is as of yet
3585
 *     unsaved in the database.
3586
 *   If $type was defined, only a single associative array with the above
3587
 *   elements is returned.
3588
 */
3589
function system_get_date_types($type = NULL) {
3590
  $types = &drupal_static(__FUNCTION__);
3591

    
3592
  if (!isset($types)) {
3593
    $types = _system_date_format_types_build();
3594
  }
3595

    
3596
  return $type ? (isset($types[$type]) ? $types[$type] : FALSE) : $types;
3597
}
3598

    
3599
/**
3600
 * Implements hook_date_format_types().
3601
 */
3602
function system_date_format_types() {
3603
  return array(
3604
    'long' => t('Long'),
3605
    'medium' => t('Medium'),
3606
    'short' => t('Short'),
3607
  );
3608
}
3609

    
3610
/**
3611
 * Implements hook_date_formats().
3612
 */
3613
function system_date_formats() {
3614
  include_once DRUPAL_ROOT . '/includes/date.inc';
3615
  return system_default_date_formats();
3616
}
3617

    
3618
/**
3619
 * Gets the list of defined date formats and attributes.
3620
 *
3621
 * @param $type
3622
 *   (optional) The date type name.
3623
 *
3624
 * @return
3625
 *   An associative array of date formats. The top-level keys are the names of
3626
 *   the date types that the date formats belong to. The values are in turn
3627
 *   associative arrays keyed by the format string, with the following keys:
3628
 *   - dfid: The date format ID.
3629
 *   - format: The format string.
3630
 *   - type: The machine-readable name of the date type.
3631
 *   - locales: An array of language codes. This can include both 2 character
3632
 *     language codes like 'en and 'fr' and 5 character language codes like
3633
 *     'en-gb' and 'en-us'.
3634
 *   - locked: A boolean indicating whether or not this date type should be
3635
 *     configurable from the user interface.
3636
 *   - module: The name of the module that defined this date format in its
3637
 *     hook_date_formats(). An empty string if the format was user-defined.
3638
 *   - is_new: A boolean indicating whether or not this date type is as of yet
3639
 *     unsaved in the database.
3640
 *   If $type was defined, only the date formats associated with the given date
3641
 *   type are returned, in a single associative array keyed by format string.
3642
 */
3643
function system_get_date_formats($type = NULL) {
3644
  $date_formats = &drupal_static(__FUNCTION__);
3645

    
3646
  if (!isset($date_formats)) {
3647
    $date_formats = _system_date_formats_build();
3648
  }
3649

    
3650
  return $type ? (isset($date_formats[$type]) ? $date_formats[$type] : FALSE) : $date_formats;
3651
}
3652

    
3653
/**
3654
 * Gets the format details for a particular format ID.
3655
 *
3656
 * @param $dfid
3657
 *   A date format ID.
3658
 *
3659
 * @return
3660
 *   A date format object with the following properties:
3661
 *   - dfid: The date format ID.
3662
 *   - format: The date format string.
3663
 *   - type: The name of the date type.
3664
 *   - locked: Whether the date format can be changed or not.
3665
 */
3666
function system_get_date_format($dfid) {
3667
  return db_query('SELECT df.dfid, df.format, df.type, df.locked FROM {date_formats} df WHERE df.dfid = :dfid', array(':dfid' => $dfid))->fetch();
3668
}
3669

    
3670
/**
3671
 * Resets the database cache of date formats and saves all new date formats.
3672
 */
3673
function system_date_formats_rebuild() {
3674
  drupal_static_reset('system_get_date_formats');
3675
  $date_formats = system_get_date_formats(NULL);
3676

    
3677
  foreach ($date_formats as $type => $formats) {
3678
    foreach ($formats as $format => $info) {
3679
      system_date_format_save($info);
3680
    }
3681
  }
3682

    
3683
  // Rebuild configured date formats locale list.
3684
  drupal_static_reset('system_date_format_locale');
3685
  system_date_format_locale();
3686

    
3687
  _system_date_formats_build();
3688
}
3689

    
3690
/**
3691
 * Gets the appropriate date format string for a date type and locale.
3692
 *
3693
 * @param $langcode
3694
 *   (optional) Language code for the current locale. This can be a 2 character
3695
 *   language code like 'en' and 'fr' or a 5 character language code like
3696
 *   'en-gb' and 'en-us'.
3697
 * @param $type
3698
 *   (optional) The date type name.
3699
 *
3700
 * @return
3701
 *   If $type and $langcode are specified, returns the corresponding date format
3702
 *   string. If only $langcode is specified, returns an array of all date
3703
 *   format strings for that locale, keyed by the date type. If neither is
3704
 *   specified, or if no matching formats are found, returns FALSE.
3705
 */
3706
function system_date_format_locale($langcode = NULL, $type = NULL) {
3707
  $formats = &drupal_static(__FUNCTION__);
3708

    
3709
  if (empty($formats)) {
3710
    $formats = array();
3711
    $result = db_query("SELECT format, type, language FROM {date_format_locale}");
3712
    foreach ($result as $record) {
3713
      if (!isset($formats[$record->language])) {
3714
        $formats[$record->language] = array();
3715
      }
3716
      $formats[$record->language][$record->type] = $record->format;
3717
    }
3718
  }
3719

    
3720
  if ($type && $langcode && !empty($formats[$langcode][$type])) {
3721
    return $formats[$langcode][$type];
3722
  }
3723
  elseif ($langcode && !empty($formats[$langcode])) {
3724
    return $formats[$langcode];
3725
  }
3726

    
3727
  return FALSE;
3728
}
3729

    
3730
/**
3731
 * Builds and returns information about available date types.
3732
 *
3733
 * @return
3734
 *   An associative array of date type information keyed by name. Each date type
3735
 *   information array has the following elements:
3736
 *   - type: The machine-readable name of the date type.
3737
 *   - title: The human-readable name of the date type.
3738
 *   - locked: A boolean indicating whether or not this date type should be
3739
 *     configurable from the user interface.
3740
 *   - module: The name of the module that defined this format in its
3741
 *     hook_date_format_types(). An empty string if the format was user-defined.
3742
 *   - is_new: A boolean indicating whether or not this date type is as of yet
3743
 *     unsaved in the database.
3744
 */
3745
function _system_date_format_types_build() {
3746
  $types = array();
3747

    
3748
  // Get list of modules that implement hook_date_format_types().
3749
  $modules = module_implements('date_format_types');
3750

    
3751
  foreach ($modules as $module) {
3752
    $module_types = module_invoke($module, 'date_format_types');
3753
    foreach ($module_types as $module_type => $type_title) {
3754
      $type = array();
3755
      $type['module'] = $module;
3756
      $type['type'] = $module_type;
3757
      $type['title'] = $type_title;
3758
      $type['locked'] = 1;
3759
      // Will be over-ridden later if in the db.
3760
      $type['is_new'] = TRUE;
3761
      $types[$module_type] = $type;
3762
    }
3763
  }
3764

    
3765
  // Get custom formats added to the database by the end user.
3766
  $result = db_query('SELECT dft.type, dft.title, dft.locked FROM {date_format_type} dft ORDER BY dft.title');
3767
  foreach ($result as $record) {
3768
    if (!isset($types[$record->type])) {
3769
      $type = array();
3770
      $type['is_new'] = FALSE;
3771
      $type['module'] = '';
3772
      $type['type'] = $record->type;
3773
      $type['title'] = $record->title;
3774
      $type['locked'] = $record->locked;
3775
      $types[$record->type] = $type;
3776
    }
3777
    else {
3778
      $type = array();
3779
      $type['is_new'] = FALSE;  // Over-riding previous setting.
3780
      $types[$record->type] = array_merge($types[$record->type], $type);
3781
    }
3782
  }
3783

    
3784
  // Allow other modules to modify these date types.
3785
  drupal_alter('date_format_types', $types);
3786

    
3787
  return $types;
3788
}
3789

    
3790
/**
3791
 * Builds and returns information about available date formats.
3792
 *
3793
 * @return
3794
 *   An associative array of date formats. The top-level keys are the names of
3795
 *   the date types that the date formats belong to. The values are in turn
3796
 *   associative arrays keyed by format with the following keys:
3797
 *   - dfid: The date format ID.
3798
 *   - format: The PHP date format string.
3799
 *   - type: The machine-readable name of the date type the format belongs to.
3800
 *   - locales: An array of language codes. This can include both 2 character
3801
 *     language codes like 'en and 'fr' and 5 character language codes like
3802
 *     'en-gb' and 'en-us'.
3803
 *   - locked: A boolean indicating whether or not this date type should be
3804
 *     configurable from the user interface.
3805
 *   - module: The name of the module that defined this format in its
3806
 *     hook_date_formats(). An empty string if the format was user-defined.
3807
 *   - is_new: A boolean indicating whether or not this date type is as of yet
3808
 *     unsaved in the database.
3809
 */
3810
function _system_date_formats_build() {
3811
  $date_formats = array();
3812

    
3813
  // First handle hook_date_format_types().
3814
  $types = _system_date_format_types_build();
3815
  foreach ($types as $type => $info) {
3816
    system_date_format_type_save($info);
3817
  }
3818

    
3819
  // Get formats supplied by various contrib modules.
3820
  $module_formats = module_invoke_all('date_formats');
3821

    
3822
  foreach ($module_formats as $module_format) {
3823
    // System types are locked.
3824
    $module_format['locked'] = 1;
3825
    // If no date type is specified, assign 'custom'.
3826
    if (!isset($module_format['type'])) {
3827
      $module_format['type'] = 'custom';
3828
    }
3829
    if (!in_array($module_format['type'], array_keys($types))) {
3830
      continue;
3831
    }
3832
    if (!isset($date_formats[$module_format['type']])) {
3833
      $date_formats[$module_format['type']] = array();
3834
    }
3835

    
3836
    // If another module already set this format, merge in the new settings.
3837
    if (isset($date_formats[$module_format['type']][$module_format['format']])) {
3838
      $date_formats[$module_format['type']][$module_format['format']] = array_merge_recursive($date_formats[$module_format['type']][$module_format['format']], $module_format);
3839
    }
3840
    else {
3841
      // This setting will be overridden later if it already exists in the db.
3842
      $module_format['is_new'] = TRUE;
3843
      $date_formats[$module_format['type']][$module_format['format']] = $module_format;
3844
    }
3845
  }
3846

    
3847
  // Get custom formats added to the database by the end user.
3848
  $result = db_query('SELECT df.dfid, df.format, df.type, df.locked, dfl.language FROM {date_formats} df LEFT JOIN {date_format_locale} dfl ON df.format = dfl.format AND df.type = dfl.type ORDER BY df.type, df.format');
3849
  foreach ($result as $record) {
3850
    // If this date type isn't set, initialise the array.
3851
    if (!isset($date_formats[$record->type])) {
3852
      $date_formats[$record->type] = array();
3853
    }
3854
    $format = (array) $record;
3855
    $format['is_new'] = FALSE; // It's in the db, so override this setting.
3856
    // If this format not already present, add it to the array.
3857
    if (!isset($date_formats[$record->type][$record->format])) {
3858
      $format['module'] = '';
3859
      $format['locales'] = array($record->language);
3860
      $date_formats[$record->type][$record->format] = $format;
3861
    }
3862
    // Format already present, so merge in settings.
3863
    else {
3864
      if (!empty($record->language)) {
3865
        $format['locales'] = array_merge($date_formats[$record->type][$record->format]['locales'], array($record->language));
3866
      }
3867
      $date_formats[$record->type][$record->format] = array_merge($date_formats[$record->type][$record->format], $format);
3868
    }
3869
  }
3870

    
3871
  // Allow other modules to modify these formats.
3872
  drupal_alter('date_formats', $date_formats);
3873

    
3874
  return $date_formats;
3875
}
3876

    
3877
/**
3878
 * Saves a date type to the database.
3879
 *
3880
 * @param $type
3881
 *   A date type array containing the following keys:
3882
 *   - type: The machine-readable name of the date type.
3883
 *   - title: The human-readable name of the date type.
3884
 *   - locked: A boolean indicating whether or not this date type should be
3885
 *     configurable from the user interface.
3886
 *   - is_new: A boolean indicating whether or not this date type is as of yet
3887
 *     unsaved in the database.
3888
 */
3889
function system_date_format_type_save($type) {
3890
  $info = array();
3891
  $info['type'] = $type['type'];
3892
  $info['title'] = $type['title'];
3893
  $info['locked'] = $type['locked'];
3894

    
3895
  // Update date_format table.
3896
  if (!empty($type['is_new'])) {
3897
    drupal_write_record('date_format_type', $info);
3898
  }
3899
  else {
3900
    drupal_write_record('date_format_type', $info, 'type');
3901
  }
3902
}
3903

    
3904
/**
3905
 * Deletes a date type from the database.
3906
 *
3907
 * @param $type
3908
 *   The machine-readable name of the date type.
3909
 */
3910
function system_date_format_type_delete($type) {
3911
  db_delete('date_formats')
3912
    ->condition('type', $type)
3913
    ->execute();
3914
  db_delete('date_format_type')
3915
    ->condition('type', $type)
3916
    ->execute();
3917
  db_delete('date_format_locale')
3918
    ->condition('type', $type)
3919
    ->execute();
3920
}
3921

    
3922
/**
3923
 * Saves a date format to the database.
3924
 *
3925
 * @param $date_format
3926
 *   A date format array containing the following keys:
3927
 *   - type: The name of the date type this format is associated with.
3928
 *   - format: The PHP date format string.
3929
 *   - locked: A boolean indicating whether or not this format should be
3930
 *     configurable from the user interface.
3931
 * @param $dfid
3932
 *   If set, replace the existing date format having this ID with the
3933
 *   information specified in $date_format.
3934
 *
3935
 * @see system_get_date_types()
3936
 * @see http://php.net/date
3937
 */
3938
function system_date_format_save($date_format, $dfid = 0) {
3939
  $info = array();
3940
  $info['dfid'] = $dfid;
3941
  $info['type'] = $date_format['type'];
3942
  $info['format'] = $date_format['format'];
3943
  $info['locked'] = $date_format['locked'];
3944

    
3945
  // Update date_format table.
3946
  if (!empty($date_format['is_new'])) {
3947
    drupal_write_record('date_formats', $info);
3948
  }
3949
  else {
3950
    $keys = ($dfid ? array('dfid') : array('format', 'type'));
3951
    drupal_write_record('date_formats', $info, $keys);
3952
  }
3953

    
3954
  // Retrieve an array of language objects for enabled languages.
3955
  $languages = language_list('enabled');
3956
  // This list is keyed off the value of $language->enabled; we want the ones
3957
  // that are enabled (value of 1).
3958
  $languages = $languages[1];
3959

    
3960
  $locale_format = array();
3961
  $locale_format['type'] = $date_format['type'];
3962
  $locale_format['format'] = $date_format['format'];
3963

    
3964
  // Check if the suggested language codes are configured and enabled.
3965
  if (!empty($date_format['locales'])) {
3966
    foreach ($date_format['locales'] as $langcode) {
3967
      // Only proceed if language is enabled.
3968
      if (isset($languages[$langcode])) {
3969
        $is_existing = (bool) db_query_range('SELECT 1 FROM {date_format_locale} WHERE type = :type AND language = :language', 0, 1, array(':type' => $date_format['type'], ':language' => $langcode))->fetchField();
3970
        if (!$is_existing) {
3971
          $locale_format['language'] = $langcode;
3972
          drupal_write_record('date_format_locale', $locale_format);
3973
        }
3974
      }
3975
    }
3976
  }
3977
}
3978

    
3979
/**
3980
 * Deletes a date format from the database.
3981
 *
3982
 * @param $dfid
3983
 *   The date format ID.
3984
 */
3985
function system_date_format_delete($dfid) {
3986
  db_delete('date_formats')
3987
    ->condition('dfid', $dfid)
3988
    ->execute();
3989
}
3990

    
3991
/**
3992
 * Implements hook_archiver_info().
3993
 */
3994
function system_archiver_info() {
3995
  $archivers['tar'] = array(
3996
    'class' => 'ArchiverTar',
3997
    'extensions' => array('tar', 'tgz', 'tar.gz', 'tar.bz2'),
3998
  );
3999
  if (function_exists('zip_open')) {
4000
    $archivers['zip'] = array(
4001
      'class' => 'ArchiverZip',
4002
      'extensions' => array('zip'),
4003
    );
4004
  }
4005
  return $archivers;
4006
}
4007

    
4008
/**
4009
 * Returns HTML for a confirmation form.
4010
 *
4011
 * By default this does not alter the appearance of a form at all,
4012
 * but is provided as a convenience for themers.
4013
 *
4014
 * @param $variables
4015
 *   An associative array containing:
4016
 *   - form: A render element representing the form.
4017
 *
4018
 * @ingroup themeable
4019
 */
4020
function theme_confirm_form($variables) {
4021
  return drupal_render_children($variables['form']);
4022
}
4023

    
4024
/**
4025
 * Returns HTML for a system settings form.
4026
 *
4027
 * By default this does not alter the appearance of a form at all,
4028
 * but is provided as a convenience for themers.
4029
 *
4030
 * @param $variables
4031
 *   An associative array containing:
4032
 *   - form: A render element representing the form.
4033
 *
4034
 * @ingroup themeable
4035
 */
4036
function theme_system_settings_form($variables) {
4037
  return drupal_render_children($variables['form']);
4038
}
4039

    
4040
/**
4041
 * Returns HTML for an exposed filter form.
4042
 *
4043
 * @param $variables
4044
 *   An associative array containing:
4045
 *   - form: An associative array containing the structure of the form.
4046
 *
4047
 * @return
4048
 *   A string containing an HTML-formatted form.
4049
 *
4050
 * @ingroup themeable
4051
 */
4052
function theme_exposed_filters($variables) {
4053
  $form = $variables['form'];
4054
  $output = '';
4055

    
4056
  if (isset($form['current'])) {
4057
    $items = array();
4058
    foreach (element_children($form['current']) as $key) {
4059
      $items[] = drupal_render($form['current'][$key]);
4060
    }
4061
    $output .= theme('item_list', array('items' => $items, 'attributes' => array('class' => array('clearfix', 'current-filters'))));
4062
  }
4063

    
4064
  $output .= drupal_render_children($form);
4065

    
4066
  return '<div class="exposed-filters">' . $output . '</div>';
4067
}
4068

    
4069
/**
4070
 * Implements hook_admin_paths().
4071
 */
4072
function system_admin_paths() {
4073
  $paths = array(
4074
    'admin' => TRUE,
4075
    'admin/*' => TRUE,
4076
    'batch' => TRUE,
4077
    // This page should not be treated as administrative since it outputs its
4078
    // own content (outside of any administration theme).
4079
    'admin/reports/status/php' => FALSE,
4080
  );
4081
  return $paths;
4082
}