theme.inc 58.5 KB
Newer Older
Dries's avatar
   
Dries committed
1
<?php
2
// $Id$
Dries's avatar
   
Dries committed
3

4
/**
Dries's avatar
   
Dries committed
5
 * @file
6
 * The theme system, which controls the output of Drupal.
Dries's avatar
   
Dries committed
7
8
9
10
 *
 * The theme system allows for nearly all output of the Drupal system to be
 * customized by user themes.
 *
Dries's avatar
   
Dries committed
11
 * @see <a href="http://drupal.org/node/253">Theme system</a>
Dries's avatar
   
Dries committed
12
13
 * @see themeable
 */
Dries's avatar
   
Dries committed
14

15
16
17
18
19
20
21
22
23
24
25
26
27
 /**
 * @name Content markers
 * @{
 * Markers used by theme_mark() and node_mark() to designate content.
 * @see theme_mark(), node_mark()
 */
define('MARK_READ',    0);
define('MARK_NEW',     1);
define('MARK_UPDATED', 2);
/**
 * @} End of "Content markers".
 */

Dries's avatar
   
Dries committed
28
/**
Dries's avatar
   
Dries committed
29
 * Initialize the theme system by loading the theme.
Dries's avatar
   
Dries committed
30
 */
Dries's avatar
   
Dries committed
31
function init_theme() {
32
33
34
35
36
37
  global $theme, $user, $custom_theme, $theme_engine, $theme_key;

  // If $theme is already set, assume the others are set, too, and do nothing
  if (isset($theme)) {
    return;
  }
Dries's avatar
   
Dries committed
38

39
  drupal_bootstrap(DRUPAL_BOOTSTRAP_DATABASE);
Dries's avatar
   
Dries committed
40
41
  $themes = list_themes();

42
43
  // Only select the user selected theme if it is available in the
  // list of enabled themes.
44
  $theme = !empty($user->theme) && $themes[$user->theme]->status ? $user->theme : variable_get('theme_default', 'garland');
Dries's avatar
   
Dries committed
45
46

  // Allow modules to override the present theme... only select custom theme
Dries's avatar
   
Dries committed
47
  // if it is available in the list of installed themes.
48
  $theme = $custom_theme && $themes[$custom_theme] ? $custom_theme : $theme;
Dries's avatar
   
Dries committed
49
50
51
52

  // Store the identifier for retrieving theme settings with.
  $theme_key = $theme;

53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
  // Find all our ancestor themes and put them in an array.
  $base_theme = array();
  $ancestor = $theme;
  while ($ancestor && isset($themes[$ancestor]->base_theme)) {
    if (isset($themes[$themes[$ancestor]->base_theme])) {
      $base_theme[] = $new_base_theme = $themes[$themes[$ancestor]->base_theme];
      // stop if this is final ancestor.
      if (!isset($new_base_theme->base_theme)) {
        break;
      }
      $ancestor = $new_base_theme->base_theme;
    }
    // stop if ancestor didn't exist.
    else {
      break;
    }
  }
  _init_theme($themes[$theme], array_reverse($base_theme));
}

/**
 * Initialize the theme system given already loaded information. This
 * function is useful to initialize a theme when no database is present.
 *
 * @param $theme
 *   An object with the following information:
 *     filename
 *       The .info file for this theme. The 'path' to
 *       the theme will be in this file's directory. (Required)
 *     owner
 *       The path to the .theme file or the .engine file to load for
 *       the theme. (Required)
 *     stylesheet
 *       The primary stylesheet for the theme. (Optional)
 *     engine
 *       The name of theme engine to use. (Optional)
 * @param $base_theme
 *    An optional array of objects that represent the 'base theme' if the
 *    theme is meant to be derivative of another theme. It requires
 *    the same information as the $theme object. It should be in
 *    'oldest first' order, meaning the top level of the chain will
 *    be first.
 */
function _init_theme($theme, $base_theme = array()) {
  global $theme_info, $base_theme_info, $theme_engine, $theme_path;
  $theme_info = $theme;
  $base_theme_info = $base_theme;

  $theme_path = dirname($theme->filename);

103
104
105
106
107
  // Add stylesheets used by this theme.
  if (!empty($theme->stylesheets)) {
    foreach ($theme->stylesheets as $media => $stylesheets) {
      foreach ($stylesheets as $stylesheet) {
        drupal_add_css($stylesheet, 'theme', $media);
108
      }
Dries's avatar
   
Dries committed
109
110
    }
  }
111
112
113
114
  // Add scripts used by this theme.
  if (!empty($theme->scripts)) {
    foreach ($theme->scripts as $script) {
      drupal_add_js($script, 'theme');
115
116
117
    }
  }

118
119
120
121
122
123
124
125
  $theme_engine = NULL;

  // Initialize the theme.
  if (isset($theme->engine)) {
    // Include the engine.
    include_once './'. $theme->owner;

    $theme_engine = $theme->engine;
Dries's avatar
   
Dries committed
126
    if (function_exists($theme_engine .'_init')) {
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
      foreach ($base_theme as $base) {
        call_user_func($theme_engine .'_init', $base);
      }
      call_user_func($theme_engine .'_init', $theme);
    }
  }
  else {
    // include non-engine theme files
    foreach ($base_theme as $base) {
      // Include the theme file or the engine.
      if (!empty($base->owner)) {
        include_once './'. $base->owner;
      }
    }
    // and our theme gets one too.
    if (!empty($theme->owner)) {
      include_once './'. $theme->owner;
Dries's avatar
   
Dries committed
144
145
    }
  }
146
  _theme_load_registry($theme, $base_theme, $theme_engine);
Dries's avatar
   
Dries committed
147
148
}

149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
/**
 * Retrieve the stored theme registry. If the theme registry is already
 * in memory it will be returned; otherwise it will attempt to load the
 * registry from cache. If this fails, it will construct the registry and
 * cache it.
 */
function theme_get_registry($registry = NULL) {
  static $theme_registry = NULL;
  if (isset($registry)) {
    $theme_registry = $registry;
  }

  return $theme_registry;
}

/**
 * Store the theme registry in memory.
 */
