+ * @param $visibility int Element of {ITEM_APPROVED, ITEM_DELETED, ITEM_REAPPROVE}

+ * @param $reason string Reason why the visibility was changed.

+ * @return array Changed post data, empty array if an error occurred.

+ if (!in_array($visibility, array(ITEM_APPROVED, ITEM_DELETED, ITEM_REAPPROVE)))

+ if (in_array($visibility, array(ITEM_REAPPROVE, ITEM_DELETED)))

+ $field_alias = array(

+ ITEM_APPROVED => 'posts_approved',

+ ITEM_UNAPPROVED => 'posts_unapproved',

+ ITEM_DELETED => 'posts_softdeleted',

+ ITEM_REAPPROVE => 'posts_unapproved',

+ );

+ $cur_posts = array_fill_keys($field_alias, 0);

+

+ $cur_posts[$field_alias[(int) $post_visibility]] += $visibility_posts;

+ $recipient_field = $field_alias[$visibility];

+

+ foreach ($cur_posts as $field => $count)

+ // Decrease the count for the old statuses.

+ if ($count && $field != $recipient_field)

+ $sql_ary[$field] = " - $count";

+ // Add up the count from all statuses excluding the recipient status.

+ $count_increase = array_sum(array_diff($cur_posts, array($recipient_field)));

+

+ if ($count_increase)

+ $sql_ary[$recipient_field] = " + $count_increase";

+ * @param $visibility int Element of {ITEM_APPROVED, ITEM_DELETED, ITEM_REAPPROVE}

+ if (!in_array($visibility, array(ITEM_APPROVED, ITEM_DELETED, ITEM_REAPPROVE)))

+ // If we're soft deleting a topic we only mark approved posts as soft deleted.

+<?php

+/**

+*

+* @package migration

+* @copyright (c) 2014 phpBB Group

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

+*

+*/

+

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

+

+class auth_provider_oauth2 extends \phpbb\db\migration\migration

+{

+ static public function depends_on()

+ {

+ return array(

+ '\phpbb\db\migration\data\v310\auth_provider_oauth',

+ );

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('custom', array(

+ array($this, 'update_auth_link_module_auth'),

+ )),

+ );

+ }

+

+ public function update_auth_link_module_auth()

+ {

+ $sql = 'UPDATE ' . MODULES_TABLE . "

+ SET module_auth = 'authmethod_oauth'

+ WHERE module_class = 'ucp'

+ AND module_basename = 'ucp_auth_link'

+ AND module_mode = 'auth_link'

+ AND module_auth = ''";

+ $this->db->sql_query($sql);

+ }

+}

+<?php

+/**

+*

+* @package migration

+* @copyright (c) 2014 phpBB Group

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

+*

+*/

+

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

+

+class board_contact_name extends \phpbb\db\migration\migration

+{

+ public function effectively_installed()

+ {

+ return isset($this->config['board_contact_name']);

+ }

+

+ static public function depends_on()

+ {

+ return array('\phpbb\db\migration\data\v310\beta2');

+ }

+

+ public function update_data()

+ {

+ return array(

+ array('config.add', array('board_contact_name', '')),

+ );

+ }

+}

+ if (!$start)

+ {

+ // Preserve the forum_posts value for link forums as it represents redirects.

+ $sql = 'UPDATE ' . $this->table_prefix . 'forums

+ SET forum_posts_approved = forum_posts

+ WHERE forum_type = ' . FORUM_LINK;

+ $this->db->sql_query($sql);

+ }

+

+ if ($reverse)

+ {

+ return false;

+ }

+ else

+ {

+ return array(

+ $parameters[0],

+ array($last_result),

+ );

+ }

+ * Is the used MS SQL Server a SQL Server 2000?

+ * @var bool

+ */

+ protected $is_sql_server_2000;

+

+ /**

+ // Add unique indexes?

+ * Check if a specified index exists in table. Does not return PRIMARY KEY indexes.

+ // We need the data here

+ $old_return_statements = $this->return_statements;

+ $this->return_statements = true;

+ $indexes = $this->mssql_get_existing_indexes($table_name, $column_name);

+ // Drop any indexes

+ $recreate_indexes = array();

+ if (!empty($indexes))

+ {

+ foreach ($indexes as $index_name => $index_data)

+ $result = $this->sql_index_drop($table_name, $index_name);

+ $statements = array_merge($statements, $result);

+ if (sizeof($index_data) > 1)

+ {

+ // Remove this column from the index and recreate it

+ $recreate_indexes[$index_name] = array_diff($index_data, array($column_name));

+ }

+ // Drop default value constraint

+ $result = $this->mssql_get_drop_default_constraints_queries($table_name, $column_name);

+ $statements = array_merge($statements, $result);

+

+ // Remove the column

+

+ if (!empty($recreate_indexes))

+ {

+ // Recreate indexes after we removed the column

+ foreach ($recreate_indexes as $index_name => $index_data)

+ {

+ $result = $this->sql_create_index($table_name, $index_name, $index_data);

+ $statements = array_merge($statements, $result);

+ }

+ }

+

+ $this->return_statements = $old_return_statements;

+ // We need the data here

+ $old_return_statements = $this->return_statements;

+ $this->return_statements = true;

+

+ $indexes = $this->mssql_get_existing_indexes($table_name, $column_name);

+

+ // Drop any indexes

+ if (!empty($indexes))

+ {

+ foreach ($indexes as $index_name => $index_data)

+ {

+ $result = $this->sql_index_drop($table_name, $index_name);

+ $statements = array_merge($statements, $result);

+ }

+ }

+

+ // Drop default value constraint

+ $result = $this->mssql_get_drop_default_constraints_queries($table_name, $column_name);

+ $statements = array_merge($statements, $result);

+

+ // Change the column

+ // Add new default value constraint

+ $statements[] = 'ALTER TABLE [' . $table_name . '] ADD CONSTRAINT [DF_' . $table_name . '_' . $column_name . '_1] ' . $this->db->sql_escape($column_data['default']) . ' FOR [' . $column_name . ']';

+ }

+ if (!empty($indexes))

+ {

+ // Recreate indexes after we changed the column

+ foreach ($indexes as $index_name => $index_data)

+ $result = $this->sql_create_index($table_name, $index_name, $index_data);

+ $statements = array_merge($statements, $result);

+

+ $this->return_statements = $old_return_statements;

+

+ /**

+ * Get queries to drop the default constraints of a column

+ *

+ * We need to drop the default constraints of a column,

+ * before being able to change their type or deleting them.

+ *

+ * @param string $table_name

+ * @param string $column_name

+ * @return array Array with SQL statements

+ */

