5 * Configuration system that lets administrators modify the workings of the site.
9 * Maximum age of temporary files in seconds.
11 define('DRUPAL_MAXIMUM_TEMP_FILE_AGE', 21600);
14 * Default interval for automatic cron executions in seconds.
16 define('DRUPAL_CRON_DEFAULT_THRESHOLD', 10800);
19 * New users will be set to the default time zone at registration.
21 define('DRUPAL_USER_TIMEZONE_DEFAULT', 0);
24 * New users will get an empty time zone at registration.
26 define('DRUPAL_USER_TIMEZONE_EMPTY', 1);
29 * New users will select their own timezone at registration.
31 define('DRUPAL_USER_TIMEZONE_SELECT', 2);
34 * Disabled option on forms and settings
36 define('DRUPAL_DISABLED', 0);
39 * Optional option on forms and settings
41 define('DRUPAL_OPTIONAL', 1);
44 * Required option on forms and settings
46 define('DRUPAL_REQUIRED', 2);
49 * Maximum number of values in a weight select element.
51 * If the number of values is over the maximum, a text field is used instead.
53 define('DRUPAL_WEIGHT_SELECT_MAX', 100);
56 * Return only visible regions.
58 * @see system_region_list()
60 define('REGIONS_VISIBLE', 'visible');
65 * @see system_region_list()
67 define('REGIONS_ALL', 'all');
70 * Implements hook_help().
72 function system_help($path, $arg) {
76 case
'admin/help#system':
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/handbook/modules/system')) .
'</p>';
80 $output .
= '<h3>' .
t('Uses') .
'</h3>';
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>';
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>';
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>';
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>';
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>';
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>';
128 case
'admin/config/development/maintenance':
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>';
134 case
'admin/config/system/actions':
135 case
'admin/config/system/actions/manage':
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>';
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>';
152 * Implements hook_theme().
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',
160 'system_settings_form' => array(
161 'render element' => 'form',
163 'confirm_form' => array(
164 'render element' => 'form',
166 'system_modules_fieldset' => array(
167 'render element' => 'form',
168 'file' => 'system.admin.inc',
170 'system_modules_incompatible' => array(
171 'variables' => array('message' => NULL
),
172 'file' => 'system.admin.inc',
174 'system_modules_uninstall' => array(
175 'render element' => 'form',
176 'file' => 'system.admin.inc',
178 'status_report' => array(
179 'render element' => 'requirements',
180 'file' => 'system.admin.inc',
182 'admin_page' => array(
183 'variables' => array('blocks' => NULL
),
184 'file' => 'system.admin.inc',
186 'admin_block' => array(
187 'variables' => array('block' => NULL
),
188 'file' => 'system.admin.inc',
190 'admin_block_content' => array(
191 'variables' => array('content' => NULL
),
192 'file' => 'system.admin.inc',
194 'system_admin_index' => array(
195 'variables' => array('menu_items' => NULL
),
196 'file' => 'system.admin.inc',
198 'system_powered_by' => array(
199 'variables' => array(),
201 'system_compact_link' => array(
202 'variables' => array(),
204 'system_date_time_settings' => array(
205 'render element' => 'form',
206 'file' => 'system.admin.inc',
212 * Implements hook_permission().
214 function system_permission() {
216 'administer modules' => array(
217 'title' => t('Administer modules'),
219 'administer site configuration' => array(
220 'title' => t('Administer site configuration'),
221 'restrict access' => TRUE
,
223 'administer themes' => array(
224 'title' => t('Administer themes'),
226 'administer software updates' => array(
227 'title' => t('Administer software updates'),
228 'restrict access' => TRUE
,
230 'administer actions' => array(
231 'title' => t('Administer actions'),
233 'access administration pages' => array(
234 'title' => t('Use the administration pages and help'),
236 'access site in maintenance mode' => array(
237 'title' => t('Use the site in maintenance mode'),
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'))),
243 'access site reports' => array(
244 'title' => t('View site reports'),
246 'block IP addresses' => array(
247 'title' => t('Block IP addresses'),
253 * Implements hook_hook_info().
255 function system_hook_info() {
256 $hooks['token_info'] = array(
259 $hooks['token_info_alter'] = array(
262 $hooks['tokens'] = array(
265 $hooks['tokens_alter'] = array(
273 * Implements hook_entity_info().
275 function system_entity_info() {
278 'label' => t('File'),
279 'base table' => 'file_managed',
280 'entity keys' => array(
282 'label' => 'filename',
284 'static cache' => FALSE
,
290 * Implements hook_element_info().
292 function system_element_info() {
293 // Top level elements.
294 $types['form'] = array(
296 '#action' => request_uri(),
297 '#theme_wrappers' => array('form'),
299 $types['page'] = array(
300 '#show_messages' => TRUE
,
302 '#theme_wrappers' => array('html'),
304 // By default, we don't want Ajax commands being rendered in the context of an
305 // HTML page, so we don't provide defaults for #theme or #theme_wrappers.
306 // However, modules can set these properties (for example, to provide an HTML
307 // debugging page that displays rather than executes Ajax commands).
308 $types['ajax'] = array(
310 '#commands' => array(),
313 $types['html_tag'] = array(
314 '#theme' => 'html_tag',
315 '#pre_render' => array('drupal_pre_render_conditional_comments'),
316 '#attributes' => array(),
319 $types['styles'] = array(
321 '#pre_render' => array('drupal_pre_render_styles'),
322 '#group_callback' => 'drupal_group_css',
323 '#aggregate_callback' => 'drupal_aggregate_css',
327 $types['submit'] = array(
330 '#button_type' => 'submit',
331 '#executes_submit_callback' => TRUE
,
332 '#limit_validation_errors' => FALSE
,
333 '#process' => array('ajax_process_form'),
334 '#theme_wrappers' => array('button'),
336 $types['button'] = array(
339 '#button_type' => 'submit',
340 '#executes_submit_callback' => FALSE
,
341 '#limit_validation_errors' => FALSE
,
342 '#process' => array('ajax_process_form'),
343 '#theme_wrappers' => array('button'),
345 $types['image_button'] = array(
347 '#button_type' => 'submit',
348 '#executes_submit_callback' => TRUE
,
349 '#limit_validation_errors' => FALSE
,
350 '#process' => array('ajax_process_form'),
351 '#return_value' => TRUE
,
352 '#has_garbage_value' => TRUE
,
354 '#theme_wrappers' => array('image_button'),
356 $types['textfield'] = array(
360 '#autocomplete_path' => FALSE
,
361 '#process' => array('ajax_process_form'),
362 '#theme' => 'textfield',
363 '#theme_wrappers' => array('form_element'),
365 $types['machine_name'] = array(
367 '#default_value' => NULL
,
371 '#autocomplete_path' => FALSE
,
372 '#process' => array('form_process_machine_name', 'ajax_process_form'),
373 '#element_validate' => array('form_validate_machine_name'),
374 '#theme' => 'textfield',
375 '#theme_wrappers' => array('form_element'),
377 $types['password'] = array(
381 '#process' => array('ajax_process_form'),
382 '#theme' => 'password',
383 '#theme_wrappers' => array('form_element'),
385 $types['password_confirm'] = array(
387 '#process' => array('form_process_password_confirm', 'user_form_process_password_confirm'),
388 '#theme_wrappers' => array('form_element'),
390 $types['textarea'] = array(
394 '#resizable' => TRUE
,
395 '#process' => array('ajax_process_form'),
396 '#theme' => 'textarea',
397 '#theme_wrappers' => array('form_element'),
399 $types['radios'] = array(
401 '#process' => array('form_process_radios'),
402 '#theme_wrappers' => array('radios'),
403 '#pre_render' => array('form_pre_render_conditional_form_element'),
405 $types['radio'] = array(
407 '#default_value' => NULL
,
408 '#process' => array('ajax_process_form'),
410 '#theme_wrappers' => array('form_element'),
411 '#title_display' => 'after',
413 $types['checkboxes'] = array(
415 '#process' => array('form_process_checkboxes'),
416 '#theme_wrappers' => array('checkboxes'),
417 '#pre_render' => array('form_pre_render_conditional_form_element'),
419 $types['checkbox'] = array(
421 '#return_value' => 1,
422 '#theme' => 'checkbox',
423 '#process' => array('form_process_checkbox', 'ajax_process_form'),
424 '#theme_wrappers' => array('form_element'),
425 '#title_display' => 'after',
427 $types['select'] = array(
429 '#multiple' => FALSE
,
430 '#process' => array('form_process_select', 'ajax_process_form'),
431 '#theme' => 'select',
432 '#theme_wrappers' => array('form_element'),
434 $types['weight'] = array(
437 '#default_value' => 0,
438 '#process' => array('form_process_weight', 'ajax_process_form'),
440 $types['date'] = array(
442 '#element_validate' => array('date_validate'),
443 '#process' => array('form_process_date'),
445 '#theme_wrappers' => array('form_element'),
447 $types['file'] = array(
451 '#theme_wrappers' => array('form_element'),
453 $types['tableselect'] = array(
455 '#js_select' => TRUE
,
457 '#process' => array('form_process_tableselect'),
458 '#options' => array(),
460 '#theme' => 'tableselect',
464 $types['item'] = array(
466 '#pre_render' => array('drupal_pre_render_markup'),
467 '#theme_wrappers' => array('form_element'),
469 $types['hidden'] = array(
471 '#process' => array('ajax_process_form'),
472 '#theme' => 'hidden',
474 $types['value'] = array(
477 $types['markup'] = array(
479 '#pre_render' => array('drupal_pre_render_markup'),
481 $types['link'] = array(
482 '#pre_render' => array('drupal_pre_render_link', 'drupal_pre_render_markup'),
484 $types['fieldset'] = array(
485 '#collapsible' => FALSE
,
486 '#collapsed' => FALSE
,
488 '#process' => array('form_process_fieldset', 'ajax_process_form'),
489 '#pre_render' => array('form_pre_render_fieldset'),
490 '#theme_wrappers' => array('fieldset'),
492 $types['vertical_tabs'] = array(
493 '#theme_wrappers' => array('vertical_tabs'),
494 '#default_tab' => '',
495 '#process' => array('form_process_vertical_tabs'),
498 $types['container'] = array(
499 '#theme_wrappers' => array('container'),
500 '#process' => array('form_process_container'),
502 $types['actions'] = array(
503 '#theme_wrappers' => array('container'),
504 '#process' => array('form_process_actions', 'form_process_container'),
508 $types['token'] = array(
510 '#theme' => 'hidden',
517 * Implements hook_menu().
519 function system_menu() {
520 $items['system/files'] = array(
521 'title' => 'File download',
522 'page callback' => 'file_download',
523 'page arguments' => array('private'),
524 'access callback' => TRUE
,
525 'type' => MENU_CALLBACK
,
527 $items['system/temporary'] = array(
528 'title' => 'Temporary files',
529 'page callback' => 'file_download',
530 'page arguments' => array('temporary'),
531 'access callback' => TRUE
,
532 'type' => MENU_CALLBACK
,
534 $items['system/ajax'] = array(
535 'title' => 'AHAH callback',
536 'page callback' => 'ajax_form_callback',
537 'delivery callback' => 'ajax_deliver',
538 'access callback' => TRUE
,
539 'theme callback' => 'ajax_base_page_theme',
540 'type' => MENU_CALLBACK
,
541 'file path' => 'includes',
542 'file' => 'form.inc',
544 $items['system/timezone'] = array(
545 'title' => 'Time zone',
546 'page callback' => 'system_timezone',
547 'access callback' => TRUE
,
548 'type' => MENU_CALLBACK
,
549 'file' => 'system.admin.inc',
551 $items['admin'] = array(
552 'title' => 'Administration',
553 'access arguments' => array('access administration pages'),
554 'page callback' => 'system_admin_menu_block_page',
556 'menu_name' => 'management',
557 'file' => 'system.admin.inc',
559 $items['admin/compact'] = array(
560 'title' => 'Compact mode',
561 'page callback' => 'system_admin_compact_page',
562 'access arguments' => array('access administration pages'),
563 'type' => MENU_CALLBACK
,
564 'file' => 'system.admin.inc',
566 $items['admin/tasks'] = array(
568 'type' => MENU_DEFAULT_LOCAL_TASK
,
571 $items['admin/index'] = array(
573 'page callback' => 'system_admin_index',
574 'access arguments' => array('access administration pages'),
575 'type' => MENU_LOCAL_TASK
,
577 'file' => 'system.admin.inc',
580 // Menu items that are basically just menu blocks.
581 $items['admin/structure'] = array(
582 'title' => 'Structure',
583 'description' => 'Administer blocks, content types, menus, etc.',
584 'position' => 'right',
586 'page callback' => 'system_admin_menu_block_page',
587 'access arguments' => array('access administration pages'),
588 'file' => 'system.admin.inc',
591 $items['admin/appearance'] = array(
592 'title' => 'Appearance',
593 'description' => 'Select and configure your themes.',
594 'page callback' => 'system_themes_page',
595 'access arguments' => array('administer themes'),
596 'position' => 'left',
598 'file' => 'system.admin.inc',
600 $items['admin/appearance/list'] = array(
602 'description' => 'Select and configure your theme',
603 'type' => MENU_DEFAULT_LOCAL_TASK
,
605 'file' => 'system.admin.inc',
607 $items['admin/appearance/enable'] = array(
608 'title' => 'Enable theme',
609 'page callback' => 'system_theme_enable',
610 'access arguments' => array('administer themes'),
611 'type' => MENU_CALLBACK
,
612 'file' => 'system.admin.inc',
614 $items['admin/appearance/disable'] = array(
615 'title' => 'Disable theme',
616 'page callback' => 'system_theme_disable',
617 'access arguments' => array('administer themes'),
618 'type' => MENU_CALLBACK
,
619 'file' => 'system.admin.inc',
621 $items['admin/appearance/default'] = array(
622 'title' => 'Set default theme',
623 'page callback' => 'system_theme_default',
624 'access arguments' => array('administer themes'),
625 'type' => MENU_CALLBACK
,
626 'file' => 'system.admin.inc',
628 $items['admin/appearance/settings'] = array(
629 'title' => 'Settings',
630 'description' => 'Configure default and theme specific settings.',
631 'page callback' => 'drupal_get_form',
632 'page arguments' => array('system_theme_settings'),
633 'access arguments' => array('administer themes'),
634 'type' => MENU_LOCAL_TASK
,
635 'file' => 'system.admin.inc',
638 // Theme configuration subtabs.
639 $items['admin/appearance/settings/global'] = array(
640 'title' => 'Global settings',
641 'type' => MENU_DEFAULT_LOCAL_TASK
,
645 foreach (list_themes() as
$theme) {
646 $items['admin/appearance/settings/' .
$theme->name
] = array(
647 'title' => $theme->info
['name'],
648 'page arguments' => array('system_theme_settings', $theme->name
),
649 'type' => MENU_LOCAL_TASK
,
650 'access callback' => '_system_themes_access',
651 'access arguments' => array($theme),
652 'file' => 'system.admin.inc',
657 $items['admin/modules'] = array(
658 'title' => 'Modules',
659 'description' => 'Extend site functionality.',
660 'page callback' => 'drupal_get_form',
661 'page arguments' => array('system_modules'),
662 'access arguments' => array('administer modules'),
663 'file' => 'system.admin.inc',
666 $items['admin/modules/list'] = array(
668 'type' => MENU_DEFAULT_LOCAL_TASK
,
670 $items['admin/modules/list/confirm'] = array(
672 'access arguments' => array('administer modules'),
673 'type' => MENU_VISIBLE_IN_BREADCRUMB
,
675 $items['admin/modules/uninstall'] = array(
676 'title' => 'Uninstall',
677 'page arguments' => array('system_modules_uninstall'),
678 'access arguments' => array('administer modules'),
679 'type' => MENU_LOCAL_TASK
,
680 'file' => 'system.admin.inc',
683 $items['admin/modules/uninstall/confirm'] = array(
684 'title' => 'Uninstall',
685 'access arguments' => array('administer modules'),
686 'type' => MENU_VISIBLE_IN_BREADCRUMB
,
687 'file' => 'system.admin.inc',
691 $items['admin/config'] = array(
692 'title' => 'Configuration',
693 'description' => 'Administer settings.',
694 'page callback' => 'system_admin_config_page',
695 'access arguments' => array('access administration pages'),
696 'file' => 'system.admin.inc',
699 // IP address blocking.
700 $items['admin/config/people/ip-blocking'] = array(
701 'title' => 'IP address blocking',
702 'description' => 'Manage blocked IP addresses.',
703 'page callback' => 'system_ip_blocking',
704 'access arguments' => array('block IP addresses'),
705 'file' => 'system.admin.inc',
708 $items['admin/config/people/ip-blocking/delete/%blocked_ip'] = array(
709 'title' => 'Delete IP address',
710 'page callback' => 'drupal_get_form',
711 'page arguments' => array('system_ip_blocking_delete', 5),
712 'access arguments' => array('block IP addresses'),
713 'file' => 'system.admin.inc',
717 $items['admin/config/media'] = array(
719 'description' => 'Media tools.',
720 'position' => 'left',
722 'page callback' => 'system_admin_menu_block_page',
723 'access arguments' => array('access administration pages'),
724 'file' => 'system.admin.inc',
726 $items['admin/config/media/file-system'] = array(
727 'title' => 'File system',
728 'description' => 'Tell Drupal where to store uploaded files and how they are accessed.',
729 'page callback' => 'drupal_get_form',
730 'page arguments' => array('system_file_system_settings'),
731 'access arguments' => array('administer site configuration'),
733 'file' => 'system.admin.inc',
735 $items['admin/config/media/image-toolkit'] = array(
736 'title' => 'Image toolkit',
737 'description' => 'Choose which image toolkit to use if you have installed optional toolkits.',
738 'page callback' => 'drupal_get_form',
739 'page arguments' => array('system_image_toolkit_settings'),
740 'access arguments' => array('administer site configuration'),
742 'file' => 'system.admin.inc',
746 $items['admin/config/services'] = array(
747 'title' => 'Web services',
748 'description' => 'Tools related to web services.',
749 'position' => 'right',
751 'page callback' => 'system_admin_menu_block_page',
752 'access arguments' => array('access administration pages'),
753 'file' => 'system.admin.inc',
755 $items['admin/config/services/rss-publishing'] = array(
756 'title' => 'RSS publishing',
757 'description' => 'Configure the site description, the number of items per feed and whether feeds should be titles/teasers/full-text.',
758 'page callback' => 'drupal_get_form',
759 'page arguments' => array('system_rss_feeds_settings'),
760 'access arguments' => array('administer site configuration'),
761 'file' => 'system.admin.inc',
764 // Development settings.
765 $items['admin/config/development'] = array(
766 'title' => 'Development',
767 'description' => 'Development tools.',
768 'position' => 'right',
770 'page callback' => 'system_admin_menu_block_page',
771 'access arguments' => array('access administration pages'),
772 'file' => 'system.admin.inc',
774 $items['admin/config/development/maintenance'] = array(
775 'title' => 'Maintenance mode',
776 'description' => 'Take the site offline for maintenance or bring it back online.',
777 'page callback' => 'drupal_get_form',
778 'page arguments' => array('system_site_maintenance_mode'),
779 'access arguments' => array('administer site configuration'),
780 'file' => 'system.admin.inc',
783 $items['admin/config/development/performance'] = array(
784 'title' => 'Performance',
785 'description' => 'Enable or disable page caching for anonymous users and set CSS and JS bandwidth optimization options.',
786 'page callback' => 'drupal_get_form',
787 'page arguments' => array('system_performance_settings'),
788 'access arguments' => array('administer site configuration'),
789 'file' => 'system.admin.inc',
792 $items['admin/config/development/logging'] = array(
793 'title' => 'Logging and errors',
794 'description' => "Settings for logging and alerts modules. Various modules can route Drupal's system events to different destinations, such as syslog, database, email, etc.",
795 'page callback' => 'drupal_get_form',
796 'page arguments' => array('system_logging_settings'),
797 'access arguments' => array('administer site configuration'),
798 'file' => 'system.admin.inc',
802 // Regional and date settings.
803 $items['admin/config/regional'] = array(
804 'title' => 'Regional and language',
805 'description' => 'Regional settings, localization and translation.',
806 'position' => 'left',
808 'page callback' => 'system_admin_menu_block_page',
809 'access arguments' => array('access administration pages'),
810 'file' => 'system.admin.inc',
812 $items['admin/config/regional/settings'] = array(
813 'title' => 'Regional settings',
814 'description' => "Settings for the site's default time zone and country.",
815 'page callback' => 'drupal_get_form',
816 'page arguments' => array('system_regional_settings'),
817 'access arguments' => array('administer site configuration'),
819 'file' => 'system.admin.inc',
821 $items['admin/config/regional/date-time'] = array(
822 'title' => 'Date and time',
823 'description' => 'Configure display formats for date and time.',
824 'page callback' => 'drupal_get_form',
825 'page arguments' => array('system_date_time_settings'),
826 'access arguments' => array('administer site configuration'),
828 'file' => 'system.admin.inc',
830 $items['admin/config/regional/date-time/types'] = array(
832 'description' => 'Configure display formats for date and time.',
833 'page callback' => 'drupal_get_form',
834 'page arguments' => array('system_date_time_settings'),
835 'access arguments' => array('administer site configuration'),
836 'type' => MENU_DEFAULT_LOCAL_TASK
,
838 'file' => 'system.admin.inc',
840 $items['admin/config/regional/date-time/types/add'] = array(
841 'title' => 'Add date type',
842 'description' => 'Add new date type.',
843 'page callback' => 'drupal_get_form',
844 'page arguments' => array('system_add_date_format_type_form'),
845 'access arguments' => array('administer site configuration'),
846 'type' => MENU_LOCAL_ACTION
,
848 'file' => 'system.admin.inc',
850 $items['admin/config/regional/date-time/types/%/delete'] = array(
851 'title' => 'Delete date type',
852 'description' => 'Allow users to delete a configured date type.',
853 'page callback' => 'drupal_get_form',
854 'page arguments' => array('system_delete_date_format_type_form', 5),
855 'access arguments' => array('administer site configuration'),
856 'file' => 'system.admin.inc',
858 $items['admin/config/regional/date-time/formats'] = array(
859 'title' => 'Formats',
860 'description' => 'Configure display format strings for date and time.',
861 'page callback' => 'system_date_time_formats',
862 'access arguments' => array('administer site configuration'),
863 'type' => MENU_LOCAL_TASK
,
865 'file' => 'system.admin.inc',
867 $items['admin/config/regional/date-time/formats/add'] = array(
868 'title' => 'Add format',
869 'description' => 'Allow users to add additional date formats.',
870 'type' => MENU_LOCAL_ACTION
,
871 'page callback' => 'drupal_get_form',
872 'page arguments' => array('system_configure_date_formats_form'),
873 'access arguments' => array('administer site configuration'),
875 'file' => 'system.admin.inc',
877 $items['admin/config/regional/date-time/formats/%/edit'] = array(
878 'title' => 'Edit date format',
879 'description' => 'Allow users to edit a configured date format.',
880 'page callback' => 'drupal_get_form',
881 'page arguments' => array('system_configure_date_formats_form', 5),
882 'access arguments' => array('administer site configuration'),
883 'file' => 'system.admin.inc',
885 $items['admin/config/regional/date-time/formats/%/delete'] = array(
886 'title' => 'Delete date format',
887 'description' => 'Allow users to delete a configured date format.',
888 'page callback' => 'drupal_get_form',
889 'page arguments' => array('system_date_delete_format_form', 5),
890 'access arguments' => array('administer site configuration'),
891 'file' => 'system.admin.inc',
893 $items['admin/config/regional/date-time/formats/lookup'] = array(
894 'title' => 'Date and time lookup',
895 'page callback' => 'system_date_time_lookup',
896 'access arguments' => array('administer site configuration'),
897 'type' => MENU_CALLBACK
,
898 'file' => 'system.admin.inc',
902 $items['admin/config/search'] = array(
903 'title' => 'Search and metadata',
904 'description' => 'Local site search, metadata and SEO.',
905 'position' => 'left',
907 'page callback' => 'system_admin_menu_block_page',
908 'access arguments' => array('access administration pages'),
909 'file' => 'system.admin.inc',
911 $items['admin/config/search/clean-urls'] = array(
912 'title' => 'Clean URLs',
913 'description' => 'Enable or disable clean URLs for your site.',
914 'page callback' => 'drupal_get_form',
915 'page arguments' => array('system_clean_url_settings'),
916 'access arguments' => array('administer site configuration'),
917 'file' => 'system.admin.inc',
920 $items['admin/config/search/clean-urls/check'] = array(
921 'title' => 'Clean URL check',
922 'page callback' => 'drupal_json_output',
923 'page arguments' => array(array('status' => TRUE
)),
924 'access callback' => TRUE
,
925 'type' => MENU_CALLBACK
,
926 'file' => 'system.admin.inc',
930 $items['admin/config/system'] = array(
932 'description' => 'General system related configuration.',
933 'position' => 'right',
935 'page callback' => 'system_admin_menu_block_page',
936 'access arguments' => array('access administration pages'),
937 'file' => 'system.admin.inc',
939 $items['admin/config/system/actions'] = array(
940 'title' => 'Actions',
941 'description' => 'Manage the actions defined for your site.',
942 'access arguments' => array('administer actions'),
943 'page callback' => 'system_actions_manage',
944 'file' => 'system.admin.inc',
946 $items['admin/config/system/actions/manage'] = array(
947 'title' => 'Manage actions',
948 'description' => 'Manage the actions defined for your site.',
949 'page callback' => 'system_actions_manage',
950 'type' => MENU_DEFAULT_LOCAL_TASK
,
952 'file' => 'system.admin.inc',
954 $items['admin/config/system/actions/configure'] = array(
955 'title' => 'Configure an advanced action',
956 'page callback' => 'drupal_get_form',
957 'page arguments' => array('system_actions_configure'),
958 'access arguments' => array('administer actions'),
959 'type' => MENU_VISIBLE_IN_BREADCRUMB
,
960 'file' => 'system.admin.inc',
962 $items['admin/config/system/actions/delete/%actions'] = array(
963 'title' => 'Delete action',
964 'description' => 'Delete an action.',
965 'page callback' => 'drupal_get_form',
966 'page arguments' => array('system_actions_delete_form', 5),
967 'access arguments' => array('administer actions'),
968 'file' => 'system.admin.inc',
970 $items['admin/config/system/actions/orphan'] = array(
971 'title' => 'Remove orphans',
972 'page callback' => 'system_actions_remove_orphans',
973 'access arguments' => array('administer actions'),
974 'type' => MENU_CALLBACK
,
975 'file' => 'system.admin.inc',
977 $items['admin/config/system/site-information'] = array(
978 'title' => 'Site information',
979 'description' => 'Change site name, e-mail address, slogan, default front page, and number of posts per page, error pages.',
980 'page callback' => 'drupal_get_form',
981 'page arguments' => array('system_site_information_settings'),
982 'access arguments' => array('administer site configuration'),
983 'file' => 'system.admin.inc',
986 $items['admin/config/system/cron'] = array(
988 'description' => 'Manage automatic site maintenance tasks.',
989 'page callback' => 'drupal_get_form',
990 'page arguments' => array('system_cron_settings'),
991 'access arguments' => array('administer site configuration'),
992 'file' => 'system.admin.inc',
995 // Additional categories
996 $items['admin/config/user-interface'] = array(
997 'title' => 'User interface',
998 'description' => 'Tools that enhance the user interface.',
999 'position' => 'right',
1000 'page callback' => 'system_admin_menu_block_page',
1001 'access arguments' => array('access administration pages'),
1002 'file' => 'system.admin.inc',
1005 $items['admin/config/workflow'] = array(
1006 'title' => 'Workflow',
1007 'description' => 'Content workflow, editorial workflow tools.',
1008 'position' => 'right',
1010 'page callback' => 'system_admin_menu_block_page',
1011 'access arguments' => array('access administration pages'),
1012 'file' => 'system.admin.inc',
1014 $items['admin/config/content'] = array(
1015 'title' => 'Content authoring',
1016 'description' => 'Settings related to formatting and authoring content.',
1017 'position' => 'left',
1019 'page callback' => 'system_admin_menu_block_page',
1020 'access arguments' => array('access administration pages'),
1021 'file' => 'system.admin.inc',
1025 $items['admin/reports'] = array(
1026 'title' => 'Reports',
1027 'description' => 'View reports, updates, and errors.',
1028 'page callback' => 'system_admin_menu_block_page',
1029 'access arguments' => array('access site reports'),
1031 'position' => 'left',
1032 'file' => 'system.admin.inc',
1034 $items['admin/reports/status'] = array(
1035 'title' => 'Status report',
1036 'description' => "Get a status report about your site's operation and any detected problems.",
1037 'page callback' => 'system_status',
1039 'access arguments' => array('administer site configuration'),
1040 'file' => 'system.admin.inc',
1042 $items['admin/reports/status/run-cron'] = array(
1043 'title' => 'Run cron',
1044 'page callback' => 'system_run_cron',
1045 'access arguments' => array('administer site configuration'),
1046 'type' => MENU_CALLBACK
,
1047 'file' => 'system.admin.inc',
1049 $items['admin/reports/status/php'] = array(
1051 'page callback' => 'system_php',
1052 'access arguments' => array('administer site configuration'),
1053 'type' => MENU_CALLBACK
,
1054 'file' => 'system.admin.inc',
1057 // Default page for batch operations.
1058 $items['batch'] = array(
1059 'page callback' => 'system_batch_page',
1060 'access callback' => TRUE
,
1061 'theme callback' => '_system_batch_theme',
1062 'type' => MENU_CALLBACK
,
1063 'file' => 'system.admin.inc',
1069 * Theme callback for the default batch page.
1071 function _system_batch_theme() {
1072 // Retrieve the current state of the batch.
1073 $batch = &batch_get();
1074 if (!$batch && isset($_REQUEST['id'])) {
1075 require_once DRUPAL_ROOT .
'/includes/batch.inc';
1076 $batch = batch_load($_REQUEST['id']);
1078 // Use the same theme as the page that started the batch.
1079 if (!empty($batch['theme'])) {
1080 return $batch['theme'];
1085 * Implements hook_library().
1087 function system_library() {
1088 // Drupal's Ajax framework.
1089 $libraries['drupal.ajax'] = array(
1090 'title' => 'Drupal AJAX',
1091 'website' => 'http://api.drupal.org/api/drupal/includes--ajax.inc/group/ajax/7',
1092 'version' => VERSION
,
1094 'misc/ajax.js' => array('group' => JS_LIBRARY
, 'weight' => 2),
1096 'dependencies' => array(
1097 array('system', 'drupal.progress'),
1101 // Drupal's batch API.
1102 $libraries['drupal.batch'] = array(
1103 'title' => 'Drupal batch API',
1104 'version' => VERSION
,
1106 'misc/batch.js' => array('group' => JS_DEFAULT
, 'cache' => FALSE
),
1108 'dependencies' => array(
1109 array('system', 'drupal.progress'),
1113 // Drupal's progress indicator.
1114 $libraries['drupal.progress'] = array(
1115 'title' => 'Drupal progress indicator',
1116 'version' => VERSION
,
1118 'misc/progress.js' => array('group' => JS_DEFAULT
),
1122 // Drupal's form library.
1123 $libraries['drupal.form'] = array(
1124 'title' => 'Drupal form library',
1125 'version' => VERSION
,
1127 'misc/form.js' => array('group' => JS_LIBRARY
, 'weight' => 1),
1131 // Drupal's states library.
1132 $libraries['drupal.states'] = array(
1133 'title' => 'Drupal states',
1134 'version' => VERSION
,
1136 'misc/states.js' => array('group' => JS_LIBRARY
, 'weight' => 1),
1140 // Drupal's collapsible fieldset.
1141 $libraries['drupal.collapse'] = array(
1142 'title' => 'Drupal collapsible fieldset',
1143 'version' => VERSION
,
1145 'misc/collapse.js' => array('group' => JS_DEFAULT
),
1147 'dependencies' => array(
1148 // collapse.js relies on drupalGetSummary in form.js
1149 array('system', 'drupal.form'),
1153 // Drupal's resizable textarea.
1154 $libraries['drupal.textarea'] = array(
1155 'title' => 'Drupal resizable textarea',
1156 'version' => VERSION
,
1158 'misc/textarea.js' => array('group' => JS_DEFAULT
),
1162 // Drupal's autocomplete widget.
1163 $libraries['drupal.autocomplete'] = array(
1164 'title' => 'Drupal autocomplete',
1165 'version' => VERSION
,
1167 'misc/autocomplete.js' => array('group' => JS_DEFAULT
),
1172 $libraries['jquery'] = array(
1173 'title' => 'jQuery',
1174 'website' => 'http://jquery.com',
1175 'version' => '1.4.4',
1177 'misc/jquery.js' => array('group' => JS_LIBRARY
, 'weight' => -20),
1182 $libraries['jquery.once'] = array(
1183 'title' => 'jQuery Once',
1184 'website' => 'http://plugins.jquery.com/project/once',
1187 'misc/jquery.once.js' => array('group' => JS_LIBRARY
, 'weight' => -19),
1191 // jQuery Form Plugin.
1192 $libraries['jquery.form'] = array(
1193 'title' => 'jQuery Form Plugin',
1194 'website' => 'http://malsup.com/jquery/form/',
1195 'version' => '2.52',
1197 'misc/jquery.form.js' => array(),
1199 'dependencies' => array(
1200 array('system', 'jquery.cookie'),
1204 // jQuery BBQ plugin.
1205 $libraries['jquery.bbq'] = array(
1206 'title' => 'jQuery BBQ',
1207 'website' => 'http://benalman.com/projects/jquery-bbq-plugin/',
1208 'version' => '1.2.1',
1210 'misc/jquery.ba-bbq.js' => array(),
1215 $libraries['drupal.vertical-tabs'] = array(
1216 'title' => 'Vertical Tabs',
1217 'website' => 'http://drupal.org/node/323112',
1220 'misc/vertical-tabs.js' => array(),
1223 'misc/vertical-tabs.css' => array(),
1225 'dependencies' => array(
1226 // Vertical tabs relies on drupalGetSummary in form.js
1227 array('system', 'drupal.form'),
1232 $libraries['farbtastic'] = array(
1233 'title' => 'Farbtastic',
1234 'website' => 'http://code.google.com/p/farbtastic/',
1237 'misc/farbtastic/farbtastic.js' => array(),
1240 'misc/farbtastic/farbtastic.css' => array(),
1245 $libraries['jquery.cookie'] = array(
1246 'title' => 'Cookie',
1247 'website' => 'http://plugins.jquery.com/project/cookie',
1250 'misc/jquery.cookie.js' => array(),
1255 $libraries['ui'] = array(
1256 'title' => 'jQuery UI: Core',
1257 'website' => 'http://jqueryui.com',
1258 'version' => '1.8.7',
1260 'misc/ui/jquery.ui.core.min.js' => array('group' => JS_LIBRARY
, 'weight' => -11),
1263 'misc/ui/jquery.ui.core.css' => array(),
1264 'misc/ui/jquery.ui.theme.css' => array(),
1267 $libraries['ui.accordion'] = array(
1268 'title' => 'jQuery UI: Accordion',
1269 'website' => 'http://jqueryui.com/demos/accordion/',
1270 'version' => '1.8.7',
1272 'misc/ui/jquery.ui.accordion.min.js' => array(),
1275 'misc/ui/jquery.ui.accordion.css' => array(),
1277 'dependencies' => array(
1278 array('system', 'ui.widget'),
1281 $libraries['ui.autocomplete'] = array(
1282 'title' => 'jQuery UI: Autocomplete',
1283 'website' => 'http://jqueryui.com/demos/autocomplete/',
1284 'version' => '1.8.7',
1286 'misc/ui/jquery.ui.autocomplete.min.js' => array(),
1289 'misc/ui/jquery.ui.autocomplete.css' => array(),
1291 'dependencies' => array(
1292 array('system', 'ui.widget'),
1293 array('system', 'ui.position'),
1296 $libraries['ui.button'] = array(
1297 'title' => 'jQuery UI: Button',
1298 'website' => 'http://jqueryui.com/demos/button/',
1299 'version' => '1.8.7',
1301 'misc/ui/jquery.ui.button.min.js' => array(),
1304 'misc/ui/jquery.ui.button.css' => array(),
1306 'dependencies' => array(
1307 array('system', 'ui.widget'),
1310 $libraries['ui.datepicker'] = array(
1311 'title' => 'jQuery UI: Date Picker',
1312 'website' => 'http://jqueryui.com/demos/datepicker/',
1313 'version' => '1.8.7',
1315 'misc/ui/jquery.ui.datepicker.min.js' => array(),
1318 'misc/ui/jquery.ui.datepicker.css' => array(),
1320 'dependencies' => array(
1321 array('system', 'ui'),
1324 $libraries['ui.dialog'] = array(
1325 'title' => 'jQuery UI: Dialog',
1326 'website' => 'http://jqueryui.com/demos/dialog/',
1327 'version' => '1.8.7',
1329 'misc/ui/jquery.ui.dialog.min.js' => array(),
1332 'misc/ui/jquery.ui.dialog.css' => array(),
1334 'dependencies' => array(
1335 array('system', 'ui.widget'),
1336 array('system', 'ui.button'),
1337 array('system', 'ui.draggable'),
1338 array('system', 'ui.mouse'),
1339 array('system', 'ui.position'),
1340 array('system', 'ui.resizable'),
1343 $libraries['ui.draggable'] = array(
1344 'title' => 'jQuery UI: Draggable',
1345 'website' => 'http://jqueryui.com/demos/draggable/',
1346 'version' => '1.8.7',
1348 'misc/ui/jquery.ui.draggable.min.js' => array(),
1350 'dependencies' => array(
1351 array('system', 'ui.widget'),
1352 array('system', 'ui.mouse'),
1355 $libraries['ui.droppable'] = array(
1356 'title' => 'jQuery UI: Droppable',
1357 'website' => 'http://jqueryui.com/demos/droppable/',
1358 'version' => '1.8.7',
1360 'misc/ui/jquery.ui.droppable.min.js' => array(),
1362 'dependencies' => array(
1363 array('system', 'ui.widget'),
1364 array('system', 'ui.mouse'),
1365 array('system', 'ui.draggable'),
1368 $libraries['ui.mouse'] = array(
1369 'title' => 'jQuery UI: Mouse',
1370 'website' => 'http://docs.jquery.com/UI/Mouse',
1371 'version' => '1.8.7',
1373 'misc/ui/jquery.ui.mouse.min.js' => array(),
1375 'dependencies' => array(
1376 array('system', 'ui.widget'),
1379 $libraries['ui.position'] = array(
1380 'title' => 'jQuery UI: Position',
1381 'website' => 'http://jqueryui.com/demos/position/',
1382 'version' => '1.8.7',
1384 'misc/ui/jquery.ui.position.min.js' => array(),
1387 $libraries['ui.progressbar'] = array(
1388 'title' => 'jQuery UI: Progress Bar',
1389 'website' => 'http://jqueryui.com/demos/progressbar/',
1390 'version' => '1.8.7',
1392 'misc/ui/jquery.ui.progressbar.min.js' => array(),
1395 'misc/ui/jquery.ui.progressbar.css' => array(),
1397 'dependencies' => array(
1398 array('system', 'ui.widget'),
1401 $libraries['ui.resizable'] = array(
1402 'title' => 'jQuery UI: Resizable',
1403 'website' => 'http://jqueryui.com/demos/resizable/',
1404 'version' => '1.8.7',
1406 'misc/ui/jquery.ui.resizable.min.js' => array(),
1409 'misc/ui/jquery.ui.resizable.css' => array(),
1411 'dependencies' => array(
1412 array('system', 'ui.widget'),
1413 array('system', 'ui.mouse'),
1416 $libraries['ui.selectable'] = array(
1417 'title' => 'jQuery UI: Selectable',
1418 'website' => 'http://jqueryui.com/demos/selectable/',
1419 'version' => '1.8.7',
1421 'misc/ui/jquery.ui.selectable.min.js' => array(),
1424 'misc/ui/jquery.ui.selectable.css' => array(),
1426 'dependencies' => array(
1427 array('system', 'ui.widget'),
1428 array('system', 'ui.mouse'),
1431 $libraries['ui.slider'] = array(
1432 'title' => 'jQuery UI: Slider',
1433 'website' => 'http://jqueryui.com/demos/slider/',
1434 'version' => '1.8.7',
1436 'misc/ui/jquery.ui.slider.min.js' => array(),
1439 'misc/ui/jquery.ui.slider.css' => array(),
1441 'dependencies' => array(
1442 array('system', 'ui.widget'),
1443 array('system', 'ui.mouse'),
1446 $libraries['ui.sortable'] = array(
1447 'title' => 'jQuery UI: Sortable',
1448 'website' => 'http://jqueryui.com/demos/sortable/',
1449 'version' => '1.8.7',
1451 'misc/ui/jquery.ui.sortable.min.js' => array(),
1453 'dependencies' => array(
1454 array('system', 'ui.widget'),
1455 array('system', 'ui.mouse'),
1458 $libraries['ui.tabs'] = array(
1459 'title' => 'jQuery UI: Tabs',
1460 'website' => 'http://jqueryui.com/demos/tabs/',
1461 'version' => '1.8.7',
1463 'misc/ui/jquery.ui.tabs.min.js' => array(),
1466 'misc/ui/jquery.ui.tabs.css' => array(),
1468 'dependencies' => array(
1469 array('system', 'ui.widget'),
1472 $libraries['ui.widget'] = array(
1473 'title' => 'jQuery UI: Widget',
1474 'website' => 'http://docs.jquery.com/UI/Widget',
1475 'version' => '1.8.7',
1477 'misc/ui/jquery.ui.widget.min.js' => array('group' => JS_LIBRARY
, 'weight' => -10),
1479 'dependencies' => array(
1480 array('system', 'ui'),
1483 $libraries['effects'] = array(
1484 'title' => 'jQuery UI: Effects',
1485 'website' => 'http://jqueryui.com/demos/effect/',
1486 'version' => '1.8.7',
1488 'misc/ui/jquery.effects.core.min.js' => array('group' => JS_LIBRARY
, 'weight' => -9),
1491 $libraries['effects.blind'] = array(
1492 'title' => 'jQuery UI: Effects Blind',
1493 'website' => 'http://jqueryui.com/demos/effect/',
1494 'version' => '1.8.7',
1496 'misc/ui/jquery.effects.blind.min.js' => array(),
1498 'dependencies' => array(
1499 array('system', 'effects'),
1502 $libraries['effects.bounce'] = array(
1503 'title' => 'jQuery UI: Effects Bounce',
1504 'website' => 'http://jqueryui.com/demos/effect/',
1505 'version' => '1.8.7',
1507 'misc/ui/jquery.effects.bounce.min.js' => array(),
1509 'dependencies' => array(
1510 array('system', 'effects'),
1513 $libraries['effects.clip'] = array(
1514 'title' => 'jQuery UI: Effects Clip',
1515 'website' => 'http://jqueryui.com/demos/effect/',
1516 'version' => '1.8.7',
1518 'misc/ui/jquery.effects.clip.min.js' => array(),
1520 'dependencies' => array(
1521 array('system', 'effects'),
1524 $libraries['effects.drop'] = array(
1525 'title' => 'jQuery UI: Effects Drop',
1526 'website' => 'http://jqueryui.com/demos/effect/',
1527 'version' => '1.8.7',
1529 'misc/ui/jquery.effects.drop.min.js' => array(),
1531 'dependencies' => array(
1532 array('system', 'effects'),
1535 $libraries['effects.explode'] = array(
1536 'title' => 'jQuery UI: Effects Explode',
1537 'website' => 'http://jqueryui.com/demos/effect/',
1538 'version' => '1.8.7',
1540 'misc/ui/jquery.effects.explode.min.js' => array(),
1542 'dependencies' => array(
1543 array('system', 'effects'),
1546 $libraries['effects.fade'] = array(
1547 'title' => 'jQuery UI: Effects Fade',
1548 'website' => 'http://jqueryui.com/demos/effect/',
1549 'version' => '1.8.7',
1551 'misc/ui/jquery.effects.fade.min.js' => array(),
1553 'dependencies' => array(
1554 array('system', 'effects'),
1557 $libraries['effects.fold'] = array(
1558 'title' => 'jQuery UI: Effects Fold',
1559 'website' => 'http://jqueryui.com/demos/effect/',
1560 'version' => '1.8.7',
1562 'misc/ui/jquery.effects.fold.min.js' => array(),
1564 'dependencies' => array(
1565 array('system', 'effects'),
1568 $libraries['effects.highlight'] = array(
1569 'title' => 'jQuery UI: Effects Highlight',
1570 'website' => 'http://jqueryui.com/demos/effect/',
1571 'version' => '1.8.7',
1573 'misc/ui/jquery.effects.highlight.min.js' => array(),
1575 'dependencies' => array(
1576 array('system', 'effects'),
1579 $libraries['effects.pulsate'] = array(
1580 'title' => 'jQuery UI: Effects Pulsate',
1581 'website' => 'http://jqueryui.com/demos/effect/',
1582 'version' => '1.8.7',
1584 'misc/ui/jquery.effects.pulsate.min.js' => array(),
1586 'dependencies' => array(
1587 array('system', 'effects'),
1590 $libraries['effects.scale'] = array(
1591 'title' => 'jQuery UI: Effects Scale',
1592 'website' => 'http://jqueryui.com/demos/effect/',
1593 'version' => '1.8.7',
1595 'misc/ui/jquery.effects.scale.min.js' => array(),
1597 'dependencies' => array(
1598 array('system', 'effects'),
1601 $libraries['effects.shake'] = array(
1602 'title' => 'jQuery UI: Effects Shake',
1603 'website' => 'http://jqueryui.com/demos/effect/',
1604 'version' => '1.8.7',
1606 'misc/ui/jquery.effects.shake.min.js' => array(),
1608 'dependencies' => array(
1609 array('system', 'effects'),
1612 $libraries['effects.slide'] = array(
1613 'title' => 'jQuery UI: Effects Slide',
1614 'website' => 'http://jqueryui.com/demos/effect/',
1615 'version' => '1.8.7',
1617 'misc/ui/jquery.effects.slide.min.js' => array(),
1619 'dependencies' => array(
1620 array('system', 'effects'),
1623 $libraries['effects.transfer'] = array(
1624 'title' => 'jQuery UI: Effects Transfer',
1625 'website' => 'http://jqueryui.com/demos/effect/',
1626 'version' => '1.8.7',
1628 'misc/ui/jquery.effects.transfer.min.js' => array(),
1630 'dependencies' => array(
1631 array('system', 'effects'),
1635 // These library names are deprecated. Earlier versions of Drupal 7 didn't
1636 // consistently namespace their libraries, so these names are included for
1637 // backwards compatibility with those versions.
1638 $libraries['once'] = &$libraries['jquery.once'];
1639 $libraries['form'] = &$libraries['jquery.form'];
1640 $libraries['jquery-bbq'] = &$libraries['jquery.bbq'];
1641 $libraries['vertical-tabs'] = &$libraries['drupal.vertical-tabs'];
1642 $libraries['cookie'] = &$libraries['jquery.cookie'];
1648 * Implements hook_stream_wrappers().
1650 function system_stream_wrappers() {
1653 'name' => t('Public files'),
1654 'class' => 'DrupalPublicStreamWrapper',
1655 'description' => t('Public local files served by the webserver.'),
1656 'type' => STREAM_WRAPPERS_LOCAL_NORMAL
,
1658 'temporary' => array(
1659 'name' => t('Temporary files'),
1660 'class' => 'DrupalTemporaryStreamWrapper',
1661 'description' => t('Temporary local files for upload and previews.'),
1662 'type' => STREAM_WRAPPERS_LOCAL_HIDDEN
,
1666 // Only register the private file stream wrapper if a file path has been set.
1667 if (variable_get('file_private_path', FALSE
)) {
1668 $wrappers['private'] = array(
1669 'name' => t('Private files'),
1670 'class' => 'DrupalPrivateStreamWrapper',
1671 'description' => t('Private local files served by Drupal.'),
1672 'type' => STREAM_WRAPPERS_LOCAL_NORMAL
,
1680 * Retrieve a blocked IP address from the database.
1682 * @param $iid integer
1683 * The ID of the blocked IP address to retrieve.
1686 * The blocked IP address from the database as an array.
1688 function blocked_ip_load($iid) {
1689 return db_query("SELECT * FROM {blocked_ips} WHERE iid = :iid", array(':iid' => $iid))->fetchAssoc();
1693 * Menu item access callback - only admin or enabled themes can be accessed.
1695 function _system_themes_access($theme) {
1696 return user_access('administer themes') && drupal_theme_access($theme);
1700 * @defgroup authorize Authorized operations
1702 * Functions to run operations with elevated privileges via authorize.php.
1704 * Because of the Update manager functionality included in Drupal core, there
1705 * is a mechanism for running operations with elevated file system privileges,
1706 * the top-level authorize.php script. This script runs at a reduced Drupal
1707 * bootstrap level so that it is not reliant on the entire site being
1708 * functional. The operations use a FileTransfer class to manipulate code
1709 * installed on the system as the user that owns the files, not the user that
1710 * the httpd is running as.
1712 * The first setup is to define a callback function that should be authorized
1713 * to run with the elevated privileges. This callback should take a
1714 * FileTransfer as its first argument, although you can define an array of
1715 * other arguments it should be invoked with. The callback should be placed in
1716 * a separate .inc file that will be included by authorize.php.
1718 * To run the operation, certain data must be saved into the SESSION, and then
1719 * the flow of control should be redirected to the authorize.php script. There
1720 * are two ways to do this, either to call system_authorized_run() directly,
1721 * or to call system_authorized_init() and then redirect to authorize.php,
1722 * using the URL from system_authorized_get_url(). Redirecting yourself is
1723 * necessary when your authorized operation is being triggered by a form
1724 * submit handler, since calling drupal_goto() in a submit handler is a bad
1725 * idea, and you should instead set $form_state['redirect'].
1727 * Once the SESSION is setup for the operation and the user is redirected to
1728 * authorize.php, they will be prompted for their connection credentials (core
1729 * provides FTP and SSH by default, although other connection classes can be
1730 * added via contributed modules). With valid credentials, authorize.php will
1731 * instantiate the appropriate FileTransfer object, and then invoke the
1732 * desired operation passing in that object. The authorize.php script can act
1733 * as a Batch API processing page, if the operation requires a batch.
1735 * @see authorize.php
1737 * @see hook_filetransfer_info()
1741 * Setup a given callback to run via authorize.php with elevated privileges.
1743 * To use authorize.php, certain variables must be stashed into $_SESSION.
1744 * This function sets up all the necessary $_SESSION variables, then returns
1745 * the full path to authorize.php so the caller can redirect to authorize.php.
1746 * That initiates the workflow that will eventually lead to the callback being
1747 * invoked. The callback will be invoked at a low bootstrap level, without all
1748 * modules being invoked, so it needs to be careful not to assume any code
1752 * The name of the function to invoke one the user authorizes the operation.
1754 * The full path to the file where the callback function is implemented.
1756 * Optional array of arguments to pass into the callback when it is invoked.
1757 * Note that the first argument to the callback is always the FileTransfer
1758 * object created by authorize.php when the user authorizes the operation.
1759 * @param $page_title
1760 * Optional string to use as the page title once redirected to authorize.php.
1762 * Nothing, this function just initializes variables in the user's session.
1764 function system_authorized_init($callback, $file, $arguments = array(), $page_title = NULL
) {
1765 // First, figure out what file transfer backends the site supports, and put
1766 // all of those in the SESSION so that authorize.php has access to all of
1767 // them via the class autoloader, even without a full bootstrap.
1768 $_SESSION['authorize_filetransfer_info'] = drupal_get_filetransfer_info();
1770 // Now, define the callback to invoke.
1771 $_SESSION['authorize_operation'] = array(
1772 'callback' => $callback,
1774 'arguments' => $arguments,
1777 if (isset($page_title)) {
1778 $_SESSION['authorize_operation']['page_title'] = $page_title;
1783 * Return the URL for the authorize.php script.
1785 * @param array $options
1786 * Optional array of options to pass to url().
1788 * The full URL to authorize.php, using https if available.
1790 function system_authorized_get_url(array $options = array()) {
1792 // Force https if available, regardless of what the caller specifies.
1793 $options['https'] = TRUE
;
1794 // We prefix with $base_url so we get a full path even if clean URLs are
1796 return url($base_url .
'/authorize.php', $options);
1800 * Returns the URL for the authorize.php script when it is processing a batch.
1802 function system_authorized_batch_processing_url() {
1803 return system_authorized_get_url(array('query' => array('batch' => '1')));
1807 * Setup and invoke an operation using authorize.php.
1809 * @see system_authorized_init()
1811 function system_authorized_run($callback, $file, $arguments = array(), $page_title = NULL
) {
1812 system_authorized_init($callback, $file, $arguments, $page_title);
1813 drupal_goto(system_authorized_get_url());
1817 * Use authorize.php to run batch_process().
1819 * @see batch_process()
1821 function system_authorized_batch_process() {
1822 $finish_url = system_authorized_get_url();
1823 $process_url = system_authorized_batch_processing_url();
1824 batch_process($finish_url, $process_url);
1828 * @} End of "defgroup authorize".
1832 * Implements hook_updater_info().
1834 function system_updater_info() {
1837 'class' => 'ModuleUpdater',
1838 'name' => t('Update modules'),
1842 'class' => 'ThemeUpdater',
1843 'name' => t('Update themes'),
1850 * Implements hook_filetransfer_info().
1852 function system_filetransfer_info() {
1853 $backends = array();
1855 // This is the default, will be available on most systems.
1856 if (function_exists('ftp_connect')) {
1857 $backends['ftp'] = array(
1858 'title' => t('FTP'),
1859 'class' => 'FileTransferFTP',
1860 'file' => 'ftp.inc',
1861 'file path' => 'includes/filetransfer',
1866 // SSH2 lib connection is only available if the proper PHP extension is
1868 if (function_exists('ssh2_connect')) {
1869 $backends['ssh'] = array(
1870 'title' => t('SSH'),
1871 'class' => 'FileTransferSSH',
1872 'file' => 'ssh.inc',
1873 'file path' => 'includes/filetransfer',
1881 * Implements hook_init().
1883 function system_init() {
1884 $path = drupal_get_path('module', 'system');
1885 // Add the CSS for this module. These aren't in system.info, because they
1886 // need to be in the CSS_SYSTEM group rather than the CSS_DEFAULT group.
1887 drupal_add_css($path .
'/system.base.css', array('group' => CSS_SYSTEM
, 'every_page' => TRUE
));
1888 if (path_is_admin(current_path())) {
1889 drupal_add_css($path .
'/system.admin.css', array('group' => CSS_SYSTEM
));
1891 drupal_add_css($path .
'/system.menus.css', array('group' => CSS_SYSTEM
, 'every_page' => TRUE
));
1892 drupal_add_css($path .
'/system.messages.css', array('group' => CSS_SYSTEM
, 'every_page' => TRUE
));
1893 drupal_add_css($path .
'/system.theme.css', array('group' => CSS_SYSTEM
, 'every_page' => TRUE
));
1895 // Ignore slave database servers for this request.
1897 // In Drupal's distributed database structure, new data is written to the master
1898 // and then propagated to the slave servers. This means there is a lag
1899 // between when data is written to the master and when it is available on the slave.
1900 // At these times, we will want to avoid using a slave server temporarily.
1901 // For example, if a user posts a new node then we want to disable the slave
1902 // server for that user temporarily to allow the slave server to catch up.
1903 // That way, that user will see their changes immediately while for other
1904 // users we still get the benefits of having a slave server, just with slightly
1905 // stale data. Code that wants to disable the slave server should use the
1906 // db_set_ignore_slave() function to set $_SESSION['ignore_slave_server'] to
1907 // the timestamp after which the slave can be re-enabled.
1908 if (isset($_SESSION['ignore_slave_server'])) {
1909 if ($_SESSION['ignore_slave_server'] >= REQUEST_TIME
) {
1910 Database
::ignoreTarget('default', 'slave');
1913 unset($_SESSION['ignore_slave_server']);
1917 // Add CSS/JS files from module .info files.
1918 system_add_module_assets();
1922 * Adds CSS and JavaScript files declared in module .info files.
1924 function system_add_module_assets() {
1925 foreach (system_get_info('module') as
$module => $info) {
1926 if (!empty($info['stylesheets'])) {
1927 foreach ($info['stylesheets'] as
$media => $stylesheets) {
1928 foreach ($stylesheets as
$stylesheet) {
1929 drupal_add_css($stylesheet, array('every_page' => TRUE
, 'media' => $media));
1933 if (!empty($info['scripts'])) {
1934 foreach ($info['scripts'] as
$script) {
1935 drupal_add_js($script, array('every_page' => TRUE
));
1942 * Implements hook_custom_theme().
1944 function system_custom_theme() {
1945 if (user_access('view the administration theme') && path_is_admin(current_path())) {
1946 return variable_get('admin_theme');
1951 * Implements hook_form_FORM_ID_alter().
1953 function system_form_user_profile_form_alter(&$form, &$form_state) {
1954 if ($form['#user_category'] == 'account') {
1955 if (variable_get('configurable_timezones', 1)) {
1956 system_user_timezone($form, $form_state);
1963 * Implements hook_form_FORM_ID_alter().
1965 function system_form_user_register_form_alter(&$form, &$form_state) {
1966 if (variable_get('configurable_timezones', 1)) {
1967 if (variable_get('user_default_timezone', DRUPAL_USER_TIMEZONE_DEFAULT
) == DRUPAL_USER_TIMEZONE_SELECT
) {
1968 system_user_timezone($form, $form_state);
1971 $form['account']['timezone'] = array(
1972 '#type' => 'hidden',
1973 '#value' => variable_get('user_default_timezone', DRUPAL_USER_TIMEZONE_DEFAULT
) ?
'' : variable_get('date_default_timezone', ''),
1981 * Implements hook_user_login().
1983 function system_user_login(&$edit, $account) {
1984 // If the user has a NULL time zone, notify them to set a time zone.
1985 if (!$account->timezone
&& variable_get('configurable_timezones', 1) && variable_get('empty_timezone_message', 0)) {
1986 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')))));
1991 * Add the time zone field to the user edit and register forms.
1993 function system_user_timezone(&$form, &$form_state) {
1996 $account = $form['#user'];
1998 $form['timezone'] = array(
1999 '#type' => 'fieldset',
2000 '#title' => t('Locale settings'),
2002 '#collapsible' => TRUE
,
2004 $form['timezone']['timezone'] = array(
2005 '#type' => 'select',
2006 '#title' => t('Time zone'),
2007 '#default_value' => isset($account->timezone
) ?
$account->timezone
: ($account->uid
== $user->uid ?
variable_get('date_default_timezone', '') : ''),
2008 '#options' => system_time_zones($account->uid
!= $user->uid
),
2009 '#description' => t('Select the desired local time and time zone. Dates and times throughout this site will be displayed using this time zone.'),
2011 if (!isset($account->timezone
) && $account->uid
== $user->uid
&& empty($form_state['input']['timezone'])) {
2012 $form['timezone']['#description'] = t('Your time zone setting will be automatically detected if possible. Confirm the selection and click save.');
2013 $form['timezone']['timezone']['#attributes'] = array('class' => array('timezone-detect'));
2014 drupal_add_js('misc/timezone.js');
2019 * Implements hook_block_info().
2021 function system_block_info() {
2022 $blocks['main'] = array(
2023 'info' => t('Main page content'),
2024 // Cached elsewhere.
2025 'cache' => DRUPAL_NO_CACHE
,
2027 $blocks['powered-by'] = array(
2028 'info' => t('Powered by Drupal'),
2030 'cache' => DRUPAL_NO_CACHE
,
2032 $blocks['help'] = array(
2033 'info' => t('System help'),
2035 'cache' => DRUPAL_NO_CACHE
,
2037 // System-defined menu blocks.
2038 foreach (menu_list_system_menus() as
$menu_name => $title) {
2039 $blocks[$menu_name]['info'] = t($title);
2040 // Menu blocks can't be cached because each menu item can have
2041 // a custom access callback. menu.inc manages its own caching.
2042 $blocks[$menu_name]['cache'] = DRUPAL_NO_CACHE
;
2048 * Implements hook_block_view().
2050 * Generate a block with a promotional link to Drupal.org and
2051 * all system menu blocks.
2053 function system_block_view($delta = '') {
2057 $block['subject'] = NULL
;
2058 $block['content'] = drupal_set_page_content();
2061 $block['subject'] = NULL
;
2062 $block['content'] = theme('system_powered_by');
2065 $block['subject'] = NULL
;
2066 $block['content'] = menu_get_active_help();
2069 // All system menu blocks.
2070 $system_menus = menu_list_system_menus();
2071 if (isset($system_menus[$delta])) {
2072 $block['subject'] = t($system_menus[$delta]);
2073 $block['content'] = menu_tree($delta);
2081 * Implements hook_preprocess_block().
2083 function system_preprocess_block(&$variables) {
2084 // System menu blocks should get the same class as menu module blocks.
2085 if ($variables['block']->module
== 'system' && in_array($variables['block']->delta
, array_keys(menu_list_system_menus()))) {
2086 $variables['classes_array'][] = 'block-menu';
2091 * Provide a single block on the administration overview page.
2094 * The menu item to be displayed.
2096 function system_admin_menu_block($item) {
2097 $cache = &drupal_static(__FUNCTION__
, array());
2098 // If we are calling this function for a menu item that corresponds to a
2099 // local task (for example, admin/tasks), then we want to retrieve the
2100 // parent item's child links, not this item's (since this item won't have
2102 if ($item['tab_root'] != $item['path']) {
2103 $item = menu_get_item($item['tab_root_href']);
2106 if (!isset($item['mlid'])) {
2107 $item += db_query("SELECT mlid, menu_name FROM {menu_links} ml WHERE ml.router_path = :path AND module = 'system'", array(':path' => $item['path']))->fetchAssoc();
2110 if (isset($cache[$item['mlid']])) {
2111 return $cache[$item['mlid']];
2115 $query = db_select('menu_links', 'ml', array('fetch' => PDO
::FETCH_ASSOC
));
2116 $query->join('menu_router', 'm', 'm.path = ml.router_path');
2119 // Weight should be taken from {menu_links}, not {menu_router}.
2120 ->fields('m', array_diff(drupal_schema_fields_sql('menu_router'), array('weight')))
2121 ->condition('ml.plid', $item['mlid'])
2122 ->condition('ml.menu_name', $item['menu_name'])
2123 ->condition('ml.hidden', 0);
2125 foreach ($query->execute() as
$link) {
2126 _menu_link_translate($link);
2127 if ($link['access']) {
2128 // The link description, either derived from 'description' in
2129 // hook_menu() or customized via menu module is used as title attribute.
2130 if (!empty($link['localized_options']['attributes']['title'])) {
2131 $link['description'] = $link['localized_options']['attributes']['title'];
2132 unset($link['localized_options']['attributes']['title']);
2134 // Prepare for sorting as in function _menu_tree_check_access().
2135 // The weight is offset so it is always positive, with a uniform 5-digits.
2136 $key = (50000 + $link['weight']) .
' ' .
drupal_strtolower($link['title']) .
' ' .
$link['mlid'];
2137 $content[$key] = $link;
2141 $cache[$item['mlid']] = $content;
2146 * Checks the existence of the directory specified in $form_element.
2148 * This function is called from the system_settings form to check all core
2149 * file directories (file_public_path, file_private_path, file_temporary_path).
2151 * @param $form_element
2152 * The form element containing the name of the directory to check.
2154 function system_check_directory($form_element) {
2155 $directory = $form_element['#value'];
2156 if (strlen($directory) == 0) {
2157 return $form_element;
2160 if (!is_dir($directory) && !drupal_mkdir($directory, NULL
, TRUE
)) {
2161 // If the directory does not exists and cannot be created.
2162 form_set_error($form_element['#parents'][0], t('The directory %directory does not exist and could not be created.', array('%directory' => $directory)));
2163 watchdog('file system', 'The directory %directory does not exist and could not be created.', array('%directory' => $directory), WATCHDOG_ERROR
);
2166 if (is_dir($directory) && !is_writable($directory) && !drupal_chmod($directory)) {
2167 // If the directory is not writable and cannot be made so.
2168 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)));
2169 watchdog('file system', 'The directory %directory exists but is not writable and could not be made writable.', array('%directory' => $directory), WATCHDOG_ERROR
);
2171 elseif (is_dir($directory)) {
2172 if ($form_element['#name'] == 'file_public_path') {
2173 // Create public .htaccess file.
2174 file_create_htaccess($directory, FALSE
);
2177 // Create private .htaccess file.
2178 file_create_htaccess($directory);
2182 return $form_element;
2186 * Retrieves the current status of an array of files in the system table.
2189 * An array of files to check.
2191 * The type of the files.
2193 function system_get_files_database(&$files, $type) {
2194 // Extract current files from database.
2195 $result = db_query("SELECT filename, name, type, status, schema_version, weight FROM {system} WHERE type = :type", array(':type' => $type));
2196 foreach ($result as
$file) {
2197 if (isset($files[$file->name
]) && is_object($files[$file->name
])) {
2198 $file->uri
= $file->filename
;
2199 foreach ($file as
$key => $value) {
2200 if (!isset($files[$file->name
]->$key)) {
2201 $files[$file->name
]->$key = $value;
2209 * Updates the records in the system table based on the files array.
2212 * An array of files.
2214 * The type of the files.
2216 function system_update_files_database(&$files, $type) {
2217 $result = db_query("SELECT * FROM {system} WHERE type = :type", array(':type' => $type));
2219 // Add all files that need to be deleted to a DatabaseCondition.
2221 foreach ($result as
$file) {
2222 if (isset($files[$file->name
]) && is_object($files[$file->name
])) {
2223 // Keep the old filename from the database in case the file has moved.
2224 $old_filename = $file->filename
;
2226 $updated_fields = array();
2228 // Handle info specially, compare the serialized value.
2229 $serialized_info = serialize($files[$file->name
]->info
);
2230 if ($serialized_info != $file->info
) {
2231 $updated_fields['info'] = $serialized_info;
2235 // Scan remaining fields to find only the updated values.
2236 foreach ($file as
$key => $value) {
2237 if (isset($files[$file->name
]->$key) && $files[$file->name
]->$key != $value) {
2238 $updated_fields[$key] = $files[$file->name
]->$key;
2242 // Update the record.
2243 if (count($updated_fields)) {
2245 ->fields($updated_fields)
2246 ->condition('filename', $old_filename)
2250 // Indicate that the file exists already.
2251 $files[$file->name
]->exists
= TRUE
;
2254 // File is not found in file system, so delete record from the system table.
2255 $delete->condition('filename', $file->filename
);
2259 if (count($delete) > 0) {
2260 // Delete all missing files from the system table, but only if the plugin
2261 // has never been installed.
2263 ->condition($delete)
2264 ->condition('schema_version', -1)
2268 // All remaining files are not in the system table, so we need to add them.
2269 $query = db_insert('system')->fields(array('filename', 'name', 'type', 'owner', 'info'));
2270 foreach ($files as
&$file) {
2271 if (isset($file->exists
)) {
2272 unset($file->exists
);
2275 $query->values(array(
2276 'filename' => $file->uri
,
2277 'name' => $file->name
,
2279 'owner' => isset($file->owner
) ?
$file->owner
: '',
2280 'info' => serialize($file->info
),
2282 $file->type
= $type;
2284 $file->schema_version
= -1;
2289 // If any module or theme was moved to a new location, we need to reset the
2290 // system_list() cache or we will continue to load the old copy, look for
2291 // schema updates in the wrong place, etc.
2292 system_list_reset();
2296 * Returns an array of information about enabled modules or themes.
2298 * This function returns the information from the {system} table corresponding
2299 * to the cached contents of the .info file for each active module or theme.
2302 * Either 'module' or 'theme'.
2304 * (optional) The name of a module or theme whose information shall be
2305 * returned. If omitted, all records for the provided $type will be returned.
2306 * If $name does not exist in the provided $type or is not enabled, an empty
2307 * array will be returned.
2310 * An associative array of module or theme information keyed by name, or only
2311 * information for $name, if given. If no records are available, an empty
2312 * array is returned.
2314 * @see system_rebuild_module_data()
2315 * @see system_rebuild_theme_data()
2317 function system_get_info($type, $name = NULL
) {
2319 if ($type == 'module') {
2320 $type = 'module_enabled';
2322 $list = system_list($type);
2323 foreach ($list as
$shortname => $item) {
2324 if (!empty($item->status
)) {
2325 $info[$shortname] = $item->info
;
2329 return isset($info[$name]) ?
$info[$name] : array();
2335 * Helper function to scan and collect module .info data.
2338 * An associative array of module information.
2340 function _system_rebuild_module_data() {
2342 $modules = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN .
'\.module$/', 'modules', 'name', 0);
2344 // Include the install profile in modules that are loaded.
2345 $profile = drupal_get_profile();
2346 $modules[$profile] = new
stdClass();
2347 $modules[$profile]->name
= $profile;
2348 $modules[$profile]->uri
= 'profiles/' .
$profile .
'/' .
$profile .
'.profile';
2349 $modules[$profile]->filename
= $profile .
'.profile';
2351 // Install profile hooks are always executed last.
2352 $modules[$profile]->weight
= 1000;
2354 // Set defaults for module info.
2356 'dependencies' => array(),
2357 'description' => '',
2358 'package' => 'Other',
2360 'php' => DRUPAL_MINIMUM_PHP
,
2365 // Read info files for each module.
2366 foreach ($modules as
$key => $module) {
2367 // The module system uses the key 'filename' instead of 'uri' so copy the
2368 // value so it will be used by the modules system.
2369 $modules[$key]->filename
= $module->uri
;
2371 // Look for the info file.
2372 $module->info
= drupal_parse_info_file(dirname($module->uri
) .
'/' .
$module->name .
'.info');
2374 // Skip modules that don't provide info.
2375 if (empty($module->info
)) {
2376 unset($modules[$key]);
2380 // Merge in defaults and save.
2381 $modules[$key]->info
= $module->info
+ $defaults;
2383 // Prefix stylesheets and scripts with module path.
2384 $path = dirname($module->uri
);
2385 if (isset($module->info
['stylesheets'])) {
2386 $module->info
['stylesheets'] = _system_info_add_path($module->info
['stylesheets'], $path);
2388 if (isset($module->info
['scripts'])) {
2389 $module->info
['scripts'] = _system_info_add_path($module->info
['scripts'], $path);
2392 // Install profiles are hidden by default, unless explicitly specified
2393 // otherwise in the .info file.
2394 if ($key == $profile && !isset($modules[$key]->info
['hidden'])) {
2395 $modules[$key]->info
['hidden'] = TRUE
;
2398 // Invoke hook_system_info_alter() to give installed modules a chance to
2399 // modify the data in the .info files if necessary.
2401 drupal_alter('system_info', $modules[$key]->info
, $modules[$key], $type);
2404 if (isset($modules[$profile])) {
2405 // The install profile is required, if it's a valid module.
2406 $modules[$profile]->info
['required'] = TRUE
;
2407 // Add a default distribution name if the profile did not provide one. This
2408 // matches the default value used in install_profile_info().
2409 if (!isset($modules[$profile]->info
['distribution_name'])) {
2410 $modules[$profile]->info
['distribution_name'] = 'Drupal';
2418 * Rebuild, save, and return data about all currently available modules.
2421 * Array of all available modules and their data.
2423 function system_rebuild_module_data() {
2424 $modules_cache = &drupal_static(__FUNCTION__
);
2425 // Only rebuild once per request. $modules and $modules_cache cannot be
2426 // combined into one variable, because the $modules_cache variable is reset by
2427 // reference from system_list_reset() during the rebuild.
2428 if (!isset($modules_cache)) {
2429 $modules = _system_rebuild_module_data();
2431 system_get_files_database($modules, 'module');
2432 system_update_files_database($modules, 'module');
2433 $modules = _module_build_dependencies($modules);
2434 $modules_cache = $modules;
2436 return $modules_cache;
2440 * Refresh bootstrap column in the system table.
2442 * This is called internally by module_enable/disable() to flag modules that
2443 * implement hooks used during bootstrap, such as hook_boot(). These modules
2444 * are loaded earlier to invoke the hooks.
2446 function _system_update_bootstrap_status() {
2447 $bootstrap_modules = array();
2448 foreach (bootstrap_hooks() as
$hook) {
2449 foreach (module_implements($hook) as
$module) {
2450 $bootstrap_modules[] = $module;
2453 $query = db_update('system')->fields(array('bootstrap' => 0));
2454 if ($bootstrap_modules) {
2456 ->fields(array('bootstrap' => 1))
2457 ->condition('name', $bootstrap_modules, 'IN')
2459 $query->condition('name', $bootstrap_modules, 'NOT IN');
2462 // Reset the cached list of bootstrap modules.
2463 system_list_reset();
2467 * Helper function to scan and collect theme .info data and their engines.
2470 * An associative array of themes information.
2472 function _system_rebuild_theme_data() {
2474 $themes = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN .
'\.info$/', 'themes');
2475 // Allow modules to add further themes.
2476 if ($module_themes = module_invoke_all('system_theme_info')) {
2477 foreach ($module_themes as
$name => $uri) {
2478 // @see file_scan_directory()
2479 $themes[$name] = (object) array(
2481 'filename' => pathinfo($uri, PATHINFO_FILENAME
),
2487 // Find theme engines
2488 $engines = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN .
'\.engine$/', 'themes/engines');
2490 // Set defaults for theme info.
2492 'engine' => 'phptemplate',
2494 'sidebar_first' => 'Left sidebar',
2495 'sidebar_second' => 'Right sidebar',
2496 'content' => 'Content',
2497 'header' => 'Header',
2498 'footer' => 'Footer',
2499 'highlighted' => 'Highlighted',
2501 'page_top' => 'Page top',
2502 'page_bottom' => 'Page bottom',
2504 'description' => '',
2505 'features' => _system_default_theme_features(),
2506 'screenshot' => 'screenshot.png',
2507 'php' => DRUPAL_MINIMUM_PHP
,
2508 'stylesheets' => array(),
2509 'scripts' => array(),
2512 $sub_themes = array();
2513 // Read info files for each theme
2514 foreach ($themes as
$key => $theme) {
2515 $themes[$key]->filename
= $theme->uri
;
2516 $themes[$key]->info
= drupal_parse_info_file($theme->uri
) + $defaults;
2518 // Invoke hook_system_info_alter() to give installed modules a chance to
2519 // modify the data in the .info files if necessary.
2521 drupal_alter('system_info', $themes[$key]->info
, $themes[$key], $type);
2523 if (!empty($themes[$key]->info
['base theme'])) {
2524 $sub_themes[] = $key;
2526 if ($themes[$key]->info
['engine'] == 'theme') {
2527 $filename = dirname($themes[$key]->uri
) .
'/' .
$themes[$key]->name .
'.theme';
2528 if (file_exists($filename)) {
2529 $themes[$key]->owner
= $filename;
2530 $themes[$key]->prefix
= $key;
2534 $engine = $themes[$key]->info
['engine'];
2535 if (isset($engines[$engine])) {
2536 $themes[$key]->owner
= $engines[$engine]->uri
;
2537 $themes[$key]->prefix
= $engines[$engine]->name
;
2538 $themes[$key]->template
= TRUE
;
2542 // Prefix stylesheets and scripts with module path.
2543 $path = dirname($theme->uri
);
2544 $theme->info
['stylesheets'] = _system_info_add_path($theme->info
['stylesheets'], $path);
2545 $theme->info
['scripts'] = _system_info_add_path($theme->info
['scripts'], $path);
2547 // Give the screenshot proper path information.
2548 if (!empty($themes[$key]->info
['screenshot'])) {
2549 $themes[$key]->info
['screenshot'] = $path .
'/' .
$themes[$key]->info
['screenshot'];
2553 // Now that we've established all our master themes, go back and fill in data
2555 foreach ($sub_themes as
$key) {
2556 $themes[$key]->base_themes
= system_find_base_themes($themes, $key);
2557 // Don't proceed if there was a problem with the root base theme.
2558 if (!current($themes[$key]->base_themes
)) {
2561 $base_key = key($themes[$key]->base_themes
);
2562 foreach (array_keys($themes[$key]->base_themes
) as
$base_theme) {
2563 $themes[$base_theme]->sub_themes
[$key] = $themes[$key]->info
['name'];
2565 // Copy the 'owner' and 'engine' over if the top level theme uses a theme
2567 if (isset($themes[$base_key]->owner
)) {
2568 if (isset($themes[$base_key]->info
['engine'])) {
2569 $themes[$key]->info
['engine'] = $themes[$base_key]->info
['engine'];
2570 $themes[$key]->owner
= $themes[$base_key]->owner
;
2571 $themes[$key]->prefix
= $themes[$base_key]->prefix
;
2574 $themes[$key]->prefix
= $key;
2583 * Rebuild, save, and return data about all currently available themes.
2586 * Array of all available themes and their data.
2588 function system_rebuild_theme_data() {
2589 $themes = _system_rebuild_theme_data();
2591 system_get_files_database($themes, 'theme');
2592 system_update_files_database($themes, 'theme');
2597 * Prefixes all values in an .info file array with a given path.
2599 * This helper function is mainly used to prefix all array values of an .info
2600 * file property with a single given path (to the module or theme); e.g., to
2601 * prefix all values of the 'stylesheets' or 'scripts' properties with the file
2602 * path to the defining module/theme.
2605 * A nested array of data of an .info file to be processed.
2607 * A file path to prepend to each value in $info.
2610 * The $info array with prefixed values.
2612 * @see _system_rebuild_module_data()
2613 * @see _system_rebuild_theme_data()
2615 function _system_info_add_path($info, $path) {
2616 foreach ($info as
$key => $value) {
2617 // Recurse into nested values until we reach the deepest level.
2618 if (is_array($value)) {
2619 $info[$key] = _system_info_add_path($info[$key], $path);
2621 // Unset the original value's key and set the new value with prefix, using
2622 // the original value as key, so original values can still be looked up.
2625 $info[$value] = $path .
'/' .
$value;
2632 * Returns an array of default theme features.
2634 function _system_default_theme_features() {
2640 'node_user_picture',
2641 'comment_user_picture',
2642 'comment_user_verification',
2649 * Find all the base themes for the specified theme.
2651 * Themes can inherit templates and function implementations from earlier themes.
2654 * An array of available themes.
2656 * The name of the theme whose base we are looking for.
2658 * A recursion parameter preventing endless loops.
2660 * Returns an array of all of the theme's ancestors; the first element's value
2661 * will be NULL if an error occurred.
2663 function system_find_base_themes($themes, $key, $used_keys = array()) {
2664 $base_key = $themes[$key]->info
['base theme'];
2665 // Does the base theme exist?
2666 if (!isset($themes[$base_key])) {
2667 return array($base_key => NULL
);
2670 $current_base_theme = array($base_key => $themes[$base_key]->info
['name']);
2672 // Is the base theme itself a child of another theme?
2673 if (isset($themes[$base_key]->info
['base theme'])) {
2674 // Do we already know the base themes of this theme?
2675 if (isset($themes[$base_key]->base_themes
)) {
2676 return $themes[$base_key]->base_themes
+ $current_base_theme;
2679 if (!empty($used_keys[$base_key])) {
2680 return array($base_key => NULL
);
2682 $used_keys[$base_key] = TRUE
;
2683 return system_find_base_themes($themes, $base_key, $used_keys) + $current_base_theme;
2685 // If we get here, then this is our parent theme.
2686 return $current_base_theme;
2690 * Get a list of available regions from a specified theme.
2693 * The name of a theme.
2695 * Possible values: REGIONS_ALL or REGIONS_VISIBLE. Visible excludes hidden
2698 * An array of regions in the form $region['name'] = 'description'.
2700 function system_region_list($theme_key, $show = REGIONS_ALL
) {
2701 $themes = list_themes();
2702 if (!isset($themes[$theme_key])) {
2707 $info = $themes[$theme_key]->info
;
2708 // If requested, suppress hidden regions. See block_admin_display_form().
2709 foreach ($info['regions'] as
$name => $label) {
2710 if ($show == REGIONS_ALL
|| !isset($info['regions_hidden']) || !in_array($name, $info['regions_hidden'])) {
2711 $list[$name] = t($label);
2719 * Implements hook_system_info_alter().
2721 function system_system_info_alter(&$info, $file, $type) {
2722 // Remove page-top from the blocks UI since it is reserved for modules to
2723 // populate from outside the blocks system.
2724 if ($type == 'theme') {
2725 $info['regions_hidden'][] = 'page_top';
2726 $info['regions_hidden'][] = 'page_bottom';
2731 * Get the name of the default region for a given theme.
2734 * The name of a theme.
2736 * A string that is the region name.
2738 function system_default_region($theme) {
2739 $regions = array_keys(system_region_list($theme, REGIONS_VISIBLE
));
2740 return isset($regions[0]) ?
$regions[0] : '';
2744 * Add default buttons to a form and set its prefix.
2747 * An associative array containing the structure of the form.
2750 * The form structure.
2752 * @see system_settings_form_submit()
2755 function system_settings_form($form) {
2756 $form['actions']['#type'] = 'actions';
2757 $form['actions']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration'));
2759 if (!empty($_POST) && form_get_errors()) {
2760 drupal_set_message(t('The settings have not been saved because of the errors.'), 'error');
2762 $form['#submit'][] = 'system_settings_form_submit';
2763 // By default, render the form using theme_system_settings_form().
2764 if (!isset($form['#theme'])) {
2765 $form['#theme'] = 'system_settings_form';
2771 * Execute the system_settings_form.
2773 * If you want node type configure style handling of your checkboxes,
2774 * add an array_filter value to your form.
2776 function system_settings_form_submit($form, &$form_state) {
2777 // Exclude unnecessary elements.
2778 form_state_values_clean($form_state);
2780 foreach ($form_state['values'] as
$key => $value) {
2781 if (is_array($value) && isset($form_state['values']['array_filter'])) {
2782 $value = array_keys(array_filter($value));
2784 variable_set($key, $value);
2787 drupal_set_message(t('The configuration options have been saved.'));
2791 * Helper function to sort requirements.
2793 function _system_sort_requirements($a, $b) {
2794 if (!isset($a['weight'])) {
2795 if (!isset($b['weight'])) {
2796 return strcmp($a['title'], $b['title']);
2798 return -$b['weight'];
2800 return isset($b['weight']) ?
$a['weight'] - $b['weight'] : $a['weight'];
2804 * Generates a form array for a confirmation form.
2806 * This function returns a complete form array for confirming an action. The
2807 * form contains a confirm button as well as a cancellation link that allows a
2808 * user to abort the action.
2810 * If the submit handler for a form that implements confirm_form() is invoked,
2811 * the user successfully confirmed the action. You should never directly
2812 * inspect $_POST to see if an action was confirmed.
2814 * Note - if the parameters $question, $description, $yes, or $no could contain
2815 * any user input (such as node titles or taxonomy terms), it is the
2816 * responsibility of the code calling confirm_form() to sanitize them first with
2817 * a function like check_plain() or filter_xss().
2820 * Additional elements to add to the form. These can be regular form elements,
2821 * #value elements, etc., and their values will be available to the submit
2824 * The question to ask the user (e.g. "Are you sure you want to delete the
2825 * block <em>foo</em>?"). The page title will be set to this value.
2827 * The page to go to if the user cancels the action. This can be either:
2828 * - A string containing a Drupal path.
2829 * - An associative array with a 'path' key. Additional array values are
2830 * passed as the $options parameter to l().
2831 * If the 'destination' query parameter is set in the URL when viewing a
2832 * confirmation form, that value will be used instead of $path.
2833 * @param $description
2834 * Additional text to display. Defaults to t('This action cannot be undone.').
2836 * A caption for the button that confirms the action (e.g. "Delete",
2837 * "Replace", ...). Defaults to t('Confirm').
2839 * A caption for the link which cancels the action (e.g. "Cancel"). Defaults
2842 * The internal name used to refer to the confirmation item.
2847 function confirm_form($form, $question, $path, $description = NULL
, $yes = NULL
, $no = NULL
, $name = 'confirm') {
2848 $description = isset($description) ?
$description : t('This action cannot be undone.');
2850 // Prepare cancel link.
2851 if (isset($_GET['destination'])) {
2852 $options = drupal_parse_url(urldecode($_GET['destination']));
2854 elseif (is_array($path)) {
2858 $options = array('path' => $path);
2861 drupal_set_title($question, PASS_THROUGH
);
2863 $form['#attributes']['class'][] = 'confirmation';
2864 $form['description'] = array('#markup' => $description);
2865 $form[$name] = array('#type' => 'hidden', '#value' => 1);
2867 $form['actions'] = array('#type' => 'actions');
2868 $form['actions']['submit'] = array(
2869 '#type' => 'submit',
2870 '#value' => $yes ?
$yes : t('Confirm'),
2872 $form['actions']['cancel'] = array(
2874 '#title' => $no ?
$no : t('Cancel'),
2875 '#href' => $options['path'],
2876 '#options' => $options,
2878 // By default, render the form using theme_confirm_form().
2879 if (!isset($form['#theme'])) {
2880 $form['#theme'] = 'confirm_form';
2886 * Determines if the current user is in compact mode.
2889 * TRUE when in compact mode, FALSE when in expanded mode.
2891 function system_admin_compact_mode() {
2892 // PHP converts dots into underscores in cookie names to avoid problems with
2893 // its parser, so we use a converted cookie name.
2894 return isset($_COOKIE['Drupal_visitor_admin_compact_mode']) ?
$_COOKIE['Drupal_visitor_admin_compact_mode'] : variable_get('admin_compact_mode', FALSE
);
2898 * Menu callback; Sets whether the admin menu is in compact mode or not.
2901 * Valid values are 'on' and 'off'.
2903 function system_admin_compact_page($mode = 'off') {
2904 user_cookie_save(array('admin_compact_mode' => ($mode == 'on')));
2909 * Generate a list of tasks offered by a specified module.
2914 * The module's information, as provided by system_get_info().
2917 * An array of task links.
2919 function system_get_module_admin_tasks($module, $info) {
2920 $links = &drupal_static(__FUNCTION__
);
2922 if (!isset($links)) {
2924 $query = db_select('menu_links', 'ml', array('fetch' => PDO
::FETCH_ASSOC
));
2925 $query->join('menu_router', 'm', 'm.path = ml.router_path');
2928 // Weight should be taken from {menu_links}, not {menu_router}.
2929 ->fields('m', array_diff(drupal_schema_fields_sql('menu_router'), array('weight')))
2930 ->condition('ml.link_path', 'admin/%', 'LIKE')
2931 ->condition('ml.hidden', 0, '>=')
2932 ->condition('ml.module', 'system')
2933 ->condition('m.number_parts', 1, '>')
2934 ->condition('m.page_callback', 'system_admin_menu_block_page', '<>');
2935 foreach ($query->execute() as
$link) {
2936 _menu_link_translate($link);
2937 if ($link['access']) {
2938 $links[$link['router_path']] = $link;
2943 $admin_tasks = array();
2945 if ($menu = module_invoke($module, 'menu')) {
2946 foreach ($menu as
$path => $item) {
2947 if (isset($links[$path])) {
2948 $task = $links[$path];
2949 // The link description, either derived from 'description' in
2950 // hook_menu() or customized via menu module is used as title attribute.
2951 if (!empty($task['localized_options']['attributes']['title'])) {
2952 $task['description'] = $task['localized_options']['attributes']['title'];
2953 unset($task['localized_options']['attributes']['title']);
2956 // Check the admin tasks for duplicate names. If one is found,
2957 // append the parent menu item's title to differentiate.
2958 $duplicate_path = array_search($task['title'], $titles);
2959 if ($duplicate_path !== FALSE
) {
2960 if ($parent = menu_link_load($task['plid'])) {
2961 // Append the parent item's title to this task's title.
2962 $task['title'] = t('@original_title (@parent_title)', array('@original_title' => $task['title'], '@parent_title' => $parent['title']));
2964 if ($parent = menu_link_load($admin_tasks[$duplicate_path]['plid'])) {
2965 // Append the parent item's title to the duplicated task's title.
2966 // We use $links[$duplicate_path] in case there are triplicates.
2967 $admin_tasks[$duplicate_path]['title'] = t('@original_title (@parent_title)', array('@original_title' => $links[$duplicate_path]['title'], '@parent_title' => $parent['title']));
2971 $titles[$path] = $task['title'];
2974 $admin_tasks[$path] = $task;
2979 // Append link for permissions.
2980 if (module_hook($module, 'permission')) {
2981 $item = menu_get_item('admin/people/permissions');
2982 if (!empty($item['access'])) {
2983 $item['link_path'] = $item['href'];
2984 $item['title'] = t('Configure @module permissions', array('@module' => $info['name']));
2985 unset($item['description']);
2986 $item['localized_options']['fragment'] = 'module-' .
$module;
2987 $admin_tasks["admin/people/permissions#module-$module"] = $item;
2991 return $admin_tasks;
2995 * Implements hook_cron().
2997 * Remove older rows from flood and batch table. Remove old temporary files.
2999 function system_cron() {
3000 // Cleanup the flood.
3002 ->condition('expiration', REQUEST_TIME
, '<')
3005 // Remove temporary files that are older than DRUPAL_MAXIMUM_TEMP_FILE_AGE.
3006 // Use separate placeholders for the status to avoid a bug in some versions
3007 // of PHP. See http://drupal.org/node/352956.
3008 $result = db_query('SELECT fid FROM {file_managed} WHERE status <> :permanent AND timestamp < :timestamp', array(
3009 ':permanent' => FILE_STATUS_PERMANENT
,
3010 ':timestamp' => REQUEST_TIME
- DRUPAL_MAXIMUM_TEMP_FILE_AGE
3012 foreach ($result as
$row) {
3013 if ($file = file_load($row->fid
)) {
3014 $references = file_usage_list($file);
3015 if (empty($references)) {
3016 if (!file_delete($file)) {
3017 watchdog('file system', 'Could not delete temporary file "%path" during garbage collection', array('%path' => $file->uri
), WATCHDOG_ERROR
);
3021 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
);
3026 $core = array('cache', 'cache_path', 'cache_filter', 'cache_page', 'cache_form', 'cache_menu');
3027 $cache_tables = array_merge(module_invoke_all('flush_caches'), $core);
3028 foreach ($cache_tables as
$table) {
3029 cache_clear_all(NULL
, $table);
3032 // Cleanup the batch table and the queue for failed batches.
3034 ->condition('timestamp', REQUEST_TIME
- 864000, '<')
3037 ->condition('created', REQUEST_TIME
- 864000, '<')
3038 ->condition('name', 'drupal_batch:%', 'LIKE')
3041 // Reset expired items in the default queue implementation table. If that's
3042 // not used, this will simply be a no-op.
3047 ->condition('expire', 0, '<>')
3048 ->condition('expire', REQUEST_TIME
, '<')
3053 * Implements hook_flush_caches().
3055 function system_flush_caches() {
3056 // Rebuild list of date formats.
3057 system_date_formats_rebuild();
3058 // Reset the menu static caches.
3059 menu_reset_static_cache();
3063 * Implements hook_action_info().
3065 function system_action_info() {
3067 'system_message_action' => array(
3069 'label' => t('Display a message to the user'),
3070 'configurable' => TRUE
,
3071 'triggers' => array('any'),
3073 'system_send_email_action' => array(
3075 'label' => t('Send e-mail'),
3076 'configurable' => TRUE
,
3077 'triggers' => array('any'),
3079 'system_block_ip_action' => array(
3081 'label' => t('Ban IP address of current user'),
3082 'configurable' => FALSE
,
3083 'triggers' => array('any'),
3085 'system_goto_action' => array(
3087 'label' => t('Redirect to URL'),
3088 'configurable' => TRUE
,
3089 'triggers' => array('any'),
3095 * Return a form definition so the Send email action can be configured.
3098 * Default values (if we are editing an existing action instance).
3103 * @see system_send_email_action_validate()
3104 * @see system_send_email_action_submit()
3106 function system_send_email_action_form($context) {
3107 // Set default values for form.
3108 if (!isset($context['recipient'])) {
3109 $context['recipient'] = '';
3111 if (!isset($context['subject'])) {
3112 $context['subject'] = '';
3114 if (!isset($context['message'])) {
3115 $context['message'] = '';
3118 $form['recipient'] = array(
3119 '#type' => 'textfield',
3120 '#title' => t('Recipient'),
3121 '#default_value' => $context['recipient'],
3122 '#maxlength' => '254',
3123 '#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.'),
3125 $form['subject'] = array(
3126 '#type' => 'textfield',
3127 '#title' => t('Subject'),
3128 '#default_value' => $context['subject'],
3129 '#maxlength' => '254',
3130 '#description' => t('The subject of the message.'),
3132 $form['message'] = array(
3133 '#type' => 'textarea',
3134 '#title' => t('Message'),
3135 '#default_value' => $context['message'],
3138 '#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.'),
3144 * Validate system_send_email_action form submissions.
3146 function system_send_email_action_validate($form, $form_state) {
3147 $form_values = $form_state['values'];
3148 // Validate the configuration form.
3149 if (!valid_email_address($form_values['recipient']) && strpos($form_values['recipient'], ':mail') === FALSE
) {
3150 // We want the literal %author placeholder to be emphasized in the error message.
3151 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]')));
3156 * Process system_send_email_action form submissions.
3158 function system_send_email_action_submit($form, $form_state) {
3159 $form_values = $form_state['values'];
3160 // Process the HTML form to store configuration. The keyed array that
3161 // we return will be serialized to the database.
3163 'recipient' => $form_values['recipient'],
3164 'subject' => $form_values['subject'],
3165 'message' => $form_values['message'],
3171 * Sends an e-mail message.
3173 * @param object $entity
3174 * An optional node object, which will be added as $context['node'] if
3176 * @param array $context
3177 * Array with the following elements:
3178 * - 'recipient': E-mail message recipient. This will be passed through
3180 * - 'subject': The subject of the message. This will be passed through
3182 * - 'message': The message to send. This will be passed through