function _theme_set_registry($registry) {
  // Pass through for setting of static variable.
  return theme_get_registry($registry);
}

/**
 * Get the theme_registry cache from the database; if it doesn't exist, build
 * it.
175
176
177
178
179
180
181
182
 *
 * @param $theme
 *   The loaded $theme object.
 * @param $base_theme
 *   An array of loaded $theme objects representing the ancestor themes in
 *   oldest first order.
 * @param theme_engine
 *   The name of the theme engine.
183
 */
184
185
186
function _theme_load_registry($theme, $base_theme = NULL, $theme_engine = NULL) {
  // Check the theme registry cache; if it exists, use it.
  $cache = cache_get("theme_registry:$theme->name", 'cache');
187
  if (isset($cache->data)) {
188
    $registry = $cache->data;
189
190
  }
  else {
191
192
    // If not, build one and cache it.
    $registry = _theme_build_registry($theme, $base_theme, $theme_engine);
193
194
195
196
197
198
199
200
201
    _theme_save_registry($theme, $registry);
  }
  _theme_set_registry($registry);
}

/**
 * Write the theme_registry cache into the database.
 */
function _theme_save_registry($theme, $registry) {
202
  cache_set("theme_registry:$theme->name", $registry);
203
204
205
206
207
208
209
210
211
212
213
214
}

/**
 * Force the system to rebuild the theme registry; this should be called
 * when modules are added to the system, or when a dynamic system needs
 * to add more theme hooks.
 */
function drupal_rebuild_theme_registry() {
  cache_clear_all('theme_registry', 'cache', TRUE);
}

/**
215
216
217
218
219
220
221
222
 * Process a single invocation of the theme hook. $type will be one
 * of 'module', 'theme_engine' or 'theme' and it tells us some
 * important information.
 *
 * Because $cache is a reference, the cache will be continually
 * expanded upon; new entries will replace old entries in the
 * array_merge, but we are careful to ensure some data is carried
 * forward, such as the arguments a theme hook needs.
223
 */
224
function _theme_process_registry(&$cache, $name, $type, $theme, $path) {
225
226
  $function = $name .'_theme';
  if (function_exists($function)) {
227
    $result = $function($cache, $type, $theme, $path);
228
229
230

    foreach ($result as $hook => $info) {
      $result[$hook]['type'] = $type;
231
      $result[$hook]['theme path'] = $path;
232
233
234
235
236
      // if function and file are left out, default to standard naming
      // conventions.
      if (!isset($info['file']) && !isset($info['function'])) {
        $result[$hook]['function'] = ($type == 'module' ? 'theme_' : $name .'_') . $hook;
      }
237
238
239
      // If a path is set in the info, use what was set. Otherwise use the
      // default path. This is mostly so system.module can declare theme
      // functions on behalf of core .include files.
240
241
242
243
244
245
246
247
248
      if (isset($info['file']) && !isset($info['path'])) {
        $result[$hook]['file'] = $path .'/'. $info['file'];
      }
      // If 'arguments' have been defined previously, carry them forward.
      // This should happen if a theme overrides a Drupal defined theme
      // function, for example.
      if (!isset($info['arguments']) && isset($cache[$hook])) {
        $result[$hook]['arguments'] = $cache[$hook]['arguments'];
      }
249
250
251
252
      // Check for default _preprocess_ functions. Ensure arrayness.
      if (!isset($info['preprocess functions']) || !is_array($info['preprocess functions'])) {
        $info['preprocess functions'] = array();
        $prefix = ($type == 'module' ? 'template' : $name);
253
        // theme engines get an extra set that come before the normally named preprocess.
254
255
256
257
258
259
260
261
        if ($type == 'theme_engine') {
          if (function_exists($prefix .'_engine_preprocess')) {
            $info['preprocess functions'][] = $prefix .'_engine_preprocess';
          }
          if (function_exists($prefix .'_engine_preprocess_'. $hook)) {
            $info['preprocess functions'][] = $prefix .'_engine_preprocess_'. $hook;
          }
        }
262
263
264
265
266
267
268
269
270

        // It would be too much of a performance hit to let every module have
        // a generic preprocess function; themes and theme engines can do that.
        if ($type != 'module' && function_exists($prefix .'_preprocess')) {
          $info['preprocess functions'][] = $prefix .'_preprocess';
        }
        if (function_exists($prefix .'_preprocess_'. $hook)) {
          $info['preprocess functions'][] = $prefix .'_preprocess_'. $hook;
        }
271
272
273
274
275
      }
      if (isset($cache[$hook]['preprocess functions']) && is_array($cache[$hook]['preprocess functions']) && empty($cache[$hook]['override preprocess functions'])) {
        $info['preprocess functions'] = array_merge($cache[$hook]['preprocess functions'], $info['preprocess functions']);
      }
      $result[$hook]['preprocess functions'] = $info['preprocess functions'];
276
277
    }

278
    // Merge the newly created theme hooks into the existing cache.
279
280
281
282
283
284
    $cache = array_merge($cache, $result);
  }
}

/**
 * Rebuild the hook theme_registry cache.
285
286
287
288
289
290
291
292
 *
 * @param $theme
 *   The loaded $theme object.
 * @param $base_theme
 *   An array of loaded $theme objects representing the ancestor themes in
 *   oldest first order.
 * @param theme_engine
 *   The name of the theme engine.
293
 */
294
function _theme_build_registry($theme, $base_theme, $theme_engine) {
295
  $cache = array();
296
297
  // First, process the theme hooks advertised by modules. This will
  // serve as the basic registry.
298
  foreach (module_implements('theme') as $module) {
299
300
301
302
303
304
305
306
307
308
309
    _theme_process_registry($cache, $module, 'module', $module, drupal_get_path('module', $module));
  }

  // Process each base theme.
  foreach ($base_theme as $base) {
    // If the theme uses a theme engine, process its hooks.
    $base_path = dirname($base->filename);
    if ($theme_engine) {
      _theme_process_registry($cache, $theme_engine, 'base_theme_engine', $base->name, $base_path);
    }
    _theme_process_registry($cache, $base->name, 'base_theme', $base->name, $base_path);
310
311
  }

312
  // And then the same thing, but for the theme.
313
  if ($theme_engine) {
314
    _theme_process_registry($cache, $theme_engine, 'theme_engine', $theme->name, dirname($theme->filename));
315
316
  }

317
318
  // Finally, hooks provided by the theme itself.
  _theme_process_registry($cache, $theme->name, 'theme', $theme->name, dirname($theme->filename));
319
320
321
322

  return $cache;
}

