+ if ($this->cachedToken)

+ {

+ if ($this->cachedToken instanceof TokenInterface)

+ {

+* ACM dummy Caching

+class dummy extends \phpbb\cache\driver\base

+ if (!$user->is_setup())

+class exception extends \phpbb\exception\runtime_exception

+use Symfony\Component\HttpFoundation\JsonResponse;

+ $message_text = call_user_func_array(array($this->user, 'lang'), $parameters);

+ $message_title = $this->user->lang($title);

+

+ if ($this->request->is_ajax())

+ {

+ global $refresh_data;

+

+ return new JsonResponse(

+ array(

+ 'MESSAGE_TITLE' => $message_title,

+ 'MESSAGE_TEXT' => $message_text,

+ 'S_USER_WARNING' => false,

+ 'S_USER_NOTICE' => false,

+ 'REFRESH_DATA' => (!empty($refresh_data)) ? $refresh_data : null

+ ),

+ $code

+ );

+ }

+

+ 'MESSAGE_TEXT' => $message_text,

+ 'MESSAGE_TITLE' => $message_title,

+ return $this->render('message_body.html', $message_title, $code);

+ public function __construct(ContainerInterface $container, $phpbb_root_path, \phpbb\template\template $template = null)

+ throw new \phpbb\controller\exception('CONTROLLER_NOT_SPECIFIED');

+ throw new \phpbb\controller\exception('CONTROLLER_METHOD_NOT_SPECIFIED');

+ throw new \phpbb\controller\exception('CONTROLLER_SERVICE_UNDEFINED', array($service));

+ throw new \phpbb\controller\exception('CONTROLLER_ARGUMENT_VALUE_MISSING', array($param->getPosition() + 1, get_class($object) . ':' . $method, $param->name));

+ $this->db->sql_freeresult($result);

+<?php

+/**

+*

+* This file is part of the phpBB Forum Software package.

+*

+* @copyright (c) phpBB Limited <https://www.phpbb.com>

+* @license GNU General Public License, version 2 (GPL-2.0)

+*

+* For full copyright and license information, please see

+* the docs/CREDITS.txt file.

+*

+*/

+

+namespace phpbb\db\migration\data\v30x;

+

+class release_3_0_14 extends \phpbb\db\migration\migration

+{

+ public function effectively_installed()

+ {

+ return phpbb_version_compare($this->config['version'], '3.0.14', '>=') && phpbb_version_compare($this->config['version'], '3.1.0-dev', '<');

+ }

+

+ static public function depends_on()

+ {

+ return array('\phpbb\db\migration\data\v30x\release_3_0_14_rc1');

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('if', array(

+ phpbb_version_compare($this->config['version'], '3.0.14', '<'),

+ array('config.update', array('version', '3.0.14')),

+ )),

+ );

+ }

+}

+<?php

+/**

+*

+* This file is part of the phpBB Forum Software package.

+*

+* @copyright (c) phpBB Limited <https://www.phpbb.com>

+* @license GNU General Public License, version 2 (GPL-2.0)

+*

+* For full copyright and license information, please see

+* the docs/CREDITS.txt file.

+*

+*/

+

+namespace phpbb\db\migration\data\v30x;

+

+class release_3_0_14_rc1 extends \phpbb\db\migration\migration

+{

+ public function effectively_installed()

+ {

+ return phpbb_version_compare($this->config['version'], '3.0.14-RC1', '>=') && phpbb_version_compare($this->config['version'], '3.1.0-dev', '<');

+ }

+

+ static public function depends_on()

+ {

+ return array('\phpbb\db\migration\data\v30x\release_3_0_13');

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('if', array(

+ phpbb_version_compare($this->config['version'], '3.0.14-RC1', '<'),

+ array('config.update', array('version', '3.0.14-RC1')),

+ )),

+ );

+ }

+}

+ $this->sql_query('DELETE FROM ' . STYLES_TABLE);

+ FROM ' . STYLES_TABLE . "

+ $this->config->set('default_style', $default_style);

+<?php

+/**

+*

+* This file is part of the phpBB Forum Software package.

+*

+* @copyright (c) phpBB Limited <https://www.phpbb.com>

+* @license GNU General Public License, version 2 (GPL-2.0)

+*

+* For full copyright and license information, please see

+* the docs/CREDITS.txt file.

+*

+*/

+

+namespace phpbb\db\migration\data\v31x;

+

+class v314 extends \phpbb\db\migration\migration

+{

+ static public function depends_on()

+ {

+ return array(

+ '\phpbb\db\migration\data\v30x\release_3_0_14',

+ '\phpbb\db\migration\data\v31x\v314rc2',

+ );

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('config.update', array('version', '3.1.4')),

+ );

+ }

+}

+<?php

+/**

+*

+* This file is part of the phpBB Forum Software package.

+*

+* @copyright (c) phpBB Limited <https://www.phpbb.com>

+* @license GNU General Public License, version 2 (GPL-2.0)

+*

+* For full copyright and license information, please see

+* the docs/CREDITS.txt file.

+*

+*/

+

+namespace phpbb\db\migration\data\v31x;

+

+class v314rc2 extends \phpbb\db\migration\migration

+{

+ static public function depends_on()

+ {

+ return array(

+ '\phpbb\db\migration\data\v30x\release_3_0_14_rc1',

+ '\phpbb\db\migration\data\v31x\v314rc1',

+ );

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('config.update', array('version', '3.1.4-RC2')),

+ );

+ }

+}

+use phpbb\filesystem\filesystem;

+use Symfony\Component\Filesystem\Exception\IOException;

+ * @var string The environment to use.

+ */

+ protected $environment;

+

+ /**

+ * The container under construction

+ *

+ * @var ContainerBuilder

+ */

+ * Indicates whether extensions should be used (default to true).

+ *

+ * @var bool

+ */

+ * Defines a custom path to find the configuration of the container (default to $this->phpbb_root_path . 'config')

+ *

+ * @var string

+ */

+ * Indicates whether the container should be dumped to the filesystem (default to true).

+ *

+ * If DEBUG_CONTAINER is set this option is ignored and a new container is build.

+ *

+ * @var bool

+ */

+ protected $use_cache = true;

+ * Indicates if the container should be compiled automatically (default to true).

+ *

+ * @var bool

+ */

+ * Custom parameters to inject into the container.

+ *

+ * Default to:

+ * array(

+ * 'core.root_path', $this->phpbb_root_path,

+ * 'core.php_ext', $this->php_ext,

+ * );

+ *

+ * @var array

+ */

+ * @var \phpbb\config_php_file

+ */

+ * @var array

+ */

+ private $container_extensions;

+

+ /**

+ * Constructor

+ *

+ * @param string $phpbb_root_path Path to the phpbb includes directory.

+ * @param string $php_ext php file extension

+ */

+ function __construct($phpbb_root_path, $php_ext)

+ * Build and return a new Container respecting the current configuration

+ *

+ * @return \phpbb_cache_container|ContainerBuilder

+ */

+ if ($this->use_cache && $config_cache->isFresh())

+ $this->container_extensions = array(new extension\core($this->get_config_path()));

+ $this->load_extensions();

+ // Inject the config

+ if ($this->config_php_file)

+ $this->container_extensions[] = new extension\config($this->config_php_file);

+ $this->container = $this->create_container($this->container_extensions);

+ // Easy collections through tags

+ $this->container->addCompilerPass(new pass\collection_pass());

+ // Event listeners "phpBB style"

+ $this->container->addCompilerPass(new RegisterListenersPass('dispatcher', 'event.listener_listener', 'event.listener'));

+ // Event listeners "Symfony style"

+ $this->container->addCompilerPass(new RegisterListenersPass('dispatcher'));

+

+ $filesystem = new filesystem();

+ $loader = new YamlFileLoader($this->container, new FileLocator($filesystem->realpath($this->get_config_path())));

+ if ($this->use_cache)

+ {

+ $this->dump_container($config_cache);

+ }

+ if ($this->compile_container && $this->config_php_file)

+ $this->container->set('config.php', $this->config_php_file);

+ * Enable the extensions.

+ *

+ * @param string $environment The environment to use

+ * @return $this

+ */

+ public function with_environment($environment)

+ {

+ $this->environment = $environment;

+

+ return $this;

+ }

+

+ /**

+ * Enable the extensions.

+ *

+ * @return $this

+ */

+ public function with_extensions()

+ $this->use_extensions = true;

+

+ return $this;

+ }

+

+ /**

+ * Disable the extensions.

+ *

+ * @return $this

+ */

+ public function without_extensions()

