- 'EXPLAIN' => $token_explain)

- );

- $sp_replace = str_replace($token, '${' . ($n + 1) . '}', $sp_replace);

- $template = new phpbb_template($phpbb_root_path, $phpEx, $config, $user, $style_resource_locator, new phpbb_template_context(), $phpbb_extension_manager);

- $this->template_filename = $style_resource_locator->get_source_file_for_handle('bbcode.html');

- public function __construct(phpbb_user $user, ContainerInterface $container)

-function phpbb_create_compiled_container(array $extensions, array $passes, $phpbb_root_path, $php_ext)

- // Create a temporary container for access to the ext.manager service

- $tmp_container = phpbb_create_container($extensions, $phpbb_root_path, $php_ext);

- $tmp_container->compile();

-

- // XXX stop writing to global $cache when

- // http://tracker.phpbb.com/browse/PHPBB3-11203 is fixed

- $GLOBALS['cache'] = $tmp_container->get('cache');

- $installed_exts = $tmp_container->get('ext.manager')->all_enabled();

-function phpbb_create_dumped_container(array $extensions, array $passes, $phpbb_root_path, $php_ext)

-function phpbb_create_dumped_container_unless_debug(array $extensions, array $passes, $phpbb_root_path, $php_ext)

- new phpbb_di_extension_config($phpbb_root_path . 'config.' . $php_ext),

- var $tpl_obj = NULL;

- var $tpl_msg = array();

-

- *

- // $tpl->set_filenames will do a trigger_error

- // tpl_msg now holds a template object we can use to parse the template file

- if (!isset($this->tpl_msg[$template_lang . $template_file]))

- $style_resource_locator = new phpbb_style_resource_locator();

- $style_path_provider = new phpbb_style_extension_path_provider($phpbb_extension_manager, new phpbb_style_path_provider(), $phpbb_root_path);

- $tpl = new phpbb_template($phpbb_root_path, $phpEx, $config, $user, $style_resource_locator, new phpbb_template_context(), $phpbb_extension_manager);

- $style = new phpbb_style($phpbb_root_path, $phpEx, $config, $user, $style_resource_locator, $style_path_provider, $tpl);

-

- $this->tpl_msg[$template_lang . $template_file] = $tpl;

- $fallback_template_path = false;

- if (!$template_path)

- $template_path = (!empty($user->lang_path)) ? $user->lang_path : $phpbb_root_path . 'language/';

- $template_path .= $template_lang . '/email';

- // we can only specify default language fallback when the path is not a custom one for which we

- // do not know the default language alternative

- if ($template_lang !== basename($config['default_lang']))

- {

- $fallback_template_path = (!empty($user->lang_path)) ? $user->lang_path : $phpbb_root_path . 'language/';

- $fallback_template_path .= basename($config['default_lang']) . '/email';

- }

- $style->set_custom_style($template_lang . '_email', array($template_path, $fallback_template_path), array(), '');

- $tpl->set_filenames(array(

- 'body' => $template_file . '.txt',

- ));

- }

- $this->tpl_obj = &$this->tpl_msg[$template_lang . $template_file];

- $this->vars = &$this->tpl_obj->_rootref;

- $this->tpl_msg = '';

- if (!is_object($this->tpl_obj))

- {

- return;

- }

- $this->tpl_obj->assign_vars($vars);

- if (!is_object($this->tpl_obj))

- {

- return;

- }

- $this->tpl_obj->assign_block_vars($blockname, $vars);

- $this->msg = trim($this->tpl_obj->assign_display('body'));

- global $phpbb_root_path, $phpbb_admin_path, $phpEx, $user;

- * Set style location based on (current) user's chosen style.

- public function set_style()

- $style_path = $this->user->style['style_path'];

- $style_dirs = ($this->user->style['style_parent_id']) ? array_reverse(explode('/', $this->user->style['style_parent_tree'])) : array();

- $names = array($style_path);

- foreach ($style_dirs as $dir)

- $names[] = $dir;

- // Add 'all' path, used as last fallback path by events and extensions

- //$names[] = 'all';

- foreach ($names as $name)

- $paths[] = $this->get_style_path($name);

- return $this->set_custom_style($style_path, $paths, $names);

- $this->template->set_style_names($names);

-

- else

- $this->locator->set_default_template_path();

- $this->template->cachepath = $this->phpbb_root_path . 'cache/tpl_' . str_replace('_', '-', $name) . '_';

- public function get_style_path($path)

- return $this->phpbb_root_path . 'styles/' . $path;

-<?php

-/**

-*

-* @package phpBB3

-* @copyright (c) 2005 phpBB Group

-* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

-*

-*/

-

-/**

-* @ignore

-*/

-if (!defined('IN_PHPBB'))

-{

- exit;

-}

-

-stream_filter_register('phpbb_template', 'phpbb_template_filter');

-

-/**

-* Extension of template class - Functions needed for compiling templates only.

-*

-* @package phpBB3

-* @uses template_filter As a PHP stream filter to perform compilation of templates

-*/

-class phpbb_template_compile

-{

- /**

- * Array of parameters to forward to template filter

- *

- * @var array

- */

- private $filter_params;

-

- /**

- * Array of default parameters

- *

- * @var array

- */

- private $default_filter_params;

-

- /**

- * Constructor.

- *

- * @param bool $allow_php Whether PHP code will be allowed in templates (inline PHP code, PHP tag and INCLUDEPHP tag)

- * @param array $style_names Name of style to which the template being compiled belongs and parents in style tree order

- * @param phpbb_style_resource_locator $locator Resource locator

- * @param string $phpbb_root_path Path to phpBB root directory

- * @param phpbb_extension_manager $extension_manager Extension manager to use for finding template fragments in extensions; if null, template events will not be invoked

- * @param phpbb_user $user Current user

- */

- public function __construct($allow_php, $style_names, $locator, $phpbb_root_path, $extension_manager = null, $user = null)

- {

- $this->filter_params = $this->default_filter_params = array(

- 'allow_php' => $allow_php,

- 'style_names' => $style_names,

- 'locator' => $locator,

- 'phpbb_root_path' => $phpbb_root_path,

- 'extension_manager' => $extension_manager,

- 'user' => $user,

- 'template_compile' => $this,

- 'cleanup' => true,

- );

- }

-

- /**

- * Set filter parameters

- *

- * @param array $params Array of parameters (will be merged onto $this->filter_params)

- */

- public function set_filter_params($params)

- {

- $this->filter_params = array_merge(

- $this->filter_params,

- $params

- );

- }

-

- /**

- * Reset filter parameters to their default settings

- */

- public function reset_filter_params()

- {

- $this->filter_params = $this->default_filter_params;

- }

-

- /**

- * Compiles template in $source_file and writes compiled template to

- * cache directory

- *

- * @param string $handle Template handle to compile

- * @param string $source_file Source template file

- * @return bool Return true on success otherwise false

- */

- public function compile_file_to_file($source_file, $compiled_file)

- {

- $lock = new phpbb_lock_flock($compiled_file);

- $lock->acquire();

-

- $source_handle = @fopen($source_file, 'rb');

- $destination_handle = @fopen($compiled_file, 'wb');

-

- if (!$source_handle || !$destination_handle)

- {

- return false;

- }

-

- $this->compile_stream_to_stream($source_handle, $destination_handle);

-

- @fclose($source_handle);

- @fclose($destination_handle);

-

- phpbb_chmod($compiled_file, CHMOD_READ | CHMOD_WRITE);

-

- $lock->release();

-

- clearstatcache();

-

- return true;

- }

-

- /**

- * Compiles a template located at $source_file.

- *

- * Returns PHP source suitable for eval().

- *

- * @param string $source_file Source template file

- * @return string|bool Return compiled code on successful compilation otherwise false

- */

- public function compile_file($source_file)

- {

- $source_handle = @fopen($source_file, 'rb');

- $destination_handle = @fopen('php://temp' ,'r+b');

-

- if (!$source_handle || !$destination_handle)

- {

- return false;

- }

-

- $this->compile_stream_to_stream($source_handle, $destination_handle);

-

- @fclose($source_handle);

-

- rewind($destination_handle);

- $contents = stream_get_contents($destination_handle);

- @fclose($dest_handle);

-

- return $contents;

- }

-

- /**

- * Compiles contents of $source_stream into $dest_stream.

- *

- * A stream filter is appended to $source_stream as part of the

- * process.

- *

- * @param resource $source_stream Source stream

- * @param resource $dest_stream Destination stream

- * @return null

- */

- private function compile_stream_to_stream($source_stream, $dest_stream)

- {

- stream_filter_append($source_stream, 'phpbb_template', null, $this->filter_params);

- stream_copy_to_stream($source_stream, $dest_stream);

- }

-}