Dries's avatar
   
Dries committed
323
/**
Dries's avatar
   
Dries committed
324
325
326
 * Provides a list of currently available themes.
 *
 * @param $refresh
327
328
329
 *   Whether to reload the list of themes from the database.
 * @return
 *   An array of the currently available themes.
Dries's avatar
   
Dries committed
330
 */
331
function list_themes($refresh = FALSE) {
332
  static $list = array();
Dries's avatar
   
Dries committed
333
334

  if ($refresh) {
335
    $list = array();
Dries's avatar
   
Dries committed
336
337
  }

338
  if (empty($list)) {
Dries's avatar
   
Dries committed
339
    $list = array();
340
    $result = db_query("SELECT * FROM {system} WHERE type = 'theme'");
Dries's avatar
   
Dries committed
341
342
    while ($theme = db_fetch_object($result)) {
      if (file_exists($theme->filename)) {
343
        $theme->info = unserialize($theme->info);
344
345
346
347
348
349
        foreach ($theme->info['stylesheets'] as $media => $stylesheets) {
          foreach ($stylesheets as $stylesheet => $path) {
            if (file_exists($path)) {
              $theme->stylesheets[$media][$stylesheet] = $path;
            }
          }
350
        }
351
352
353
354
        foreach ($theme->info['scripts'] as $script => $path) {
          if (file_exists($path)) {
            $theme->scripts[$script] = $path;
          }
355
        }
356
357
358
359
360
361
        if (isset($theme->info['engine'])) {
          $theme->engine = $theme->info['engine'];
        }
        if (isset($theme->info['base theme'])) {
          $theme->base_theme = $theme->info['base theme'];
        }
Dries's avatar
   
Dries committed
362
363
364
365
366
367
368
369
        $list[$theme->name] = $theme;
      }
    }
  }

  return $list;
}

Dries's avatar
   
Dries committed
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
/**
 * Provides a list of currently available theme engines
 *
 * @param $refresh
 *   Whether to reload the list of themes from the database.
 * @return
 *   An array of the currently available theme engines.
 */
function list_theme_engines($refresh = FALSE) {
  static $list;

  if ($refresh) {
    unset($list);
  }

  if (!$list) {
    $list = array();
Dries's avatar
   
Dries committed
387
    $result = db_query("SELECT * FROM {system} WHERE type = 'theme_engine' AND status = '1' ORDER BY name");
Dries's avatar
   
Dries committed
388
389
    while ($engine = db_fetch_object($result)) {
      if (file_exists($engine->filename)) {
390
        $engine->info = unserialize($engine->info);
Dries's avatar
   
Dries committed
391
392
393
394
395
396
397
398
        $list[$engine->name] = $engine;
      }
    }
  }

  return $list;
}

Dries's avatar
   
Dries committed
399
/**
400
401
402
403
404
405
406
407
408
 * Generate the themed output.
 *
 * All requests for theme hooks must go through this function. It examines
 * the request and routes it to the appropriate theme function. The theme
 * registry is checked to determine which implementation to use, which may
 * be a function or a template.
 *
 * If the implementation is a function, it is executed and its return value
 * passed along.
Dries's avatar
   
Dries committed
409
 *
410
411
412
413
 * If the implementation is a template, the arguments are converted to a
 * $variables array. This array is then modified by the theme engine (if
 * applicable) and the theme. The following functions may be used to modify
 * the $variables array:
414
 *
415
 * ENGINE_engine_preprocess(&$variables)
416
 *   This function should only be implemented by theme engines and exists
417
418
 *   so that the theme engine can set necessary variables. It is commonly
 *   used to set global variables such as $directory and $is_front_page.
419
 *
420
 * ENGINE_engine_preprocess_HOOK(&$variables)
421
 *   This is the same as the previous function, but is called only per hook.
422
 *
423
 * ENGINE_preprocess_HOOK(&$variables)
424
 *
425
 * ENGINE_preprocess(&$variables)
426
427
428
429
 *   This is meant to be used by themes that utilize a theme engine; as it is
 *   good practice for these themes to use the theme engine's name for
 *   their functions so that they may share code. In PHPTemplate, these
 *   functions will appear in template.php
430
 *
431
 * THEME_preprocess_HOOK(&$variables)
432
 *
433
 * THEME_preprocess(&$variables)
434
435
436
437
 *   These functions are based upon the raw theme; they should primarily be
 *   used by themes that do not use an engine or by themes that need small
 *   changes to what has already been established in the theme engine version
 *   of the function.
438
 *
439
440
441
442
 * template_preprocess(&$variables)
 *   This function will only be called for theme functions registered by
 *   the named module. In general it is preferred to use the following
 *   function if possible, but it may not always be the case.
443
 *
444
445
 * template_preprocess_HOOK(&$variables)
 *   This is the same as the previous function, but is called only per hook.
Dries's avatar
   
Dries committed
446
 *
447
448
449
450
451
452
453
454
 * There are two special variables that these hooks can set:
 *   'template_file' and 'template_files'. These will be merged together
 *   to form a list of 'suggested' alternate template files to use, in
 *   reverse order of priority. template_file will always be a higher
 *   priority than items in template_files. theme() will then look for these
 *   files, one at a time, and use the first one
 *   that exists.
 * @param $hook
455
456
457
458
459
460
 *   The name of the theme function to call. May be an array, in which
 *   case the first hook that actually has an implementation registered
 *   will be used. This can be used to choose 'fallback' theme implementations,
 *   so that if the specific theme hook isn't implemented anywhere, a more
 *   generic one will be used. This can allow themes to create specific theme
 *   implementations for named objects.
461
462
463
464
 * @param ...
 *   Additional arguments to pass along to the theme function.
 * @return
 *   An HTML string that generates the themed output.
Dries's avatar
   
Dries committed
465
 */
Dries's avatar
   
