</tr>

<!-- BEGIN enabled -->

<tr class="ext_enabled row-highlight">

<td style="text-align: center;">

<!-- IF enabled.S_VERSIONCHECK -->

<strong <!-- IF enabled.S_UP_TO_DATE -->style="color: #228822;"<!-- ELSE -->style="color: #BC2A4D;"<!-- ENDIF -->>{enabled.META_VERSION}</strong>

</tr>

<!-- BEGIN disabled -->

<tr class="ext_disabled row-highlight">

<td style="text-align: center;">

<!-- IF disabled.S_VERSIONCHECK -->

<strong <!-- IF disabled.S_UP_TO_DATE -->style="color: #228822;"<!-- ELSE -->style="color: #BC2A4D;"<!-- ENDIF -->>{disabled.META_VERSION}</strong>

<p>If you are currently using a stable release of phpBB, updating to this version is straightforward. You would have downloaded one of four packages and your choice determines what you need to do. <strong>Note</strong>: Before updating, we heavily recommend you do a <em>full backup of your database and existing phpBB files</em>! If you are unsure how to achieve this please ask your hosting provider for advice.</p>

<a name="update_full"></a><h3>4.i. Full package</h3>

<p>The directory structure has been preserved, enabling you (if you wish) to simply upload the uncompressed contents of the archive to the appropriate location on your server, i.e. simply overwrite the existing files with the new versions. Do not forget that if you have installed any modifications (MODs) these files will overwrite the originals, possibly destroying them in the process. You will need to re-add MODs to any affected file before uploading.</p>

<a name="update_patch"></a><h3>4.iii. Patch file</h3>

<p>If you do get failures, you should look at using the <a href="#update_files">Changed Files</a> package to replace the files which failed to patch. Please note that you will need to manually re-add any MODs to these particular files. Alternatively, if you know how, you can examine the .rej files to determine what failed where and make manual adjustments to the relevant source.</p>

<a name="update_auto"></a><h3>4.iv. Automatic update package</h3>

* Since: 3.1.11-RC1

* Purpose: Add more detailed information on extension after the available information.

acp_ext_list_disabled_title_after

===

* Location: adm/style/acp_ext_list.html

* Since: 3.1.11-RC1

* Purpose: Add text after disabled extensions section title.

acp_ext_list_enabled_title_after

===

* Location: adm/style/acp_ext_list.html

* @var string mode Download mode

* @var bool thumbnail Flag indicating if the file is a thumbnail

* @since 3.1.6-RC1

*/

$vars = array(

'attach_id',

'cookie_domain' => array('lang' => 'COOKIE_DOMAIN', 'validate' => 'string', 'type' => 'text::255', 'explain' => false),

'cookie_name' => array('lang' => 'COOKIE_NAME', 'validate' => 'string', 'type' => 'text::16', 'explain' => false),

'cookie_path' => array('lang' => 'COOKIE_PATH', 'validate' => 'string', 'type' => 'text::255', 'explain' => false),

'cookie_notice' => array('lang' => 'COOKIE_NOTICE', 'validate' => 'bool', 'type' => 'radio:enabled_disabled', 'explain' => true),

)

);