- $vararray['S_ROW_COUNT'] = $s_row_count;

- $vararray['S_ROW_COUNT'] = $s_row_count;

-<?php

-/**

-*

-* @package phpBB3

-* @copyright (c) 2011 phpBB Group, sections (c) 2001 ispi of Lincoln Inc

-* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

-*

-*/

-

-/**

-* @ignore

-*/

-if (!defined('IN_PHPBB'))

-{

- exit;

-}

-

-/**

-* The template filter that does the actual compilation

-*

-* psoTFX, phpBB Development Team - Completion of file caching, decompilation

-* routines and implementation of conditionals/keywords and associated changes

-*

-* The interface was inspired by PHPLib templates, and the template file (formats are

-* quite similar)

-*

-* The keyword/conditional implementation is currently based on sections of code from

-* the Smarty templating engine (c) 2001 ispi of Lincoln, Inc. which is released

-* (on its own and in whole) under the LGPL. Section 3 of the LGPL states that any code

-* derived from an LGPL application may be relicenced under the GPL, this applies

-* to this source

-*

-* DEFINE directive inspired by a request by Cyberalien

-*

-* @see template_compile

-* @package phpBB3

-*/

-class phpbb_template_filter extends php_user_filter

-{

- const REGEX_NS = '[a-z_][a-z_0-9]+';

-

- const REGEX_VAR = '[A-Z_][A-Z_0-9]+';

- const REGEX_VAR_SUFFIX = '[A-Z_0-9]+';

-

- const REGEX_TAG = '<!-- ([A-Z][A-Z_0-9]+)(?: (.*?) ?)?-->';

-

- const REGEX_TOKENS = '~<!-- ([A-Z][A-Z_0-9]+)(?: (.*?) ?)?-->|{((?:[a-z_][a-z_0-9]+\.)*\\$?[A-Z][A-Z_0-9]+)}~';

-

- /**

- * @var array

- */

- private $block_names = array();

-

- /**

- * @var array

- */

- private $block_else_level = array();

-

- /**

- * @var string

- */

- private $chunk;

-

- /**

- * @var bool

- */

- private $in_php;

-

- /**

- * Whether inline PHP code, <!-- PHP --> and <!-- INCLUDEPHP --> tags

- * are allowed. If this is false all PHP code will be silently

- * removed from the template during compilation.

- *

- * @var bool

- */

- private $allow_php;

-

- /**

- * Whether cleanup will be performed on resulting code, see compile()

- * (Preserve whitespace)

- *

- * @var bool

- */

- private $cleanup = true;

-

- /**

- * Resource locator.

- *

- * @var phpbb_template_locator

- */

- private $locator;

-

- /**

- * @var string phpBB root path

- */

- private $phpbb_root_path;

-

- /**

- * Name of the style that the template being compiled and/or rendered

- * belongs to, and its parents, in inheritance tree order.

- *

- * Used to invoke style-specific template events.

- *

- * @var array

- */

- private $style_names;

-

- /**

- * Extension manager.

- *

- * @var phpbb_extension_manager

- */

- private $extension_manager;

-

- /**

- * Current user

- *

- * @var phpbb_user

- */

- private $user;

-

- /**

- * Template compiler.

- *

- * @var phpbb_template_compile

- */

- private $template_compile;

-

- /**

- * Stream filter

- *

- * Is invoked for evey chunk of the stream, allowing us

- * to work on a chunk at a time, which saves memory.

- */

- public function filter($in, $out, &$consumed, $closing)

- {

- $written = false;

- $first = false;

-

- while ($bucket = stream_bucket_make_writeable($in))

- {

- $consumed += $bucket->datalen;

-

- $data = $this->chunk . $bucket->data;

- $last_nl = strrpos($data, "\n");

- $this->chunk = substr($data, $last_nl);

- $data = substr($data, 0, $last_nl);

-

- if (!strlen($data))

- {

- continue;

- }

-

- $written = true;

-

- $data = $this->compile($data);

- if (!$first)

- {

- $data = $this->prepend_preamble($data);

- $first = false;

- }

- $bucket->data = $data;

- $bucket->datalen = strlen($bucket->data);

- stream_bucket_append($out, $bucket);

- }

-

- if ($closing && strlen($this->chunk))

- {

- $written = true;

- $bucket = stream_bucket_new($this->stream, $this->compile($this->chunk));

- stream_bucket_append($out, $bucket);

- }

-

- return $written ? PSFS_PASS_ON : PSFS_FEED_ME;

- }

-

- /**

- * Initializer, called on creation.

- *

- * Get the allow_php option, style_names, root directory and locator from params,

- * which are passed to stream_filter_append.

- *

- * @return boolean Returns true

- */

- public function onCreate()

- {

- $this->chunk = '';

- $this->in_php = false;

- $this->allow_php = $this->params['allow_php'];

- $this->locator = $this->params['locator'];

- $this->phpbb_root_path = $this->params['phpbb_root_path'];

- $this->style_names = $this->params['style_names'];

- $this->extension_manager = $this->params['extension_manager'];

- $this->cleanup = $this->params['cleanup'];

- if (isset($this->params['user']))

- {

- $this->user = $this->params['user'];

- }

- $this->template_compile = $this->params['template_compile'];

- return true;

- }

-

- /**

- * Compiles a chunk of template.

- *

- * The chunk must comprise of one or more complete lines from the source

- * template.

- *

- * @param string $data Chunk of source template to compile

- * @return string Compiled PHP/HTML code

- */

- private function compile($data)

- {

- $block_start_in_php = $this->in_php;

-

- $data = preg_replace('#<(?:[\\?%]|script)#s', '<?php echo\'\\0\';?>', $data);

- $data = preg_replace_callback(self::REGEX_TOKENS, array($this, 'replace'), $data);

-

- // Remove php

- if (!$this->allow_php)

- {

- if ($block_start_in_php

- && $this->in_php

- && strpos($data, '<!-- PHP -->') === false

- && strpos($data, '<!-- ENDPHP -->') === false)

- {

- // This is just php code

- return '';

- }

- $data = preg_replace('~^.*?<!-- ENDPHP -->~', '', $data);

- $data = preg_replace('~<!-- PHP -->.*?<!-- ENDPHP -->~', '', $data);

- $data = preg_replace('~<!-- ENDPHP -->.*?$~', '', $data);

- }

-

- if ($this->cleanup)

- {

- /*

-

- Preserve whitespace.

- PHP removes a newline after the closing tag (if it's there).

- This is by design:

-

- http://www.php.net/manual/en/language.basic-syntax.phpmode.php

- http://www.php.net/manual/en/language.basic-syntax.instruction-separation.php

-

-

- Consider the following template:

-

- <!-- IF condition -->

- some content

- <!-- ENDIF -->

-

- If we were to simply preserve all whitespace, we could simply

- replace all "?>" tags with "?>\n".

- Doing that, would add additional newlines to the compiled

- template in place of the IF and ENDIF statements. These

- newlines are unwanted (and one is conditional). The IF and

- ENDIF are usually on their own line for ease of reading.

-

- This replacement preserves newlines only for statements that

- are not the only statement on a line. It will NOT preserve

- newlines at the end of statements in the above example.

- It will preserve newlines in situations like:

-

- <!-- IF condition -->inline content<!-- ENDIF -->

-

- */

-

- $data = preg_replace('~(?<!^)(<\?php.+(?<!/\*\*/)\?>)$~m', "$1\n", $data);

- $data = str_replace('/**/?>', "?>\n", $data);

- $data = str_replace('?><?php', '', $data);

- }

-

- return $data;

- }

-

- /**

- * Prepends a preamble to compiled template.

- * Currently preamble checks if IN_PHPBB is defined and calls exit() if it is not.

- *

- * @param string $data Compiled template chunk

- * @return string Compiled template chunk with preamble prepended

- */

- private function prepend_preamble($data)

- {

- $data = "<?php if (!defined('IN_PHPBB')) exit;" . ((strncmp($data, '<?php', 5) === 0) ? substr($data, 5) : ' ?>' . $data);

- return $data;

- }

-

- /**

- * Callback for replacing matched tokens with compiled template code.

- *

- * Compiled template code is an HTML stream with embedded PHP.

- *

- * @param array $matches Regular expression matches

- * @return string compiled template code

- */

- private function replace($matches)

- {

- if ($this->in_php && $matches[1] != 'ENDPHP')

- {

- return '';

- }

-

- if (isset($matches[3]))

- {

- return $this->compile_var_tags($matches[0]);

- }

-

- switch ($matches[1])

- {

- case 'BEGIN':

- $this->block_else_level[] = false;

- return '<?php ' . $this->compile_tag_block($matches[2]) . ' ?>';

- break;

-

- case 'BEGINELSE':

- $this->block_else_level[sizeof($this->block_else_level) - 1] = true;

- return '<?php }} else { ?>';

- break;

-

- case 'END':

- array_pop($this->block_names);

- return '<?php ' . ((array_pop($this->block_else_level)) ? '}' : '}}') . ' ?>';

- break;

-

- case 'IF':

- return '<?php ' . $this->compile_tag_if($matches[2], false) . ' ?>';

- break;

-

- case 'ELSE':

- return '<?php } else { ?>';

- break;

-

- case 'ELSEIF':

- return '<?php ' . $this->compile_tag_if($matches[2], true) . ' ?>';

- break;

-

- case 'ENDIF':

- return '<?php } ?>';

- break;

-

- case 'DEFINE':

- return '<?php ' . $this->compile_tag_define($matches[2], true) . ' ?>';

- break;

-

- case 'UNDEFINE':

- return '<?php ' . $this->compile_tag_define($matches[2], false) . ' ?>';

- break;

-

- case 'ENDDEFINE':

- return '<?php ' . $this->compile_tag_enddefine() . ' ?>';

- break;

-

- case 'INCLUDE':

- return '<?php ' . $this->compile_tag_include($matches[2]) . ' ?>';

- break;

-

- case 'INCLUDEPHP':

- return ($this->allow_php) ? '<?php ' . $this->compile_tag_include_php($matches[2]) . ' ?>' : '';

- break;

-

- case 'INCLUDEJS':

- return '<?php ' . $this->compile_tag_include_js($matches[2]) . ' ?>';

- break;

-

- case 'PHP':

- if ($this->allow_php)

- {

- $this->in_php = true;

- return '<?php ';

- }

- return '<!-- PHP -->';

- break;

-

- case 'ENDPHP':

- if ($this->allow_php)

- {

- $this->in_php = false;

- return ' ?>';

- }

- return '<!-- ENDPHP -->';

- break;

-

- case 'EVENT':

- return '<?php ' . $this->compile_tag_event($matches[2]) . '?>';

- break;

-

- default:

- return $matches[0];

- break;

-

- }

- return '';

- }

-

- /**

- * Convert template variables into PHP varrefs

- *

- * @param string $text_blocks Variable reference in source template

- * @param bool $is_expr Returns whether the source was an expression type variable (i.e. S_FIRST_ROW)

- * @return string PHP variable name

- */

- private function get_varref($text_blocks, &$is_expr)

- {

- // change template varrefs into PHP varrefs

- $varrefs = array();

-

- // This one will handle varrefs WITH namespaces

- preg_match_all('#\{((?:' . self::REGEX_NS . '\.)+)(\$)?(' . self::REGEX_VAR . ')\}#', $text_blocks, $varrefs, PREG_SET_ORDER);

-

- foreach ($varrefs as $var_val)

- {

- $namespace = $var_val[1];

- $varname = $var_val[3];

- $new = $this->generate_block_varref($namespace, $varname, $is_expr, $var_val[2]);

-

- $text_blocks = str_replace($var_val[0], $new, $text_blocks);

- }

-

- // Language variables cannot be reduced to a single varref, so they must be skipped

- // These two replacements would break language variables, so we can only run them on non-language types

- if (strpos($text_blocks, '{L_') === false && strpos($text_blocks, '{LA_') === false)

- {

- // This will handle the remaining root-level varrefs

- $text_blocks = preg_replace('#\{(' . self::REGEX_VAR . ')\}#', "\$_rootref['\\1']", $text_blocks);

- $text_blocks = preg_replace('#\{\$(' . self::REGEX_VAR . ')\}#', "\$_tpldata['DEFINE']['.']['\\1']", $text_blocks);

- }

-

- return $text_blocks;

- }

-

- /**

- * Parse paths of the form {FOO}/a/{BAR}/b

- *

- * Note: this method assumes at least one variable in the path, this should

- * be checked before this method is called.

- *

- * @param string $path The path to parse

- * @param string $include_type The type of template function to call

- * @return string An appropriately formatted string to include in the

- * template or an empty string if an expression like S_FIRST_ROW was

- * incorrectly used

- */

- private function parse_dynamic_path($path, $include_type)

- {

- $matches = array();

- $replace = array();

- $is_expr = true;

-

- preg_match_all('#\{((?:' . self::REGEX_NS . '\.)*)(\$)?(' . self::REGEX_VAR . ')\}#', $path, $matches);

- foreach ($matches[0] as $var_str)

- {

- $tmp_is_expr = false;

- $var = $this->get_varref($var_str, $tmp_is_expr);

- $is_expr = $is_expr && $tmp_is_expr;

- $replace[] = "' . $var . '";

- }

-

- if (!$is_expr)

- {

- return " \$_template->$include_type('" . str_replace($matches[0], $replace, $path) . "', true);";

- }

- else

- {

- return '';

- }

- }

-

- /**

- * Compile variables

- *

- * @param string $text_blocks Variable reference in source template

- * @return string compiled template code

- */

- private function compile_var_tags(&$text_blocks)

- {

- $is_expr = null;

- $text_blocks = $this->get_varref($text_blocks, $is_expr);

- $lang_replaced = $this->compile_language_tags($text_blocks);

-

- if(!$lang_replaced)

- {

- $text_blocks = '<?php echo ' . ($is_expr ? "$text_blocks" : "(isset($text_blocks)) ? $text_blocks : ''") . '; /**/?>';

- }

-

- return $text_blocks;

- }

-

- /**

- * Handles special language tags L_ and LA_

- *

- * @param string $text_blocks Variable reference in source template

- * @return bool Whether a replacement occurred or not

- */

- private function compile_language_tags(&$text_blocks)

- {

- $replacements = 0;

-

- // transform vars prefixed by L_ into their language variable pendant if nothing is set within the tpldata array

- if (strpos($text_blocks, '{L_') !== false)

- {

- $text_blocks = preg_replace('#\{L_(' . self::REGEX_VAR_SUFFIX . ')\}#', "<?php echo ((isset(\$_rootref['L_\\1'])) ? \$_rootref['L_\\1'] : ((isset(\$_lang['\\1'])) ? \$_lang['\\1'] : '{ \\1 }')); /**/?>", $text_blocks, -1, $replacements);

- return (bool) $replacements;

- }

-

- // Handle addslashed language variables prefixed with LA_

- // If a template variable already exist, it will be used in favor of it...

- if (strpos($text_blocks, '{LA_') !== false)

- {

- $text_blocks = preg_replace('#\{LA_(' . self::REGEX_VAR_SUFFIX . '+)\}#', "<?php echo ((isset(\$_rootref['LA_\\1'])) ? \$_rootref['LA_\\1'] : ((isset(\$_rootref['L_\\1'])) ? addslashes(\$_rootref['L_\\1']) : ((isset(\$_lang['\\1'])) ? addslashes(\$_lang['\\1']) : '{ \\1 }'))); /**/?>", $text_blocks, -1, $replacements);

- return (bool) $replacements;

- }

-

- return false;

- }

-

- /**

- * Compile blocks

- *

- * @param string $tag_args Block contents in source template

- * @return string compiled template code

- */

- private function compile_tag_block($tag_args)

- {

- $no_nesting = false;

-

- // Is the designer wanting to call another loop in a loop?

- // <!-- BEGIN loop -->

- // <!-- BEGIN !loop2 -->

- // <!-- END !loop2 -->

- // <!-- END loop -->

- // 'loop2' is actually on the same nesting level as 'loop' you assign

- // variables to it with template->assign_block_vars('loop2', array(...))

- if (strpos($tag_args, '!') === 0)

- {

- // Count the number if ! occurrences (not allowed in vars)

- $no_nesting = substr_count($tag_args, '!');

- $tag_args = substr($tag_args, $no_nesting);

- }

-

- // Allow for control of looping (indexes start from zero):

- // foo(2) : Will start the loop on the 3rd entry

- // foo(-2) : Will start the loop two entries from the end

- // foo(3,4) : Will start the loop on the fourth entry and end it on the fifth

- // foo(3,-4) : Will start the loop on the fourth entry and end it four from last

- $match = array();

-

- if (preg_match('#^([^()]*)\(([\-\d]+)(?:,([\-\d]+))?\)$#', $tag_args, $match))

- {

- $tag_args = $match[1];

-

- if ($match[2] < 0)

- {

- $loop_start = '($_' . $tag_args . '_count ' . $match[2] . ' < 0 ? 0 : $_' . $tag_args . '_count ' . $match[2] . ')';

- }

- else

- {

- $loop_start = '($_' . $tag_args . '_count < ' . $match[2] . ' ? $_' . $tag_args . '_count : ' . $match[2] . ')';

- }

-

- if (!isset($match[3]) || strlen($match[3]) < 1 || $match[3] == -1)

- {

- $loop_end = '$_' . $tag_args . '_count';

- }

- else if ($match[3] >= 0)

- {

- $loop_end = '(' . ($match[3] + 1) . ' > $_' . $tag_args . '_count ? $_' . $tag_args . '_count : ' . ($match[3] + 1) . ')';

- }

- else //if ($match[3] < -1)

- {

- $loop_end = '$_' . $tag_args . '_count' . ($match[3] + 1);

- }

- }

- else

- {

- $loop_start = 0;

- $loop_end = '$_' . $tag_args . '_count';

- }

-

- $tag_template_php = '';

- array_push($this->block_names, $tag_args);

-

- if ($no_nesting !== false)

- {

- // We need to implode $no_nesting times from the end...

- $block = array_slice($this->block_names, -$no_nesting);

- }

- else

- {

- $block = $this->block_names;

- }

-

- if (sizeof($block) < 2)

- {

- // Block is not nested.

- $tag_template_php = '$_' . $tag_args . "_count = (isset(\$_tpldata['$tag_args'])) ? sizeof(\$_tpldata['$tag_args']) : 0;";

- $varref = "\$_tpldata['$tag_args']";

- }

- else

- {

- // This block is nested.

- // Generate a namespace string for this block.

- $namespace = implode('.', $block);

-

- // Get a reference to the data array for this block that depends on the

- // current indices of all parent blocks.

- $varref = $this->generate_block_data_ref($namespace, false);

-

- // Create the for loop code to iterate over this block.

- $tag_template_php = '$_' . $tag_args . '_count = (isset(' . $varref . ')) ? sizeof(' . $varref . ') : 0;';

- }

-

- $tag_template_php .= 'if ($_' . $tag_args . '_count) {';

-

- /**

- * The following uses foreach for iteration instead of a for loop, foreach is faster but requires PHP to make a copy of the contents of the array which uses more memory

- * <code>

- * if (!$offset)

- * {

- * $tag_template_php .= 'foreach (' . $varref . ' as $_' . $tag_args . '_i => $_' . $tag_args . '_val){';

- * }

- * </code>

- */

-

- $tag_template_php .= 'for ($_' . $tag_args . '_i = ' . $loop_start . '; $_' . $tag_args . '_i < ' . $loop_end . '; ++$_' . $tag_args . '_i){';

- $tag_template_php .= '$_' . $tag_args . '_val = &' . $varref . '[$_' . $tag_args . '_i];';

-

- return $tag_template_php;

- }

-

- /**

- * Compile a general expression - much of this is from Smarty with

- * some adaptions for our block level methods

- *

- * @param string $tag_args Expression (tag arguments) in source template

- * @return string compiled template code

- */

- private function compile_expression($tag_args)

- {

- $match = array();

- preg_match_all('/(?:

- "[^"\\\\]*(?:\\\\.[^"\\\\]*)*" |

- \'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*\' |

- [(),] |

- [^\s(),]+)/x', $tag_args, $match);

-

- $tokens = $match[0];

- $is_arg_stack = array();

-

- for ($i = 0, $size = sizeof($tokens); $i < $size; $i++)

- {

- $token = &$tokens[$i];

-

- switch ($token)

- {

- case '!==':

- case '===':

- case '<<':

- case '>>':

- case '|':

- case '^':

- case '&':

- case '~':

- case ')':

- case ',':

- case '+':

- case '-':

- case '*':

- case '/':

- case '@':

- break;

-

- case '==':

- case 'eq':

- $token = '==';

- break;

-

- case '!=':

- case '<>':

- case 'ne':

- case 'neq':

- $token = '!=';

- break;

-

- case '<':

- case 'lt':

- $token = '<';

- break;

-

- case '<=':

- case 'le':

- case 'lte':

- $token = '<=';

- break;

-

- case '>':

- case 'gt':

- $token = '>';

- break;

-

- case '>=':

- case 'ge':

- case 'gte':

- $token = '>=';

- break;

-

- case '&&':

- case 'and':

- $token = '&&';

- break;

-

- case '||':

- case 'or':

- $token = '||';

- break;

-

- case '!':

- case 'not':

- $token = '!';

- break;

-

- case '%':

- case 'mod':

- $token = '%';

- break;

-

- case '(':

- array_push($is_arg_stack, $i);

- break;

-

- case 'is':

- $is_arg_start = ($tokens[$i-1] == ')') ? array_pop($is_arg_stack) : $i-1;

- $is_arg = implode(' ', array_slice($tokens, $is_arg_start, $i - $is_arg_start));

-

- $new_tokens = $this->_parse_is_expr($is_arg, array_slice($tokens, $i+1));

-

- array_splice($tokens, $is_arg_start, sizeof($tokens), $new_tokens);

-

- $i = $is_arg_start;

-

- // no break

-

- default:

- $varrefs = array();

- if (preg_match('#^((?:' . self::REGEX_NS . '\.)+)?(\$)?(?=[A-Z])([A-Z0-9\-_]+)#s', $token, $varrefs))

- {

- if (!empty($varrefs[1]))

- {

- $namespace = substr($varrefs[1], 0, -1);

- $dot_pos = strrchr($namespace, '.');

- if ($dot_pos !== false)

- {

- $namespace = substr($dot_pos, 1);

- }

-

- // S_ROW_COUNT is deceptive, it returns the current row number not the number of rows

- // hence S_ROW_COUNT is deprecated in favour of S_ROW_NUM

- switch ($varrefs[3])

- {

- case 'S_ROW_NUM':

- case 'S_ROW_COUNT':

- $token = "\$_${namespace}_i";

- break;

-

- case 'S_NUM_ROWS':

- $token = "\$_${namespace}_count";

- break;

-

- case 'S_FIRST_ROW':

- $token = "(\$_${namespace}_i == 0)";

- break;

-

- case 'S_LAST_ROW':

- $token = "(\$_${namespace}_i == \$_${namespace}_count - 1)";

- break;

-

- case 'S_BLOCK_NAME':

- $token = "'$namespace'";

- break;

-

- default:

- $token = $this->generate_block_data_ref(substr($varrefs[1], 0, -1), true, $varrefs[2]) . '[\'' . $varrefs[3] . '\']';

- $token = '(isset(' . $token . ') ? ' . $token . ' : null)';

- break;

- }

- }

- else

- {

- $token = ($varrefs[2]) ? '$_tpldata[\'DEFINE\'][\'.\'][\'' . $varrefs[3] . '\']' : '$_rootref[\'' . $varrefs[3] . '\']';

- $token = '(isset(' . $token . ') ? ' . $token . ' : null)';

- }

-

- }

- else if (preg_match('#^\.((?:' . self::REGEX_NS . '\.?)+)$#s', $token, $varrefs))

- {

- // Allow checking if loops are set with .loopname

- // It is also possible to check the loop count by doing <!-- IF .loopname > 1 --> for example

- $blocks = explode('.', $varrefs[1]);

-

- // If the block is nested, we have a reference that we can grab.

- // If the block is not nested, we just go and grab the block from _tpldata

- if (sizeof($blocks) > 1)

- {

- $block = array_pop($blocks);

- $namespace = implode('.', $blocks);

- $varref = $this->generate_block_data_ref($namespace, true);

-

- // Add the block reference for the last child.

- $varref .= "['" . $block . "']";

- }

- else

- {

- $varref = '$_tpldata';

-

- // Add the block reference for the last child.

- $varref .= "['" . $blocks[0] . "']";

- }

- $token = "(isset($varref) ? sizeof($varref) : 0)";

- }

-

- break;

- }

- }

-

- return $tokens;

- }

-

- /**

- * Compile IF tags

- *

- * @param string $tag_args Expression given with IF in source template

- * @param bool $elseif True if compiling an IF tag, false if compiling an ELSEIF tag

- * @return string compiled template code

- */

- private function compile_tag_if($tag_args, $elseif)

- {

- $tokens = $this->compile_expression($tag_args);

-

- $tpl = ($elseif) ? '} else if (' : 'if (';

-

- $tpl .= implode(' ', $tokens);

- $tpl .= ') { ';

-

- return $tpl;

- }

-

- /**

- * Compile DEFINE tags

- *

- * @param string $tag_args Expression given with DEFINE in source template

- * @param bool $op True if compiling a DEFINE tag, false if compiling an UNDEFINE tag

- * @return string compiled template code

- */

- private function compile_tag_define($tag_args, $op)

- {

- $match = array();

- preg_match('#^((?:' . self::REGEX_NS . '\.)+)?\$(?=[A-Z])([A-Z0-9_\-]*)(?: = (.*?))?$#', $tag_args, $match);

-

- if (!empty($match[2]) && !isset($match[3]) && $op)

- {

- // DEFINE tag with ENDDEFINE

- $array = "\$_tpldata['DEFINE']['.vars']";

- $code = 'ob_start(); ';

- $code .= "if (!isset($array)) { $array = array(); } ";

- $code .= "{$array}[] = '{$match[2]}'";

- return $code;

- }

-

- if (empty($match[2]) || (!isset($match[3]) && $op))

- {

- return '';

- }

-

- if (!$op)

- {

- return 'unset(' . (($match[1]) ? $this->generate_block_data_ref(substr($match[1], 0, -1), true, true) . '[\'' . $match[2] . '\']' : '$_tpldata[\'DEFINE\'][\'.\'][\'' . $match[2] . '\']') . ');';

- }

-

- /*

- * Define tags that contain template variables (enclosed in curly brackets)

- * need to be treated differently.

- */

- if (substr($match[3], 1, 1) == '{' && substr($match[3], -2, 1) == '}')

- {

- $parsed_statement = implode(' ', $this->compile_expression(substr($match[3], 2, -2)));

- }

- else

- {

- $parsed_statement = implode(' ', $this->compile_expression($match[3]));

- }

-

- return (($match[1]) ? $this->generate_block_data_ref(substr($match[1], 0, -1), true, true) . '[\'' . $match[2] . '\']' : '$_tpldata[\'DEFINE\'][\'.\'][\'' . $match[2] . '\']') . ' = ' . $parsed_statement . ';';

- }

-

- /**

- * Compile ENDDEFINE tag

- *

- * @return string compiled template code

- */

- private function compile_tag_enddefine()

- {

- $array = "\$_tpldata['DEFINE']['.vars']";

- $code = "if (!isset($array) || !sizeof($array)) { trigger_error('ENDDEFINE tag without DEFINE in ' . basename(__FILE__), E_USER_ERROR); }";

- $code .= "\$define_var = array_pop($array); ";

- $code .= "\$_tpldata['DEFINE']['.'][\$define_var] = ob_get_clean();";

- return $code;

- }

-

- /**

- * Compile INCLUDE tag

- *

- * @param string $tag_args Expression given with INCLUDE in source template

- * @return string compiled template code

- */

- private function compile_tag_include($tag_args)

- {

- // Process dynamic includes

- if (strpos($tag_args, '{') !== false)

- {

- return $this->parse_dynamic_path($tag_args, '_tpl_include');

- }

-

- return "\$_template->_tpl_include('$tag_args');";

- }

-

- /**

- * Compile INCLUDE_PHP tag

- *

- * @param string $tag_args Expression given with INCLUDEPHP in source template

- * @return string compiled template code

- */

- private function compile_tag_include_php($tag_args)

- {

- if (strpos($tag_args, '{') !== false)

- {

- return $this->parse_dynamic_path($tag_args, '_php_include');

- }

-

- return "\$_template->_php_include('$tag_args');";

- }

-

- /**

- * Compile EVENT tag.

- *

- * $tag_args should be a single string identifying the event.

- * The event name can contain letters, numbers and underscores only.

- * If an invalid event name is specified, an E_USER_ERROR will be

- * triggered.

- *

- * Event tags are only functional when the template engine has

- * an instance of the extension manager. Extension manager would

- * be called upon to find all extensions listening for the specified

- * event, and to obtain additional template fragments. All such

- * template fragments will be compiled and included in the generated

- * compiled template code for the current template being compiled.

- *

- * The above means that whenever an extension is enabled or disabled,

- * template cache should be cleared in order to update the compiled

- * template code for the active set of template event listeners.

- *

- * This also means that extensions cannot return different template

- * fragments at different times. Once templates are compiled, changing

- * such template fragments would have no effect.

- *

- * @param string $tag_args EVENT tag arguments, as a string - for EVENT this is the event name

- * @return string compiled template code

- */

- private function compile_tag_event($tag_args)

- {

- if (!preg_match('/^\w+$/', $tag_args))

- {

- // The event location is improperly formatted,

- if ($this->user)

- {

- trigger_error($this->user->lang('ERR_TEMPLATE_EVENT_LOCATION', $tag_args), E_USER_ERROR);

- }

- else

- {

- trigger_error(sprintf('The specified template event location <em>[%s]</em> is improperly formatted.', $tag_args), E_USER_ERROR);

- }

- }

- $location = $tag_args;

-

- if ($this->extension_manager)

- {

- $finder = $this->extension_manager->get_finder();

-

- $files = $finder

- ->extension_prefix($location)

- ->extension_suffix('.html')

- ->extension_directory("/styles/all/template")

- ->get_files();

-

- foreach ($this->style_names as $style_name)

- {

- $more_files = $finder

- ->extension_prefix($location)

- ->extension_suffix('.html')

- ->extension_directory("/styles/" . $style_name . "/template")

- ->get_files();

- if (!empty($more_files))

- {

- $files = array_merge($files, $more_files);

- break;

- }

- }

-

- $all_compiled = '';

- foreach ($files as $file)

- {

- $this->template_compile->set_filter_params(array(

- 'cleanup' => false,

- ));

-

- $compiled = $this->template_compile->compile_file($file);

-

- $this->template_compile->reset_filter_params();

-

- if ($compiled === false)

- {

- if ($this->user)

- {

- trigger_error($this->user->lang('ERR_TEMPLATE_COMPILATION', phpbb_filter_root_path($file)), E_USER_ERROR);

- }

- else

- {

- trigger_error(sprintf('The file could not be compiled: %s', phpbb_filter_root_path($file)), E_USER_ERROR);

- }

- }

-

- $all_compiled .= $compiled;

- }

- // Need spaces inside php tags as php cannot grok

- // < ?php? > sans the spaces

- return ' ?' . '>' . $all_compiled . '<?php ';

- }

- }

-

- /**

- * parse expression

- * This is from Smarty

- */

- private function _parse_is_expr($is_arg, $tokens)

- {

- $expr_end = 0;

- $negate_expr = false;

-

- if (($first_token = array_shift($tokens)) == 'not')

- {

- $negate_expr = true;

- $expr_type = array_shift($tokens);

- }

- else

- {

- $expr_type = $first_token;

- }

-

- switch ($expr_type)

- {

- case 'even':

- if (isset($tokens[$expr_end]) && $tokens[$expr_end] == 'by')

- {

- $expr_end++;

- $expr_arg = $tokens[$expr_end++];

- $expr = "!(($is_arg / $expr_arg) & 1)";

- }

- else

- {

- $expr = "!($is_arg & 1)";

- }

- break;

-

- case 'odd':

- if (isset($tokens[$expr_end]) && $tokens[$expr_end] == 'by')

- {

- $expr_end++;

- $expr_arg = $tokens[$expr_end++];

- $expr = "(($is_arg / $expr_arg) & 1)";

- }

- else

- {

- $expr = "($is_arg & 1)";

- }

- break;

-

- case 'div':

- if (isset($tokens[$expr_end]) && $tokens[$expr_end] == 'by')

- {

- $expr_end++;

- $expr_arg = $tokens[$expr_end++];

- $expr = "!($is_arg % $expr_arg)";

- }

- break;

- }

-

- if ($negate_expr)

- {

- if ($expr[0] == '!')

- {

- // Negated expression, de-negate it.

- $expr = substr($expr, 1);

- }

- else

- {

- $expr = "!($expr)";

- }

- }

-

- array_splice($tokens, 0, $expr_end, $expr);

-

- return $tokens;

- }

-

- /**

- * Compile INCLUDEJS tag

- *

- * @param string $tag_args Expression given with INCLUDEJS in source template

- * @return string compiled template code

- */

- private function compile_tag_include_js($tag_args)

- {

- // Process dynamic includes

- if (strpos($tag_args, '{') !== false)

- {

- return $this->parse_dynamic_path($tag_args, '_js_include');

- }

-

- // Locate file

- $filename = $this->locator->get_first_file_location(array($tag_args), false, true);

-

- if ($filename === false)

- {

- // File does not exist, find it during run time

- return ' $_template->_js_include(\'' . addslashes($tag_args) . '\', true); ';

- }

-

- if (substr($filename, 0, strlen($this->phpbb_root_path)) != $this->phpbb_root_path)

- {

- // Absolute path, include as is

- return ' $_template->_js_include(\'' . addslashes($filename) . '\', false, false); ';

- }

-

- // Relative path, remove root path from it

- $filename = substr($filename, strlen($this->phpbb_root_path));

- return ' $_template->_js_include(\'' . addslashes($filename) . '\', false, true); ';

- }

-

- /**

- * Generates a reference to the given variable inside the given (possibly nested)

- * block namespace. This is a string of the form:

- * ' . $_tpldata['parent'][$_parent_i]['$child1'][$_child1_i]['$child2'][$_child2_i]...['varname'] . '

- * It's ready to be inserted into an "echo" line in one of the templates.

- *

- * @param string $namespace Namespace to access (expects a trailing "." on the namespace)

- * @param string $varname Variable name to use

- * @param bool $expr Returns whether the source was an expression type

- * @param bool $defop If true this is a variable created with the DEFINE construct, otherwise template variable

- * @return string Code to access variable or echo it if $echo is true

- */

- private function generate_block_varref($namespace, $varname, &$expr, $defop = false)

- {

- // Strip the trailing period.

- $namespace = substr($namespace, 0, -1);

-

- if (($pos = strrpos($namespace, '.')) !== false)

- {

- $local_namespace = substr($namespace, $pos + 1);

- }

- else

- {

- $local_namespace = $namespace;

- }

-

- $expr = true;

-

- // S_ROW_COUNT is deceptive, it returns the current row number now the number of rows

- // hence S_ROW_COUNT is deprecated in favour of S_ROW_NUM

- switch ($varname)

- {

- case 'S_ROW_NUM':

- case 'S_ROW_COUNT':

- $varref = "\$_${local_namespace}_i";

- break;

-

- case 'S_NUM_ROWS':

- $varref = "\$_${local_namespace}_count";

- break;

-

- case 'S_FIRST_ROW':

- $varref = "(\$_${local_namespace}_i == 0)";

- break;

-

- case 'S_LAST_ROW':

- $varref = "(\$_${local_namespace}_i == \$_${local_namespace}_count - 1)";

- break;

-

- case 'S_BLOCK_NAME':

- $varref = "'$local_namespace'";

- break;

-

- default:

- // Get a reference to the data block for this namespace.

- $varref = $this->generate_block_data_ref($namespace, true, $defop);

- // Prepend the necessary code to stick this in an echo line.

-

- // Append the variable reference.

- $varref .= "['$varname']";

-

- $expr = false;

- break;

- }

- // @todo Test the !$expr more

-

- return $varref;

- }

-

- /**

- * Generates a reference to the array of data values for the given

- * (possibly nested) block namespace. This is a string of the form:

- * $_tpldata['parent'][$_parent_i]['$child1'][$_child1_i]['$child2'][$_child2_i]...['$childN']

- *

- * @param string $blockname Block to access (does not expect a trailing "." on the blockname)

- * @param bool $include_last_iterator If $include_last_iterator is true, then [$_childN_i] will be appended to the form shown above.

- * @param bool $defop If true this is a variable created with the DEFINE construct, otherwise template variable

- * @return string Code to access variable

- */

- private function generate_block_data_ref($blockname, $include_last_iterator, $defop = false)

- {

- // Get an array of the blocks involved.

- $blocks = explode('.', $blockname);

- $blockcount = sizeof($blocks) - 1;

-

- // DEFINE is not an element of any referenced variable, we must use _tpldata to access it

- if ($defop)

- {

- $varref = '$_tpldata[\'DEFINE\']';

- // Build up the string with everything but the last child.

- for ($i = 0; $i < $blockcount; $i++)

- {

- $varref .= "['" . $blocks[$i] . "'][\$_" . $blocks[$i] . '_i]';

- }

- // Add the block reference for the last child.

- $varref .= "['" . $blocks[$blockcount] . "']";

- // Add the iterator for the last child if requried.

- if ($include_last_iterator)

- {

- $varref .= '[$_' . $blocks[$blockcount] . '_i]';

- }

- return $varref;

- }

- else if ($include_last_iterator)

- {

- return '$_'. $blocks[$blockcount] . '_val';

- }

- else

- {

- return '$_'. $blocks[$blockcount - 1] . '_val[\''. $blocks[$blockcount]. '\']';

- }

- }

-}

-<?php

-/**

-*

-* @package phpBB3

-* @copyright (c) 2011 phpBB Group

-* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

-*

-*/

-

-/**

-* @ignore

-*/

-if (!defined('IN_PHPBB'))

-{

- exit;

-}

-

-/**

-* Template renderer interface.

-*

-* Objects implementing this interface encapsulate a means of displaying

-* a template.

-*

-* @package phpBB3

-*/

-interface phpbb_template_renderer

-{

- /**

- * Displays the template managed by this renderer.

- *

- * @param phpbb_template_context $context Template context to use

- * @param array $lang Language entries to use

- */

- public function render($context, $lang);

-}

-<?php

-/**

-*

-* @package phpBB3

-* @copyright (c) 2011 phpBB Group

-* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

-*

-*/

-

-/**

-* @ignore

-*/

-if (!defined('IN_PHPBB'))

-{

- exit;

-}

-

-/**

-* Template renderer that stores compiled template's php code and

-* displays it via eval.

-*

-* @package phpBB3

-*/

-class phpbb_template_renderer_eval implements phpbb_template_renderer

-{

- /**

- * Template code to be eval'ed.

- */

- private $code;

-

- /**

- * Constructor. Stores provided code for future evaluation.

- * Template includes are delegated to template object $template.

- *

- * @param string $code php code of the template

- * @param phpbb_template $template template object

- */

- public function __construct($code, $template)

- {

- $this->code = $code;

- $this->template = $template;

- }

-

- /**

- * Displays the template managed by this renderer by eval'ing php code

- * of the template.

- *

- * @param phpbb_template_context $context Template context to use

- * @param array $lang Language entries to use

- */

- public function render($context, $lang)

- {

- $_template = $this->template;

- $_tpldata = &$context->get_data_ref();

- $_rootref = &$context->get_root_ref();

- $_lang = $lang;

-

- eval(' ?>' . $this->code . '<?php ');

- }

-}

-<?php

-/**

-*

-* @package phpBB3

-* @copyright (c) 2011 phpBB Group

-* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

-*

-*/

-

-/**

-* @ignore

-*/

-if (!defined('IN_PHPBB'))

-{

- exit;

-}

-

-

-/**

-* Template renderer that stores path to php file with template code

-* and displays it by including the file.

-*

-* @package phpBB3

-*/

-class phpbb_template_renderer_include implements phpbb_template_renderer

-{

- /**

- * Template path to be included.

- */

- private $path;

-

- /**

- * Constructor. Stores path to the template for future inclusion.

- * Template includes are delegated to template object $template.

- *

- * @param string $path path to the template

- */

- public function __construct($path, $template)

- {

- $this->path = $path;

- $this->template = $template;

- }

-

- /**

- * Displays the template managed by this renderer by including

- * the php file containing the template.

- *

- * @param phpbb_template_context $context Template context to use

- * @param array $lang Language entries to use

- */

- public function render($context, $lang)

- {

- $_template = $this->template;

- $_tpldata = &$context->get_data_ref();

- $_rootref = &$context->get_root_ref();

- $_lang = $lang;

-

- include($this->path);

- }

-}

-* @copyright (c) 2005 phpBB Group, sections (c) 2001 ispi of Lincoln Inc

-/**

-* @todo

-* IMG_ for image substitution?

-* {IMG_[key]:[alt]:[type]}

-* {IMG_ICON_CONTACT:CONTACT:full} -> $user->img('icon_contact', 'CONTACT', 'full');

-*

-* More in-depth...

-* yadayada

-*/

-

-/**

-* Base Template class.

-* @package phpBB3

-*/

-class phpbb_template

- /**

- * Template context.

- * Stores template data used during template rendering.

- * @var phpbb_template_context

- */

- private $context;

-

- /**

- * Path of the cache directory for the template

- * @var string

- */

- public $cachepath = '';

-

- /**

- * phpBB root path

- * @var string

- */

- private $phpbb_root_path;

-

- /**

- * PHP file extension

- * @var string

- */

- private $php_ext;

-

- /**

- * phpBB config instance

- * @var phpbb_config

- */

- private $config;

-

- /**

- * Current user

- * @var phpbb_user

- */

- private $user;

-

- /**

- * Template locator

- * @var phpbb_template_locator

- */

- private $locator;

-

- /**

- * Extension manager.

- *

- * @var phpbb_extension_manager

- */

- private $extension_manager;

-

- /**

- * Name of the style that the template being compiled and/or rendered

- * belongs to, and its parents, in inheritance tree order.

- *

- * Used to invoke style-specific template events.

- *

- * @var array

- */

- private $style_names;

- * Constructor.

- * @param string $phpbb_root_path phpBB root path

- * @param user $user current user

- * @param phpbb_template_locator $locator template locator

- * @param phpbb_template_context $context template context

- * @param phpbb_extension_manager $extension_manager extension manager, if null then template events will not be invoked

- public function __construct($phpbb_root_path, $php_ext, $config, $user, phpbb_template_locator $locator, phpbb_template_context $context, phpbb_extension_manager $extension_manager = null)

- {

- $this->phpbb_root_path = $phpbb_root_path;

- $this->php_ext = $php_ext;

- $this->config = $config;

- $this->user = $user;

- $this->locator = $locator;

- $this->context = $context;

- $this->extension_manager = $extension_manager;

- }

- public function set_filenames(array $filename_array)

- {

- $this->locator->set_filenames($filename_array);

-

- return true;

- }

- * Sets the style names corresponding to style hierarchy being compiled

- * @return null

- public function set_style_names(array $style_names)

- {

- $this->style_names = $style_names;

- }

- public function destroy()

- {

- $this->context->clear();

- }

- public function destroy_block_vars($blockname)

- {

- $this->context->destroy_block_vars($blockname);

- }

- * @return bool True on success, false on failure

- */

- public function display($handle)

- {

- $result = $this->call_hook($handle, __FUNCTION__);

- if ($result !== false)

- {

- return $result[0];

- }

-

- return $this->load_and_render($handle);

- }

-

- /**

- * Loads a template for $handle, compiling it if necessary, and

- * renders the template.

- *

- * @param string $handle Template handle to render

- * @return bool True on success, false on failure

- */

- private function load_and_render($handle)

- {

- $renderer = $this->_tpl_load($handle);

-

- if ($renderer)

- {

- $renderer->render($this->context, $this->get_lang());

- return true;

- }

- else

- {

- return false;

- }

- }

-

- /**

- * Calls hook if any is defined.

- *

- * @param string $handle Template handle being displayed.

- * @param string $method Method name of the caller.

- private function call_hook($handle, $method)

- {

- global $phpbb_hook;

-

- if (!empty($phpbb_hook) && $phpbb_hook->call_hook(array(__CLASS__, $method), $handle, $this))

- {

- if ($phpbb_hook->hook_return(array(__CLASS__, $method)))

- {

- $result = $phpbb_hook->hook_return_result(array(__CLASS__, $method));

- return array($result);

- }

- }

-

- return false;

- }

-

- /**

- * Obtains language array.

- * This is either lang property of $user property, or if

- * it is not set an empty array.

- * @return array language entries

- */

- public function get_lang()

- {

- if (isset($this->user->lang))

- {

- $lang = $this->user->lang;

- }

- else

- {

- $lang = array();

- }

- return $lang;

- }

- * @return bool|string false on failure, otherwise if $return_content is true return string of the compiled handle, otherwise return true

- */

- public function assign_display($handle, $template_var = '', $return_content = true)

- {

- ob_start();

- $result = $this->display($handle);

- $contents = ob_get_clean();

- if ($result === false)

- {

- return false;

- }

-

- if ($return_content)

- {

- return $contents;

- }

-

- $this->assign_var($template_var, $contents);

-

- return true;

- }

-

- /**

- * Obtains a template renderer for a template identified by specified

- * handle. The template renderer can display the template later.

- *

- * Template source will first be compiled into php code.

- * If template cache is writable the compiled php code will be stored

- * on filesystem and template will not be subsequently recompiled.

- * If template cache is not writable template source will be recompiled

- * every time it is needed. DEBUG define and load_tplcompile

- * configuration setting may be used to force templates to be always

- * recompiled.

- *

- * Returns an object implementing phpbb_template_renderer, or null

- * if template loading or compilation failed. Call render() on the

- * renderer to display the template. This will result in template

- * contents sent to the output stream (unless, of course, output

- * buffering is in effect).

- *

- * @param string $handle Handle of the template to load

- * @return phpbb_template_renderer Template renderer object, or null on failure

- * @uses phpbb_template_compile is used to compile template source

- */

- private function _tpl_load($handle)

- {

- $output_file = $this->_compiled_file_for_handle($handle);

-

- $recompile = defined('DEBUG') ||

- !file_exists($output_file) ||

- @filesize($output_file) === 0;

-

- if ($recompile || $this->config['load_tplcompile'])

- {

- // Set only if a recompile or an mtime check are required.

- $source_file = $this->locator->get_source_file_for_handle($handle);

-

- if (!$recompile && @filemtime($output_file) < @filemtime($source_file))

- {

- $recompile = true;

- }

- }

-

- // Recompile page if the original template is newer, otherwise load the compiled version

- if (!$recompile)

- {

- return new phpbb_template_renderer_include($output_file, $this);

- }

-

- $compile = new phpbb_template_compile($this->config['tpl_allow_php'], $this->style_names, $this->locator, $this->phpbb_root_path, $this->extension_manager, $this->user);

-

- if ($compile->compile_file_to_file($source_file, $output_file) !== false)

- {

- $renderer = new phpbb_template_renderer_include($output_file, $this);

- }

- else if (($code = $compile->compile_file($source_file)) !== false)

- {

- $renderer = new phpbb_template_renderer_eval($code, $this);

- }

- else

- {

- $renderer = null;

- }

-

- return $renderer;

- }

-

- /**

- * Determines compiled file path for handle $handle.

- *

- * @param string $handle Template handle (i.e. "friendly" template name)

- * @return string Compiled file path

- private function _compiled_file_for_handle($handle)

- {

- $source_file = $this->locator->get_filename_for_handle($handle);

- $compiled_file = $this->cachepath . str_replace('/', '.', $source_file) . '.' . $this->php_ext;

- return $compiled_file;

- }

- public function assign_vars(array $vararray)

- {

- foreach ($vararray as $key => $val)

- {

- $this->assign_var($key, $val);

- }

- }

- public function assign_var($varname, $varval)

- {

- $this->context->assign_var($varname, $varval);

- }

- public function append_var($varname, $varval)

- {

- $this->context->append_var($varname, $varval);

- }

- // Docstring is copied from phpbb_template_context method with the same name.

- public function assign_block_vars($blockname, array $vararray)

- {

- return $this->context->assign_block_vars($blockname, $vararray);

- }

- // Docstring is copied from phpbb_template_context method with the same name.

- public function alter_block_array($blockname, array $vararray, $key = false, $mode = 'insert')

- {

- return $this->context->alter_block_array($blockname, $vararray, $key, $mode);

- }

-

- /**

- * Include a separate template.

- *

- * This function is marked public due to the way the template

- * implementation uses it. It is actually an implementation function

- * and should not be considered part of template class's public API.

- *

- * @param string $filename Template filename to include

- * @param bool $include True to include the file, false to just load it

- * @uses template_compile is used to compile uncached templates

- */

- public function _tpl_include($filename, $include = true)

- {

- $this->locator->set_filenames(array($filename => $filename));

-

- if (!$this->load_and_render($filename))

- {

- // trigger_error cannot be used here, as the output already started

- echo 'template->_tpl_include(): Failed including ' . htmlspecialchars($handle) . "\n";

- }

- }

- * Include a PHP file.

- *

- * If a relative path is passed in $filename, it is considered to be

- * relative to board root ($phpbb_root_path). Absolute paths are

- * also allowed.

- * This function is marked public due to the way the template

- * implementation uses it. It is actually an implementation function

- * and should not be considered part of template class's public API.

- *

- * @param string $filename Path to PHP file to include

- public function _php_include($filename)

- {

- if (phpbb_is_absolute($filename))

- {

- $file = $filename;

- }

- else

- {

- $file = $this->phpbb_root_path . $filename;

- }

-

- if (!file_exists($file))

- {

- // trigger_error cannot be used here, as the output already started

- echo 'template->_php_include(): File ' . htmlspecialchars($file) . " does not exist\n";

- return;

- }

- include($file);

- }

-

- /**

- * Include JS file

- *

- * @param string $file file name

- * @param bool $locate True if file needs to be located

- * @param bool $relative True if path is relative to phpBB root directory. Ignored if $locate == true

- */

- public function _js_include($file, $locate = false, $relative = false)

- {

- // Locate file

- if ($locate)

- {

- $located = $this->locator->get_first_file_location(array($file), false, true);

- if ($located)

- {

- $file = $located;

- }

- }

- else if ($relative)

- {

- $file = $this->phpbb_root_path . $file;

- }

-

- $file .= (strpos($file, '?') === false) ? '?' : '&';

- $file .= 'assets_version=' . $this->config['assets_version'];

-

- // Add HTML code

- $code = '<script src="' . htmlspecialchars($file) . '"></script>';

- $this->context->append_var('SCRIPTS', $code);

- }

- $error = array_merge($error, array_map(array(&$user, 'lang'), $colour_error));