Dries committed
466
function theme() {
467
  $args = func_get_args();
468
  $hook = array_shift($args);
469

470
471
472
473
  static $hooks = NULL;
  if (!isset($hooks)) {
    init_theme();
    $hooks = theme_get_registry();
474
  }
475

476
477
478
479
480
481
482
483
484
  if (is_array($hook)) {
    foreach ($hook as $candidate) {
      if (isset($hooks[$candidate])) {
        break;
      }
    }
    $hook = $candidate;
  }

485
486
  if (!isset($hooks[$hook])) {
    return;
487
488
  }

489
  $info = $hooks[$hook];
490
491
492
493
  global $theme_path;
  $temp = $theme_path;
  // point path_to_theme() to the currently used theme path:
  $theme_path = $hooks[$hook]['theme path'];
Dries's avatar
   
Dries committed
494

495
496
497
498
  if (isset($info['function'])) {
    // The theme call is a function.
    // Include a file if this theme function is held elsewhere.
    if (!empty($info['file'])) {
499
500
501
502
503
      $function_file = $info['file'];
      if (isset($info['path'])) {
        $function_file = $info['path'] .'/'. $function_file;
      }
      include_once($function_file);
504
    }
505
    $output = call_user_func_array($info['function'], $args);
Dries's avatar
   
Dries committed
506
  }
507
508
509
510
511
512
513
514
515
516
517
518
  else {
    // The theme call is a template.
    $variables = array(
      'template_files' => array()
    );
    if (!empty($info['arguments'])) {
      $count = 0;
      foreach ($info['arguments'] as $name => $default) {
        $variables[$name] = isset($args[$count]) ? $args[$count] : $default;
        $count++;
      }
    }
Dries's avatar
   
Dries committed
519

520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
    // default render function and extension.
    $render_function = 'theme_render_template';
    $extension = '.tpl.php';

    // Run through the theme engine variables, if necessary
    global $theme_engine;
    if (isset($theme_engine)) {
      // If theme or theme engine is implementing this, it may have
      // a different extension and a different renderer.
      if ($hooks[$hook]['type'] != 'module') {
        if (function_exists($theme_engine .'_render_template')) {
          $render_function = $theme_engine .'_render_template';
        }
        $extension_function = $theme_engine .'_extension';
        if (function_exists($extension_function)) {
          $extension = $extension_function();
        }
      }
    }

540
541
542
543
544
545
546
547
    if (isset($info['preprocess functions']) && is_array($info['preprocess functions'])) {
      // This construct ensures that we can keep a reference through
      // call_user_func_array.
      $args = array(&$variables, $hook);
      foreach ($info['preprocess functions'] as $preprocess_function) {
        if (function_exists($preprocess_function)) {
          call_user_func_array($preprocess_function, $args);
        }
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
      }
    }

    // Get suggestions for alternate templates out of the variables
    // that were set. This lets us dynamically choose a template
    // from a list. The order is FILO, so this array is ordered from
    // least appropriate first to most appropriate last.
    $suggestions = array();

    if (isset($variables['template_files'])) {
      $suggestions = $variables['template_files'];
    }
    if (isset($variables['template_file'])) {
      $suggestions[] = $variables['template_file'];
    }

    if ($suggestions) {
      $template_file = drupal_discover_template($suggestions, $extension);
    }

    if (empty($template_file)) {
      $template_file = $hooks[$hook]['file'] . $extension;
      if (isset($hooks[$hook]['path'])) {
        $template_file = $hooks[$hook]['path'] .'/'. $template_file;
      }
    }
574
    $output = $render_function($template_file, $variables);
Dries's avatar
   
Dries committed
575
  }
576
577
578
  // restore path_to_theme()
  $theme_path = $temp;
  return $output;
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
}

/**
 * Choose which template file to actually render; these are all
 * suggested templates from the theme.
 */
function drupal_discover_template($suggestions, $extension = '.tpl.php') {
  global $theme_engine;

  // Loop through any suggestions in FIFO order.
  $suggestions = array_reverse($suggestions);
  foreach ($suggestions as $suggestion) {
    if (!empty($suggestion) && file_exists($file = path_to_theme() .'/'. $suggestion . $extension)) {
      return $file;
    }
Dries's avatar
   
Dries committed
594
595
596
597
  }
}

/**
598
 * Return the path to the currently selected theme.
Dries's avatar
   
Dries committed
599
 */
Dries's avatar
   
Dries committed
600
function path_to_theme() {
601
  global $theme_path;
Dries's avatar
   
Dries committed
602

603
  if (!isset($theme_path)) {
604
605
606
    init_theme();
  }

607
  return $theme_path;
608
609
}

610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
/**
 * Find overridden theme functions. Called by themes and/or theme engines to
 * easily discover theme functions.
 *
 * @param $cache
 *   The existing cache of theme hooks to test against.
 * @param $prefixes
 *   An array of prefixes to test, in reverse order of importance.
 *
 * @return $templates
 *   The functions found, suitable for returning from hook_theme;
 */
function drupal_find_theme_functions($cache, $prefixes) {
  $templates = array();
  $functions = get_defined_functions();

  foreach ($cache as $hook => $info) {
    foreach ($prefixes as $prefix) {
      if (!empty($info['pattern'])) {
        $matches = preg_grep('/^'. $prefix .'_'. $info['pattern'] .'/', $functions['user']);
        if ($matches) {
          foreach ($matches as $match) {
            $new_hook = str_replace($prefix . '_', '', $match);
            $templates[$new_hook] = array(
              'function' => $match,
              'arguments' => $info['arguments'],
            );
          }
        }
      }
      if (function_exists($prefix .'_'. $hook)) {
        $templates[$hook] = array(
          'function' => $prefix .'_'. $hook,
        );
      }
    }
  }

  return $templates;
}

/**
 * Find overridden theme templates. Called by themes and/or theme engines to
 * easily discover templates.
 *
 * @param $cache
 *   The existing cache of theme hooks to test against.
 * @param $extension
 *   The extension that these templates will have.
 * @param $path
 *   The path to search.
 */