{

function module()

{

return array(

'filename' => 'acp_logs',

'title' => 'ACP_LOGGING',

);

}

* @var bool allow_url_bbcode Whether or not to parse the [url] BBCode

* @var string mode Mode to parse text as, e.g. post or sig

* @since 3.1.0-a1

*/

$vars = array(

'text',

* @var array root_data Array with the root forum data

* @var array row The data of the 'category'

* @since 3.1.0-RC4

*/

$vars = array(

'cat_row',

* @var array row The data of the forum

* @var array subforums_row Template data of subforums

* @since 3.1.0-a1

*/

$vars = array('forum_row', 'row', 'subforums_row');

extract($phpbb_dispatcher->trigger_event('core.display_forums_modify_template_vars', compact($vars)));

* @var string url The "Return to topic" URL

*

* @since 3.1.0-a3

* poll, update_message, update_search_index

*/

$vars = array(

* Use this event to modify the values to be inserted when a user is added

*

* @event core.user_add_modify_data

* @since 3.1.0-a1

*/

extract($phpbb_dispatcher->trigger_event('core.user_add_modify_data', compact($vars)));

$sql = 'INSERT INTO ' . USERS_TABLE . ' ' . $db->sql_build_array('INSERT', $sql_ary);

* @var string action Topic quick moderation action name

* @var bool quickmod Flag indicating whether MCP is in quick moderation mode

* @since 3.1.0-a4

*/

$vars = array('action', 'quickmod');

extract($phpbb_dispatcher->trigger_event('core.modify_quickmod_actions', compact($vars)));

* @var bool return Do we return after the event is triggered if $warn_msg is not empty

* @var array warn_msg Array of the warning messages

* @since 3.1.2-RC1

*/

$message = $this->message;

$warn_msg = $this->warn_msg;

* @var bool delete Whether the user is deleting the PM

* @var int reply_to_all Value of reply_to_all request variable.

* @since 3.1.0-RC5

*/

$vars = array(

'sql',

* @var bool delete If deleting message

* @var int reply_to_all Value of reply_to_all request variable.

* @since 3.1.0-RC5

*/

$vars = array(

'sql',

* @var bool submit Whether or not the form has been sumitted

* @var bool preview Whether or not the signature is being previewed

* @since 3.1.10-RC1

*/

$vars = array(

'enable_bbcode',

'HELP_BBCODE_OTHERS_CUSTOM_ANSWER' => 'If you are an administrator on this board and have the proper permissions, you can add further BBCodes through the Custom BBCodes section.',

'HELP_BBCODE_OTHERS_CUSTOM_QUESTION' => 'Can I add my own tags?',

'HELP_BBCODE_QUOTES_CODE_QUESTION' => 'Outputting code or fixed width data',

'HELP_BBCODE_QUOTES_TEXT_ANSWER' => 'There are two ways you can quote text, with a reference or without.<ul><li>When you utilise the Quote function to reply to a post on the board you should notice that the post text is added to the message window enclosed in a <strong>[quote=&quot;&quot;][/quote]</strong> block. This method allows you to quote with a reference to a person or whatever else you choose to put! For example to quote a piece of text Mr. Blobby wrote you would enter:<br /><br /><strong>[quote=&quot;Mr. Blobby&quot;]</strong>The text Mr. Blobby wrote would go here<strong>[/quote]</strong><br /><br />The resulting output will automatically add &quot;Mr. Blobby wrote:&quot; before the actual text. Remember you <strong>must</strong> include the quotation marks &quot;&quot; around the name you are quoting, they are not optional.</li><li>The second method allows you to blindly quote something. To utilise this enclose the text in <strong>[quote][/quote]</strong> tags. When you view the message it will simply show the text within a quotation block.</li></ul>',

'HELP_BBCODE_QUOTES_TEXT_QUESTION' => 'Quoting text in replies',

/**

* Find the "@changed" Information lines

*

* @return array Absolute line numbers

* @throws \LogicException

*/

{

$match = array();

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

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

{

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

}

/**

* Calls hook if any is defined.

*

* @param string $handle Template handle being displayed.

}

/**

* Change already assigned key variable pair (one-dimensional - single loop entry)

*

* An example of how to use this function:

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

{

$this->num_rows_is_set = false;

{

{

}

else

{

}

}

}

{

}

// Change key to zero (change first position) if false and to last position if true

if ($key === false || $key === true)

{

unset($block[($key - 1)]['S_LAST_ROW']);

$vararray['S_LAST_ROW'] = true;

}

{

unset($block[0]['S_FIRST_ROW']);

$vararray['S_FIRST_ROW'] = true;

}

// Assign S_BLOCK_NAME

// Re-position template blocks

for ($i = sizeof($block); $i > $key; $i--)

// Which block to change?

if ($mode == 'change')

{

if ($key == sizeof($block))

{

$key--;

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

/**

* Get path to template for handle (required for BBCode parser)

*

* @param string $handle Handle to retrieve the source file

* NOTE: Should be actual language strings, NOT

* language keys.

* @since 3.1.0-a1

*/

$vars = array(

'post_id',

* is posting a new topic or editing a post)

* @var bool refresh Whether or not to retain previously submitted data

* @var object message_parser The message parser object

* @since 3.1.2-RC1

*/

$vars = array(

'post_data',

'cancel',

'refresh',

'message_parser',

);

extract($phpbb_dispatcher->trigger_event('core.posting_modify_message_text', compact($vars)));

* @var array error Any error strings; a non-empty array aborts form submission.

* NOTE: Should be actual language strings, NOT language keys.

* @since 3.1.0-RC5

*/

$vars = array(

'post_data',

* posting page via $template->assign_vars()

* @var object message_parser The message parser object

* @since 3.1.0-a1

* s_topic_icons, form_enctype, s_action, s_hidden_fields,

* post_id, topic_id, forum_id, submit, preview, save, load,

* delete, cancel, refresh, error, page_data, message_parser

*/

$vars = array(

'post_data',

<span title="{L_SORT_OPTIONS}" class="button button-secondary dropdown-trigger dropdown-select">

<i class="icon fa-sort-amount-asc fa-fw" aria-hidden="true"></i>

<span class="caret"><i class="icon fa-sort-down fa-fw" aria-hidden="true"></i></span>

<br /><strong>{forumrow.L_SUBFORUM_STR}{L_COLON}</strong>

<!-- BEGIN subforum -->

<a href="{forumrow.subforum.U_SUBFORUM}" class="subforum<!-- IF forumrow.subforum.S_UNREAD --> unread<!-- ELSE --> read<!-- ENDIF -->" title="<!-- IF forumrow.subforum.S_UNREAD -->{L_UNREAD_POSTS}<!-- ELSE -->{L_NO_UNREAD_POSTS}<!-- ENDIF -->">

<!-- END subforum -->

<!-- EVENT forumlist_body_subforums_after -->

<!-- ENDIF -->

<ul class="dropdown-contents">

<!-- BEGIN jumpbox_forums -->

<!-- IF jumpbox_forums.FORUM_ID neq -1 -->

<!-- ENDIF -->

<!-- END jumpbox_forums -->

</ul>

<!-- ENDIF -->

<!-- BEGIN pagination -->

<!-- IF pagination.S_IS_PREV -->

<!-- ELSEIF pagination.S_IS_CURRENT -->

<li class="active"><span>{pagination.PAGE_NUMBER}</span></li>

<!-- ELSEIF pagination.S_IS_ELLIPSIS -->

<li class="ellipsis" role="separator"><span>{L_ELLIPSIS}</span></li>

<!-- ELSEIF pagination.S_IS_NEXT -->

<!-- ELSE -->

<li><a class="button" href="{pagination.PAGE_URL}" role="button">{pagination.PAGE_NUMBER}</a></li>

<!-- ENDIF -->

text-align: left;

}

.rtl div.rules ul {

margin-left: 0;

margin-right: 20px;

float: left;

}

/* Notifications

-----------------------------------------*/

.rtl .notification_list ul li img {

*/

.rtl .caret {

}

/* Post control buttons

--------------------------------------------- */

.rtl .post-buttons {

float: right;

}

border-left-width: 1px;

border-right-width: 0;

}

color: #2E8B57;

}

/* Attachments

----------------------------------------*/

.attachbox {

--------------------------------------------------------------

*/

* Author, Post time, Replies, Subject, Views

* @var string sort_dir Either "a" for ascending or "d" for descending

* @since 3.1.0-a1

*/

$vars = array(

'forum_data',

* @var int guest_counter Number of guests displayed

* @var array forum_data Array with forum data

* @since 3.1.0-a1

*/

$vars = array('sql_ary', 'show_guests', 'guest_counter', 'forum_data');

extract($phpbb_dispatcher->trigger_event('core.viewonline_modify_sql', compact($vars)));

* @var string location_url Page url to displayed in the list

* @var array forum_data Array with forum data

* @since 3.1.0-a1

*/

$vars = array('on_page', 'row', 'location', 'location_url', 'forum_data');

extract($phpbb_dispatcher->trigger_event('core.viewonline_overwrite_location', compact($vars)));

* @var int total_posts Topic total posts count

* @var string viewtopic_url URL to the topic page

* @since 3.1.0-RC4

*/

$vars = array(

'base_url',

* @var int start Pagination information

* @var array sql_ary The SQL array to get the data of posts and posters

* @since 3.1.0-a1

*/

$vars = array(

'forum_id',

* @var array post_row Template block array of the post

* @var array topic_data Array with topic data

* @since 3.1.0-a1

*/

$vars = array(

'start',

* @var array post_row Template block array of the post

* @var array topic_data Array with topic data

* @since 3.1.0-a3

*/

$vars = array(

'start',

* @var int start Start offset used to calculate the page

* @var array post_list Array with post_ids we are going to display

* @since 3.1.0-a1

*/

$vars = array('page_title', 'topic_data', 'forum_id', 'start', 'post_list');

extract($phpbb_dispatcher->trigger_event('core.viewtopic_modify_page_title', compact($vars)));

'[code:]unparsed code[/code:]',

),

array(

'Test default bbcodes: simple list',

'[list]no item[/list]',

'[list:]no item[/list:u:]',

* posting page via $template->assign_vars()

* @var object message_parser The message parser object

* @since 3.1.0-a1

* s_topic_icons, form_enctype, s_action, s_hidden_fields,

* post_id, topic_id, forum_id, submit, preview, save, load,

* delete, cancel, refresh, error, page_data, message_parser

),

array(

'outer',

array('VARIABLE' => 'pos #1'),

0,

'change',

<<<EOT

middle - 0

middle - 1

outer - 1

middle - 0

middle - 1

outer - 2

middle - 0

middle - 1

EOT

,

),

);

}

$expect = 'outer - 0[outer|4]outer - 1[outer|4]middle - 0[middle|1]outer - 2 - test[outer|4]middle - 0[middle|2]middle - 1[middle|2]outer - 3[outer|4]middle - 0[middle|3]middle - 1[middle|3]middle - 2[middle|3]';

$this->assertEquals($expect, str_replace(array("\n", "\r", "\t"), '', $this->display('test')), 'Ensuring S_NUM_ROWS is correct after modification');

}

public function assign_block_vars_array_data()

{

return array(