+ {

+ $this->use_extensions = false;

+

+ return $this;

+ * Enable the caching of the container.

+ *

+ * If DEBUG_CONTAINER is set this option is ignored and a new container is build.

+ *

+ * @return $this

+ */

+ public function with_cache()

+ $this->use_cache = true;

+

+ return $this;

+ * Disable the caching of the container.

+ *

+ * @return $this

+ */

+ public function without_cache()

+ $this->use_cache = false;

+

+ return $this;

+ * Set the cache directory.

+ *

+ * @param string $cache_dir The cache directory.

+ * @return $this

+ */

+ public function with_cache_dir($cache_dir)

+ $this->cache_dir = $cache_dir;

+

+ return $this;

+ * Enable the compilation of the container.

+ *

+ * @return $this

+ */

+ public function with_compiled_container()

+ $this->compile_container = true;

+

+ return $this;

+ * Disable the compilation of the container.

+ *

+ * @return $this

+ */

+ public function without_compiled_container()

+ $this->compile_container = false;

+

+ return $this;

+ * Set a custom path to find the configuration of the container.

+ *

+ * @param string $config_path

+ * @return $this

+ */

+ public function with_config_path($config_path)

+

+ return $this;

+ * Set custom parameters to inject into the container.

+ * @param array $custom_parameters

+ * @return $this

+ public function with_custom_parameters($custom_parameters)

+ $this->custom_parameters = $custom_parameters;

+

+ return $this;

+ * Set custom parameters to inject into the container.

+ *

+ * @param \phpbb\config_php_file $config_php_file

+ * @return $this

+ */

+ public function with_config(\phpbb\config_php_file $config_php_file)

+ $this->config_php_file = $config_php_file;

+

+ return $this;

+ * Returns the path to the container configuration (default: root_path/config)

+ * @return string

+ protected function get_config_path()

+ return $this->config_path ?: $this->phpbb_root_path . 'config';

+ * Load the enabled extensions.

+ */

+ protected function load_extensions()

+ if ($this->config_php_file !== null)

+ {

+ // Build an intermediate container to load the ext list from the database

+ $container_builder = new container_builder($this->phpbb_root_path, $this->php_ext);

+ $ext_container = $container_builder

+ ->without_cache()

+ ->without_extensions()

+ ->with_config($this->config_php_file)

+ ->with_environment('production')

+ ->without_compiled_container()

+ ->get_container()

+ ;

+

+ $ext_container->register('cache.driver', '\\phpbb\\cache\\driver\\dummy');

+ $ext_container->compile();

+

+ $extensions = $ext_container->get('ext.manager')->all_enabled();

+

+ // Load each extension found

+ foreach ($extensions as $ext_name => $path)

+ {

+ $extension_class = '\\' . str_replace('/', '\\', $ext_name) . '\\di\\extension';

+ if (!class_exists($extension_class))

+ {

+ $extension_class = '\\phpbb\\extension\\di\\extension_base';

+ }

+ $this->container_extensions[] = new $extension_class($ext_name, $path);

+ // Load extension autoloader

+ $filename = $path . 'vendor/autoload.php';

+ if (file_exists($filename))

+ {

+ require $filename;

+ }

+ }

+ }

+ else

+ // To load the extensions we need the database credentials.

+ // Automatically disable the extensions if we don't have them.

+ $this->use_extensions = false;

+ * Dump the container to the disk.

+ *

+ * @param ConfigCache $cache The config cache

+ */

+ protected function dump_container($cache)

+ try

+ {

+ $dumper = new PhpDumper($this->container);

+ $cached_container_dump = $dumper->dump(array(

+ 'class' => 'phpbb_cache_container',

+ 'base_class' => 'Symfony\\Component\\DependencyInjection\\ContainerBuilder',

+ ));

+ $cache->write($cached_container_dump, $this->container->getResources());

+ }

+ catch (IOException $e)

+ // Don't fail if the cache isn't writeable

+ * Create the ContainerBuilder object

+ *

+ * @param array $extensions Array of Container extension objects

+ * @return ContainerBuilder object

+ */

+ * Get the filename under which the dumped container will be stored.

+ *

+ * @return string Path for dumped container

+ */

+ return $this->environment ?: PHPBB_ENVIRONMENT;

+ ->booleanNode('debug')->defaultValue(null)->end()

+ ->booleanNode('auto_reload')->defaultValue(null)->end()

+ // Set the Twig options if defined in the environment

+ $definition = $container->getDefinition('template.twig.environment');

+ $twig_environment_options = $definition->getArgument(7);

+ if ($config['twig']['debug'])

+ {

+ $twig_environment_options['debug'] = true;

+ }

+ if ($config['twig']['auto_reload'])

+ {

+ $twig_environment_options['auto_reload'] = true;

+ }

+ // Replace the 8th argument, the options passed to the environment

+ $definition->replaceArgument(7, $twig_environment_options);

+

+ /** @var string The minimum version for the events to return */

+ protected $min_version;

+

+ /** @var string The maximum version for the events to return */

+ protected $max_version;

+

+ * @param string $min_version

+ * @param string $max_version

+ public function __construct($phpbb_root_path, $extension = null, $min_version = null, $max_version = null)

+ $this->min_version = $min_version;

+ $this->max_version = $max_version;

+

+ $changed_versions = array();

+ if (strpos($details, "\n* Changed: ") !== false)

+ {

+ list($since, $details) = explode("\n* Changed: ", $details, 2);

+ while (strpos($details, "\n* Changed: ") !== false)

+ {

+ list($changed, $details) = explode("\n* Changed: ", $details, 2);

+ $changed_versions[] = $changed;

+ }

+ list($changed, $description) = explode("\n* Purpose: ", $details, 2);

+ $changed_versions[] = $changed;

+ }

+ else

+ {

+ list($since, $description) = explode("\n* Purpose: ", $details, 2);

+ $changed_versions = array();

+ }

+ $changes = array();

+ foreach ($changed_versions as $changed)

+ {

+ list($changed_version, $changed_description) = $this->validate_changed($changed);

+

+ if (isset($changes[$changed_version]))

+ {

+ throw new \LogicException("Duplicate change information found for event '{$this->current_event}'");

+ }

+

+ $changes[$changed_version] = $changed_description;

+ }

+ $description = trim($description, "\n") . "\n";

+

+ if (!$this->version_is_filtered($since))

+ {

+ $is_filtered = false;

+ foreach ($changes as $version => $null)

+ {

+ if ($this->version_is_filtered($version))

+ {

+ $is_filtered = true;

+ break;

+ }

+ }

+

+ if (!$is_filtered)

+ {

+ continue;

+ }

+ }

+ 'changed' => $changes,

+ * The version to check

+ *

+ * @param string $version

+ * @return bool

+ */

+ protected function version_is_filtered($version)

+ {

+ return (!$this->min_version || phpbb_version_compare($this->min_version, $version, '<='))

+ && (!$this->max_version || phpbb_version_compare($this->max_version, $version, '>='));

+ }

+

+ /**

+ *

+ * @param string $action

+ public function export_events_for_wiki($action = '')

+ if ($action === 'diff')

+ {

+ $wiki_page = '=== ACP Template Events ===' . "\n";

+ }

+ else

+ {

+ $wiki_page = '= ACP Template Events =' . "\n";

+ }

+ if ($action === 'diff')

+ {

+ $wiki_page = '=== Template Events ===' . "\n";

+ }

+ else

+ {

+ $wiki_page = '= Template Events =' . "\n";

+ }

+ if (!$this->validate_version($since))

+ * Validate "Changed" Information

+ *

+ * @param string $changed

+ * @return string

+ * @throws \LogicException

+ */

+ public function validate_changed($changed)

+ {

+ if (strpos($changed, ' ') !== false)

+ {

+ list($version, $description) = explode(' ', $changed, 2);

+ }

+ else

+ {

+ $version = $changed;

+ $description = '';

+ }

+

+ if (!$this->validate_version($version))

+ {

+ throw new \LogicException("Invalid changed information found for event '{$this->current_event}'");

+ }

+

+ return array($version, $description);

+ }

+

+ /**

+ * Validate "version" Information

+ *

+ * @param string $version

+ * @return bool True if valid, false otherwise

+ */

+ public function validate_version($version)

+ {

+ return preg_match('#^\d+\.\d+\.\d+(?:-(?:a|b|RC|pl)\d+)?$#', $version);

+ }

+

+ /**

+ /** @var string The minimum version for the events to return */

+ protected $min_version;

+

+ /** @var string The maximum version for the events to return */

+ protected $max_version;

+

+ * @param string $min_version

+ * @param string $max_version

+ public function __construct($phpbb_root_path, $extension = null, $min_version = null, $max_version = null)

+ $this->min_version = $min_version;

+ $this->max_version = $max_version;

+ *

+ * @param string $action

+ public function export_events_for_wiki($action = '')

+ if ($action === 'diff')

+ {

+ $wiki_page = '=== PHP Events (Hook Locations) ===' . "\n";

+ }

+ else

+ {

+ $wiki_page = '= PHP Events (Hook Locations) =' . "\n";

+ }

+ $changed_line_nums = $this->find_changed('changed');

+ if (empty($changed_line_nums))

+ {

+ $changed_line_nums = $this->find_changed('change');

+ }

+ $changed_versions = array();

+ if (!empty($changed_line_nums))

+ {

+ foreach ($changed_line_nums as $changed_line_num)

+ {

+ $changed_versions[] = $this->validate_changed($this->file_lines[$changed_line_num]);

+ }

+ }

+

+ if (!$this->version_is_filtered($since))

+ {

+ $valid_version = false;

+ foreach ($changed_versions as $changed)

+ {

+ $valid_version = $valid_version || $this->version_is_filtered($changed);

+ }

+

+ if (!$valid_version)

+ {

+ continue;

+ }

+ }

+

+ * The version to check

+ *

+ * @param string $version

+ * @return bool

+ */

+ protected function version_is_filtered($version)

+ {

+ return (!$this->min_version || phpbb_version_compare($this->min_version, $version, '<='))

+ && (!$this->max_version || phpbb_version_compare($this->max_version, $version, '>='));

+ }

+

+ /**

+ * Find the "@changed" Information lines

+ *

+ * @param string $tag_name Should be 'changed' or 'change'

+ * @return array Absolute line numbers

+ * @throws \LogicException

+ */

+ public function find_changed($tag_name)

+ {

+ $lines = array();

+ $last_line = 0;

+ try

+ {

+ while ($line = $this->find_tag($tag_name, array('since'), $last_line))

+ {

+ $lines[] = $line;

+ $last_line = $line;

+ }

+ }

+ catch (\LogicException $e)

+ {

+ // Not changed? No problem!

+ }

+

+ return $lines;

+ }

+

+ /**

+ * @param int $skip_to_line Skip lines until this one

+ public function find_tag($find_tag, $disallowed_tags, $skip_to_line = 0)

+ $find_tag_line = $skip_to_line ? $this->current_event_line - $skip_to_line + 1 : 0;

+ $found_comment_end = ($skip_to_line) ? true : false;

+ * Validate "@changed" Information

+ *

+ * @param string $line

+ * @return string

+ * @throws \LogicException

+ */

+ public function validate_changed($line)

+ {

+ $match = array();

+ $line = str_replace("\t", ' ', ltrim($line, "\t "));

+ preg_match('#^\* @change(d)? (\d+\.\d+\.\d+(?:-(?:a|b|RC|pl)\d+)?)( (?:.*))?$#', $line, $match);

+ if (!isset($match[2]))

+ {

+ throw new \LogicException("Invalid '@changed' information for event "

+ . "'{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'");

+ }

+

+ return $match[2];

+ }

+

+ /**

+class exception extends \phpbb\exception\runtime_exception

+ public function __construct(ContainerInterface $container, \phpbb\db\driver\driver_interface $db, \phpbb\config\config $config, \phpbb\filesystem\filesystem_interface $filesystem, $extension_table, $phpbb_root_path, $php_ext = 'php', \phpbb\cache\driver\driver_interface $cache = null, $cache_name = '_ext')

+ return new \phpbb\extension\metadata_manager($name, $this->config, $this, $template, $this->phpbb_root_path);

+ public function __construct($ext_name, \phpbb\config\config $config, \phpbb\extension\manager $extension_manager, \phpbb\template\template $template, $phpbb_root_path)

+ throw new \phpbb\extension\exception('FILE_NOT_FOUND', array($this->metadata_file));

+ throw new \phpbb\extension\exception('FILE_NOT_FOUND', array($this->metadata_file));

+ throw new \phpbb\extension\exception('FILE_CONTENT_ERR', array($this->metadata_file));

+ throw new \phpbb\extension\exception('FILE_JSON_DECODE_ERR', array($this->metadata_file));

+ throw new \phpbb\extension\exception('META_FIELD_NOT_SET', array($name));

+ throw new \phpbb\extension\exception('META_FIELD_INVALID', array($name));

+ throw new \phpbb\extension\exception('META_FIELD_NOT_SET', array('authors'));

+ throw new \phpbb\extension\exception('META_FIELD_NOT_SET', array('author name'));

+ $handle = @fopen($file, 'c');

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\help\controller;

+

+/**

+ * BBCode help page

+ */

+class bbcode extends controller

+{

+ /**

+ * @return string The title of the page

+ */

+ public function display()

+ {

+ $this->language->add_lang('help/bbcode');

+

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_INTRO',

+ false,

+ array(

+ 'HELP_BBCODE_INTRO_BBCODE_QUESTION' => 'HELP_BBCODE_INTRO_BBCODE_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_TEXT',

+ false,

+ array(

+ 'HELP_BBCODE_TEXT_BASIC_QUESTION' => 'HELP_BBCODE_TEXT_BASIC_ANSWER',

+ 'HELP_BBCODE_TEXT_COLOR_QUESTION' => 'HELP_BBCODE_TEXT_COLOR_ANSWER',

+ 'HELP_BBCODE_TEXT_COMBINE_QUESTION' => 'HELP_BBCODE_TEXT_COMBINE_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_QUOTES',

+ false,

+ array(

+ 'HELP_BBCODE_QUOTES_TEXT_QUESTION' => 'HELP_BBCODE_QUOTES_TEXT_ANSWER',

+ 'HELP_BBCODE_QUOTES_CODE_QUESTION' => 'HELP_BBCODE_QUOTES_CODE_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_LISTS',

+ false,

+ array(

+ 'HELP_BBCODE_LISTS_UNORDERER_QUESTION' => 'HELP_BBCODE_LISTS_UNORDERER_ANSWER',

+ 'HELP_BBCODE_LISTS_ORDERER_QUESTION' => 'HELP_BBCODE_LISTS_ORDERER_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_LINKS',

+ true,

+ array(

+ 'HELP_BBCODE_LINKS_BASIC_QUESTION' => 'HELP_BBCODE_LINKS_BASIC_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_IMAGES',

+ false,

+ array(

+ 'HELP_BBCODE_IMAGES_BASIC_QUESTION' => 'HELP_BBCODE_IMAGES_BASIC_ANSWER',

+ 'HELP_BBCODE_IMAGES_ATTACHMENT_QUESTION' => 'HELP_BBCODE_IMAGES_ATTACHMENT_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_BBCODE_BLOCK_OTHERS',

+ false,

+ array(

+ 'HELP_BBCODE_OTHERS_CUSTOM_QUESTION' => 'HELP_BBCODE_OTHERS_CUSTOM_ANSWER',

+ )

+ );

+

+ return $this->language->lang('BBCODE_GUIDE');

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\help\controller;

+

+/**

+ * BBCode help page

+ */

+abstract class controller

+{

+ /** @var \phpbb\controller\helper */

+ protected $helper;

+

+ /** @var \phpbb\help\manager */

+ protected $manager;

+

+ /** @var \phpbb\template\template */

+ protected $template;

+

+ /** @var \phpbb\language\language */

+ protected $language;

+

+ /** @var string */

+ protected $root_path;

+

+ /** @var string */

+ protected $php_ext;

+

+ /**

+ * Constructor

+ *

+ * @param \phpbb\controller\helper $helper

+ * @param \phpbb\help\manager $manager

+ * @param \phpbb\template\template $template

+ * @param \phpbb\language\language $language

+ * @param string $root_path

+ * @param string $php_ext

+ */

+ public function __construct(\phpbb\controller\helper $helper, \phpbb\help\manager $manager, \phpbb\template\template $template, \phpbb\language\language $language, $root_path, $php_ext)

+ {

+ $this->helper = $helper;

+ $this->manager = $manager;

+ $this->template = $template;

+ $this->language = $language;

+ $this->root_path = $root_path;

+ $this->php_ext = $php_ext;

+ }

+

+ /**

+ * @return string

+ */

+ abstract protected function display();

+

+ public function handle()

+ {

+ $title = $this->display();

+

+ $this->template->assign_vars(array(

+ 'L_FAQ_TITLE' => $title,

+ 'S_IN_FAQ' => true,

+ ));

+

+ make_jumpbox(append_sid("{$this->root_path}viewforum.{$this->php_ext}"));

+ return $this->helper->render('faq_body.html', $title);

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\help\controller;

+

+/**

+ * FAQ help page

+ */

+class faq extends controller

+{

+ /**

+ * @return string The title of the page

+ */

+ public function display()

+ {

+ $this->language->add_lang('help/faq');

+

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_LOGIN',

+ false,

+ array(

+ 'HELP_FAQ_LOGIN_REGISTER_QUESTION' => 'HELP_FAQ_LOGIN_REGISTER_ANSWER',

+ 'HELP_FAQ_LOGIN_COPPA_QUESTION' => 'HELP_FAQ_LOGIN_COPPA_ANSWER',

+ 'HELP_FAQ_LOGIN_CANNOT_REGISTER_QUESTION' => 'HELP_FAQ_LOGIN_CANNOT_REGISTER_ANSWER',

+ 'HELP_FAQ_LOGIN_REGISTER_CONFIRM_QUESTION' => 'HELP_FAQ_LOGIN_REGISTER_CONFIRM_ANSWER',

+ 'HELP_FAQ_LOGIN_CANNOT_LOGIN_QUESTION' => 'HELP_FAQ_LOGIN_CANNOT_LOGIN_ANSWER',

+ 'HELP_FAQ_LOGIN_CANNOT_LOGIN_ANYMORE_QUESTION' => 'HELP_FAQ_LOGIN_CANNOT_LOGIN_ANYMORE_ANSWER',

+ 'HELP_FAQ_LOGIN_LOST_PASSWORD_QUESTION' => 'HELP_FAQ_LOGIN_LOST_PASSWORD_ANSWER',

+ 'HELP_FAQ_LOGIN_AUTO_LOGOUT_QUESTION' => 'HELP_FAQ_LOGIN_AUTO_LOGOUT_ANSWER',

+ 'HELP_FAQ_LOGIN_DELETE_COOKIES_QUESTION' => 'HELP_FAQ_LOGIN_DELETE_COOKIES_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_USERSETTINGS',

+ false,

+ array(

+ 'HELP_FAQ_USERSETTINGS_CHANGE_SETTINGS_QUESTION' => 'HELP_FAQ_USERSETTINGS_CHANGE_SETTINGS_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_HIDE_ONLINE_QUESTION' => 'HELP_FAQ_USERSETTINGS_HIDE_ONLINE_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_TIMEZONE_QUESTION' => 'HELP_FAQ_USERSETTINGS_TIMEZONE_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_SERVERTIME_QUESTION' => 'HELP_FAQ_USERSETTINGS_SERVERTIME_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_LANGUAGE_QUESTION' => 'HELP_FAQ_USERSETTINGS_LANGUAGE_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_AVATAR_QUESTION' => 'HELP_FAQ_USERSETTINGS_AVATAR_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_AVATAR_DISPLAY_QUESTION' => 'HELP_FAQ_USERSETTINGS_AVATAR_DISPLAY_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_RANK_QUESTION' => 'HELP_FAQ_USERSETTINGS_RANK_ANSWER',

+ 'HELP_FAQ_USERSETTINGS_EMAIL_LOGIN_QUESTION' => 'HELP_FAQ_USERSETTINGS_EMAIL_LOGIN_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_POSTING',

+ false,

+ array(

+ 'HELP_FAQ_POSTING_CREATE_QUESTION' => 'HELP_FAQ_POSTING_CREATE_ANSWER',

+ 'HELP_FAQ_POSTING_EDIT_DELETE_QUESTION' => 'HELP_FAQ_POSTING_EDIT_DELETE_ANSWER',

+ 'HELP_FAQ_POSTING_SIGNATURE_QUESTION' => 'HELP_FAQ_POSTING_SIGNATURE_ANSWER',

+ 'HELP_FAQ_POSTING_POLL_CREATE_QUESTION' => 'HELP_FAQ_POSTING_POLL_CREATE_ANSWER',

+ 'HELP_FAQ_POSTING_POLL_ADD_QUESTION' => 'HELP_FAQ_POSTING_POLL_ADD_ANSWER',

+ 'HELP_FAQ_POSTING_POLL_EDIT_QUESTION' => 'HELP_FAQ_POSTING_POLL_EDIT_ANSWER',

+ 'HELP_FAQ_POSTING_FORUM_RESTRICTED_QUESTION' => 'HELP_FAQ_POSTING_FORUM_RESTRICTED_ANSWER',

+ 'HELP_FAQ_POSTING_NO_ATTACHMENTS_QUESTION' => 'HELP_FAQ_POSTING_NO_ATTACHMENTS_ANSWER',

+ 'HELP_FAQ_POSTING_WARNING_QUESTION' => 'HELP_FAQ_POSTING_WARNING_ANSWER',

+ 'HELP_FAQ_POSTING_REPORT_QUESTION' => 'HELP_FAQ_POSTING_REPORT_ANSWER',

+ 'HELP_FAQ_POSTING_DRAFT_QUESTION' => 'HELP_FAQ_POSTING_DRAFT_ANSWER',

+ 'HELP_FAQ_POSTING_QUEUE_QUESTION' => 'HELP_FAQ_POSTING_QUEUE_ANSWER',

+ 'HELP_FAQ_POSTING_BUMP_QUESTION' => 'HELP_FAQ_POSTING_BUMP_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_FORMATTING',

+ false,

+ array(

+ 'HELP_FAQ_FORMATTING_BBOCDE_QUESTION' => 'HELP_FAQ_FORMATTING_BBOCDE_ANSWER',

+ 'HELP_FAQ_FORMATTING_HTML_QUESTION' => 'HELP_FAQ_FORMATTING_HTML_ANSWER',

+ 'HELP_FAQ_FORMATTING_SMILIES_QUESTION' => 'HELP_FAQ_FORMATTING_SMILIES_ANSWER',

+ 'HELP_FAQ_FORMATTING_IMAGES_QUESTION' => 'HELP_FAQ_FORMATTING_IMAGES_ANSWER',

+ 'HELP_FAQ_FORMATTING_GLOBAL_ANNOUNCE_QUESTION' => 'HELP_FAQ_FORMATTING_GLOBAL_ANNOUNCE_ANSWER',

+ 'HELP_FAQ_FORMATTING_ANNOUNCEMENT_QUESTION' => 'HELP_FAQ_FORMATTING_ANNOUNCEMENT_ANSWER',

+ 'HELP_FAQ_FORMATTING_STICKIES_QUESTION' => 'HELP_FAQ_FORMATTING_STICKIES_ANSWER',

+ 'HELP_FAQ_FORMATTING_LOCKED_QUESTION' => 'HELP_FAQ_FORMATTING_LOCKED_ANSWER',

+ 'HELP_FAQ_FORMATTING_ICONS_QUESTION' => 'HELP_FAQ_FORMATTING_ICONS_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_GROUPS',

+ true,

+ array(

+ 'HELP_FAQ_GROUPS_ADMINISTRATORS_QUESTION' => 'HELP_FAQ_GROUPS_ADMINISTRATORS_ANSWER',

+ 'HELP_FAQ_GROUPS_MODERATORS_QUESTION' => 'HELP_FAQ_GROUPS_MODERATORS_ANSWER',

+ 'HELP_FAQ_GROUPS_USERGROUPS_QUESTION' => 'HELP_FAQ_GROUPS_USERGROUPS_ANSWER',

+ 'HELP_FAQ_GROUPS_USERGROUPS_JOIN_QUESTION' => 'HELP_FAQ_GROUPS_USERGROUPS_JOIN_ANSWER',

+ 'HELP_FAQ_GROUPS_USERGROUPS_LEAD_QUESTION' => 'HELP_FAQ_GROUPS_USERGROUPS_LEAD_ANSWER',

+ 'HELP_FAQ_GROUPS_COLORS_QUESTION' => 'HELP_FAQ_GROUPS_COLORS_ANSWER',

+ 'HELP_FAQ_GROUPS_DEFAULT_QUESTION' => 'HELP_FAQ_GROUPS_DEFAULT_ANSWER',

+ 'HELP_FAQ_GROUPS_TEAM_QUESTION' => 'HELP_FAQ_GROUPS_TEAM_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_PMS',

+ false,

+ array(

+ 'HELP_FAQ_PMS_CANNOT_SEND_QUESTION' => 'HELP_FAQ_PMS_CANNOT_SEND_ANSWER',

+ 'HELP_FAQ_PMS_UNWANTED_QUESTION' => 'HELP_FAQ_PMS_UNWANTED_ANSWER',

+ 'HELP_FAQ_PMS_SPAM_QUESTION' => 'HELP_FAQ_PMS_SPAM_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_FRIENDS',

+ false,

+ array(

+ 'HELP_FAQ_FRIENDS_BASIC_QUESTION' => 'HELP_FAQ_FRIENDS_BASIC_ANSWER',

+ 'HELP_FAQ_FRIENDS_MANAGE_QUESTION' => 'HELP_FAQ_FRIENDS_MANAGE_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_SEARCH',

+ false,

+ array(

+ 'HELP_FAQ_SEARCH_FORUM_QUESTION' => 'HELP_FAQ_SEARCH_FORUM_ANSWER',

+ 'HELP_FAQ_SEARCH_NO_RESULT_QUESTION' => 'HELP_FAQ_SEARCH_NO_RESULT_ANSWER',

+ 'HELP_FAQ_SEARCH_BLANK_QUESTION' => 'HELP_FAQ_SEARCH_BLANK_ANSWER',

+ 'HELP_FAQ_SEARCH_MEMBERS_QUESTION' => 'HELP_FAQ_SEARCH_MEMBERS_ANSWER',

+ 'HELP_FAQ_SEARCH_OWN_QUESTION' => 'HELP_FAQ_SEARCH_OWN_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_BOOKMARKS',

+ false,

+ array(

+ 'HELP_FAQ_BOOKMARKS_DIFFERENCE_QUESTION' => 'HELP_FAQ_BOOKMARKS_DIFFERENCE_ANSWER',

+ 'HELP_FAQ_BOOKMARKS_TOPIC_QUESTION' => 'HELP_FAQ_BOOKMARKS_TOPIC_ANSWER',

+ 'HELP_FAQ_BOOKMARKS_FORUM_QUESTION' => 'HELP_FAQ_BOOKMARKS_FORUM_ANSWER',

+ 'HELP_FAQ_BOOKMARKS_REMOVE_QUESTION' => 'HELP_FAQ_BOOKMARKS_REMOVE_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_ATTACHMENTS',

+ false,

+ array(

+ 'HELP_FAQ_ATTACHMENTS_ALLOWED_QUESTION' => 'HELP_FAQ_ATTACHMENTS_ALLOWED_ANSWER',

+ 'HELP_FAQ_ATTACHMENTS_OWN_QUESTION' => 'HELP_FAQ_ATTACHMENTS_OWN_ANSWER',

+ )

+ );

+ $this->manager->add_block(

+ 'HELP_FAQ_BLOCK_ISSUES',

+ false,

+ array(

+ 'HELP_FAQ_ISSUES_WHOIS_PHPBB_QUESTION' => 'HELP_FAQ_ISSUES_WHOIS_PHPBB_ANSWER',

+ 'HELP_FAQ_ISSUES_FEATURE_QUESTION' => 'HELP_FAQ_ISSUES_FEATURE_ANSWER',

+ 'HELP_FAQ_ISSUES_LEGAL_QUESTION' => 'HELP_FAQ_ISSUES_LEGAL_ANSWER',

+ 'HELP_FAQ_ISSUES_ADMIN_QUESTION' => 'HELP_FAQ_ISSUES_ADMIN_ANSWER',

+ )

+ );

+

+ return $this->language->lang('FAQ_EXPLAIN');

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\help;

+

+/**

+ * Class help page manager

+ */

+class manager

+{

+ /** @var \phpbb\event\dispatcher */

+ protected $dispatcher;

+

+ /** @var \phpbb\language\language */

+ protected $language;

+

+ /** @var \phpbb\template\template */

+ protected $template;

+

+ /** @var bool */

+ protected $switched_column;

+

+ /**

+ * Constructor

+ *

+ * @param \phpbb\event\dispatcher $dispatcher

+ * @param \phpbb\language\language $language

+ * @param \phpbb\template\template $template

+ */

+ public function __construct(\phpbb\event\dispatcher $dispatcher, \phpbb\language\language $language, \phpbb\template\template $template)

+ {

+ $this->dispatcher = $dispatcher;

+ $this->language = $language;

+ $this->template = $template;

+ }

+

+ /**

+ * Add a new faq block

+ *

+ * @param string $block_name Name or language key with the name of the block

+ * @param bool $switch_column Switch the column of the menu

+ */

+ public function add_block($block_name, $switch_column = false, $questions = array())

+ {

+ /**

+ * You can use this event to add a block before the current one.

+ *

+ * @event core.help_manager_add_block_before

+ * @var string block_name Language key of the block headline

+ * @var bool switch_column Should we switch the menu column before this headline

+ * @var array questions Array with questions

+ * @since 3.2.0-a1

+ */

+ $vars = array('block_name', 'switch_column', 'questions');

+ extract($this->dispatcher->trigger_event('core.help_manager_add_block_before', compact($vars)));

+

+ $this->template->assign_block_vars('faq_block', array(

+ 'BLOCK_TITLE' => $this->language->lang($block_name),

+ 'SWITCH_COLUMN' => !$this->switched_column && $switch_column,

+ ));

+

+ foreach ($questions as $question => $answer)

+ {

+ $this->add_question($question, $answer);

+ }

+

+ $this->switched_column = $this->switched_column || $switch_column;

+

+ /**

+ * You can use this event to add a block after the current one.

+ *

+ * @event core.help_manager_add_block_after

+ * @var string block_name Language key of the block headline

+ * @var bool switch_column Should we switch the menu column before this headline

+ * @var array questions Array with questions

+ * @since 3.2.0-a1

+ */

+ $vars = array('block_name', 'switch_column', 'questions');

+ extract($this->dispatcher->trigger_event('core.help_manager_add_block_after', compact($vars)));

+ }

+

+ /**

+ * Add a new faq question

+ *

+ * @param string $question Question or language key with the question of the block

+ * @param string $answer Answer or language key with the answer of the block

+ */

+ public function add_question($question, $answer)

+ {

+ /**

+ * You can use this event to add a question before the current one.

+ *

+ * @event core.help_manager_add_question_before

+ * @var string question Language key of the question

+ * @var string answer Language key of the answer

+ * @since 3.2.0-a1

+ */

+ $vars = array('question', 'answer');

+ extract($this->dispatcher->trigger_event('core.help_manager_add_question_before', compact($vars)));

+

+ $this->template->assign_block_vars('faq_block.faq_row', array(

+ 'FAQ_QUESTION' => $this->language->lang($question),

+ 'FAQ_ANSWER' => $this->language->lang($answer),

+ ));

+

+ /**

+ * You can use this event to add a question after the current one.

+ *

+ * @event core.help_manager_add_question_after

+ * @var string question Language key of the question

+ * @var string answer Language key of the answer

+ * @since 3.2.0-a1

+ */

+ $vars = array('question', 'answer');

+ extract($this->dispatcher->trigger_event('core.help_manager_add_question_after', compact($vars)));

+ }

+

+ /**

+ * Returns whether the block titles switched side

+ * @return bool

+ */

+ public function switched_column()

+ {

+ return $this->switched_column;

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language\exception;

+

+/**

+ * Thrown when nonexistent plural rule is specified

+ */

+class invalid_plural_rule_exception extends language_exception

+{

+

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language\exception;

+

+/**

+ * Base exception class for language exceptions

+ */

+class language_exception extends \phpbb\exception\runtime_exception

+{

+

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language\exception;

+

+/**

+ * This exception is thrown when the language file is not found

+ */

+class language_file_not_found extends language_exception

+{

+

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language;

+

+use phpbb\language\exception\invalid_plural_rule_exception;

+

+/**

+ * Wrapper class for loading translations

+ */

+class language

+{

+ /**

+ * Global fallback language

+ *

+ * ISO code of the language to fallback to when the specified language entries

+ * cannot be found.

+ *

+ * @var string

+ */

+ const FALLBACK_LANGUAGE = 'en';

+

+ /**

+ * @var array List of common language files

+ */

+ protected $common_language_files;

+

+ /**

+ * @var bool

+ */

+ protected $common_language_files_loaded;

+

+ /**

+ * @var string ISO code of the default board language

+ */

+ protected $default_language;

+

+ /**

+ * @var string ISO code of the User's language

+ */

+ protected $user_language;

+

+ /**

+ * @var array Language fallback array (the order is important)

+ */

+ protected $language_fallback;

+

+ /**

+ * @var array Array of language variables

+ */

+ protected $lang;

+

+ /**

+ * @var array Loaded language sets

+ */

+ protected $loaded_language_sets;

+

+ /**

+ * @var \phpbb\language\language_file_loader Language file loader

+ */

+ protected $loader;

+

+ /**

+ * Constructor

+ *

+ * @param \phpbb\language\language_file_loader $loader Language file loader

+ * @param array|null $common_modules Array of common language modules to load (optional)

+ */

+ public function __construct(language_file_loader $loader, $common_modules = null)

+ {

+ $this->loader = $loader;

+

+ // Set up default information

+ $this->user_language = false;

+ $this->default_language = false;

+ $this->lang = array();

+ $this->loaded_language_sets = array(

+ 'core' => array(),

+ 'ext' => array(),

+ );

+

+ // Common language files

+ if (is_array($common_modules))

+ {

+ $this->common_language_files = $common_modules;

+ }

+ else

+ {

+ $this->common_language_files = array(

+ 'common',

+ );

+ }

+

+ $this->common_language_files_loaded = false;

+

+ $this->language_fallback = array(self::FALLBACK_LANGUAGE);

+ }

+

+ /**

+ * Function to set user's language to display.

+ *

+ * @param string $user_lang_iso ISO code of the User's language

+ */

+ public function set_user_language($user_lang_iso)

+ {

+ $this->user_language = $user_lang_iso;

+

+ $this->set_fallback_array();

+ }

+

+ /**

+ * Function to set the board's default language to display.

+ *

+ * @param string $default_lang_iso ISO code of the board's default language

+ */

+ public function set_default_language($default_lang_iso)

+ {

+ $this->default_language = $default_lang_iso;

+

+ $this->set_fallback_array();

+ }

+

+ /**

+ * Returns language array

+ *

+ * Note: This function is needed for the BC purposes, until \phpbb\user::lang[] is

+ * not removed.

+ *

+ * @return array Array of loaded language strings

+ */

+ public function get_lang_array()

+ {

+ // Load common language files if they not loaded yet

+ if (!$this->common_language_files_loaded)

+ {

+ $this->load_common_language_files();

+ }

+

+ return $this->lang;

+ }

+

+ /**

+ * Add Language Items

+ *

+ * Examples:

+ * <code>

+ * $component = array('posting');

+ * $component = array('posting', 'viewtopic')

+ * $component = 'posting'

+ * </code>

+ *

+ * @param string|array $component The name of the language component to load

+ * @param string|null $extension_name Name of the extension to load component from, or null for core file

+ */

+ public function add_lang($component, $extension_name = null)

+ {

+ // Load common language files if they not loaded yet

+ // This needs to be here to correctly merge language arrays

+ if (!$this->common_language_files_loaded)

+ {

+ $this->load_common_language_files();

+ }

+

+ if (!is_array($component))

+ {

+ if (!is_null($extension_name))

+ {

+ $this->load_extension($extension_name, $component);

+ }

+ else

+ {

+ $this->load_core_file($component);

+ }

+ }

+ else

+ {

+ foreach ($component as $lang_file)

+ {

+ $this->add_lang($lang_file, $extension_name);

+ }

+ }

+ }

+

+ /**

+ * Advanced language substitution

+ *

+ * Function to mimic sprintf() with the possibility of using phpBB's language system to substitute nullar/singular/plural forms.

+ * Params are the language key and the parameters to be substituted.

+ * This function/functionality is inspired by SHS` and Ashe.

+ *

+ * Example call: <samp>$user->lang('NUM_POSTS_IN_QUEUE', 1);</samp>

+ *

+ * If the first parameter is an array, the elements are used as keys and subkeys to get the language entry:

+ * Example: <samp>$user->lang(array('datetime', 'AGO'), 1)</samp> uses $user->lang['datetime']['AGO'] as language entry.

+ *

+ * @return string Return localized string or the language key if the translation is not available

+ */

+ public function lang()

+ {

+ // Load common language files if they not loaded yet

+ if (!$this->common_language_files_loaded)

+ {

+ $this->load_common_language_files();

+ }

+

+ $args = func_get_args();

+ $key = $args[0];

+

+ if (is_array($key))

+ {

+ $lang = &$this->lang[array_shift($key)];

+

+ foreach ($key as $_key)

+ {

+ $lang = &$lang[$_key];

+ }

+ }

+ else

+ {

+ $lang = &$this->lang[$key];

+ }

+

+ // Return if language string does not exist

+ if (!isset($lang) || (!is_string($lang) && !is_array($lang)))

+ {

+ return $key;

+ }

+

+ // If the language entry is a string, we simply mimic sprintf() behaviour

+ if (is_string($lang))

+ {

+ if (sizeof($args) == 1)

+ {

+ return $lang;

+ }

+

+ // Replace key with language entry and simply pass along...

+ $args[0] = $lang;

+ return call_user_func_array('sprintf', $args);

+ }

+ else if (sizeof($lang) == 0)

+ {

+ // If the language entry is an empty array, we just return the language key

+ return $args[0];

+ }

+

+ // It is an array... now handle different nullar/singular/plural forms

+ $key_found = false;

+

+ // We now get the first number passed and will select the key based upon this number

+ for ($i = 1, $num_args = sizeof($args); $i < $num_args; $i++)

+ {

+ if (is_int($args[$i]) || is_float($args[$i]))

+ {

+ if ($args[$i] == 0 && isset($lang[0]))

+ {

+ // We allow each translation using plural forms to specify a version for the case of 0 things,

+ // so that "0 users" may be displayed as "No users".

+ $key_found = 0;

+ break;

+ }

+ else

+ {

+ $use_plural_form = $this->get_plural_form($args[$i]);

+ if (isset($lang[$use_plural_form]))

+ {

+ // The key we should use exists, so we use it.

+ $key_found = $use_plural_form;

+ }

+ else

+ {

+ // If the key we need to use does not exist, we fall back to the previous one.

+ $numbers = array_keys($lang);

+

+ foreach ($numbers as $num)

+ {

+ if ($num > $use_plural_form)

+ {

+ break;

+ }

+

+ $key_found = $num;

+ }

+ }

+ break;

+ }

+ }

+ }

+

+ // Ok, let's check if the key was found, else use the last entry (because it is mostly the plural form)

+ if ($key_found === false)

+ {

+ $numbers = array_keys($lang);

+ $key_found = end($numbers);

+ }

+

+ // Use the language string we determined and pass it to sprintf()

+ $args[0] = $lang[$key_found];

+ return call_user_func_array('sprintf', $args);

+ }

+

+ /**

+ * Loads common language files

+ */

+ protected function load_common_language_files()

+ {

+ if (!$this->common_language_files_loaded)

+ {

+ foreach ($this->common_language_files as $lang_file)

+ {

+ $this->load_core_file($lang_file);

+ }

+

+ $this->common_language_files_loaded = true;

+ }

+ }

+

+ /**

+ * Determine which plural form we should use.

+ *

+ * For some languages this is not as simple as for English.

+ *

+ * @param int|float $number The number we want to get the plural case for. Float numbers are floored.

+ * @param int|bool $force_rule False to use the plural rule of the language package

+ * or an integer to force a certain plural rule

+ *

+ * @return int The plural-case we need to use for the number plural-rule combination

+ *

+ * @throws \phpbb\language\exception\invalid_plural_rule_exception When $force_rule has an invalid value

+ */

+ public function get_plural_form($number, $force_rule = false)

+ {

+ $number = (int) $number;

+ $plural_rule = ($force_rule !== false) ? $force_rule : ((isset($this->lang['PLURAL_RULE'])) ? $this->lang['PLURAL_RULE'] : 1);

+

+ if ($plural_rule > 15 || $plural_rule < 0)

+ {

+ throw new invalid_plural_rule_exception('INVALID_PLURAL_RULE', array(

+ 'plural_rule' => $plural_rule,

+ ));

+ }

+

+ /**

+ * The following plural rules are based on a list published by the Mozilla Developer Network

+ * https://developer.mozilla.org/en/Localization_and_Plurals

+ */

+ switch ($plural_rule)

+ {

+ case 0:

+ /**

+ * Families: Asian (Chinese, Japanese, Korean, Vietnamese), Persian, Turkic/Altaic (Turkish), Thai, Lao

+ * 1 - everything: 0, 1, 2, ...

+ */

+ return 1;

+

+ case 1:

+ /**

+ * Families: Germanic (Danish, Dutch, English, Faroese, Frisian, German, Norwegian, Swedish), Finno-Ugric (Estonian, Finnish, Hungarian), Language isolate (Basque), Latin/Greek (Greek), Semitic (Hebrew), Romanic (Italian, Portuguese, Spanish, Catalan)

+ * 1 - 1

+ * 2 - everything else: 0, 2, 3, ...

+ */

+ return ($number === 1) ? 1 : 2;

+

+ case 2:

+ /**

+ * Families: Romanic (French, Brazilian Portuguese)

+ * 1 - 0, 1

+ * 2 - everything else: 2, 3, ...

+ */

+ return (($number === 0) || ($number === 1)) ? 1 : 2;

+

+ case 3:

+ /**

+ * Families: Baltic (Latvian)

+ * 1 - 0

+ * 2 - ends in 1, not 11: 1, 21, ... 101, 121, ...

+ * 3 - everything else: 2, 3, ... 10, 11, 12, ... 20, 22, ...

+ */

+ return ($number === 0) ? 1 : ((($number % 10 === 1) && ($number % 100 != 11)) ? 2 : 3);

+

+ case 4:

+ /**

+ * Families: Celtic (Scottish Gaelic)

+ * 1 - is 1 or 11: 1, 11

+ * 2 - is 2 or 12: 2, 12

+ * 3 - others between 3 and 19: 3, 4, ... 10, 13, ... 18, 19

+ * 4 - everything else: 0, 20, 21, ...

+ */

+ return ($number === 1 || $number === 11) ? 1 : (($number === 2 || $number === 12) ? 2 : (($number >= 3 && $number <= 19) ? 3 : 4));

+

+ case 5:

+ /**

+ * Families: Romanic (Romanian)

+ * 1 - 1

+ * 2 - is 0 or ends in 01-19: 0, 2, 3, ... 19, 101, 102, ... 119, 201, ...

+ * 3 - everything else: 20, 21, ...

+ */

+ return ($number === 1) ? 1 : ((($number === 0) || (($number % 100 > 0) && ($number % 100 < 20))) ? 2 : 3);

+

+ case 6:

+ /**

+ * Families: Baltic (Lithuanian)

+ * 1 - ends in 1, not 11: 1, 21, 31, ... 101, 121, ...

+ * 2 - ends in 0 or ends in 10-20: 0, 10, 11, 12, ... 19, 20, 30, 40, ...

+ * 3 - everything else: 2, 3, ... 8, 9, 22, 23, ... 29, 32, 33, ...

+ */

+ return (($number % 10 === 1) && ($number % 100 != 11)) ? 1 : ((($number % 10 < 2) || (($number % 100 >= 10) && ($number % 100 < 20))) ? 2 : 3);

+

+ case 7:

+ /**

+ * Families: Slavic (Croatian, Serbian, Russian, Ukrainian)

+ * 1 - ends in 1, not 11: 1, 21, 31, ... 101, 121, ...

+ * 2 - ends in 2-4, not 12-14: 2, 3, 4, 22, 23, 24, 32, ...

+ * 3 - everything else: 0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 25, 26, ...

+ */

+ return (($number % 10 === 1) && ($number % 100 != 11)) ? 1 : ((($number % 10 >= 2) && ($number % 10 <= 4) && (($number % 100 < 10) || ($number % 100 >= 20))) ? 2 : 3);

+

+ case 8:

+ /**

+ * Families: Slavic (Slovak, Czech)

+ * 1 - 1

+ * 2 - 2, 3, 4

+ * 3 - everything else: 0, 5, 6, 7, ...

+ */

+ return ($number === 1) ? 1 : ((($number >= 2) && ($number <= 4)) ? 2 : 3);

+

+ case 9:

+ /**

+ * Families: Slavic (Polish)

+ * 1 - 1

+ * 2 - ends in 2-4, not 12-14: 2, 3, 4, 22, 23, 24, 32, ... 104, 122, ...

+ * 3 - everything else: 0, 5, 6, ... 11, 12, 13, 14, 15, ... 20, 21, 25, ...

+ */

+ return ($number === 1) ? 1 : ((($number % 10 >= 2) && ($number % 10 <= 4) && (($number % 100 < 12) || ($number % 100 > 14))) ? 2 : 3);

+

+ case 10:

+ /**

+ * Families: Slavic (Slovenian, Sorbian)

+ * 1 - ends in 01: 1, 101, 201, ...

+ * 2 - ends in 02: 2, 102, 202, ...

+ * 3 - ends in 03-04: 3, 4, 103, 104, 203, 204, ...

+ * 4 - everything else: 0, 5, 6, 7, 8, 9, 10, 11, ...

+ */

+ return ($number % 100 === 1) ? 1 : (($number % 100 === 2) ? 2 : ((($number % 100 === 3) || ($number % 100 === 4)) ? 3 : 4));

+

+ case 11:

+ /**

+ * Families: Celtic (Irish Gaeilge)

+ * 1 - 1

+ * 2 - 2

+ * 3 - is 3-6: 3, 4, 5, 6

+ * 4 - is 7-10: 7, 8, 9, 10

+ * 5 - everything else: 0, 11, 12, ...

+ */

+ return ($number === 1) ? 1 : (($number === 2) ? 2 : (($number >= 3 && $number <= 6) ? 3 : (($number >= 7 && $number <= 10) ? 4 : 5)));

+

+ case 12:

+ /**

+ * Families: Semitic (Arabic)

+ * 1 - 1

+ * 2 - 2

+ * 3 - ends in 03-10: 3, 4, ... 10, 103, 104, ... 110, 203, 204, ...

+ * 4 - ends in 11-99: 11, ... 99, 111, 112, ...

+ * 5 - everything else: 100, 101, 102, 200, 201, 202, ...

+ * 6 - 0

+ */

+ return ($number === 1) ? 1 : (($number === 2) ? 2 : ((($number % 100 >= 3) && ($number % 100 <= 10)) ? 3 : ((($number % 100 >= 11) && ($number % 100 <= 99)) ? 4 : (($number != 0) ? 5 : 6))));

+

+ case 13:

+ /**

+ * Families: Semitic (Maltese)

+ * 1 - 1

+ * 2 - is 0 or ends in 01-10: 0, 2, 3, ... 9, 10, 101, 102, ...

+ * 3 - ends in 11-19: 11, 12, ... 18, 19, 111, 112, ...

+ * 4 - everything else: 20, 21, ...

+ */

+ return ($number === 1) ? 1 : ((($number === 0) || (($number % 100 > 1) && ($number % 100 < 11))) ? 2 : ((($number % 100 > 10) && ($number % 100 < 20)) ? 3 : 4));

+

+ case 14:

+ /**

+ * Families: Slavic (Macedonian)

+ * 1 - ends in 1: 1, 11, 21, ...

+ * 2 - ends in 2: 2, 12, 22, ...

+ * 3 - everything else: 0, 3, 4, ... 10, 13, 14, ... 20, 23, ...

+ */

+ return ($number % 10 === 1) ? 1 : (($number % 10 === 2) ? 2 : 3);

+

+ case 15:

+ /**

+ * Families: Icelandic

+ * 1 - ends in 1, not 11: 1, 21, 31, ... 101, 121, 131, ...

+ * 2 - everything else: 0, 2, 3, ... 10, 11, 12, ... 20, 22, ...

+ */

+ return (($number % 10 === 1) && ($number % 100 != 11)) ? 1 : 2;

+ }

+ }

+

+ /**

+ * Returns language fallback data

+ *

+ * @return array

+ */

+ protected function set_fallback_array()

+ {

+ $fallback_array = array();

+

+ if ($this->user_language !== false)

+ {

+ $fallback_array[] = $this->user_language;

+ }

+

+ if ($this->default_language !== false)

+ {

+ $fallback_array[] = $this->default_language;

+ }

+

+ $fallback_array[] = self::FALLBACK_LANGUAGE;

+

+ $this->language_fallback = $fallback_array;

+ }

+

+ /**

+ * Load core language file

+ *

+ * @param string $component Name of the component to load

+ */

+ protected function load_core_file($component)

+ {

+ // Check if the component is already loaded

+ if (isset($this->loaded_language_sets['core'][$component]))

+ {

+ return;

+ }

+

+ $this->loader->load($component, $this->language_fallback, $this->lang);

+ $this->loaded_language_sets['core'][$component] = true;

+ }

+

+ /**

+ * Load extension language file

+ *

+ * @param string $extension_name Name of the extension to load language from

+ * @param string $component Name of the component to load

+ */

+ protected function load_extension($extension_name, $component)

+ {

+ // Check if the component is already loaded

+ if (isset($this->loaded_language_sets['ext'][$extension_name][$component]))

+ {

+ return;

+ }

+

+ $this->loader->load_extension($extension_name, $component, $this->language_fallback, $this->lang);

+ $this->loaded_language_sets['ext'][$extension_name][$component] = true;

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language;

+

+use Symfony\Component\Finder\Finder;

+

+/**

+ * Helper class for language file related functions

+ */

+class language_file_helper

+{

+ /**

+ * @var string Path to phpBB's root

+ */

+ protected $phpbb_root_path;

+

+ /**

+ * Constructor

+ *

+ * @param string $phpbb_root_path Path to phpBB's root

+ */

+ public function __construct($phpbb_root_path)

+ {

+ $this->phpbb_root_path = $phpbb_root_path;

+ }

+

+ /**

+ * Returns available languages

+ *

+ * @return array

+ */

+ public function get_available_languages()

+ {

+ // Find available language packages

+ $finder = new Finder();

+ $finder->files()

+ ->name('iso.txt')

+ ->depth('== 1')

+ ->in($this->phpbb_root_path . 'language');

+

+ $available_languages = array();

+ foreach ($finder as $file)

+ {

+ $path = $file->getRelativePath();

+ $info = explode("\n", $file->getContents());

+

+ $available_languages[] = array(

+ // Get the name of the directory containing iso.txt

+ 'iso' => $path,

+

+ // Recover data from file

+ 'name' => trim($info[0]),

+ 'local_name' => trim($info[1]),

+ 'author' => trim($info[2])

+ );

+ }

+

+ return $available_languages;

+ }

+}

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\language;

+

+use \phpbb\language\exception\language_file_not_found;

+

+/**

+ * Language file loader

+ */

+class language_file_loader

+{

+ /**

+ * @var string Path to phpBB's root

+ */

+ protected $phpbb_root_path;

+

+ /**

+ * @var string Extension of PHP files

+ */

+ protected $php_ext;

+

+ /**

+ * @var \phpbb\extension\manager Extension manager

+ */

+ protected $extension_manager;

+

+ /**

+ * Constructor

+ *

+ * @param string $phpbb_root_path Path to phpBB's root

+ * @param string $php_ext Extension of PHP files

+ */

+ public function __construct($phpbb_root_path, $php_ext)

+ {

+ $this->phpbb_root_path = $phpbb_root_path;

+ $this->php_ext = $php_ext;

+

+ $this->extension_manager = null;

+ }

+

+ /**

+ * Extension manager setter

+ *

+ * @param \phpbb\extension\manager $extension_manager Extension manager

+ */

+ public function set_extension_manager(\phpbb\extension\manager $extension_manager)

+ {

+ $this->extension_manager = $extension_manager;

+ }

+

+ /**

+ * Loads language array for the given component

+ *

+ * @param string $component Name of the language component

+ * @param string|array $locale ISO code of the language to load, or array of ISO codes if you want to

+ * specify additional language fallback steps

+ * @param array $lang Array reference containing language strings

+ */

+ public function load($component, $locale, &$lang)

+ {

+ $locale = (array) $locale;

+

+ // Determine path to language directory

+ $path = $this->phpbb_root_path . 'language/';

+

+ $this->load_file($path, $component, $locale, $lang);

+ }

+

+ /**

+ * Loads language array for the given extension component

+ *

+ * @param string $extension Name of the extension

+ * @param string $component Name of the language component

+ * @param string|array $locale ISO code of the language to load, or array of ISO codes if you want to

+ * specify additional language fallback steps

+ * @param array $lang Array reference containing language strings

+ */

+ public function load_extension($extension, $component, $locale, &$lang)

+ {

+ // Check if extension manager was loaded

+ if ($this->extension_manager === null)

+ {

+ // If not, let's return

+ return;

+ }

+

+ $locale = (array) $locale;

+

+ // Determine path to language directory

+ $path = $this->extension_manager->get_extension_path($extension, true) . 'language/';

+

+ $this->load_file($path, $component, $locale, $lang);

+ }

+

+ /**

+ * Prepares language file loading

+ *

+ * @param string $path Path to search for file in

+ * @param string $component Name of the language component

+ * @param array $locale Array containing language fallback options

+ * @param array $lang Array reference of language strings

+ */

+ protected function load_file($path, $component, $locale, &$lang)

+ {

+ // This is BC stuff and not the best idea as it makes language fallback

+ // implementation quite hard like below.

+ if (strpos($this->phpbb_root_path . $component, $path) === 0)

+ {

+ // Filter out the path

+ $path_diff = str_replace($path, '', dirname($this->phpbb_root_path . $component));

+ $language_file = basename($component, '.' . $this->php_ext);

+ $component = '';

+

+ // This step is needed to resolve language/en/subdir style $component

+ // $path already points to the language base directory so we need to eliminate

+ // the first directory from the path (that should be the language directory)

+ $path_diff_parts = explode('/', $path_diff);

+

+ if (sizeof($path_diff_parts) > 1)

+ {

+ array_shift($path_diff_parts);

+ $component = implode('/', $path_diff_parts) . '/';

+ }

+

+ $component .= $language_file;

+ }

+

+ // Determine filename

+ $filename = $component . '.' . $this->php_ext;

+

+ // Determine path to file

+ $file_path = $this->get_language_file_path($path, $filename, $locale);

+

+ // Load language array

+ $this->load_language_file($file_path, $lang);

+ }

+

+ /**

+ * This function implements language fallback logic

+ *

+ * @param string $path Path to language directory

+ * @param string $filename Filename to load language strings from

+ *

+ * @return string Relative path to language file

+ *

+ * @throws \phpbb\language\exception\language_file_not_found When the path to the file cannot be resolved

+ */

+ protected function get_language_file_path($path, $filename, $locales)

+ {

+ $language_file_path = $filename;

+

+ // Language fallback logic

+ foreach ($locales as $locale)

+ {

+ $language_file_path = $path . $locale . '/' . $filename;

+

+ // If we are in install, try to use the updated version, when available

+ if (defined('IN_INSTALL'))

+ {

+ $install_language_path = str_replace('language/', 'install/update/new/language/', $language_file_path);

+ if (file_exists($install_language_path))

+ {

+ return $install_language_path;

+ }

+ }

+

+ if (file_exists($language_file_path))

+ {

+ return $language_file_path;

+ }

+ }

+

+ // The language file is not exist

+ throw new language_file_not_found('Language file ' . $language_file_path . ' couldn\'t be opened.');

+ }

+

+ /**

+ * Loads language file

+ *

+ * @param string $path Path to language file to load

+ * @param array $lang Reference of the array of language strings

+ */

+ protected function load_language_file($path, &$lang)

+ {

+ // Do not suppress error if in DEBUG mode

+ if (defined('DEBUG'))

+ {

+ include $path;

+ }

+ else

+ {

+ @include $path;

+ }

+ }

+}

+* Dummy logger

+class dummy implements log_interface

+ $get_logs_sql_ary = array(

+ 'SELECT' => 'l.*, u.username, u.username_clean, u.user_colour',

+ 'FROM' => array(

+ $this->log_table => 'l',

+ USERS_TABLE => 'u',

+ ),

+ 'WHERE' => 'l.log_type = ' . (int) $log_type . "

+ $sql_additional",

+

+ 'ORDER_BY' => $sort_by,

+ );

+

+ if($log_time)

+ {

+ $get_logs_sql_ary['WHERE'] = 'l.log_time >= ' . (int) $log_time . '

+ AND ' . $get_logs_sql_ary['WHERE'];

+ }

+

+ /**

+ * Modify the query to obtain the logs data

+ *

+ * @event core.get_logs_main_query_before

+ * @var array get_logs_sql_ary The array in the format of the query builder with the query

+ * to get the log count and the log list

+ * @var string mode Mode of the entries we display

+ * @var bool count_logs Do we count all matching entries?

+ * @var int limit Limit the number of entries

+ * @var int offset Offset when fetching the entries

+ * @var mixed forum_id Limit entries to the forum_id,

+ * can also be an array of forum_ids

+ * @var int topic_id Limit entries to the topic_id

+ * @var int user_id Limit entries to the user_id

+ * @var int log_time Limit maximum age of log entries

+ * @var string sort_by SQL order option

+ * @var string keywords Will only return entries that have the

+ * keywords in log_operation or log_data

+ * @var string profile_url URL to the users profile

+ * @var int log_type Limit logs to a certain type. If log_type

+ * is false, no entries will be returned.

+ * @var string sql_additional Additional conditions for the entries,

+ * e.g.: 'AND l.forum_id = 1'

+ * @since 3.1.5-RC1

+ */

+ $vars = array(

+ 'get_logs_sql_ary',

+ 'mode',

+ 'count_logs',

+ 'limit',

+ 'offset',

+ 'forum_id',

+ 'topic_id',

+ 'user_id',

+ 'log_time',

+ 'sort_by',

+ 'keywords',

+ 'profile_url',

+ 'log_type',

+ 'sql_additional',

+ );

+ extract($this->dispatcher->trigger_event('core.get_logs_main_query_before', compact($vars)));

+

+ if ($count_logs)

+ {

+ $count_logs_sql_ary = $get_logs_sql_ary;

+

+ $count_logs_sql_ary['SELECT'] = 'COUNT(l.log_id) AS total_entries';

+ unset($count_logs_sql_ary['ORDER_BY']);

+

+ $sql = $this->db->sql_build_query('SELECT', $count_logs_sql_ary);

+ $sql = $this->db->sql_build_query('SELECT', $get_logs_sql_ary);

+class exception extends \phpbb\exception\runtime_exception

+ throw new \phpbb\notification\exception('NOTIFICATION_TYPE_NOT_EXIST', array($notification_type_name));

+ * @var \phpbb\textformatter\utils_interface

+ */

+ protected $utils;

+

+ /**

+ $usernames = $this->utils->get_outermost_quote_authors($post['post_text']);

+ if (empty($usernames))

+ $usernames = array_unique($usernames);

+ $usernames = array_map('utf8_clean_string', $usernames);

+

+ /**

+ * Set the utils service used to retrieve quote authors

+ *

+ * @param \phpbb\textformatter\utils_interface $utils

+ */

+ public function set_utils(\phpbb\textformatter\utils_interface $utils)

+ {

+ $this->utils = $utils;

+ }

+ 'm_info' => array('lang' => 'ACL_M_INFO', 'cat' => 'post_actions'),

+ 'm_softdelete' => array('lang' => 'ACL_M_SOFTDELETE', 'cat' => 'post_actions'),

+use Symfony\Component\Filesystem\Exception\IOException;

+ * @param string $phpbb_root_path phpBB root path

+ * @param string $php_ext PHP file extension

+ * @param string $environment Name of the current environment

+ * @param manager|null $extension_manager Extension manager

+ * @param array $routing_files Array of strings containing paths to YAML files

+ * holding route information

+ public function __construct(\phpbb\filesystem\filesystem_interface $filesystem, $phpbb_root_path, $php_ext, $environment, manager $extension_manager = null, $routing_files = array())

+ $this->find_routing_files(

+ ($this->extension_manager !== null) ? $this->extension_manager->all_enabled(false) : array()

+ )

+ try

+ $cache = new ConfigCache("{$this->phpbb_root_path}cache/{$this->environment}/url_matcher.{$this->php_ext}", defined('DEBUG'));

+ if (!$cache->isFresh())

+ {

+ $dumper = new PhpMatcherDumper($this->get_routes());

+ $options = array(

+ 'class' => 'phpbb_url_matcher',

+ 'base_class' => 'Symfony\\Component\\Routing\\Matcher\\UrlMatcher',

+ );

+ $cache->write($dumper->dump($options), $this->get_routes()->getResources());

+ }

+ require_once($cache->getPath());

+ $this->matcher = new \phpbb_url_matcher($this->context);

+ }

+ catch (IOException $e)

+ {

+ $this->create_new_url_matcher();

+ }

+ try

+ $cache = new ConfigCache("{$this->phpbb_root_path}cache/{$this->environment}/url_generator.{$this->php_ext}", defined('DEBUG'));

+ if (!$cache->isFresh())

+ {

+ $dumper = new PhpGeneratorDumper($this->get_routes());

+ $options = array(

+ 'class' => 'phpbb_url_generator',

+ 'base_class' => 'Symfony\\Component\\Routing\\Generator\\UrlGenerator',

+ );

+ $cache->write($dumper->dump($options), $this->get_routes()->getResources());

+ }

+ require_once($cache->getPath());

+ $this->generator = new \phpbb_url_generator($this->context);

+ }

+ catch (IOException $e)

+ {

+ $this->create_new_url_generator();

+ }

+ /** @var \phpbb\filesystem\filesystem */

+ protected $filesystem;

+

+ * @param \phpbb\filesystem\filesystem $filesystem

+ public function __construct($url, \phpbb\path_helper $path_helper, \phpbb\filesystem\filesystem $filesystem)

+ $this->filesystem = $filesystem;

+ // Since 1.7.0 Twig returns the real path of the file. We need it to be relative.

+ $real_root_path = $this->filesystem->realpath($this->path_helper->get_phpbb_root_path()) . DIRECTORY_SEPARATOR;

+

+ // If the asset is under the phpBB root path we need to remove its path and then prepend $phpbb_root_path

+ if ($real_root_path && substr($path . DIRECTORY_SEPARATOR, 0, strlen($real_root_path)) === $real_root_path)

+ {

+ $path = $this->path_helper->get_phpbb_root_path() . str_replace('\\', '/', substr($path, strlen($real_root_path)));

+ }

+ else

+ {

+ // Else we make the path relative to the current working directory

+ $real_root_path = $this->filesystem->realpath('.') . DIRECTORY_SEPARATOR;

+ if ($real_root_path && substr($path . DIRECTORY_SEPARATOR, 0, strlen($real_root_path)) === $real_root_path)

+ {

+ $path = str_replace('\\', '/', substr($path, strlen($real_root_path)));

+ }

+<?php

+/**

+ *

+ * This file is part of the phpBB Forum Software package.

+ *

+ * @copyright (c) phpBB Limited <https://www.phpbb.com>

+ * @license GNU General Public License, version 2 (GPL-2.0)

+ *

+ * For full copyright and license information, please see

+ * the docs/CREDITS.txt file.

+ *

+ */

+

+namespace phpbb\template\exception;

+

+/**

+ * This exception is thrown when the user object was not set but it is required by the called method

+ */

+class user_object_not_available extends \phpbb\exception\runtime_exception

+{

+

+}

+ /** @var \phpbb\filesystem\filesystem */

+ protected $filesystem;

+

+ * @param \phpbb\filesystem\filesystem $filesystem

+ public function __construct(\phpbb\config\config $phpbb_config, \phpbb\filesystem\filesystem $filesystem, \phpbb\path_helper $path_helper, \Symfony\Component\DependencyInjection\ContainerInterface $container, $cache_path, \phpbb\extension\manager $extension_manager = null, \Twig_LoaderInterface $loader = null, $options = array())

+ $this->filesystem = $filesystem;

+ 'debug' => false,

+ * Get the phpBB root path

+ *

+ * @return string

+ */

+ * Get the filesystem object

+ *

+ * @return \phpbb\filesystem\filesystem

+ */

+ public function get_filesystem()

+ {

+ return $this->filesystem;

+ }

+

+ /**

+ /** @var \phpbb\language\language */

+ protected $language;

+ * @param \phpbb\language\language $language

+ public function __construct(\phpbb\template\context $context, $language)

+ $this->language = $language;

+ return call_user_func_array(array($this->language, 'lang'), $args);

+ if (isset($this->cache[$name]))

+ {

+ if ($this->getAttribute('capture'))

+ {

+ ->write("\$asset = new \phpbb\\template\\asset(\$asset_file, \$this->getEnvironment()->get_path_helper(), \$this->getEnvironment()->get_filesystem());\n")

+ if ($this->getAttribute('ignore_missing'))

+ {

+ if ($this->getAttribute('ignore_missing'))

+ {

+ if ($stream->test(\Twig_Token::OPERATOR_TYPE, '='))

+ {

+ }

+ else

+ {

+ if ($stream->test(\Twig_Token::NAME_TYPE, 'ignore'))

+ {

+use phpbb\template\exception\user_object_not_available;

+

+ * @param \phpbb\user|null $user

+ public function __construct(\phpbb\path_helper $path_helper, $config, \phpbb\template\context $context, \phpbb\template\twig\environment $twig_environment, $cache_path, \phpbb\user $user = null, $extensions = array(), \phpbb\extension\manager $extension_manager = null)

+ *

+ * @throws \phpbb\template\exception\user_object_not_available When user service was not set

+ if ($this->user === null)

+ {

+ throw new user_object_not_available();

+ }

+

+ if ($this->user instanceof \phpbb\user)

+ {

+ $vars['user'] = $this->user;

+ }

+

+ * @return array[] Array of arrays. Each array contains a lang string at index 0 plus any number

+ * of optional parameters

+ public function __construct(\phpbb\cache\driver\driver_interface $cache, $key, factory $factory, \phpbb\event\dispatcher_interface $dispatcher)

+ * - toggle features or BBCodes

+ * - register variables or custom parsers in the s9e\TextFormatter parser

+ * - configure the s9e\TextFormatter parser's runtime settings

+ $vars = array('parser');

+ * This will convert the log entries found in s9e\TextFormatter's logger into phpBB error

+ $errors[] = array('TOO_MANY_SMILIES', $context['tagLimit']);

+ $errors[] = array('TOO_MANY_URLS', $context['tagLimit']);

+ $errors[] = array($msg, $context['max_size']);

+ $errors[] = array($msg, $context['max_' . strtolower($m[1])]);

+ $errors[] = array('UNAUTHORISED_BBCODE', '[' . $name . ']');

+ $errors[] = array($msg);

+ // Deduplicate error messages. array_unique() only works on strings so we have to serialize

+ if (!empty($errors))

+ {

+ $errors = array_map('unserialize', array_unique(array_map('serialize', $errors)));

+ }

+

+ return $errors;

+ * Return given string between quotes

+ *

+ * Will use either single- or double- quotes depending on whichever requires less escaping.

+ * Quotes and backslashes are escaped with backslashes where necessary

+ *

+ * @param string $str Original string

+ * @return string Escaped string within quotes

+ */

+ protected function enquote($str)

+ {

+ $singleQuoted = "'" . addcslashes($str, "\\'") . "'";

+ $doubleQuoted = '"' . addcslashes($str, '\\"') . '"';

+

+ return (strlen($singleQuoted) < strlen($doubleQuoted)) ? $singleQuoted : $doubleQuoted;

+ }

+

+ /**

+ * {@inheritdoc}

+ */

+ public function generate_quote($text, array $attributes = array())

+ {

+ $quote = '[quote';

+ if (isset($attributes['author']))

+ {

+ // Add the author as the BBCode's default attribute

+ $quote .= '=' . $this->enquote($attributes['author']);

+ unset($attributes['author']);

+ }

+ foreach ($attributes as $name => $value)

+ {

+ $quote .= ' ' . $name . '=' . $this->enquote($value);

+ }

+ $quote .= ']' . $text . '[/quote]';

+

+ return $quote;

+ }

+

+ /**

+ * Get a list of quote authors, limited to the outermost quotes

+ *

+ * @param string $xml Parsed text

+ * @return string[] List of authors

+ */

+ public function get_outermost_quote_authors($xml)

+ {

+ $authors = array();

+ if (strpos($xml, '<QUOTE ') === false)

+ {

+ return $authors;

+ }

+

+ $dom = new \DOMDocument;

+ $dom->loadXML($xml);

+ $xpath = new \DOMXPath($dom);

+ foreach ($xpath->query('//QUOTE[not(ancestor::QUOTE)]/@author') as $author)

+ {

+ $authors[] = $author->textContent;

+ }

+

+ return $authors;

+ }

+

+ /**

+ * Create a quote block for given text

+ *

+ * Possible attributes:

+ * - author

+ *

+ * @param string $text Quote's text

+ * @param array $attributes Quote's attributes

+ * @return string Quote block to be used in a new post/text

+ */

+ public function generate_quote($text, array $attributes = array());

+

+ /**

+ * Get a list of quote authors, limited to the outermost quotes

+ *

+ * @param string $text Parsed text

+ * @return string[] List of authors

+ */

+ public function get_outermost_quote_authors($text);

+

+ /**

+ /**

+ * @var \phpbb\language\language

+ */

+ protected $language;

+

+ /** @var bool */

+ protected $is_setup_flag;

+

+ *

+ * @param \phpbb\language\language $lang phpBB's Language loader

+ function __construct(\phpbb\language\language $lang, $datetime_class)

+ $this->language = $lang;

+

+ $this->is_setup_flag = false;

+ * Returns whether user::setup was called

+ *

+ * @return bool

+ */

+ public function is_setup()

+ return $this->is_setup_flag;

+ }

+ /**

+ * Magic getter for BC compatibility

+ *

+ * Implement array access for user::lang.

+ *

+ * @param string $param_name Name of the BC component the user want to access

+ *

+ * @return array The appropriate array

+ *

+ * @deprecated 3.2.0-dev (To be removed: 4.0.0)

+ */

+ public function __get($param_name)

+ {

+ if ($param_name === 'lang')

+ {

+ return $this->language->get_lang_array();

+ }

+ else if ($param_name === 'help')

+ $help_array = $this->language->get_lang_array();

+ return $help_array['__help'];

+

+ return array();

+ $this->language->set_default_language($config['default_lang']);

+

+

+

+ $this->language->set_user_language($user_lang_name);

+

+ $this->is_setup_flag = true;

+

+ *

+ * @deprecated 3.2.0-dev (To be removed 4.0.0)

+ return call_user_func_array(array($this->language, 'lang'), $args);

+ * @return int|bool The plural-case we need to use for the number plural-rule combination, false if $force_rule

+ * was invalid.

+ *

+ * @deprecated: 3.2.0-dev (To be removed: 3.3.0)

+ return $this->language->get_plural_form($number, $force_rule);

+ * @param bool $use_db internal variable for recursion, do not use @deprecated 3.2.0-dev (To be removed: 3.3.0)

+ * @param bool $use_help internal variable for recursion, do not use @deprecated 3.2.0-dev (To be removed: 3.3.0)

+ *

+ * Note: $use_db and $use_help should be removed. The old function was kept for BC purposes,

+ * so the BC logic is handled here.

+ *

+ * @deprecated: 3.2.0-dev (To be removed: 3.3.0)

+ // This is never used

+ $this->set_lang($lang_file, $use_help, $ext_name);

+ $this->set_lang($lang_set, $use_help, $ext_name);

+ }

+ }

+

+ /**

+ * BC function for loading language files

+ *

+ * @deprecated 3.2.0-dev (To be removed: 3.3.0)

+ */

+ private function set_lang($lang_set, $use_help, $ext_name)

+ {

+ if (empty($ext_name))

+ {

+ $ext_name = null;

+ }

+

+ if ($use_help && strpos($lang_set, '/') !== false)

+ {

+ $component = dirname($lang_set) . '/help_' . basename($lang_set);

+

+ if ($component[0] === '/')

+ {

+ $component = substr($component, 1);

+ }

+ }

+ else

+ {

+ $component = (($use_help) ? 'help_' : '') . $lang_set;

+

+ $this->language->add_lang($component, $ext_name);

+ *

+ * Note: $use_db and $use_help should be removed. Kept for BC purposes.

+ *

+ * @deprecated: 3.2.0-dev (To be removed: 3.3.0)

+ $alt = $this->language->lang($alt);