function drupal_find_theme_templates($cache, $extension, $path) {
  $templates = array();

  // Escape the dots in the extension.
  $regex = str_replace('.', '\.', $extension) . '$';

  // Because drupal_system_listing works the way it does, we check for real
  // templates separately from checking for patterns.
  $files = drupal_system_listing($regex, $path, 'name', 0);
  foreach ($files as $template => $file) {
    // Chop off the extension. We do it this way because $template will
    // have one extension chopped off, but there might be more than one,
    // such as with .tpl.php
    $template = substr($template, 0, strpos($template, '.'));
676
677
678
679
680
    // Transform - in filenames to _ to match function naming scheme
    // for the purposes of searching.
    $hook = strtr($template, '-', '_');
    if (isset($cache[$hook])) {
      $templates[$hook] = array(
681
682
683
684
685
686
687
688
689
690
        'file' => $template,
        'path' => dirname($file->filename),
      );
    }
  }

  $patterns = array_keys($files);

  foreach ($cache as $hook => $info) {
    if (!empty($info['pattern'])) {
691
692
693
694
695
      // Transform _ in pattern to - to match file naming scheme
      // for the purposes of searching.
      $pattern = strtr($info['pattern'], '_', '-');

      $matches = preg_grep('/^'. $pattern .'/', $patterns);
696
697
698
      if ($matches) {
        foreach ($matches as $match) {
          $file = substr($match, 0, strpos($match, '.'));
699
700
          // Put the underscores back in for the hook name and register this pattern.
          $templates[strtr($file, '-', '_')] = array(
701
702
703
704
705
706
707
708
709
710
711
            'file' => $file,
            'path' => dirname($files[$match]->filename),
            'arguments' => $info['arguments'],
          );
        }
      }
    }
  }
  return $templates;
}

Dries's avatar
   
Dries committed
712
713
714
/**
 * Retrieve an associative array containing the settings for a theme.
 *
715
 * The final settings are arrived at by merging the default settings,
Dries's avatar
   
Dries committed
716
717
718
719
720
721
722
723
724
725
726
727
728
 * the site-wide settings, and the settings defined for the specific theme.
 * If no $key was specified, only the site-wide theme defaults are retrieved.
 *
 * The default values for each of settings are also defined in this function.
 * To add new settings, add their default values here, and then add form elements
 * to system_theme_settings() in system.module.
 *
 * @param $key
 *  The template/style value for a given theme.
 *
 * @return
 *   An associative array containing theme settings.
 */
729
function theme_get_settings($key = NULL) {
Dries's avatar
   
Dries committed
730
731
732
733
  $defaults = array(
    'mission'                       =>  '',
    'default_logo'                  =>  1,
    'logo_path'                     =>  '',
734
735
    'default_favicon'               =>  1,
    'favicon_path'                  =>  '',
Dries's avatar
   
Dries committed
736
    'toggle_logo'                   =>  1,
737
    'toggle_favicon'                =>  1,
Dries's avatar
   
Dries committed
738
739
740
741
742
743
744
745
    'toggle_name'                   =>  1,
    'toggle_search'                 =>  1,
    'toggle_slogan'                 =>  0,
    'toggle_mission'                =>  1,
    'toggle_node_user_picture'      =>  0,
    'toggle_comment_user_picture'   =>  0,
  );

746
  if (module_exists('node')) {
747
    foreach (node_get_types() as $type => $name) {
748
      $defaults['toggle_node_info_'. $type] = 1;
749
    }
Dries's avatar
   
Dries committed
750
751
752
753
754
755
756
  }
  $settings = array_merge($defaults, variable_get('theme_settings', array()));

  if ($key) {
    $settings = array_merge($settings, variable_get(str_replace('/', '_', 'theme_'. $key .'_settings'), array()));
  }

757
  // Only offer search box if search.module is enabled.
758
  if (!module_exists('search') || !user_access('search content')) {
759
760
761
    $settings['toggle_search'] = 0;
  }

Dries's avatar
   
Dries committed
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
  return $settings;
}

/**
 * Retrieve a setting for the current theme.
 * This function is designed for use from within themes & engines
 * to determine theme settings made in the admin interface.
 *
 * Caches values for speed (use $refresh = TRUE to refresh cache)
 *
 * @param $setting_name
 *  The name of the setting to be retrieved.
 *
 * @param $refresh
 *  Whether to reload the cache of settings.
 *
 * @return
 *   The value of the requested setting, NULL if the setting does not exist.
 */
781
function theme_get_setting($setting_name, $refresh = FALSE) {
782
  global $theme_key;
Dries's avatar
   
Dries committed
783
784
785
  static $settings;

  if (empty($settings) || $refresh) {
786
    $settings = theme_get_settings($theme_key);
Dries's avatar
   
Dries committed
787
788
789
790
791
792
793
794
795
796
797
798
799
800

    $themes = list_themes();
    $theme_object = $themes[$theme_key];

    if ($settings['mission'] == '') {
      $settings['mission'] = variable_get('site_mission', '');
    }

    if (!$settings['toggle_mission']) {
      $settings['mission'] = '';
    }

    if ($settings['toggle_logo']) {
      if ($settings['default_logo']) {
801
        $settings['logo'] = base_path() . dirname($theme_object->filename) .'/logo.png';
Dries's avatar
   
Dries committed
802
803
      }
      elseif ($settings['logo_path']) {
804
        $settings['logo'] = base_path() . $settings['logo_path'];
Dries's avatar
   
Dries committed
805
806
807
      }
    }

808
809
810
    if ($settings['toggle_favicon']) {
      if ($settings['default_favicon']) {
        if (file_exists($favicon = dirname($theme_object->filename) .'/favicon.ico')) {
811
          $settings['favicon'] = base_path() . $favicon;
812
813
        }
        else {
814
          $settings['favicon'] = base_path() .'misc/favicon.ico';
815
816
817
        }
      }
      elseif ($settings['favicon_path']) {
818
        $settings['favicon'] = base_path() . $settings['favicon_path'];
819
      }
820
821
822
      else {
        $settings['toggle_favicon'] = FALSE;
      }
823
    }
Dries's avatar
   
Dries committed
824
825
826
827
828
  }

  return isset($settings[$setting_name]) ? $settings[$setting_name] : NULL;
}