+ protected function mssql_get_drop_default_constraints_queries($table_name, $column_name)

+ {

+ $statements = array();

+ if ($this->mssql_is_sql_server_2000())

+ {

+ // http://msdn.microsoft.com/en-us/library/aa175912%28v=sql.80%29.aspx

+ // Deprecated in SQL Server 2005

+ $sql = "SELECT so.name AS def_name

+ FROM sysobjects so

+ JOIN sysconstraints sc ON so.id = sc.constid

+ WHERE object_name(so.parent_obj) = '{$table_name}'

+ AND so.xtype = 'D'

+ AND sc.colid = (SELECT colid FROM syscolumns

+ WHERE id = object_id('{$table_name}')

+ AND name = '{$column_name}')";

+ }

+ else

+ {

+ $sql = "SELECT dobj.name AS def_name

+ FROM sys.columns col

+ LEFT OUTER JOIN sys.objects dobj ON (dobj.object_id = col.default_object_id AND dobj.type = 'D')

+ WHERE col.object_id = object_id('{$table_name}')

+ AND col.name = '{$column_name}'

+ AND dobj.name IS NOT NULL";

+ }

+

+ $result = $this->db->sql_query($sql);

+ while ($row = $this->db->sql_fetchrow($result))

+ {

+ $statements[] = 'ALTER TABLE [' . $table_name . '] DROP CONSTRAINT [' . $row['def_name'] . ']';

+ }

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

+

+ return $statements;

+ }

+

+ /**

+ * Get a list with existing indexes for the column

+ *

+ * @param string $table_name

+ * @param string $column_name

+ * @return array Array with Index name => columns

+ */

+ protected function mssql_get_existing_indexes($table_name, $column_name)

+ {

+ $existing_indexes = array();

+ if ($this->mssql_is_sql_server_2000())

+ {

+ // http://msdn.microsoft.com/en-us/library/aa175912%28v=sql.80%29.aspx

+ // Deprecated in SQL Server 2005

+ $sql = "SELECT DISTINCT ix.name AS phpbb_index_name

+ FROM sysindexes ix

+ INNER JOIN sysindexkeys ixc

+ ON ixc.id = ix.id

+ AND ixc.indid = ix.indid

+ INNER JOIN syscolumns cols

+ ON cols.colid = ixc.colid

+ AND cols.id = ix.id

+ WHERE ix.id = object_id('{$table_name}')

+ AND cols.name = '{$column_name}'";

+ }

+ else

+ {

+ $sql = "SELECT DISTINCT ix.name AS phpbb_index_name

+ FROM sys.indexes ix

+ INNER JOIN sys.index_columns ixc

+ ON ixc.object_id = ix.object_id

+ AND ixc.index_id = ix.index_id

+ INNER JOIN sys.columns cols

+ ON cols.column_id = ixc.column_id

+ AND cols.object_id = ix.object_id

+ WHERE ix.object_id = object_id('{$table_name}')

+ AND cols.name = '{$column_name}'";

+ }

+

+ $result = $this->db->sql_query($sql);

+ $existing_indexes = array();

+ while ($row = $this->db->sql_fetchrow($result))

+ {

+ $existing_indexes[$row['phpbb_index_name']] = array();

+ }

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

+

+ if (empty($existing_indexes))

+ {

+ return array();

+ }

+

+ if ($this->mssql_is_sql_server_2000())

+ {

+ $sql = "SELECT DISTINCT ix.name AS phpbb_index_name, cols.name AS phpbb_column_name

+ FROM sysindexes ix

+ INNER JOIN sysindexkeys ixc

+ ON ixc.id = ix.id

+ AND ixc.indid = ix.indid

+ INNER JOIN syscolumns cols

+ ON cols.colid = ixc.colid

+ AND cols.id = ix.id

+ WHERE ix.id = object_id('{$table_name}')

+ AND " . $this->db->sql_in_set('ix.name', array_keys($existing_indexes));

+ }

+ else

+ {

+ $sql = "SELECT DISTINCT ix.name AS phpbb_index_name, cols.name AS phpbb_column_name

+ FROM sys.indexes ix

+ INNER JOIN sys.index_columns ixc

+ ON ixc.object_id = ix.object_id

+ AND ixc.index_id = ix.index_id

+ INNER JOIN sys.columns cols

+ ON cols.column_id = ixc.column_id

+ AND cols.object_id = ix.object_id

+ WHERE ix.object_id = object_id('{$table_name}')

+ AND " . $this->db->sql_in_set('ix.name', array_keys($existing_indexes));

+ }

+

+ $result = $this->db->sql_query($sql);

+

+ while ($row = $this->db->sql_fetchrow($result))

+ {

+ $existing_indexes[$row['phpbb_index_name']][] = $row['phpbb_column_name'];

+ }

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

+

+ return $existing_indexes;

+ }

+

+ /**

+ * Is the used MS SQL Server a SQL Server 2000?

+ *

+ * @return bool

+ */

+ protected function mssql_is_sql_server_2000()

+ {

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

+ {

+ $sql = "SELECT CAST(SERVERPROPERTY('productversion') AS VARCHAR(25)) AS mssql_version";

+ $result = $this->db->sql_query($sql);

+ $properties = $this->db->sql_fetchrow($result);

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

+ $this->is_sql_server_2000 = $properties['mssql_version'][0] == '8';

+ }

+

+ return $this->is_sql_server_2000;

+ }

+<?php

+/**

+*

+* @package phpBB3

+* @copyright (c) 2014 phpBB Group

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

+*

+*/

