source: trunk/include/template.class.php @ 12954

Last change on this file since 12954 was 12954, checked in by rvelices, 12 years ago

feature 2548 multisize

  • added define_derivative template functiion for themes and plugins
  • code cleanup, new events ...
  • Property svn:eol-style set to LF
File size: 41.3 KB
Line 
1<?php
2// +-----------------------------------------------------------------------+
3// | Piwigo - a PHP based photo gallery                                    |
4// +-----------------------------------------------------------------------+
5// | Copyright(C) 2008-2012 Piwigo Team                  http://piwigo.org |
6// | Copyright(C) 2003-2008 PhpWebGallery Team    http://phpwebgallery.net |
7// | Copyright(C) 2002-2003 Pierrick LE GALL   http://le-gall.net/pierrick |
8// +-----------------------------------------------------------------------+
9// | This program is free software; you can redistribute it and/or modify  |
10// | it under the terms of the GNU General Public License as published by  |
11// | the Free Software Foundation                                          |
12// |                                                                       |
13// | This program is distributed in the hope that it will be useful, but   |
14// | WITHOUT ANY WARRANTY; without even the implied warranty of            |
15// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU      |
16// | General Public License for more details.                              |
17// |                                                                       |
18// | You should have received a copy of the GNU General Public License     |
19// | along with this program; if not, write to the Free Software           |
20// | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
21// | USA.                                                                  |
22// +-----------------------------------------------------------------------+
23
24
25class Template {
26
27  var $smarty;
28
29  var $output = '';
30
31  // Hash of filenames for each template handle.
32  var $files = array();
33
34  // Template extents filenames for each template handle.
35  var $extents = array();
36
37  // Templates prefilter from external sources (plugins)
38  var $external_filters = array();
39
40  // used by html_head smarty block to add content before </head>
41  var $html_head_elements = array();
42  private $html_style = '';
43
44  const COMBINED_SCRIPTS_TAG = '<!-- COMBINED_SCRIPTS -->';
45  var $scriptLoader;
46
47  const COMBINED_CSS_TAG = '<!-- COMBINED_CSS -->';
48  var $css_by_priority = array();
49
50  function Template($root = ".", $theme= "", $path = "template")
51  {
52    global $conf, $lang_info;
53
54    $this->scriptLoader = new ScriptLoader;
55    $this->smarty = new Smarty;
56    $this->smarty->debugging = $conf['debug_template'];
57    $this->smarty->compile_check = $conf['template_compile_check'];
58    $this->smarty->force_compile = $conf['template_force_compile'];
59
60    if (!isset($conf['data_dir_checked']))
61    {
62      $dir = PHPWG_ROOT_PATH.$conf['data_location'];
63      mkgetdir($dir, MKGETDIR_DEFAULT&~MKGETDIR_DIE_ON_ERROR);
64      if (!is_writable($dir))
65      {
66        load_language('admin.lang');
67        fatal_error(
68          sprintf(
69            l10n('Give write access (chmod 777) to "%s" directory at the root of your Piwigo installation'),
70            $conf['data_location']
71            ),
72          l10n('an error happened'),
73          false // show trace
74          );
75      }
76      if (function_exists('pwg_query')) {
77        conf_update_param('data_dir_checked', 1);
78      }
79    }
80
81    if (!isset($conf['combined_dir_checked']))
82    {
83      $dir = PHPWG_ROOT_PATH.PWG_COMBINED_DIR;
84      mkgetdir($dir, MKGETDIR_DEFAULT&~MKGETDIR_DIE_ON_ERROR);
85      if (!is_writable($dir))
86      {
87        load_language('admin.lang');
88        fatal_error(
89          sprintf(
90            l10n('Give write access (chmod 777) to "%s" directory at the root of your Piwigo installation'),
91            PWG_COMBINED_DIR
92            ),
93          l10n('an error happened'),
94          false // show trace
95          );
96      }
97      if (function_exists('pwg_query')) {
98        conf_update_param('combined_dir_checked', 1);
99      }
100    }
101
102
103    $compile_dir = PHPWG_ROOT_PATH.$conf['data_location'].'templates_c';
104    mkgetdir( $compile_dir );
105
106    $this->smarty->compile_dir = $compile_dir;
107
108    $this->smarty->assign_by_ref( 'pwg', new PwgTemplateAdapter() );
109    $this->smarty->register_modifier( 'translate', array('Template', 'mod_translate') );
110    $this->smarty->register_modifier( 'explode', array('Template', 'mod_explode') );
111    $this->smarty->register_modifier( 'get_extent', array(&$this, 'get_extent') );
112    $this->smarty->register_block('html_head', array(&$this, 'block_html_head') );
113    $this->smarty->register_block('html_style', array(&$this, 'block_html_style') );
114    $this->smarty->register_function('combine_script', array(&$this, 'func_combine_script') );
115    $this->smarty->register_function('get_combined_scripts', array(&$this, 'func_get_combined_scripts') );
116    $this->smarty->register_function('combine_css', array(&$this, 'func_combine_css') );
117    $this->smarty->register_function('define_derivative', array(&$this, 'func_define_derivative') );
118    $this->smarty->register_compiler_function('get_combined_css', array(&$this, 'func_get_combined_css') );
119    $this->smarty->register_block('footer_script', array(&$this, 'block_footer_script') );
120    $this->smarty->register_prefilter( array('Template', 'prefilter_white_space') );
121    if ( $conf['compiled_template_cache_language'] )
122    {
123      $this->smarty->register_prefilter( array('Template', 'prefilter_language') );
124    }
125
126    $this->smarty->template_dir = array();
127    if ( !empty($theme) )
128    {
129      $this->set_theme($root, $theme, $path);
130      $this->set_prefilter( 'header', array('Template', 'prefilter_local_css') );
131    }
132    else
133      $this->set_template_dir($root);
134
135    $this->smarty->assign('lang_info', $lang_info);
136
137    if (!defined('IN_ADMIN') and isset($conf['extents_for_templates']))
138    {
139      $tpl_extents = unserialize($conf['extents_for_templates']);
140      $this->set_extents($tpl_extents, './template-extension/', true, $theme);
141    }
142  }
143
144  /**
145   * Load theme's parameters.
146   */
147  function set_theme($root, $theme, $path, $load_css=true, $load_local_head=true)
148  {
149    $this->set_template_dir($root.'/'.$theme.'/'.$path);
150
151    $themeconf = $this->load_themeconf($root.'/'.$theme);
152
153    if (isset($themeconf['parent']) and $themeconf['parent'] != $theme)
154    {
155      $this->set_theme(
156        $root,
157        $themeconf['parent'],
158        $path,
159        isset($themeconf['load_parent_css']) ? $themeconf['load_parent_css'] : $load_css,
160        isset($themeconf['load_parent_local_head']) ? $themeconf['load_parent_local_head'] : $load_local_head
161      );
162    }
163
164    $tpl_var = array(
165      'id' => $theme,
166      'load_css' => $load_css,
167    );
168    if (!empty($themeconf['local_head']) and $load_local_head)
169    {
170      $tpl_var['local_head'] = realpath($root.'/'.$theme.'/'.$themeconf['local_head'] );
171    }
172    $themeconf['id'] = $theme;
173    $this->smarty->append('themes', $tpl_var);
174    $this->smarty->append('themeconf', $themeconf, true);
175  }
176
177  /**
178   * Add template directory for this Template object.
179   * Set compile id if not exists.
180   */
181  function set_template_dir($dir)
182  {
183    $this->smarty->template_dir[] = $dir;
184
185    if (!isset($this->smarty->compile_id))
186    {
187      $real_dir = realpath($dir);
188      $compile_id = crc32( $real_dir===false ? $dir : $real_dir);
189      $this->smarty->compile_id = base_convert($compile_id, 10, 36 );
190    }
191  }
192
193  /**
194   * Gets the template root directory for this Template object.
195   */
196  function get_template_dir()
197  {
198    return $this->smarty->template_dir;
199  }
200
201  /**
202   * Deletes all compiled templates.
203   */
204  function delete_compiled_templates()
205  {
206      $save_compile_id = $this->smarty->compile_id;
207      $this->smarty->compile_id = null;
208      $this->smarty->clear_compiled_tpl();
209      $this->smarty->compile_id = $save_compile_id;
210      file_put_contents($this->smarty->compile_dir.'/index.htm', 'Not allowed!');
211  }
212
213  function get_themeconf($val)
214  {
215    $tc = $this->smarty->get_template_vars('themeconf');
216    return isset($tc[$val]) ? $tc[$val] : '';
217  }
218
219  /**
220   * Sets the template filename for handle.
221   */
222  function set_filename($handle, $filename)
223  {
224    return $this->set_filenames( array($handle=>$filename) );
225  }
226
227  /**
228   * Sets the template filenames for handles. $filename_array should be a
229   * hash of handle => filename pairs.
230   */
231  function set_filenames($filename_array)
232  {
233    if (!is_array($filename_array))
234    {
235      return false;
236    }
237    reset($filename_array);
238    while(list($handle, $filename) = each($filename_array))
239    {
240      if (is_null($filename))
241      {
242        unset($this->files[$handle]);
243      }
244      else
245      {
246        $this->files[$handle] = $this->get_extent($filename, $handle);
247      }
248    }
249    return true;
250  }
251
252  /**
253   * Sets template extention filename for handles.
254   */
255  function set_extent($filename, $param, $dir='', $overwrite=true, $theme='N/A')
256  {
257    return $this->set_extents(array($filename => $param), $dir, $overwrite);
258  }
259
260  /**
261   * Sets template extentions filenames for handles.
262   * $filename_array should be an hash of filename => array( handle, param) or filename => handle
263   */
264  function set_extents($filename_array, $dir='', $overwrite=true, $theme='N/A')
265  {
266    if (!is_array($filename_array))
267    {
268      return false;
269    }
270    foreach ($filename_array as $filename => $value)
271    {
272      if (is_array($value))
273      {
274        $handle = $value[0];
275        $param = $value[1];
276        $thm = $value[2];
277      }
278      elseif (is_string($value))
279      {
280        $handle = $value;
281        $param = 'N/A';
282        $thm = 'N/A';
283      }
284      else
285      {
286        return false;
287      }
288
289      if ((stripos(implode('',array_keys($_GET)), '/'.$param) !== false or $param == 'N/A')
290        and ($thm == $theme or $thm == 'N/A')
291        and (!isset($this->extents[$handle]) or $overwrite)
292        and file_exists($dir . $filename))
293      {
294        $this->extents[$handle] = realpath($dir . $filename);
295      }
296    }
297    return true;
298  }
299
300  /** return template extension if exists  */
301  function get_extent($filename='', $handle='')
302  {
303    if (isset($this->extents[$handle]))
304    {
305      $filename = $this->extents[$handle];
306    }
307    return $filename;
308  }
309
310  /** see smarty assign http://www.smarty.net/manual/en/api.assign.php */
311  function assign($tpl_var, $value = null)
312  {
313    $this->smarty->assign( $tpl_var, $value );
314  }
315
316  /**
317   * Inserts the uncompiled code for $handle as the value of $varname in the
318   * root-level. This can be used to effectively include a template in the
319   * middle of another template.
320   * This is equivalent to assign($varname, $this->parse($handle, true))
321   */
322  function assign_var_from_handle($varname, $handle)
323  {
324    $this->assign($varname, $this->parse($handle, true));
325    return true;
326  }
327
328  /** see smarty append http://www.smarty.net/manual/en/api.append.php */
329  function append($tpl_var, $value=null, $merge=false)
330  {
331    $this->smarty->append( $tpl_var, $value, $merge );
332  }
333
334  /**
335   * Root-level variable concatenation. Appends a  string to an existing
336   * variable assignment with the same name.
337   */
338  function concat($tpl_var, $value)
339  {
340    $old_val = & $this->smarty->get_template_vars($tpl_var);
341    if ( isset($old_val) )
342    {
343      $old_val .= $value;
344    }
345    else
346    {
347      $this->assign($tpl_var, $value);
348    }
349  }
350
351  /** see smarty append http://www.smarty.net/manual/en/api.clear_assign.php */
352  function clear_assign($tpl_var)
353  {
354    $this->smarty->clear_assign( $tpl_var );
355  }
356
357  /** see smarty get_template_vars http://www.smarty.net/manual/en/api.get_template_vars.php */
358  function &get_template_vars($name=null)
359  {
360    return $this->smarty->get_template_vars( $name );
361  }
362
363
364  /**
365   * Load the file for the handle, eventually compile the file and run the compiled
366   * code. This will add the output to the results or return the result if $return
367   * is true.
368   */
369  function parse($handle, $return=false)
370  {
371    if ( !isset($this->files[$handle]) )
372    {
373      fatal_error("Template->parse(): Couldn't load template file for handle $handle");
374    }
375
376    $this->smarty->assign( 'ROOT_URL', get_root_url() );
377
378    $save_compile_id = $this->smarty->compile_id;
379    $this->load_external_filters($handle);
380
381    global $conf, $lang_info;
382    if ( $conf['compiled_template_cache_language'] and isset($lang_info['code']) )
383    {
384      $this->smarty->compile_id .= '.'.$lang_info['code'];
385    }
386
387    $v = $this->smarty->fetch($this->files[$handle], null, null, false);
388
389    $this->smarty->compile_id = $save_compile_id;
390    $this->unload_external_filters($handle);
391
392    if ($return)
393    {
394      return $v;
395    }
396    $this->output .= $v;
397  }
398
399  /**
400   * Load the file for the handle, eventually compile the file and run the compiled
401   * code. This will print out the results of executing the template.
402   */
403  function pparse($handle)
404  {
405    $this->parse($handle, false);
406    $this->flush();
407  }
408
409  function flush()
410  {
411    if (!$this->scriptLoader->did_head())
412    {
413      $pos = strpos( $this->output, self::COMBINED_SCRIPTS_TAG );
414      if ($pos !== false)
415      {
416          $scripts = $this->scriptLoader->get_head_scripts();
417          $content = array();
418          foreach ($scripts as $script)
419          {
420              $content[]=
421                  '<script type="text/javascript" src="'
422                  . self::make_script_src($script)
423                  .'"></script>';
424          }
425
426          $this->output = substr_replace( $this->output, "\n".implode( "\n", $content ), $pos, strlen(self::COMBINED_SCRIPTS_TAG) );
427      } //else maybe error or warning ?
428    }
429
430    if(!empty($this->css_by_priority))
431    {
432      ksort($this->css_by_priority);
433
434      global $conf;
435      $css = array();
436      if ($conf['template_combine_files'])
437      {
438        $combiner = new FileCombiner('css');
439        foreach ($this->css_by_priority as $files)
440        {
441          foreach ($files as $file_ver)
442            $combiner->add( $file_ver[0], $file_ver[1] );
443        }
444        if ( $combiner->combine( $out_file, $out_version) )
445          $css[] = array($out_file, $out_version);
446      }
447      else
448      {
449        foreach ($this->css_by_priority as $files)
450          $css = array_merge($css, $files);
451      }
452
453      $content = array();
454      foreach( $css as $file_ver )
455      {
456        $href = get_root_url() . $file_ver[0];
457        if ($file_ver[1] !== false)
458          $href .= '?v' . ($file_ver[1] ? $file_ver[1] : PHPWG_VERSION);
459        // trigger the event for eventual use of a cdn
460        $href = trigger_event('combined_css', $href, $file_ver[0], $file_ver[1]);
461        $content[] = '<link rel="stylesheet" type="text/css" href="'.$href.'">';
462      }
463      $this->output = str_replace(self::COMBINED_CSS_TAG,
464          implode( "\n", $content ),
465          $this->output );
466                        $this->css_by_priority = array();
467    }
468
469    if ( count($this->html_head_elements) || strlen($this->html_style) )
470    {
471      $search = "\n</head>";
472      $pos = strpos( $this->output, $search );
473      if ($pos !== false)
474      {
475        $rep = "\n".implode( "\n", $this->html_head_elements );
476        if (strlen($this->html_style))
477        {
478          $rep='<style type="text/css">'.$this->html_style.'</style>';
479        }
480        $this->output = substr_replace( $this->output, $rep, $pos, 0 );
481      } //else maybe error or warning ?
482      $this->html_head_elements = array();
483      $this->html_style = '';
484    }
485
486    echo $this->output;
487    $this->output='';
488  }
489
490  /** flushes the output */
491  function p()
492  {
493    $this->flush();
494
495    if ($this->smarty->debugging)
496    {
497      global $t2;
498      $this->smarty->assign(
499        array(
500        'AAAA_DEBUG_TOTAL_TIME__' => get_elapsed_time($t2, get_moment())
501        )
502        );
503      require_once(SMARTY_CORE_DIR . 'core.display_debug_console.php');
504      echo smarty_core_display_debug_console(null, $this->smarty);
505    }
506  }
507
508  /**
509   * translate variable modifier - translates a text to the currently loaded
510   * language
511   */
512  static function mod_translate($text)
513  {
514    return l10n($text);
515  }
516
517  /**
518   * explode variable modifier - similar to php explode
519   * 'Yes;No'|@explode:';' -> array('Yes', 'No')
520   */
521  static function mod_explode($text, $delimiter=',')
522  {
523    return explode($delimiter, $text);
524  }
525
526  /**
527   * This smarty "html_head" block allows to add content just before
528   * </head> element in the output after the head has been parsed. This is
529   * handy in order to respect strict standards when <style> and <link>
530   * html elements must appear in the <head> element
531   */
532  function block_html_head($params, $content, &$smarty, &$repeat)
533  {
534    $content = trim($content);
535    if ( !empty($content) )
536    { // second call
537      $this->html_head_elements[] = $content;
538    }
539  }
540
541  function block_html_style($params, $content, &$smarty, &$repeat)
542  {
543    $content = trim($content);
544    if ( !empty($content) )
545    { // second call
546      $this->html_style .= $content;
547    }
548  }
549
550  function func_define_derivative($params, &$smarty)
551  {
552    !empty($params['name']) or fatal_error('define_derviative missing name');
553    if (isset($params['type']))
554    {
555      $derivative = ImageStdParams::get_by_type($params['type']);
556      $smarty->assign( $params['name'], $derivative);
557      return;
558    }
559    !empty($params['width']) or fatal_error('define_derviative missing width');
560    !empty($params['height']) or fatal_error('define_derviative missing height');
561
562    $derivative = new DerivativeParams( SizingParams::classic( intval($params['width']), intval($params['height'])) );
563    if (isset($params['crop']))
564    {
565      if (is_bool($params['crop']))
566      {
567        $derivative->sizing->max_crop = $params['crop'] ? 1:0;
568      }
569      else
570      {
571        $derivative->sizing->max_crop = round($params['crop']/100, 2);
572      }
573
574      if ($derivative->sizing->max_crop)
575      {
576        $minw = empty($params['min_width']) ? $derivative->max_width() : intval($params['min_width']);
577        $minw <= $derivative->max_width() or fatal_error('define_derviative invalid min_width');
578        $minh = empty($params['min_height']) ? $derivative->max_height() : intval($params['min_height']);
579        $minh <= $derivative->max_height() or fatal_error('define_derviative invalid min_height');
580
581        $derivative->sizing->min_size = array($minw, $minh);
582      }
583    }
584
585    ImageStdParams::apply_global($derivative);
586    $smarty->assign( $params['name'], $derivative);
587  }
588
589   /**
590    * combine_script smarty function allows inclusion of a javascript file in the current page.
591    * The engine will combine several js files into a single one in order to reduce the number of
592    * required http requests.
593    * param id - required
594    * param path - required - the path to js file RELATIVE to piwigo root dir
595    * param load - optional - header|footer|async, default header
596    * param require - optional - comma separated list of script ids required to be loaded and executed
597        before this one
598    * param version - optional - plugins could use this and change it in order to force a
599        browser refresh
600    */
601  function func_combine_script($params, &$smarty)
602  {
603    if (!isset($params['id']))
604    {
605      $smarty->trigger_error("combine_script: missing 'id' parameter", E_USER_ERROR);
606    }
607    $load = 0;
608    if (isset($params['load']))
609    {
610      switch ($params['load'])
611      {
612        case 'header': break;
613        case 'footer': $load=1; break;
614        case 'async': $load=2; break;
615        default: $smarty->trigger_error("combine_script: invalid 'load' parameter", E_USER_ERROR);
616      }
617    }
618    $this->scriptLoader->add( $params['id'], $load,
619      empty($params['require']) ? array() : explode( ',', $params['require'] ),
620      @$params['path'],
621      isset($params['version']) ? $params['version'] : 0 );
622  }
623
624
625  function func_get_combined_scripts($params, &$smarty)
626  {
627    if (!isset($params['load']))
628    {
629      $smarty->trigger_error("get_combined_scripts: missing 'load' parameter", E_USER_ERROR);
630    }
631    $load = $params['load']=='header' ? 0 : 1;
632    $content = array();
633
634    if ($load==0)
635    {
636      return self::COMBINED_SCRIPTS_TAG;
637    }
638    else
639    {
640      $scripts = $this->scriptLoader->get_footer_scripts();
641      foreach ($scripts[0] as $script)
642      {
643        $content[]=
644          '<script type="text/javascript" src="'
645          . self::make_script_src($script)
646          .'"></script>';
647      }
648      if (count($this->scriptLoader->inline_scripts))
649      {
650        $content[]= '<script type="text/javascript">//<![CDATA[
651';
652        $content = array_merge($content, $this->scriptLoader->inline_scripts);
653        $content[]= '//]]></script>';
654      }
655
656      if (count($scripts[1]))
657      {
658        $content[]= '<script type="text/javascript">';
659        $content[]= '(function() {
660var s,after = document.getElementsByTagName(\'script\')[document.getElementsByTagName(\'script\').length-1];';
661        foreach ($scripts[1] as $id => $script)
662        {
663          $content[]=
664            's=document.createElement(\'script\'); s.type=\'text/javascript\'; s.async=true; s.src=\''
665            . self::make_script_src($script)
666            .'\';';
667          $content[]= 'after = after.parentNode.insertBefore(s, after);';
668        }
669        $content[]= '})();';
670        $content[]= '</script>';
671      }
672    }
673    return implode("\n", $content);
674  }
675
676
677  private static function make_script_src( $script )
678  {
679    $ret = '';
680    if ( $script->is_remote() )
681      $ret = $script->path;
682    else
683    {
684      $ret = get_root_url().$script->path;
685      if ($script->version!==false)
686      {
687        $ret.= '?v'. ($script->version ? $script->version : PHPWG_VERSION);
688      }
689    }
690    // trigger the event for eventual use of a cdn
691    $ret = trigger_event('combined_script', $ret, $script);
692    return $ret;
693  }
694
695  function block_footer_script($params, $content, &$smarty, &$repeat)
696  {
697    $content = trim($content);
698    if ( !empty($content) )
699    { // second call
700      $this->scriptLoader->add_inline(
701        $content,
702        empty($params['require']) ? array() : explode(',', $params['require'])
703      );
704    }
705  }
706
707  /**
708    * combine_css smarty function allows inclusion of a css stylesheet file in the current page.
709    * The engine will combine several css files into a single one in order to reduce the number of
710    * required http requests.
711    * param path - required - the path to css file RELATIVE to piwigo root dir
712    * param version - optional - plugins could use this and change it in order to force a
713        browser refresh
714    */
715  function func_combine_css($params, &$smarty)
716  {
717    !empty($params['path']) || fatal_error('combine_css missing path');
718    $order = (int)@$params['order'];
719    $version = isset($params['version']) ? $params['version'] : 0;
720    $this->css_by_priority[$order][] = array( $params['path'], $version);
721  }
722
723  function func_get_combined_css($params, &$smarty)
724  {
725    return 'echo '.var_export(self::COMBINED_CSS_TAG,true);
726  }
727
728
729 /**
730   * This function allows to declare a Smarty prefilter from a plugin, thus allowing
731   * it to modify template source before compilation and without changing core files
732   * They will be processed by weight ascending.
733   * http://www.smarty.net/manual/en/advanced.features.prefilters.php
734   */
735  function set_prefilter($handle, $callback, $weight=50)
736  {
737    $this->external_filters[$handle][$weight][] = array('prefilter', $callback);
738    ksort($this->external_filters[$handle]);
739  }
740
741  function set_postfilter($handle, $callback, $weight=50)
742  {
743    $this->external_filters[$handle][$weight][] = array('postfilter', $callback);
744    ksort($this->external_filters[$handle]);
745  }
746
747  function set_outputfilter($handle, $callback, $weight=50)
748  {
749    $this->external_filters[$handle][$weight][] = array('outputfilter', $callback);
750    ksort($this->external_filters[$handle]);
751  }
752
753 /**
754   * This function actually triggers the filters on the tpl files.
755   * Called in the parse method.
756   * http://www.smarty.net/manual/en/advanced.features.prefilters.php
757   */
758  function load_external_filters($handle)
759  {
760    if (isset($this->external_filters[$handle]))
761    {
762      $compile_id = '';
763      foreach ($this->external_filters[$handle] as $filters)
764      {
765        foreach ($filters as $filter)
766        {
767          list($type, $callback) = $filter;
768          $compile_id .= $type.( is_array($callback) ? implode('', $callback) : $callback );
769          call_user_func(array($this->smarty, 'register_'.$type), $callback);
770        }
771      }
772      $this->smarty->compile_id .= '.'.base_convert(crc32($compile_id), 10, 36);
773    }
774  }
775
776  function unload_external_filters($handle)
777  {
778    if (isset($this->external_filters[$handle]))
779    {
780      foreach ($this->external_filters[$handle] as $filters)
781      {
782        foreach ($filters as $filter)
783        {
784          list($type, $callback) = $filter;
785          call_user_func(array($this->smarty, 'unregister_'.$type), $callback);
786        }
787      }
788    }
789  }
790
791  static function prefilter_white_space($source, &$smarty)
792  {
793    $ld = $smarty->left_delimiter;
794    $rd = $smarty->right_delimiter;
795    $ldq = preg_quote($ld, '#');
796    $rdq = preg_quote($rd, '#');
797
798    $regex = array();
799    $tags = array('if','foreach','section','footer_script');
800    foreach($tags as $tag)
801    {
802      array_push($regex, "#^[ \t]+($ldq$tag"."[^$ld$rd]*$rdq)\s*$#m");
803      array_push($regex, "#^[ \t]+($ldq/$tag$rdq)\s*$#m");
804    }
805    $tags = array('include','else','combine_script','html_head');
806    foreach($tags as $tag)
807    {
808      array_push($regex, "#^[ \t]+($ldq$tag"."[^$ld$rd]*$rdq)\s*$#m");
809    }
810    $source = preg_replace( $regex, "$1", $source);
811    return $source;
812  }
813
814  /**
815   * Smarty prefilter to allow caching (whenever possible) language strings
816   * from templates.
817   */
818  static function prefilter_language($source, &$smarty)
819  {
820    global $lang;
821    $ldq = preg_quote($smarty->left_delimiter, '~');
822    $rdq = preg_quote($smarty->right_delimiter, '~');
823
824    $regex = "~$ldq *\'([^'$]+)\'\|@translate *$rdq~";
825    $source = preg_replace_callback( $regex, create_function('$m', 'global $lang; return isset($lang[$m[1]]) ? $lang[$m[1]] : $m[0];'), $source);
826
827    $regex = "~$ldq *\'([^'$]+)\'\|@translate\|~";
828    $source = preg_replace_callback( $regex, create_function('$m', 'global $lang; return isset($lang[$m[1]]) ? \'{\'.var_export($lang[$m[1]],true).\'|\' : $m[0];'), $source);
829
830    $regex = "~($ldq *assign +var=.+ +value=)\'([^'$]+)\'\|@translate~";
831    $source = preg_replace_callback( $regex, create_function('$m', 'global $lang; return isset($lang[$m[2]]) ? $m[1].var_export($lang[$m[2]],true) : $m[0];'), $source);
832
833    return $source;
834  }
835
836  static function prefilter_local_css($source, &$smarty)
837  {
838    $css = array();
839    foreach ($smarty->get_template_vars('themes') as $theme)
840    {
841      $f = PWG_LOCAL_DIR.'css/'.$theme['id'].'-rules.css';
842      if (file_exists(PHPWG_ROOT_PATH.$f))
843      {
844        array_push($css, "{combine_css path='$f' order=10}");
845      }
846    }
847    $f = PWG_LOCAL_DIR.'css/rules.css';
848    if (file_exists(PHPWG_ROOT_PATH.$f))
849    {
850      array_push($css, "{combine_css path='$f' order=10}");
851    }
852
853    if (!empty($css))
854    {
855      $source = str_replace("\n{get_combined_css}", "\n".implode( "\n", $css )."\n{get_combined_css}", $source);
856    }
857
858    return $source;
859  }
860
861  function load_themeconf($dir)
862  {
863    global $themeconfs, $conf;
864
865    $dir = realpath($dir);
866    if (!isset($themeconfs[$dir]))
867    {
868      $themeconf = array();
869      include($dir.'/themeconf.inc.php');
870      // Put themeconf in cache
871      $themeconfs[$dir] = $themeconf;
872    }
873    return $themeconfs[$dir];
874  }
875}
876
877
878/**
879 * This class contains basic functions that can be called directly from the
880 * templates in the form $pwg->l10n('edit')
881 */
882class PwgTemplateAdapter
883{
884  function l10n($text)
885  {
886    return l10n($text);
887  }
888
889  function l10n_dec($s, $p, $v)
890  {
891    return l10n_dec($s, $p, $v);
892  }
893
894  function sprintf()
895  {
896    $args = func_get_args();
897    return call_user_func_array('sprintf',  $args );
898  }
899
900  function derivative_url($type, $img)
901  {
902    return DerivativeImage::url($type, $img);
903  }
904}
905
906
907final class Script
908{
909  public $id;
910  public $load_mode;
911  public $precedents = array();
912  public $path;
913  public $version;
914  public $extra = array();
915
916  function Script($load_mode, $id, $path, $version, $precedents)
917  {
918    $this->id = $id;
919    $this->load_mode = $load_mode;
920    $this->id = $id;
921    $this->set_path($path);
922    $this->version = $version;
923    $this->precedents = $precedents;
924  }
925
926  function set_path($path)
927  {
928    if (!empty($path))
929      $this->path = $path;
930  }
931
932  function is_remote()
933  {
934    return url_is_remote( $this->path );
935  }
936}
937
938
939/** Manage a list of required scripts for a page, by optimizing their loading location (head, bottom, async)
940and later on by combining them in a unique file respecting at the same time dependencies.*/
941class ScriptLoader
942{
943  private $registered_scripts;
944  public $inline_scripts;
945
946  private $did_head;
947  private $head_done_scripts;
948  private $did_footer;
949
950  private static $known_paths = array(
951      'core.scripts' => 'themes/default/js/scripts.js',
952      'jquery' => 'themes/default/js/jquery.min.js',
953      'jquery.ui' => 'themes/default/js/ui/minified/jquery.ui.core.min.js',
954      'jquery.effects' => 'themes/default/js/ui/minified/jquery.effects.core.min.js',
955    );
956
957  private static $ui_core_dependencies = array(
958      'jquery.ui.widget' => array('jquery'),
959      'jquery.ui.position' => array('jquery'),
960      'jquery.ui.mouse' => array('jquery', 'jquery.ui', 'jquery.ui.widget'),
961    );
962
963  function __construct()
964  {
965    $this->clear();
966  }
967
968  function clear()
969  {
970    $this->registered_scripts = array();
971    $this->inline_scripts = array();
972    $this->head_done_scripts = array();
973    $this->did_head = $this->did_footer = false;
974  }
975
976  function get_all()
977  {
978    return $this->registered_scripts;
979  }
980
981  function add_inline($code, $require)
982  {
983    !$this->did_footer || trigger_error("Attempt to add inline script but the footer has been written", E_USER_WARNING);
984    if(!empty($require))
985    {
986      foreach ($require as $id)
987      {
988        if(!isset($this->registered_scripts[$id]))
989          $this->load_known_required_script($id, 1) or fatal_error("inline script not found require $id");
990        $s = $this->registered_scripts[$id];
991        if($s->load_mode==2)
992          $s->load_mode=1; // until now the implementation does not allow executing inline script depending on another async script
993      }
994    }
995    $this->inline_scripts[] = $code;
996  }
997
998  function add($id, $load_mode, $require, $path, $version=0)
999  {
1000    if ($this->did_head && $load_mode==0)
1001    {
1002      trigger_error("Attempt to add script $id but the head has been written", E_USER_WARNING);
1003    }
1004    elseif ($this->did_footer)
1005    {
1006      trigger_error("Attempt to add script $id but the footer has been written", E_USER_WARNING);
1007    }
1008    if (! isset( $this->registered_scripts[$id] ) )
1009    {
1010      $script = new Script($load_mode, $id, $path, $version, $require);
1011      self::fill_well_known($id, $script);
1012      $this->registered_scripts[$id] = $script;
1013
1014      // Load or modify all UI core files
1015      if ($id == 'jquery.ui' and $script->path == self::$known_paths['jquery.ui'])
1016      {
1017        foreach (self::$ui_core_dependencies as $script_id => $required_ids)
1018          $this->add($script_id, $load_mode, $required_ids, null, $version);
1019      }
1020
1021      // Try to load undefined required script
1022      foreach ($script->precedents as $script_id)
1023      {
1024        if (! isset( $this->registered_scripts[$script_id] ) )
1025          $this->load_known_required_script($script_id, $load_mode);
1026      }
1027    }
1028    else
1029    {
1030      $script = $this->registered_scripts[$id];
1031      if (count($require))
1032      {
1033        $script->precedents = array_unique( array_merge($script->precedents, $require) );
1034      }
1035      $script->set_path($path);
1036      if ($version && version_compare($script->version, $version)<0 )
1037        $script->version = $version;
1038      if ($load_mode < $script->load_mode)
1039        $script->load_mode = $load_mode;
1040    }
1041
1042  }
1043
1044  function did_head()
1045  {
1046    return $this->did_head;
1047  }
1048
1049  function get_head_scripts()
1050  {
1051    self::check_load_dep($this->registered_scripts);
1052    foreach( array_keys($this->registered_scripts) as $id )
1053    {
1054      $this->compute_script_topological_order($id);
1055    }
1056
1057    uasort($this->registered_scripts, array('ScriptLoader', 'cmp_by_mode_and_order'));
1058
1059    foreach( $this->registered_scripts as $id => $script)
1060    {
1061      if ($script->load_mode > 0)
1062        break;
1063      if ( !empty($script->path) )
1064        $this->head_done_scripts[$id] = $script;
1065      else
1066        trigger_error("Script $id has an undefined path", E_USER_WARNING);
1067    }
1068    $this->did_head = true;
1069    return self::do_combine($this->head_done_scripts, 0);
1070  }
1071
1072  function get_footer_scripts()
1073  {
1074    if (!$this->did_head)
1075    {
1076      self::check_load_dep($this->registered_scripts);
1077    }
1078    $this->did_footer = true;
1079    $todo = array();
1080    foreach( $this->registered_scripts as $id => $script)
1081    {
1082      if (!isset($this->head_done_scripts[$id]))
1083      {
1084        $todo[$id] = $script;
1085      }
1086    }
1087
1088    foreach( array_keys($todo) as $id )
1089    {
1090      $this->compute_script_topological_order($id);
1091    }
1092
1093    uasort($todo, array('ScriptLoader', 'cmp_by_mode_and_order'));
1094
1095    $result = array( array(), array() );
1096    foreach( $todo as $id => $script)
1097    {
1098      $result[$script->load_mode-1][$id] = $script;
1099    }
1100    return array( self::do_combine($result[0],1), self::do_combine($result[1],2) );
1101  }
1102
1103  private static function do_combine($scripts, $load_mode)
1104  {
1105    global $conf;
1106    if (count($scripts)<2 or !$conf['template_combine_files'])
1107      return $scripts;
1108    $combiner = new FileCombiner('js');
1109    $result = array();
1110    foreach ($scripts as $script)
1111    {
1112      if ($script->is_remote())
1113      {
1114        if ( $combiner->combine( $out_file, $out_version) )
1115        {
1116          $results[] = new Script($load_mode, 'combi', $out_file, $out_version, array() );
1117        }
1118        $results[] = $script;
1119      }
1120      else
1121        $combiner->add( $script->path, $script->version );
1122    }
1123    if ( $combiner->combine( $out_file, $out_version) )
1124    {
1125      $results[] = new Script($load_mode, 'combi', $out_file, $out_version, array() );
1126    }
1127    return $results;
1128  }
1129
1130  // checks that if B depends on A, then B->load_mode >= A->load_mode in order to respect execution order
1131  private static function check_load_dep($scripts)
1132  {
1133    global $conf;
1134    do
1135    {
1136      $changed = false;
1137      foreach( $scripts as $id => $script)
1138      {
1139        $load = $script->load_mode;
1140        foreach( $script->precedents as $precedent)
1141        {
1142          if ( !isset($scripts[$precedent] ) )
1143            continue;
1144          if ( $scripts[$precedent]->load_mode > $load )
1145          {
1146            $scripts[$precedent]->load_mode = $load;
1147            $changed = true;
1148          }
1149          if ($load==2 && $scripts[$precedent]->load_mode==2 && ($scripts[$precedent]->is_remote() or !$conf['template_combine_files']) )
1150          {// we are async -> a predecessor cannot be async unlesss it can be merged; otherwise script execution order is not guaranteed
1151            $scripts[$precedent]->load_mode = 1;
1152            $changed = true;
1153          }
1154        }
1155      }
1156    }
1157    while ($changed);
1158  }
1159
1160
1161  private static function fill_well_known($id, $script)
1162  {
1163    if ( empty($script->path) && isset(self::$known_paths[$id]))
1164    {
1165      $script->path = self::$known_paths[$id];
1166    }
1167    if ( strncmp($id, 'jquery.', 7)==0 )
1168    {
1169      $required_ids = array('jquery');
1170
1171      if ( strncmp($id, 'jquery.ui.', 10)==0 )
1172      {
1173        if ( !isset(self::$ui_core_dependencies[$id]) )
1174          $required_ids = array_merge(array('jquery', 'jquery.ui'), array_keys(self::$ui_core_dependencies));
1175
1176        if ( empty($script->path) )
1177          $script->path = dirname(self::$known_paths['jquery.ui'])."/$id.min.js";
1178      }
1179      elseif ( strncmp($id, 'jquery.effects.', 15)==0 )
1180      {
1181        $required_ids = array('jquery', 'jquery.effects');
1182
1183        if ( empty($script->path) )
1184          $script->path = dirname(self::$known_paths['jquery.effects'])."/$id.min.js";
1185      }
1186
1187      foreach ($required_ids as $required_id)
1188      {
1189        if ( !in_array($required_id, $script->precedents ) )
1190          $script->precedents[] = $required_id;
1191      }
1192    }
1193  }
1194
1195  private function load_known_required_script($id, $load_mode)
1196  {
1197    if ( isset(self::$known_paths[$id]) or strncmp($id, 'jquery.ui.', 10)==0 or strncmp($id, 'jquery.effects.', 15)==0 )
1198    {
1199      $this->add($id, $load_mode, array(), null);
1200      return true;
1201    }
1202    return false;
1203  }
1204
1205  private function compute_script_topological_order($script_id, $recursion_limiter=0)
1206  {
1207    if (!isset($this->registered_scripts[$script_id]))
1208    {
1209      trigger_error("Undefined script $script_id is required by someone", E_USER_WARNING);
1210      return 0;
1211    }
1212    $recursion_limiter<5 or fatal_error("combined script circular dependency");
1213    $script = $this->registered_scripts[$script_id];
1214    if (isset($script->extra['order']))
1215      return $script->extra['order'];
1216    if (count($script->precedents) == 0)
1217      return ($script->extra['order'] = 0);
1218    $max = 0;
1219    foreach( $script->precedents as $precedent)
1220      $max = max($max, $this->compute_script_topological_order($precedent, $recursion_limiter+1) );
1221    $max++;
1222    return ($script->extra['order'] = $max);
1223  }
1224
1225  private static function cmp_by_mode_and_order($s1, $s2)
1226  {
1227    $ret = $s1->load_mode - $s2->load_mode;
1228    if ($ret) return $ret;
1229
1230    $ret = $s1->extra['order'] - $s2->extra['order'];
1231    if ($ret) return $ret;
1232
1233    if ($s1->extra['order']==0 and ($s1->is_remote() xor $s2->is_remote()) )
1234    {
1235      return $s1->is_remote() ? -1 : 1;
1236    }
1237    return strcmp($s1->id,$s2->id);
1238  }
1239}
1240
1241
1242/*Allows merging of javascript and css files into a single one.*/
1243final class FileCombiner
1244{
1245  private $type; // js or css
1246  private $files = array();
1247  private $versions = array();
1248
1249  function FileCombiner($type)
1250  {
1251    $this->type = $type;
1252  }
1253
1254  static function clear_combined_files()
1255  {
1256    $dir = opendir(PHPWG_ROOT_PATH.PWG_COMBINED_DIR);
1257    while ($file = readdir($dir))
1258    {
1259      if ( get_extension($file)=='js' || get_extension($file)=='css')
1260        unlink(PHPWG_ROOT_PATH.PWG_COMBINED_DIR.$file);
1261    }
1262    closedir($dir);
1263  }
1264
1265  function add($file, $version)
1266  {
1267    $this->files[] = $file;
1268    $this->versions[] = $version;
1269  }
1270
1271  function clear()
1272  {
1273    $this->files = array();
1274    $this->versions = array();
1275  }
1276
1277  function combine(&$out_file, &$out_version)
1278  {
1279    if (count($this->files) == 0)
1280    {
1281      return false;
1282    }
1283    if (count($this->files) == 1)
1284    {
1285      $out_file = $this->files[0];
1286      $out_version = $this->versions[0];
1287      $this->clear();
1288      return 1;
1289    }
1290
1291    $is_css = $this->type == "css";
1292    global $conf;
1293    $key = array();
1294    if ($is_css)
1295      $key[] = get_absolute_root_url(false);//because we modify bg url
1296    for ($i=0; $i<count($this->files); $i++)
1297    {
1298      $key[] = $this->files[$i];
1299      $key[] = $this->versions[$i];
1300      if ($conf['template_compile_check']) $key[] = filemtime( PHPWG_ROOT_PATH . $this->files[$i] );
1301    }
1302    $key = join('>', $key);
1303
1304    $file = base_convert(crc32($key),10,36);
1305    $file = PWG_COMBINED_DIR . $file . '.' . $this->type;
1306
1307    $exists = file_exists( PHPWG_ROOT_PATH . $file );
1308    if ($exists)
1309    {
1310      $is_reload =
1311        (isset($_SERVER['HTTP_CACHE_CONTROL']) && strpos($_SERVER['HTTP_CACHE_CONTROL'], 'max-age=0') !== false)
1312        || (isset($_SERVER['HTTP_PRAGMA']) && strpos($_SERVER['HTTP_PRAGMA'], 'no-cache'));
1313      if (is_admin() && $is_reload)
1314      {// the user pressed F5 in the browser
1315        if ($is_css || $conf['template_compile_check']==false)
1316          $exists = false; // we foce regeneration of css because @import sub-files are never checked for modification
1317      }
1318    }
1319
1320    if ($exists)
1321    {
1322      $out_file = $file;
1323      $out_version = false;
1324      $this->clear();
1325      return 2;
1326    }
1327
1328    $output = '';
1329    foreach ($this->files as $input_file)
1330    {
1331      $output .= "/*BEGIN $input_file */\n";
1332      if ($is_css)
1333        $output .= self::process_css($input_file);
1334      else
1335        $output .= self::process_js($input_file);
1336      $output .= "\n";
1337    }
1338
1339    file_put_contents( PHPWG_ROOT_PATH . $file,  $output );
1340    $out_file = $file;
1341    $out_version = false;
1342    $this->clear();
1343    return 2;
1344  }
1345
1346  private static function process_js($file)
1347  {
1348    $js = file_get_contents(PHPWG_ROOT_PATH . $file);
1349    if (strpos($file, '.min')===false and strpos($file, '.packed')===false )
1350    {
1351      require_once(PHPWG_ROOT_PATH.'include/jsmin.class.php');
1352      try { $js = JSMin::minify($js); } catch(Exception $e) {}
1353    }
1354    return trim($js, " \t\r\n;").";\n";
1355  }
1356
1357  private static function process_css($file)
1358  {
1359    $css = self::process_css_rec($file);
1360    require_once(PHPWG_ROOT_PATH.'include/cssmin.class.php');
1361    $css = CssMin::minify($css, array('Variables'=>false));
1362    $css = trigger_event('combined_css_postfilter', $css);
1363    return $css;
1364  }
1365
1366  private static function process_css_rec($file)
1367  {
1368    static $PATTERN = "#url\(\s*['|\"]{0,1}(.*?)['|\"]{0,1}\s*\)#";
1369    $css = file_get_contents(PHPWG_ROOT_PATH . $file);
1370    if (preg_match_all($PATTERN, $css, $matches, PREG_SET_ORDER))
1371    {
1372      $search = $replace = array();
1373      foreach ($matches as $match)
1374      {
1375        if ( !url_is_remote($match[1]) && $match[1][0] != '/')
1376        {
1377          $relative = dirname($file) . "/$match[1]";
1378          $search[] = $match[0];
1379          $replace[] = 'url('.embellish_url(get_absolute_root_url(false).$relative).')';
1380        }
1381      }
1382      $css = str_replace($search, $replace, $css);
1383    }
1384
1385    $imports = preg_match_all("#@import\s*['|\"]{0,1}(.*?)['|\"]{0,1};#", $css, $matches, PREG_SET_ORDER);
1386    if ($imports)
1387    {
1388      $search = $replace = array();
1389      foreach ($matches as $match)
1390      {
1391        $search[] = $match[0];
1392        $replace[] = self::process_css_rec(dirname($file) . "/$match[1]");
1393      }
1394      $css = str_replace($search, $replace, $css);
1395    }
1396    return $css;
1397  }
1398}
1399
1400?>
Note: See TracBrowser for help on using the repository browser.