Révision 7c856df4
Ajouté par Assos Assos il y a plus de 8 ans
| drupal7/sites/all/modules/libraries/libraries.module | ||
|---|---|---|
| 33 | 33 |
* @param $base_path |
| 34 | 34 |
* Whether to prefix the resulting path with base_path(). |
| 35 | 35 |
* |
| 36 |
* @return |
|
| 36 |
* @return string
|
|
| 37 | 37 |
* The path to the specified library or FALSE if the library wasn't found. |
| 38 | 38 |
* |
| 39 | 39 |
* @ingroup libraries |
| ... | ... | |
| 67 | 67 |
* in both the site-wide directory and site-specific directory, only the |
| 68 | 68 |
* site-specific version will be listed. |
| 69 | 69 |
* |
| 70 |
* @return |
|
| 70 |
* @return array
|
|
| 71 | 71 |
* A list of library directories. |
| 72 | 72 |
* |
| 73 | 73 |
* @ingroup libraries |
| ... | ... | |
| 122 | 122 |
* - sites/$sitename/libraries |
| 123 | 123 |
* - any directories specified via hook_libraries_info_file_paths() |
| 124 | 124 |
* |
| 125 |
* @return |
|
| 125 |
* @return array
|
|
| 126 | 126 |
* An array of info files, keyed by library name. The values are the paths of |
| 127 | 127 |
* the files. |
| 128 | 128 |
*/ |
| ... | ... | |
| 429 | 429 |
/** |
| 430 | 430 |
* Applies default properties to a library definition. |
| 431 | 431 |
* |
| 432 |
* @library |
|
| 432 |
* @param array $library
|
|
| 433 | 433 |
* An array of library information, passed by reference. |
| 434 |
* @name |
|
| 434 |
* @param string $name
|
|
| 435 | 435 |
* The machine name of the passed-in library. |
| 436 |
* |
|
| 437 |
* @return array |
|
| 438 |
* The library information array with defaults populated. |
|
| 436 | 439 |
*/ |
| 437 |
function libraries_info_defaults(&$library, $name) {
|
|
| 440 |
function libraries_info_defaults(array &$library, $name) {
|
|
| 438 | 441 |
$library += array( |
| 439 | 442 |
'machine name' => $name, |
| 440 | 443 |
'name' => $name, |
| 441 | 444 |
'vendor url' => '', |
| 442 | 445 |
'download url' => '', |
| 446 |
'download file url' => '', |
|
| 443 | 447 |
'path' => '', |
| 444 | 448 |
'library path' => NULL, |
| 445 | 449 |
'version callback' => 'libraries_get_version', |
| ... | ... | |
| 472 | 476 |
/** |
| 473 | 477 |
* Tries to detect a library and its installed version. |
| 474 | 478 |
* |
| 475 |
* @param $name |
|
| 476 |
* The machine name of a library to return registered information for. |
|
| 479 |
* @param string $name |
|
| 480 |
* (optional) The machine name of a library to detect and return registered |
|
| 481 |
* information for. If omitted, information about all registered libraries is |
|
| 482 |
* returned. |
|
| 477 | 483 |
* |
| 478 | 484 |
* @return array|false |
| 479 |
* An associative array containing registered information for the library |
|
| 480 |
* specified by $name, or FALSE if the library $name is not registered. |
|
| 485 |
* An associative array containing registered information for all libraries, |
|
| 486 |
* the registered information for the library specified by $name, or FALSE if |
|
| 487 |
* the library $name is not registered. |
|
| 481 | 488 |
* In addition to the keys returned by libraries_info(), the following keys |
| 482 | 489 |
* are contained: |
| 483 | 490 |
* - installed: A boolean indicating whether the library is installed. Note |
| ... | ... | |
| 491 | 498 |
* |
| 492 | 499 |
* @see libraries_info() |
| 493 | 500 |
*/ |
| 494 |
function libraries_detect($name) {
|
|
| 501 |
function libraries_detect($name = NULL) {
|
|
| 502 |
if (!isset($name)) {
|
|
| 503 |
$libraries = &libraries_info(); |
|
| 504 |
foreach ($libraries as $name => $library) {
|
|
| 505 |
libraries_detect($name); |
|
| 506 |
} |
|
| 507 |
return $libraries; |
|
| 508 |
} |
|
| 509 |
|
|
| 495 | 510 |
// Re-use the statically cached value of libraries_info() to save memory. |
| 496 | 511 |
$library = &libraries_info($name); |
| 497 | 512 |
|
| ... | ... | |
| 531 | 546 |
$library['version'] = call_user_func_array($library['version callback'], array_merge(array($library), $library['version arguments'])); |
| 532 | 547 |
} |
| 533 | 548 |
else {
|
| 534 |
$library['version'] = $library['version callback']($library, $library['version arguments']);
|
|
| 549 |
$library['version'] = call_user_func($library['version callback'], $library, $library['version arguments']);
|
|
| 535 | 550 |
} |
| 536 | 551 |
if (empty($library['version'])) {
|
| 537 | 552 |
$library['error'] = 'not detected'; |
| ... | ... | |
| 693 | 708 |
* The number of loaded files. |
| 694 | 709 |
*/ |
| 695 | 710 |
function libraries_load_files($library) {
|
| 711 |
// As this key was added after 7.x-2.1 cached library structures might not |
|
| 712 |
// have it. |
|
| 713 |
$library += array('post-load integration files' => FALSE);
|
|
| 714 |
|
|
| 696 | 715 |
// Load integration files. |
| 697 | 716 |
if (!$library['post-load integration files'] && !empty($library['integration files'])) {
|
| 698 | 717 |
$enabled_themes = array(); |
| ... | ... | |
| 867 | 886 |
} |
| 868 | 887 |
fclose($file); |
| 869 | 888 |
} |
| 889 |
|
|
| 890 |
/** |
|
| 891 |
* Implements hook_help(). |
|
| 892 |
*/ |
|
| 893 |
function libraries_help($path, $arg) {
|
|
| 894 |
switch ($path) {
|
|
| 895 |
case 'admin/reports/libraries': |
|
| 896 |
return t('Click on a library for a status report or detailed installation instructions in case the library is not installed correctly.');
|
|
| 897 |
} |
|
| 898 |
} |
|
| 899 |
|
|
| 900 |
/** |
|
| 901 |
* Implements hook_menu(). |
|
| 902 |
*/ |
|
| 903 |
function libraries_menu() {
|
|
| 904 |
$items = array(); |
|
| 905 |
$items['admin/reports/libraries'] = array( |
|
| 906 |
'title' => 'Libraries', |
|
| 907 |
'description' => 'An overview of libraries installed on this site.', |
|
| 908 |
'page callback' => 'drupal_get_form', |
|
| 909 |
'page arguments' => array('libraries_admin_overview'),
|
|
| 910 |
'access arguments' => array('access site reports'),
|
|
| 911 |
'file' => 'libraries.admin.inc' |
|
| 912 |
); |
|
| 913 |
$items['admin/reports/libraries/%libraries_ui'] = array( |
|
| 914 |
'title' => 'Library status report', |
|
| 915 |
'description' => 'Status overview for a single library', |
|
| 916 |
'page callback' => 'drupal_get_form', |
|
| 917 |
'page arguments' => array('libraries_admin_library_status_form', 3),
|
|
| 918 |
'access arguments' => array('access site reports'),
|
|
| 919 |
'file' => 'libraries.admin.inc' |
|
| 920 |
); |
|
| 921 |
return $items; |
|
| 922 |
} |
|
| 923 |
|
|
| 924 |
/** |
|
| 925 |
* Loads library information for display in the user interface. |
|
| 926 |
* |
|
| 927 |
* This can be used as a menu loader function by specifying a '%libraries_ui' |
|
| 928 |
* parameter in a path. |
|
| 929 |
* |
|
| 930 |
* We do not use libraries_load() (and, thus, a '%libraries' parameter) directly |
|
| 931 |
* for displaying library information in the user interface as we do not want |
|
| 932 |
* the library files to be loaded. |
|
| 933 |
* |
|
| 934 |
* @param string $name |
|
| 935 |
* The machine name of a library to return registered information for. |
|
| 936 |
* |
|
| 937 |
* @return array|false |
|
| 938 |
* An associative array containing registered information for the library |
|
| 939 |
* specified by $name, or FALSE if the library $name is not registered. |
|
| 940 |
* |
|
| 941 |
* @see libraries_detect() |
|
| 942 |
* @see libraries_menu() |
|
| 943 |
*/ |
|
| 944 |
function libraries_ui_load($name) {
|
|
| 945 |
return libraries_detect($name); |
|
| 946 |
} |
|
Formats disponibles : Unified diff
Weekly update of contrib modules