829
/**
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
 * Render a system default template, which is essentially a PHP template.
 *
 * @param $file
 *   The filename of the template to render.
 * @param $variables
 *   A keyed array of variables that will appear in the output.
 *
 * @return
 *   The output generated by the template.
 */
function theme_render_template($file, $variables) {
  extract($variables, EXTR_SKIP);  // Extract the variables to a local namespace
  ob_start();                      // Start output buffering
  include "./$file";               // Include the file
  $contents = ob_get_contents();   // Get the contents of the buffer
  ob_end_clean();                  // End buffering and discard
  return $contents;                // Return the contents
}

/**
 * @defgroup themeable Default theme implementations
851
 * @{
852
853
854
855
856
857
 * Functions and templates that present output to the user, and can be
 * implemented by themes.
 *
 * Drupal's presentation layer is a pluggable system known as the theme
 * layer. Each theme can take control over most of Drupal's output, and
 * has complete control over the CSS.
858
 *
859
860
861
 * Inside Drupal, the theme layer is utilized by the use of the theme()
 * function, which is passed the name of a component (the theme hook)
 * and several arguments. For example, theme('table', $header, $rows);
862
863
864
865
866
867
868
869
 * Additionally, the theme() function can take an array of theme
 * hooks, which can be used to provide 'fallback' implementations to
 * allow for more specific control of output. For example, the function:
 * theme(array('table__foo', 'table), $header, $rows) would look to see if
 * 'table__foo' is registered anywhere; if it is not, it would 'fall back'
 * to the generic 'table' implementation. This can be used to attach specific
 * theme functions to named objects, allowing the themer more control over
 * specific types of output.
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
 *
 * As of Drupal 6, every theme hook is required to be registered by the
 * module that owns it, so that Drupal can tell what to do with it and
 * to make it simple for themes to identify and override the behavior
 * for these calls.
 *
 * The theme hooks are registered via hook_theme(), which returns an
 * array of arrays with information about the hook. It describes the
 * arguments the function or template will need, and provides
 * defaults for the template in case they are not filled in. If the default
 * implementation is a function, by convention it is named theme_HOOK().
 *
 * Each module should provide a default implementation for themes that
 * it registers. This implementation may be either a function or a template;
 * if it is a function it must be specified via hook_theme(). By convention,
 * default implementations of theme hooks are named theme_HOOK. Default
 * template implementations are stored in the module directory.
 *
 * Drupal's default template renderer is a simple PHP parsing engine that
 * includes the template and stores the output. Drupal's theme engines
 * can provide alternate template engines, such as XTemplate, Smarty and
 * PHPTal. The most common template engine is PHPTemplate (included with
 * Drupal and implemented in phptemplate.engine, which uses Drupal's default
 * template renderer.
 *
 * In order to create theme-specific implementations of these hooks,
 * themes can implement their own version of theme hooks, either as functions
 * or templates. These implementations will be used instead of the default
 * implementation. If using a pure .theme without an engine, the .theme is
 * required to implement its own version of hook_theme() to tell Drupal what
 * it is implementing; themes utilizing an engine will have their well-named
 * theming functions automatically registered for them. While this can vary
 * based upon the theme engine, the standard set by phptemplate is that theme
 * functions should be named either phptemplate_HOOK or THEMENAME_HOOK. For
 * example, for Drupal's default theme (Garland) to implement the 'table' hook,
 * the phptemplate.engine would find phptemplate_table() or garland_table().
 * The ENGINE_HOOK() syntax is preferred, as this can be used by sub-themes
 * (which are themes that share code but use different stylesheets).
908
 *
Dries's avatar
   
Dries committed
909
 * The theme system is described and defined in theme.inc.
910
911
912
 *
 * @see theme()
 * @see hook_theme()
913
 */
914

915
/**
916
917
 * Formats text for emphasized display in a placeholder inside a sentence.
 * Used automatically by t().
918
919
920
921
922
923
924
925
926
 *
 * @param $text
 *   The text to format (plain-text).
 * @return
 *   The formatted text (html).
 */
function theme_placeholder($text) {
  return '<em>'. check_plain($text) .'</em>';
}
Dries's avatar
   
Dries committed
927

928
929
930
/**
 * Generate a themed maintenance page.
 *
Dries's avatar
Dries committed
931
 * Note: this function is not themeable.
932
933
934
 *
 * @param $content
 *   The page content to show.
935
 * @param $show_messages
936
 *   Whether to output status and error messages.
937
 *   FALSE can be useful to postpone the messages to a subsequent page.
938
 */
939
function theme_maintenance_page($content, $show_messages = TRUE) {
940
  // Set required headers.
941
  drupal_set_header('Content-Type: text/html; charset=utf-8');
942
  drupal_set_html_head('<style type="text/css" media="all">@import "'. base_path() .'misc/maintenance.css";</style>');
943
944
  drupal_set_html_head('<style type="text/css" media="all">@import "'. base_path() . drupal_get_path('module', 'system') .'/defaults.css";</style>');
  drupal_set_html_head('<style type="text/css" media="all">@import "'. base_path() . drupal_get_path('module', 'system') .'/system.css";</style>');
945
  drupal_set_html_head('<link rel="shortcut icon" href="'. base_path() .'misc/favicon.ico" type="image/x-icon" />');
946

947
948
949
950
951
952
953
954
955
956
957
958
959
  // Prepare variables.
  $variables = array(
    'head_title' => strip_tags(drupal_get_title()),
    'head' => drupal_get_html_head(),
    'styles' => '',
    'scripts' => drupal_get_js(),
    'sidebar_left' => drupal_get_content('left'),
    'sidebar_right' => drupal_get_content('right'),
    'base_path' => base_path(),
    'path_to_theme' => base_path() .'themes/garland/minnelli',
    'logo' => base_path() .'themes/garland/minnelli/logo.png',
    'site_title' => t('Drupal'),
    'title' => drupal_get_title(),
960
    'messages' => $show_messages ? theme('status_messages') : '',
961
962
    'content' => $content,
  );
963

964
  $output = theme_render_template('misc/maintenance.tpl.php', $variables);
965
966
967
968

  return $output;
}