+

+namespace phpbb\event;

+

+/**

+* Class md_exporter

+* Crawls through a markdown file and grabs all events

+*

+* @package phpbb\event

+*/

+class md_exporter

+{

+ /** @var string Path where we look for files*/

+ protected $path;

+

+ /** @var string phpBB Root Path */

+ protected $root_path;

+

+ /** @var string */

+ protected $filter;

+

+ /** @var string */

+ protected $current_event;

+

+ /** @var array */

+ protected $events;

+

+ /**

+ * @param string $phpbb_root_path

+ * @param mixed $extension String 'vendor/ext' to filter, null for phpBB core

+ */

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

+ {

+ $this->root_path = $phpbb_root_path;

+ $this->path = $this->root_path;

+ if ($extension)

+ {

+ $this->path .= 'ext/' . $extension . '/';

+ }

+

+ $this->events = array();

+ $this->events_by_file = array();

+ $this->filter = $this->current_event = '';

+ }

+

+ /**

+ * Get the list of all events

+ *

+ * @return array Array with events: name => details

+ */

+ public function get_events()

+ {

+ return $this->events;

+ }

+

+ /**

+ * @param string $md_file Relative from phpBB root

+ * @return int Number of events found

+ * @throws \LogicException

+ */

+ public function crawl_phpbb_directory_adm($md_file)

+ {

+ $this->crawl_eventsmd($md_file, 'adm');

+

+ $file_list = $this->get_recursive_file_list($this->path . 'adm/style/');

+ foreach ($file_list as $file)

+ {

+ $file_name = 'adm/style/' . $file;

+ $this->validate_events_from_file($file_name, $this->crawl_file_for_events($file_name));

+ }

+

+ return sizeof($this->events);

+ }

+

+ /**

+ * @param string $md_file Relative from phpBB root

+ * @return int Number of events found

+ * @throws \LogicException

+ */

+ public function crawl_phpbb_directory_styles($md_file)

+ {

+ $this->crawl_eventsmd($md_file, 'styles');

+

+ $styles = array('prosilver', 'subsilver2');

+ foreach ($styles as $style)

+ {

+ $file_list = $this->get_recursive_file_list(

+ $this->path . 'styles/' . $style . '/template/'

+ );

+

+ foreach ($file_list as $file)

+ {

+ $file_name = 'styles/' . $style . '/template/' . $file;

+ $this->validate_events_from_file($file_name, $this->crawl_file_for_events($file_name));

+ }

+ }

+

+ return sizeof($this->events);

+ }

+

+ /**

+ * @param string $md_file Relative from phpBB root

+ * @param string $filter Should be 'styles' or 'adm'

+ * @return int Number of events found

+ * @throws \LogicException

+ */

+ public function crawl_eventsmd($md_file, $filter)

+ {

+ if (!file_exists($this->path . $md_file))

+ {

+ throw new \LogicException("The event docs file '{$md_file}' could not be found");

+ }

+

+ $file_content = file_get_contents($this->path . $md_file);

+ $this->filter = $filter;

+

+ $events = explode("\n\n", $file_content);

+ foreach ($events as $event)

+ {

+ // Last row of the file

+ if (strpos($event, "\n===\n") === false)

+ {

+ continue;

+ }

+

+ list($event_name, $details) = explode("\n===\n", $event, 2);

+ $this->validate_event_name($event_name);

+ $this->current_event = $event_name;

+

+ if (isset($this->events[$this->current_event]))

+ {

+ throw new \LogicException("The event '{$this->current_event}' is defined multiple times");

+ }

+

+ if (($this->filter == 'adm' && strpos($this->current_event, 'acp_') !== 0)

+ || ($this->filter == 'styles' && strpos($this->current_event, 'acp_') === 0))

+ {

+ continue;

+ }

+

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

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

+

+ $files = $this->validate_file_list($file_details);

+ $since = $this->validate_since($since);

+

+ $this->events[$event_name] = array(

+ 'event' => $this->current_event,

+ 'files' => $files,

+ 'since' => $since,

+ 'description' => $description,

+ );

+ }

+

+ return sizeof($this->events);

+ }

+

+ /**

+ * Format the php events as a wiki table

+ * @return string Number of events found

+ */

+ public function export_events_for_wiki()

+ {

+ if ($this->filter === 'adm')

+ {

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

+ $wiki_page .= '{| class="zebra sortable" cellspacing="0" cellpadding="5"' . "\n";

+ $wiki_page .= '! Identifier !! Placement !! Added in Release !! Explanation' . "\n";

+ }

+ else

+ {

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

+ $wiki_page .= '{| class="zebra sortable" cellspacing="0" cellpadding="5"' . "\n";

+ $wiki_page .= '! Identifier !! Prosilver Placement (If applicable) !! Subsilver Placement (If applicable) !! Added in Release !! Explanation' . "\n";

+ }

+

+ foreach ($this->events as $event_name => $event)

+ {

+ $wiki_page .= "|- id=\"{$event_name}\"\n";

+ $wiki_page .= "| [[#{$event_name}|{$event_name}]] || ";

+

+ if ($this->filter === 'adm')

+ {

+ $wiki_page .= implode(', ', $event['files']['adm']);

+ }

+ else

+ {

+ $wiki_page .= implode(', ', $event['files']['prosilver']) . ' || ' . implode(', ', $event['files']['subsilver2']);

+ }

+

+ $wiki_page .= " || {$event['since']} || " . str_replace("\n", ' ', $event['description']) . "\n";

+ }

+ $wiki_page .= '|}' . "\n";

+

+ return $wiki_page;

+ }

+

+ /**

+ * Validates a template event name

+ *

+ * @param $event_name

+ * @return null

+ * @throws \LogicException

+ */

+ public function validate_event_name($event_name)

+ {

+ if (!preg_match('#^([a-z][a-z0-9]*(?:_[a-z][a-z0-9]*)+)$#', $event_name))

+ {

+ throw new \LogicException("Invalid event name '{$event_name}'");

+ }

+ }

+

+ /**

+ * Validate "Since" Information

+ *

+ * @param string $since

+ * @return string

+ * @throws \LogicException

+ */

+ public function validate_since($since)

+ {

+ if (!preg_match('#^\d+\.\d+\.\d+(?:-(?:a|b|rc|pl)\d+)?$#', $since))

+ {

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

+ }

+

+ return $since;

+ }

+

+ /**

+ * Validate the files list

+ *

+ * @param string $file_details

+ * @return array

+ * @throws \LogicException

+ */

+ public function validate_file_list($file_details)

+ {

+ $files_list = array(

+ 'prosilver' => array(),

+ 'subsilver2' => array(),

+ 'adm' => array(),

+ );

+

+ // Multi file list

+ if (strpos($file_details, "* Locations:\n + ") === 0)

+ {

+ $file_details = substr($file_details, strlen("* Locations:\n + "));

+ $files = explode("\n + ", $file_details);

+ foreach ($files as $file)

+ {

+ if (!file_exists($this->path . $file) || substr($file, -5) !== '.html')

+ {

+ throw new \LogicException("Invalid file '{$file}' not found for event '{$this->current_event}'", 1);

+ }

+

+ if (($this->filter !== 'adm') && strpos($file, 'styles/prosilver/template/') === 0)

+ {

+ $files_list['prosilver'][] = substr($file, strlen('styles/prosilver/template/'));

+ }

+ else if (($this->filter !== 'adm') && strpos($file, 'styles/subsilver2/template/') === 0)

+ {

+ $files_list['subsilver2'][] = substr($file, strlen('styles/subsilver2/template/'));

+ }

+ else if (($this->filter === 'adm') && strpos($file, 'adm/style/') === 0)

+ {

+ $files_list['adm'][] = substr($file, strlen('adm/style/'));

+ }

+ else

+ {

+ throw new \LogicException("Invalid file '{$file}' not found for event '{$this->current_event}'", 2);

+ }

+

+ $this->events_by_file[$file][] = $this->current_event;

+ }

+ }

+ else if ($this->filter == 'adm')

+ {

+ $file = substr($file_details, strlen('* Location: '));

+ if (!file_exists($this->path . $file) || substr($file, -5) !== '.html')

+ {

+ throw new \LogicException("Invalid file '{$file}' not found for event '{$this->current_event}'", 1);

+ }

+

+ $files_list['adm'][] = substr($file, strlen('adm/style/'));

+

+ $this->events_by_file[$file][] = $this->current_event;

+ }

+ else

+ {

+ throw new \LogicException("Invalid file list found for event '{$this->current_event}'", 2);

+ }

+

+ return $files_list;

+ }

+

+ /**

+ * Get all template events in a template file

+ *

+ * @param string $file

+ * @return array

+ * @throws \LogicException

+ */

+ public function crawl_file_for_events($file)

+ {

+ if (!file_exists($this->path . $file))

+ {

+ throw new \LogicException("File '{$file}' does not exist", 1);

+ }

+

+ $event_list = array();

+ $file_content = file_get_contents($this->path . $file);

+

+ $events = explode('<!-- EVENT ', $file_content);

+ // Remove the code before the first event

+ array_shift($events);

+ foreach ($events as $event)

+ {

+ $event = explode(' -->', $event, 2);

+ $event_list[] = array_shift($event);

+ }

+

+ return $event_list;

+ }

+

+ /**

+ * Validates whether all events from $file are in the md file and vice-versa

+ *

+ * @param string $file

+ * @param array $events

+ * @return true

+ * @throws \LogicException

+ */

+ public function validate_events_from_file($file, array $events)

+ {

+ if (empty($this->events_by_file[$file]) && empty($events))

+ {

+ return true;

+ }

+ else if (empty($this->events_by_file[$file]))

+ {

+ $event_list = implode("', '", $events);

+ throw new \LogicException("File '{$file}' should not contain events, but contains: "

+ . "'{$event_list}'", 1);

+ }

+ else if (empty($events))

+ {

+ $event_list = implode("', '", $this->events_by_file[$file]);

+ throw new \LogicException("File '{$file}' contains no events, but should contain: "

+ . "'{$event_list}'", 1);

+ }

+

+ $missing_events_from_file = array();

+ foreach ($this->events_by_file[$file] as $event)

+ {

+ if (!in_array($event, $events))

+ {

+ $missing_events_from_file[] = $event;

+ }

+ }

+

+ if (!empty($missing_events_from_file))

+ {

+ $event_list = implode("', '", $missing_events_from_file);

+ throw new \LogicException("File '{$file}' does not contain events: '{$event_list}'", 2);

+ }

+

+ $missing_events_from_md = array();

+ foreach ($events as $event)

+ {

+ if (!in_array($event, $this->events_by_file[$file]))

+ {

+ $missing_events_from_md[] = $event;

+ }

+ }

+

+ if (!empty($missing_events_from_md))

+ {

+ $event_list = implode("', '", $missing_events_from_md);

+ throw new \LogicException("File '{$file}' contains additional events: '{$event_list}'", 3);

+ }

+

+ return true;

+ }

+

+ /**

+ * Returns a list of files in $dir

+ *

+ * Works recursive with any depth

+ *

+ * @param string $dir Directory to go through

+ * @return array List of files (including directories)

+ */

+ public function get_recursive_file_list($dir)

+ {

+ try

+ {

+ $iterator = new \RecursiveIteratorIterator(

+ new \phpbb\recursive_dot_prefix_filter_iterator(

+ new \RecursiveDirectoryIterator(

+ $dir,

+ \FilesystemIterator::SKIP_DOTS

+ )

+ ),

+ \RecursiveIteratorIterator::SELF_FIRST

+ );

+ }

+ catch (\Exception $e)

+ {

+ return array();

+ }

+

+ $files = array();

+ foreach ($iterator as $file_info)

+ {

+ /** @var \RecursiveDirectoryIterator $file_info */

+ if ($file_info->isDir())

+ {

+ continue;

+ }

+

+ $relative_path = $iterator->getInnerIterator()->getSubPathname();

+

+ if (substr($relative_path, -5) == '.html')

+ {

+ $files[] = str_replace(DIRECTORY_SEPARATOR, '/', $relative_path);

+ }

+ }

+

+ return $files;

+ }

+}