969
970
971
/**
 * Generate a themed installation page.
 *
Dries's avatar
Dries committed
972
 * Note: this function is not themeable.
973
974
975
976
 *
 * @param $content
 *   The page content to show.
 */
977
978
function theme_install_page($content) {
  drupal_set_header('Content-Type: text/html; charset=utf-8');
979
  drupal_add_css('misc/maintenance.css', 'module', 'all', FALSE);
980
981
  drupal_set_html_head('<link rel="shortcut icon" href="'. base_path() .'misc/favicon.ico" type="image/x-icon" />');

982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
  $variables = array(
    'head_title' => strip_tags(drupal_get_title()),
    'head' => drupal_get_html_head(),
    'styles' => drupal_get_css(),
    'scripts' => drupal_get_js(),
    'sidebar_left' => drupal_get_content('left'),
    'sidebar_right' => drupal_get_content('right'),
    'base_path' => base_path(),
    'path_to_theme' => base_path() .'themes/garland/minnelli',
    'logo' => base_path() .'themes/garland/minnelli/logo.png',
    'site_title' => st('Drupal Installation'),
    'title' => drupal_get_title(),
    'messages' => '',
    'content' => $content,
  );

  // Special handling of error messages
999
1000
  $messages = drupal_set_message();
  if (isset($messages['error'])) {
1001
    $title = count($messages['error']) > 1 ? st('The following errors must be resolved before you can continue the installation process') : st('The following error must be resolved before you can continue the installation process');
1002
1003
    $variables['messages'] .= '<h3>'. $title .':</h3>';
    $variables['messages'] .= theme('status_messages', 'error');
1004
1005
  }

1006
  // Special handling of status messages
1007
  if (isset($messages['status'])) {
1008
    $warnings = count($messages['status']) > 1 ? st('The following installation warnings should be carefully reviewed, but in most cases may be safely ignored') : st('The following installation warning should be carefully reviewed, but in most cases may be safely ignored');
1009
1010
    $variables['messages'] .= '<h4>'. $title .':</h4>';
    $variables['messages'] .= theme('status_messages', 'status');
1011
1012
  }

1013
  return theme_render_template('misc/maintenance.tpl.php', $variables);
1014
}
1015

1016
1017
1018
/**
 * Return a themed list of maintenance tasks to perform.
 *
Dries's avatar
Dries committed
1019
 * Note: this function is not themeable.
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
 */
function theme_task_list($items, $active = NULL) {
  $done = isset($items[$active]) || $active == NULL;
  $output = '<ol class="task-list">';
  foreach ($items as $k => $item) {
    if ($active == $k) {
      $class = 'active';
      $done = false;
    }
    else {
      $class = $done ? 'done' : '';
    }
    $output .= '<li class="'. $class .'">'. $item .'</li>';
  }
  $output .= '</ol>';
1035
1036
1037
  return $output;
}

Dries's avatar
   
Dries committed
1038
/**
1039
 * Return a themed set of status and/or error messages. The messages are grouped
Dries's avatar
   
Dries committed
1040
1041
 * by type.
 *
1042
1043
1044
 * @param $display
 *   (optional) Set to 'status' or 'error' to display only messages of that type.
 *
1045
1046
 * @return
 *   A string containing the messages.
Dries's avatar
   
Dries committed
1047
 */
1048
1049
1050
1051
1052
1053
function theme_status_messages($display = NULL) {
  $output = '';
  foreach (drupal_get_messages($display) as $type => $messages) {
    $output .= "<div class=\"messages $type\">\n";
    if (count($messages) > 1) {
      $output .= " <ul>\n";
1054
      foreach ($messages as $message) {
1055
        $output .= '  <li>'. $message ."</li>\n";
Dries's avatar
   
Dries committed
1056
      }
1057
      $output .= " </ul>\n";
Dries's avatar
   
Dries committed
1058
    }
1059
1060
1061
1062
    else {
      $output .= $messages[0];
    }
    $output .= "</div>\n";
Dries's avatar
   
Dries committed
1063
  }
1064
  return $output;
Dries's avatar
   
Dries committed
1065
1066
}

Dries's avatar
   
Dries committed
1067
/**
1068
1069
1070
 * Return a themed set of links.
 *
 * @param $links
1071
 *   A keyed array of links to be themed.
1072
1073
 * @param $attributes
 *   A keyed array of attributes
1074
 * @return
1075
 *   A string containing an unordered list of links.
Dries's avatar
   
Dries committed
1076
 */
1077
1078
function theme_links($links, $attributes = array('class' => 'links')) {
  $output = '';
1079

1080
  if (count($links) > 0) {
1081
1082
1083
1084
1085
    $output = '<ul'. drupal_attributes($attributes) .'>';

    $num_links = count($links);
    $i = 1;

1086
    foreach ($links as $key => $link) {
1087
1088
1089
      $class = '';

      // Automatically add a class to each link and also to each LI
1090
      if (isset($link['attributes']) && isset($link['attributes']['class'])) {
1091
        $link['attributes']['class'] .= ' '. $key;
1092
        $class = $key;
1093
1094
      }
      else {
1095
1096
        $link['attributes']['class'] = $key;
        $class = $key;
1097
1098
      }

1099
1100
1101
1102
1103
1104
1105
1106
      // Add first and last classes to the list of links to help out themers.
      $extra_class = '';
      if ($i == 1) {
        $extra_class .= 'first ';
      }
      if ($i == $num_links) {
        $extra_class .= 'last ';
      }
1107
1108
      $output .= '<li class="'. $extra_class . $class .'">';

1109
      if (isset($link['href'])) {
1110
1111
        // Pass in $link as $options, they share the same keys.
        $output .= l($link['title'], $link['href'], $link);
1112
      }
1113
      else if (!empty($link['title'])) {
1114
1115
        // Some links are actually not links, but we wrap these in <span> for adding title and class attributes
        if (empty($link['html'])) {
1116
1117
1118
          $link['title'] = check_plain($link['title']);
        }
        $output .= '<span'. drupal_attributes($link['attributes']) .'>'. $link['title'] .'</span>';
1119
      }
1120
1121

      $i++;
1122
      $output .= "</li>\n";
1123
    }
1124
1125

    $output .= '</ul>';
1126
  }
1127

1128
  return $output;
Dries's avatar
   
Dries committed
1129
}
Dries's avatar
   
Dries committed
1130

Dries's avatar
   
Dries committed
1131
/**
1132
 * Return a themed image.
Dries's avatar
   
Dries committed
1133
 *
Dries's avatar
   
Dries committed
1134
 * @param $path
1135
 *   Either the path of the image file (relative to base_path()) or a full URL.
Dries's avatar
   
Dries committed
1136
1137
1138
1139
 * @param $alt
 *   The alternative text for text-based browsers.
 * @param $title
 *   The title text is displayed when the image is hovered in some popular browsers.
1140
1141
 * @param $attributes
 *   Associative array of attributes to be placed in the img tag.
Steven Wittens's avatar
Steven Wittens committed
1142
 * @param $getsize
1143
 *   If set to TRUE, the image's dimension are fetched and added as width/height attributes.
1144
 * @return
Dries's avatar
   
Dries committed
1145
 *   A string containing the image tag.
Dries's avatar
   
Dries committed
1146
 */
1147
function theme_image($path, $alt = '', $title = '', $attributes = NULL, $getsize = TRUE) {
1148
  if (!$getsize || (is_file($path) && (list($width, $height, $type, $image_attributes) = @getimagesize($path)))) {
1149
    $attributes = drupal_attributes($attributes);
1150
    $url = (url($path) == $path) ? $path : (base_path() . $path);
1151
    return '<img src="'. check_url($url) .'" alt="'. check_plain($alt) .'" title="'. check_plain($title) .'" '. (isset($image_attributes) ? $image_attributes : '') . $attributes .' />';
Dries's avatar
   
Dries committed
1152
  }
Dries's avatar
   
Dries committed
1153
}
Dries's avatar
   
Dries committed
1154

Dries's avatar
   
Dries committed
1155
/**
1156
 * Return a themed breadcrumb trail.
Dries's avatar
   
Dries committed
1157
 *
1158
1159
1160
 * @param $breadcrumb
 *   An array containing the breadcrumb links.
 * @return a string containing the breadcrumb output.
Dries's avatar
   
Dries committed
1161
 */
Dries's avatar
   
Dries committed
1162
function theme_breadcrumb($breadcrumb) {
1163
1164
1165
  if (!empty($breadcrumb)) {
    return '<div class="breadcrumb">'. implode(' » ', $breadcrumb) .'</div>';
  }
Dries's avatar
   
Dries committed
1166
}
Dries's avatar
   
Dries committed
1167

1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
/**
 * Return a themed help message.
 *
 * @return a string containing the helptext for the current page.
 */
function theme_help() {
  if ($help = menu_get_active_help()) {
    return '<div class="help">'. $help .'</div>';
  }
}

Dries's avatar
   
Dries committed
1179
/**
1180
 * Return a themed submenu, typically displayed under the tabs.
Dries's avatar
   
Dries committed
1181
 *
1182
1183
 * @param $links
 *   An array of links.
Dries's avatar
   
Dries committed
1184
1185
 */
function theme_submenu($links) {
1186
  return '<div class="submenu">'. implode(' | ', $links) .'</div>';
Dries's avatar
   
Dries committed
1187
1188
}

Dries's avatar
   
Dries committed
1189
/**
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
 * Return a themed table.
 *
 * @param $header
 *   An array containing the table headers. Each element of the array can be
 *   either a localized string or an associative array with the following keys:
 *   - "data": The localized title of the table column.
 *   - "field": The database field represented in the table column (required if
 *     user is to be able to sort on this column).
 *   - "sort": A default sort order for this column ("asc" or "desc").
 *   - Any HTML attributes, such as "colspan", to apply to the column header cell.
 * @param $rows
1201
1202
1203
1204
1205
1206
 *   An array of table rows. Every row is an array of cells, or an associative
 *   array with the following keys:
 *   - "data": an array of cells
 *   - Any HTML attributes, such as "class", to apply to the table row.
 *
 *   Each cell can be either a string or an associative array with the following keys:
1207
 *   - "data": The string to display in the table cell.
1208
 *   - "header": Indicates this cell is a header.
1209
 *   - Any HTML attributes, such as "colspan", to apply to the table cell.
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
 *
 *   Here's an example for $rows:
 *   @verbatim
 *   $rows = array(
 *     // Simple row
 *     array(
 *       'Cell 1', 'Cell 2', 'Cell 3'
 *     ),
 *     // Row with attributes on the row and some of its cells.
 *     array(
 *       'data' => array('Cell 1', array('data' => 'Cell 2', 'colspan' => 2)), 'class' => 'funky'
 *     )
 *   );
 *   @endverbatim
 *
1225
1226
 * @param $attributes
 *   An array of HTML attributes to apply to the table tag.
1227
1228
 * @param $caption
 *   A localized string to use for the <caption> tag.
1229
1230
 * @return
 *   An HTML string representing the table.
Dries's avatar
   
Dries committed
1231
 */
Dries's avatar
Dries committed
1232
function theme_table($header, $rows, $attributes = array(), $caption = NULL) {
Dries's avatar
   
Dries committed
1233
  $output = '<table'. drupal_attributes($attributes) .">\n";
Dries's avatar
   
Dries committed
1234

1235
1236
1237
1238
  if (isset($caption)) {
    $output .= '<caption>'. $caption ."</caption>\n";
  }

1239
  // Format the table header:
1240
  if (count($header)) {
1241
1242
1243
    // Include JS for sticky headers.
    drupal_add_js('misc/tableheader.js');

Dries's avatar
Dries committed
1244
    $ts = tablesort_init($header);
1245
    $output .= ' <thead><tr>';
Dries's avatar
   
Dries committed
1246
    foreach ($header as $cell) {
1247
      $cell = tablesort_header($cell, $header, $ts);
1248
      $output .= _theme_table_cell($cell, TRUE);
Dries's avatar
   
Dries committed
1249
    }
1250
    $output .= " </tr></thead>\n";
Dries's avatar
   
Dries committed
1251
  }
1252
1253
1254
  else {
    $ts = array();
  }
Dries's avatar