+<?php

+/**

+*

+* @package phpBB3

+* @copyright (c) 2014 phpBB Group

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

+*

+*/

+

+namespace phpbb\event;

+

+/**

+* Class php_exporter

+* Crawls through a list of files and grabs all php-events

+*

+* @package phpbb\event

+*/

+class php_exporter

+{

+ /** @var string Path where we look for files*/

+ protected $path;

+

+ /** @var string phpBB Root Path */

+ protected $root_path;

+

+ /** @var string */

+ protected $current_file;

+

+ /** @var string */

+ protected $current_event;

+

+ /** @var int */

+ protected $current_event_line;

+

+ /** @var array */

+ protected $events;

+

+ /** @var array */

+ protected $file_lines;

+

+ /**

+ * @param string $phpbb_root_path

+ * @param mixed $extension String 'vendor/ext' to filter, null for phpBB core

+ */

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

+ {

+ $this->root_path = $phpbb_root_path;

+ $this->path = $phpbb_root_path;

+ $this->events = $this->file_lines = array();

+ $this->current_file = $this->current_event = '';

+ $this->current_event_line = 0;

+

+ $this->path = $this->root_path;

+ if ($extension)

+ {

+ $this->path .= 'ext/' . $extension . '/';

+ }

+ }

+

+ /**

+ * Get the list of all events

+ *

+ * @return array Array with events: name => details

+ */

+ public function get_events()

+ {

+ return $this->events;

+ }

+

+ /**

+ * Set current event data

+ *

+ * @param string $name Name of the current event (used for error messages)

+ * @param int $line Line where the current event is placed in

+ * @return null

+ */

+ public function set_current_event($name, $line)

+ {

+ $this->current_event = $name;

+ $this->current_event_line = $line;

+ }

+

+ /**

+ * Set the content of this file

+ *

+ * @param array $content Array with the lines of the file

+ * @return null

+ */

+ public function set_content($content)

+ {

+ $this->file_lines = $content;

+ }

+

+ /**

+ * Crawl the phpBB/ directory for php events

+ * @return int The number of events found

+ */

+ public function crawl_phpbb_directory_php()

+ {

+ $files = $this->get_recursive_file_list();

+ $this->events = array();

+ foreach ($files as $file)

+ {

+ $this->crawl_php_file($file);

+ }

+ ksort($this->events);

+

+ return sizeof($this->events);

+ }

+

+ /**

+ * Returns a list of files in $dir

+ *

+ * @return array List of files (including the path)

+ */

+ public function get_recursive_file_list()

+ {

+ try

+ {

+ $iterator = new \RecursiveIteratorIterator(

+ new \phpbb\event\recursive_event_filter_iterator(

+ new \RecursiveDirectoryIterator(

+ $this->path,

+ \FilesystemIterator::SKIP_DOTS

+ ),

+ $this->path

+ ),

+ \RecursiveIteratorIterator::LEAVES_ONLY

+ );

+ }

+ catch (\Exception $e)

+ {

+ return array();

+ }

+

+ $files = array();

+ foreach ($iterator as $file_info)

+ {

+ /** @var \RecursiveDirectoryIterator $file_info */

+ $relative_path = $iterator->getInnerIterator()->getSubPathname();

+ $files[] = str_replace(DIRECTORY_SEPARATOR, '/', $relative_path);

+ }

+

+ return $files;

+ }

+

+ /**

+ * Format the php events as a wiki table

+ * @return string

+ */

+ public function export_events_for_wiki()

+ {

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

+ $wiki_page .= '{| class="sortable zebra" cellspacing="0" cellpadding="5"' . "\n";

+ $wiki_page .= '! Identifier !! Placement !! Arguments !! Added in Release !! Explanation' . "\n";

+ foreach ($this->events as $event)

+ {

+ $wiki_page .= '|- id="' . $event['event'] . '"' . "\n";

+ $wiki_page .= '| [[#' . $event['event'] . '|' . $event['event'] . ']] || ' . $event['file'] . ' || ' . implode(', ', $event['arguments']) . ' || ' . $event['since'] . ' || ' . $event['description'] . "\n";

+ }

+ $wiki_page .= '|}' . "\n";

+

+ return $wiki_page;

+ }

+

+ /**

+ * @param string $file

+ * @return int Number of events found in this file

+ * @throws \LogicException

+ */

+ public function crawl_php_file($file)

+ {

+ $this->current_file = $file;

+ $this->file_lines = array();

+ $content = file_get_contents($this->path . $this->current_file);

+ $num_events_found = 0;

+

+ if (strpos($content, "dispatcher->trigger_event('") || strpos($content, "dispatcher->dispatch('"))

+ {

+ $this->set_content(explode("\n", $content));

+ for ($i = 0, $num_lines = sizeof($this->file_lines); $i < $num_lines; $i++)

+ {

+ $event_line = false;

+ $found_trigger_event = strpos($this->file_lines[$i], "dispatcher->trigger_event('");

+ $arguments = array();

+ if ($found_trigger_event !== false)

+ {

+ $event_line = $i;

+ $this->set_current_event($this->get_event_name($event_line, false), $event_line);

+

+ // Find variables of the event

+ $arguments = $this->get_vars_from_array();

+ $doc_vars = $this->get_vars_from_docblock();

+ $this->validate_vars_docblock_array($arguments, $doc_vars);

+ }

+ else

+ {

+ $found_dispatch = strpos($this->file_lines[$i], "dispatcher->dispatch('");

+ if ($found_dispatch !== false)

+ {

+ $event_line = $i;

+ $this->set_current_event($this->get_event_name($event_line, true), $event_line);

+ }

+ }

+

+ if ($event_line)

+ {

+ // Validate @event

+ $event_line_num = $this->find_event();

+ $this->validate_event($this->current_event, $this->file_lines[$event_line_num]);

+

+ // Validate @since

+ $since_line_num = $this->find_since();

+ $since = $this->validate_since($this->file_lines[$since_line_num]);

+

+ // Find event description line

+ $description_line_num = $this->find_description();

+ $description = substr(trim($this->file_lines[$description_line_num]), strlen('* '));

+

+ if (isset($this->events[$this->current_event]))

+ {

+ throw new \LogicException("The event '{$this->current_event}' from file "

+ . "'{$this->current_file}:{$event_line_num}' already exists in file "

+ . "'{$this->events[$this->current_event]['file']}'", 10);

+ }

+

+ sort($arguments);

+ $this->events[$this->current_event] = array(

+ 'event' => $this->current_event,

+ 'file' => $this->current_file,

+ 'arguments' => $arguments,

+ 'since' => $since,

+ 'description' => $description,

+ );

+ $num_events_found++;

+ }

+ }

+ }

+

+ return $num_events_found;

+ }

+

+ /**

+ * Find the name of the event inside the dispatch() line

+ *

+ * @param int $event_line

+ * @param bool $is_dispatch Do we look for dispatch() or trigger_event() ?

+ * @return string Name of the event

+ * @throws \LogicException

+ */

+ public function get_event_name($event_line, $is_dispatch)

+ {

+ $event_text_line = $this->file_lines[$event_line];

+ $event_text_line = ltrim($event_text_line, "\t");

+

+ if ($is_dispatch)

+ {

+ $regex = '#\$([a-z](?:[a-z0-9_]|->)*)';

+ $regex .= '->dispatch\(';

+ $regex .= '\'' . $this->preg_match_event_name() . '\'';

+ $regex .= '\);#';

+ }

+ else

+ {

+ $regex = '#extract\(\$([a-z](?:[a-z0-9_]|->)*)';

+ $regex .= '->trigger_event\(';

+ $regex .= '\'' . $this->preg_match_event_name() . '\'';

+ $regex .= ', compact\(\$vars\)\)\);#';

+ }

+

+ $match = array();

+ preg_match($regex, $event_text_line, $match);

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

+ {

+ throw new \LogicException("Can not find event name in line '{$event_text_line}' "

+ . "in file '{$this->current_file}:{$event_line}'", 1);

+ }

+

+ return $match[2];

+ }

+

+ /**

+ * Returns a regex match for the event name

+ *

+ * @return string

+ */

+ protected function preg_match_event_name()

+ {

+ return '([a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)+)';

+ }

+

+ /**

+ * Find the $vars array

+ *

+ * @return array List of variables

+ * @throws \LogicException

+ */

+ public function get_vars_from_array()

+ {

+ $line = ltrim($this->file_lines[$this->current_event_line - 1], "\t");

+ if ($line === ');')

+ {

+ $vars_array = $this->get_vars_from_multi_line_array();

+ }

+ else

+ {

+ $vars_array = $this->get_vars_from_single_line_array($line);

+ }

+

+ foreach ($vars_array as $var)

+ {

+ if (!preg_match('#^([a-zA-Z_][a-zA-Z0-9_]*)$#', $var))

+ {

+ throw new \LogicException("Found invalid var '{$var}' in array for event '{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'", 3);

+ }

+ }

+

+ sort($vars_array);

+ return $vars_array;

+ }

+

+ /**

+ * Find the variables in single line array

+ *

+ * @param string $line

+ * @param bool $throw_multiline Throw an exception when there are too

+ * many arguments in one line.

+ * @return array List of variables

+ * @throws \LogicException

+ */

+ public function get_vars_from_single_line_array($line, $throw_multiline = true)

+ {

+ $match = array();

+ preg_match('#^\$vars = array\(\'([a-zA-Z0-9_\' ,]+)\'\);$#', $line, $match);

+

+ if (isset($match[1]))

+ {

+ $vars_array = explode("', '", $match[1]);

+ if ($throw_multiline && sizeof($vars_array) > 6)

+ {

+ throw new \LogicException('Should use multiple lines for $vars definition '

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

+ }

+ return $vars_array;

+ }

+ else

+ {

+ throw new \LogicException("Can not find '\$vars = array();'-line for event '{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'", 1);

+ }

+ }

+

+ /**

+ * Find the variables in single line array

+ *

+ * @return array List of variables

+ * @throws \LogicException

+ */

+ public function get_vars_from_multi_line_array()

+ {

+ $current_vars_line = 2;

+ $var_lines = array();

+ while (ltrim($this->file_lines[$this->current_event_line - $current_vars_line], "\t") !== '$vars = array(')

+ {

+ $var_lines[] = substr(trim($this->file_lines[$this->current_event_line - $current_vars_line]), 0, -1);

+

+ $current_vars_line++;

+ if ($current_vars_line > $this->current_event_line)

+ {

+ // Reached the start of the file

+ throw new \LogicException("Can not find end of \$vars array for event '{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'", 2);

+ }

+ }

+

+ return $this->get_vars_from_single_line_array('$vars = array(' . implode(", ", $var_lines) . ');', false);

+ }

+

+ /**

+ * Find the $vars array

+ *

+ * @return array List of variables

+ * @throws \LogicException

+ */

+ public function get_vars_from_docblock()

+ {

+ $doc_vars = array();

+ $current_doc_line = 1;

+ $found_comment_end = false;

+ while (ltrim($this->file_lines[$this->current_event_line - $current_doc_line], "\t") !== '/**')

+ {

+ if (ltrim($this->file_lines[$this->current_event_line - $current_doc_line], "\t") === '*/')

+ {

+ $found_comment_end = true;

+ }

+

+ if ($found_comment_end)

+ {

+ $var_line = trim($this->file_lines[$this->current_event_line - $current_doc_line]);

+ $var_line = preg_replace('!\s+!', ' ', $var_line);

+ if (strpos($var_line, '* @var ') === 0)

+ {

+ $doc_line = explode(' ', $var_line, 5);

+ if (sizeof($doc_line) !== 5)

+ {

+ throw new \LogicException("Found invalid line '{$this->file_lines[$this->current_event_line - $current_doc_line]}' "

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

+ }

+ $doc_vars[] = $doc_line[3];

+ }

+ }

+

+ $current_doc_line++;

+ if ($current_doc_line > $this->current_event_line)

+ {

+ // Reached the start of the file

+ throw new \LogicException("Can not find end of docblock for event '{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'", 2);

+ }

+ }

+

+ if (empty($doc_vars))

+ {

+ // Reached the start of the file

+ throw new \LogicException("Can not find @var lines for event '{$this->current_event}' in file '{$this->current_file}:{$this->current_event_line}'", 3);

+ }

+

+ foreach ($doc_vars as $var)

+ {

+ if (!preg_match('#^([a-zA-Z_][a-zA-Z0-9_]*)$#', $var))

+ {

+ throw new \LogicException("Found invalid @var '{$var}' in docblock for event "

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

+ }

+ }

+

+ sort($doc_vars);

+ return $doc_vars;

+ }

+

+ /**

+ * Find the "@since" Information line

+ *

+ * @return int Absolute line number

+ * @throws \LogicException

+ */

+ public function find_since()

+ {

+ return $this->find_tag('since', array('event', 'var'));

+ }

+

+ /**

+ * Find the "@event" Information line

+ *

+ * @return int Absolute line number

+ */

+ public function find_event()

+ {

+ return $this->find_tag('event', array());

+ }

+

+ /**

+ * Find a "@*" Information line

+ *

+ * @param string $find_tag Name of the tag we are trying to find

+ * @param array $disallowed_tags List of tags that must not appear between

+ * the tag and the actual event

+ * @return int Absolute line number

+ * @throws \LogicException

+ */

+ public function find_tag($find_tag, $disallowed_tags)

+ {

+ $find_tag_line = 0;

+ $found_comment_end = false;

+ while (strpos(ltrim($this->file_lines[$this->current_event_line - $find_tag_line], "\t"), '* @' . $find_tag . ' ') !== 0)

+ {

+ if ($found_comment_end && ltrim($this->file_lines[$this->current_event_line - $find_tag_line], "\t") === '/**')

+ {

+ // Reached the start of this doc block

+ throw new \LogicException("Can not find '@{$find_tag}' information for event "

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

+ }

+

+ foreach ($disallowed_tags as $disallowed_tag)

+ {

+ if ($found_comment_end && strpos(ltrim($this->file_lines[$this->current_event_line - $find_tag_line], "\t"), '* @' . $disallowed_tag) === 0)

+ {

+ // Found @var after the @since

+ throw new \LogicException("Found '@{$disallowed_tag}' information after '@{$find_tag}' for event "

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

+ }

+ }

+

+ if (ltrim($this->file_lines[$this->current_event_line - $find_tag_line], "\t") === '*/')

+ {

+ $found_comment_end = true;

+ }

+

+ $find_tag_line++;

+ if ($find_tag_line >= $this->current_event_line)

+ {

+ // Reached the start of the file

+ throw new \LogicException("Can not find '@{$find_tag}' information for event "

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

+ }

+ }

+

+ return $this->current_event_line - $find_tag_line;

+ }

+

+ /**

+ * Find a "@*" Information line

+ *

+ * @return int Absolute line number

+ * @throws \LogicException

+ */

+ public function find_description()

+ {

+ $find_desc_line = 0;

+ while (ltrim($this->file_lines[$this->current_event_line - $find_desc_line], "\t") !== '/**')

+ {

+ $find_desc_line++;

+ if ($find_desc_line > $this->current_event_line)

+ {

+ // Reached the start of the file

+ throw new \LogicException("Can not find a description for event "

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

+ }

+ }

+

+ $find_desc_line = $this->current_event_line - $find_desc_line + 1;

+

+ $desc = trim($this->file_lines[$find_desc_line]);

+ if (strpos($desc, '* @') === 0 || $desc[0] !== '*' || substr($desc, 1) == '')

+ {

+ // First line of the doc block is a @-line, empty or only contains "*"

+ throw new \LogicException("Can not find a description for event "

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

+ }

+

+ return $find_desc_line;

+ }

+

+ /**

+ * Validate "@since" Information

+ *

+ * @param string $line

+ * @return string

+ * @throws \LogicException

+ */

+ public function validate_since($line)

+ {

+ $match = array();

+ preg_match('#^\* @since (\d+\.\d+\.\d+(?:-(?:a|b|rc|pl)\d+)?)$#', ltrim($line, "\t"), $match);

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

+ {

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

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

+ }

+

+ return $match[1];

+ }

+

+ /**

+ * Validate "@event" Information

+ *

+ * @param string $event_name

+ * @param string $line

+ * @return string

+ * @throws \LogicException

+ */

+ public function validate_event($event_name, $line)

+ {

+ $event = substr(ltrim($line, "\t"), strlen('* @event '));

+

+ if ($event !== trim($event))

+ {

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

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

+ }

+

+ if ($event !== $event_name)

+ {

+ throw new \LogicException("Event name does not match '@event' tag for event "

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

+ }

+

+ return $event;

+ }

+

+ /**

+ * Validates that two arrays contain the same strings

+ *

+ * @param array $vars_array Variables found in the array line

+ * @param array $vars_docblock Variables found in the doc block

+ * @return null

+ * @throws \LogicException

+ */

+ public function validate_vars_docblock_array($vars_array, $vars_docblock)

+ {

+ $vars_array = array_unique($vars_array);

+ $vars_docblock = array_unique($vars_docblock);

+ $sizeof_vars_array = sizeof($vars_array);

+

+ if ($sizeof_vars_array !== sizeof($vars_docblock) || $sizeof_vars_array !== sizeof(array_intersect($vars_array, $vars_docblock)))

+ {

+ throw new \LogicException("\$vars array does not match the list of '@var' tags for event "

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

+ }

+ }

+}

+<?php

+/**

+*

+* @package event

+* @copyright (c) 2014 phpBB Group

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

+*

+*/

+

+namespace phpbb\event;

+

+/**

+* Class recursive_event_filter_iterator

+*

+* This filter ignores directories and files starting with a dot.

+* It also skips some directories that do not contain events anyway,

+* such as e.g. files/, store/ and vendor/

+*

+* @package phpbb\event

+*/

+class recursive_event_filter_iterator extends \RecursiveFilterIterator

+{

+ protected $root_path;

+

+ /**

+ * Construct

+ *

+ * @param \RecursiveIterator $iterator

+ * @param string $root_path

+ */

+ public function __construct(\RecursiveIterator $iterator, $root_path)

+ {

+ $this->root_path = str_replace(DIRECTORY_SEPARATOR, '/', $root_path);

+ parent::__construct($iterator);

+ }

+

+ /**

+ * Return the inner iterator's children contained in a recursive_event_filter_iterator

+ *

+ * @return recursive_event_filter_iterator

+ */

+ public function getChildren() {

+ return new self($this->getInnerIterator()->getChildren(), $this->root_path);

+ }

+

+ /**

+ * {@inheritDoc}

+ */

+ public function accept()

+ {

+ $relative_path = str_replace(DIRECTORY_SEPARATOR, '/', $this->current());

+ $filename = $this->current()->getFilename();

+

+ return (substr($relative_path, -4) === '.php' || $this->current()->isDir())

+ && $filename[0] !== '.'

+ && strpos($relative_path, $this->root_path . 'cache/') !== 0

+ && strpos($relative_path, $this->root_path . 'develop/') !== 0

+ && strpos($relative_path, $this->root_path . 'docs/') !== 0

+ && strpos($relative_path, $this->root_path . 'ext/') !== 0

+ && strpos($relative_path, $this->root_path . 'files/') !== 0

+ && strpos($relative_path, $this->root_path . 'includes/utf/') !== 0

+ && strpos($relative_path, $this->root_path . 'language/') !== 0

+ && strpos($relative_path, $this->root_path . 'phpbb/db/migration/data/') !== 0

+ && strpos($relative_path, $this->root_path . 'phpbb/event/') !== 0

+ && strpos($relative_path, $this->root_path . 'store/') !== 0

+ && strpos($relative_path, $this->root_path . 'tests/') !== 0

+ && strpos($relative_path, $this->root_path . 'vendor/') !== 0

+ ;

+ }

+}

+ * @since 3.1.0-a1

+ $vars = array(

+ 'mode',

+ 'user_id',

+ 'log_ip',

+ 'log_operation',

+ 'log_time',

+ 'additional_data',

+ 'sql_ary',

+ );

+ * @since 3.1.0-a1

+ $vars = array(

+ 'mode',

+ 'count_logs',

+ 'limit',

+ 'offset',

+ 'forum_id',

+ 'topic_id',

+ 'user_id',

+ 'log_time',

+ 'sort_by',

+ 'keywords',

+ 'profile_url',

+ 'log_type',

+ 'sql_additional',

+ );

+ * @since 3.1.0-a1

+ $num_args = substr_count($this->user->lang[$row['log_operation']], '%');

+ * @since 3.1.0-a1

+ if (substr($key, 0, 4) == 'LOG_')

+ if (is_array($value))

+ {

+ foreach ($value as $plural_value)

+ {

+ if (preg_match($keywords_pattern, $plural_value))

+ {

+ $operations[] = $key;

+ break;

+ }

+ }

+ }

+ else if (preg_match($keywords_pattern, $value))

+ {

+ $operations[] = $key;

+ }

+

+ /**

+ * {inheritDoc}

+ */

+ public function get_redirect_url()

+ {

+ return $this->get_url();

+ }

+ * {inheritDoc}

+ */

+ public function get_redirect_url()

+ {

+ return $this->get_url();

+ }

+

+ /**

+ $update_responders = $notification->add_responders($post);

+ if (!empty($update_responders))

+ {

+ $sql = 'UPDATE ' . $this->notifications_table . '

+ SET ' . $this->db->sql_build_array('UPDATE', $update_responders) . '

+ WHERE notification_id = ' . $row['notification_id'];

+ $this->db->sql_query($sql);

+ }

+ $update_responders = $notification->add_responders($post);

+ if (!empty($update_responders))

+ {

+ $sql = 'UPDATE ' . $this->notifications_table . '

+ SET ' . $this->db->sql_build_array('UPDATE', $update_responders) . '

+ WHERE notification_id = ' . $row['notification_id'];

+ $this->db->sql_query($sql);

+ }

+ if ($trimmed_responders_cnt > 20)

+ {

+ $usernames[] = $this->user->lang('NOTIFICATION_MANY_OTHERS');

+ }

+ else if ($trimmed_responders_cnt)

+ * {inheritDoc}

+ */

+ public function get_redirect_url()

+ {

+ return append_sid($this->phpbb_root_path . 'viewtopic.' . $this->php_ext, "t={$this->item_parent_id}&amp;view=unread#unread");

+ }

+

+ /**

+ return array();

+ // Do not add more than 25 responders,

+ // we trim the username list to "a, b, c and x others" anyway

+ // so there is no use to add all of them anyway.

+ if (sizeof($responders) > 25)

+ {

+ return array();

+ }

+

+ return array();

+ $serialized_data = serialize($this->get_data(false));

+

+ // If the data is longer then 4000 characters, it would cause a SQL error.

+ // We don't add the username to the list if this is the case.

+ if (utf8_strlen($serialized_data) >= 4000)

+ {

+ return array();

+ }

+

+ return array('notification_data' => $serialized_data);

+ * {inheritDoc}

+ */

+ public function get_redirect_url()

+ {

+ return parent::get_url();

+ }

+

+ /**

+ * {inheritDoc}

+ */

+ public function get_redirect_url()

+ {

+ return $this->get_url();

+ }

+

+ /**

+ * Get the url to redirect after the item has been marked as read

+ *

+ * @return string URL

+ */

+ public function get_redirect_url();

+

+ /**

+ * @since 3.1.0-a1

+ * @since 3.1.0-a1

+ $vars = array(

+ 'user_data',

+ 'user_lang_name',

+ 'user_date_format',

+ 'user_timezone',

+ 'lang_set',

+ 'lang_set_ext',

+ 'style_id',

+ );