phpBB

Development Wiki

Difference between revisions of "Release Highlights/3.1.10"

From phpBB Development Wiki

(New Features)
(Event changes)
Line 36: Line 36:
 
|- id="core.make_jumpbox_modify_tpl_ary"
 
|- id="core.make_jumpbox_modify_tpl_ary"
 
| [[#core.make_jumpbox_modify_tpl_ary|core.make_jumpbox_modify_tpl_ary]] || includes/functions_content.php || row, tpl_ary || 3.1.10-RC1 || Modify the jumpbox before it is assigned to the template
 
| [[#core.make_jumpbox_modify_tpl_ary|core.make_jumpbox_modify_tpl_ary]] || includes/functions_content.php || row, tpl_ary || 3.1.10-RC1 || Modify the jumpbox before it is assigned to the template
 +
|- id="core.modify_posting_auth"
 +
| [[#core.modify_posting_auth|core.modify_posting_auth]] || posting.php || draft_id, error, forum_id, is_authed, lastclick, load, mode, post_data, post_id, preview, refresh, save, submit, topic_id || 3.1.3-RC1 || This event allows you to do extra auth checks and verify if the user
 
|- id="core.obtain_users_online_string_before_modify"
 
|- id="core.obtain_users_online_string_before_modify"
 
| [[#core.obtain_users_online_string_before_modify|core.obtain_users_online_string_before_modify]] || includes/functions.php || item, item_id, online_users, rowset, user_online_link || 3.1.10-RC1 || Modify online userlist data
 
| [[#core.obtain_users_online_string_before_modify|core.obtain_users_online_string_before_modify]] || includes/functions.php || item, item_id, online_users, rowset, user_online_link || 3.1.10-RC1 || Modify online userlist data
 
|- id="core.prune_sql"
 
|- id="core.prune_sql"
 
| [[#core.prune_sql|core.prune_sql]] || includes/functions_admin.php || auto_sync, forum_id, prune_date, prune_flags, prune_limit, prune_mode, sql_and || 3.1.3-RC1 || Use this event to modify the SQL that selects topics to be pruned
 
| [[#core.prune_sql|core.prune_sql]] || includes/functions_admin.php || auto_sync, forum_id, prune_date, prune_flags, prune_limit, prune_mode, sql_and || 3.1.3-RC1 || Use this event to modify the SQL that selects topics to be pruned
 +
|- id="core.search_backend_search_after"
 +
| [[#core.search_backend_search_after|core.search_backend_search_after]] || search.php || author_id_ary, ex_fid_ary, id_ary, m_approve_posts_fid_sql, per_page, search_fields, search_terms, show_results, sort_by_sql, sort_days, sort_dir, sort_key, sql_author_match, start, topic_id, total_match_count || 3.1.10-RC1 || Event to search otherwise than by keywords or author
 
|- id="core.search_modify_forum_select_list"
 
|- id="core.search_modify_forum_select_list"
 
| [[#core.search_modify_forum_select_list|core.search_modify_forum_select_list]] || search.php || rowset || 3.1.10-RC1 || Modify the forum select list for advanced search page
 
| [[#core.search_modify_forum_select_list|core.search_modify_forum_select_list]] || search.php || rowset || 3.1.10-RC1 || Modify the forum select list for advanced search page
Line 47: Line 51:
 
| [[#core.search_modify_submit_parameters|core.search_modify_submit_parameters]] || search.php || author, author_id, keywords, search_id, submit || 3.1.10-RC1 || This event allows you to alter the above parameters, such as keywords and submit
 
| [[#core.search_modify_submit_parameters|core.search_modify_submit_parameters]] || search.php || author, author_id, keywords, search_id, submit || 3.1.10-RC1 || This event allows you to alter the above parameters, such as keywords and submit
 
|- id="core.search_modify_url_parameters"
 
|- id="core.search_modify_url_parameters"
| [[#core.search_modify_url_parameters|core.search_modify_url_parameters]] || search.php || search_id, sql_where, total_match_count, u_search || 3.1.7-RC1 || Event to add or modify search URL parameters
+
| [[#core.search_modify_url_parameters|core.search_modify_url_parameters]] || search.php || search_id, show_results, sql_where, total_match_count, u_search || 3.1.7-RC1 || Event to add or modify search URL parameters
 +
|- id="core.session_ip_after"
 +
| [[#core.session_ip_after|core.session_ip_after]] || phpbb/session.php || ip || 3.1.10-RC1 || Event to alter user IP address
 
|- id="core.set_post_visibility_after"
 
|- id="core.set_post_visibility_after"
 
| [[#core.set_post_visibility_after|core.set_post_visibility_after]] || phpbb/content_visibility.php || data, forum_id, is_latest, is_starter, post_id, reason, timestamp, topic_id, user_id, visibility || 3.1.10-RC1 || Perform actions after all steps to changing post visibility
 
| [[#core.set_post_visibility_after|core.set_post_visibility_after]] || phpbb/content_visibility.php || data, forum_id, is_latest, is_starter, post_id, reason, timestamp, topic_id, user_id, visibility || 3.1.10-RC1 || Perform actions after all steps to changing post visibility
Line 93: Line 99:
 
|- id="memberlist_email_before"
 
|- id="memberlist_email_before"
 
| [[#memberlist_email_before|memberlist_email_before]] || memberlist_email.html || memberlist_email.html || 3.1.10-RC1 || Allow adding customizations before the memberlist_email form.  
 
| [[#memberlist_email_before|memberlist_email_before]] || memberlist_email.html || memberlist_email.html || 3.1.10-RC1 || Allow adding customizations before the memberlist_email form.  
 +
|- id="overall_header_headerbar_after"
 +
| [[#overall_header_headerbar_after|overall_header_headerbar_after]] || overall_header.html ||  || 3.1.10-RC1 || Add content at the end of the headerbar
 +
|- id="overall_header_headerbar_before"
 +
| [[#overall_header_headerbar_before|overall_header_headerbar_before]] || overall_header.html ||  || 3.1.10-RC1 || Add content at the beginning of the headerbar
 
|- id="posting_editor_subject_append"
 
|- id="posting_editor_subject_append"
 
| [[#posting_editor_subject_append|posting_editor_subject_append]] || posting_editor.html || posting_body.html || 3.1.10-RC1 || Add field, text, etc. to the posting after the subject text box  
 
| [[#posting_editor_subject_append|posting_editor_subject_append]] || posting_editor.html || posting_body.html || 3.1.10-RC1 || Add field, text, etc. to the posting after the subject text box  

Revision as of 13:00, 24 September 2016

This page highlights important changes in phpBB 3.1.10

New Features

  • Check phpBB version constant against config version - Display a warning in the ACP if the version constant (files) does not match the phpbb_config version
  • Support extensions in UI tests - UI tests now also support installing extensions and testing their behavior

Notable Changes

  • Improved migrator - The migrator will now properly prevent timeouts and infinite loops. It will no longer unexpectedly try to revert update_data() implementations using "if": https://www.phpbb.com/community/viewtopic.php?f=461&t=2383821
  • Dropped support for MySQL versions improperly implementing FULLTEXT support - Some MySQL versions used improper implementations of FULLTEXT support. Versions with correct support are now required: https://github.com/phpbb/phpbb/pull/4426
  • Users removed from newly registered group when limit set to 0 posts - Users will now be able to exit the newly registered users group when the limit is set to according to the setting's definition in the ACP.
  • Further hardened checking links and form submissions - Added link hashes and form keys to all forms in the ACP that were still relying on global ACP form protections.

Notable Bug Fixes

  • Prevent MySQL error when looking at your posts - Wrong column was selected in certain cases.
  • Q&A CAPTCHA no longer logs error when solved - A change in 3.1.9 caused the CAPTCHA to log an error even though it was solved.
  • Min/max form values no longer preventing update of avatar settings - The newly introduced form validation on the html side will no longer report invalid min/max settings when updating avatar settings.
  • Fixed fatal error when upgrading from 3.0.x - Fixed error when upgrading from version with softdelete MOD installed.
  • Limit prunes per cron for large forums - Prunes on large forums were not limited. This could cause the prune query to fail at an unspecified point in time and leave topics unpruned.

Event changes

PHP Events (Hook Locations)

Identifier Placement Arguments Added in Release Explanation
core.acp_manage_forums_modify_forum_list includes/acp/acp_forums.php rowset 3.1.10-RC1 Modify the forum list data
core.feed_base_modify_item_sql phpbb/feed/base.php sql_ary 3.1.10-RC1 Event to modify the feed item sql
core.feed_modify_feed_row feed.php forum_id, mode, row, topic_id 3.1.10-RC1 Event to modify the feed row
core.get_forum_list_modify_data includes/functions_admin.php rowset 3.1.10-RC1 Modify the forum list data
core.make_forum_select_modify_forum_list includes/functions_admin.php rowset 3.1.10-RC1 Modify the forum list data
core.make_jumpbox_modify_forum_list includes/functions_content.php rowset 3.1.10-RC1 Modify the jumpbox forum list data
core.make_jumpbox_modify_tpl_ary includes/functions_content.php row, tpl_ary 3.1.10-RC1 Modify the jumpbox before it is assigned to the template
core.modify_posting_auth posting.php draft_id, error, forum_id, is_authed, lastclick, load, mode, post_data, post_id, preview, refresh, save, submit, topic_id 3.1.3-RC1 This event allows you to do extra auth checks and verify if the user
core.obtain_users_online_string_before_modify includes/functions.php item, item_id, online_users, rowset, user_online_link 3.1.10-RC1 Modify online userlist data
core.prune_sql includes/functions_admin.php auto_sync, forum_id, prune_date, prune_flags, prune_limit, prune_mode, sql_and 3.1.3-RC1 Use this event to modify the SQL that selects topics to be pruned
core.search_backend_search_after search.php author_id_ary, ex_fid_ary, id_ary, m_approve_posts_fid_sql, per_page, search_fields, search_terms, show_results, sort_by_sql, sort_days, sort_dir, sort_key, sql_author_match, start, topic_id, total_match_count 3.1.10-RC1 Event to search otherwise than by keywords or author
core.search_modify_forum_select_list search.php rowset 3.1.10-RC1 Modify the forum select list for advanced search page
core.search_modify_param_before search.php author_id_ary, ex_fid_ary, id_ary, keywords, search_id, show_results, sort_by_sql 3.1.3-RC1 Event to modify the SQL parameters before pre-made searches
core.search_modify_submit_parameters search.php author, author_id, keywords, search_id, submit 3.1.10-RC1 This event allows you to alter the above parameters, such as keywords and submit
core.search_modify_url_parameters search.php search_id, show_results, sql_where, total_match_count, u_search 3.1.7-RC1 Event to add or modify search URL parameters
core.session_ip_after phpbb/session.php ip 3.1.10-RC1 Event to alter user IP address
core.set_post_visibility_after phpbb/content_visibility.php data, forum_id, is_latest, is_starter, post_id, reason, timestamp, topic_id, user_id, visibility 3.1.10-RC1 Perform actions after all steps to changing post visibility
core.set_post_visibility_before_sql phpbb/content_visibility.php data, forum_id, is_latest, is_starter, post_id, reason, timestamp, topic_id, user_id, visibility 3.1.10-RC1 Perform actions right before the query to change post visibility
core.set_topic_visibility_after phpbb/content_visibility.php data, force_update_all, forum_id, reason, timestamp, topic_id, user_id, visibility 3.1.10-RC1 Perform actions after all steps to changing topic visibility
core.set_topic_visibility_before_sql phpbb/content_visibility.php data, force_update_all, forum_id, reason, timestamp, topic_id, user_id, visibility 3.1.10-RC1 Perform actions right before the query to change topic visibility
core.ucp_main_subscribed_forum_modify_template_vars includes/ucp/ucp_main.php folder_alt, folder_image, forum_id, last_post_time, last_post_url, row, template_vars, unread_forum 3.1.10-RC1 Add template variables to a subscribed forum row.
core.ucp_main_subscribed_forums_modify_query includes/ucp/ucp_main.php forbidden_forums, sql_array 3.1.10-RC1 Modify the query used to retrieve a list of subscribed forums
core.ucp_main_subscribed_post_data includes/ucp/ucp_main.php 3.1.10-RC1 Read and potentially modify the post data used to remove subscriptions to forums/topics
core.ucp_main_topiclist_count_modify_query includes/ucp/ucp_main.php forbidden_forum_ary, mode, sql_array 3.1.10-RC1 Modify the query used to retrieve the count of subscribed/bookmarked topics
core.ucp_main_topiclist_modify_query includes/ucp/ucp_main.php forbidden_forum_ary, mode, sql_array 3.1.10-RC1 Modify the query used to retrieve the list of subscribed/bookmarked topics
core.ucp_main_topiclist_topic_modify_template_vars includes/ucp/ucp_main.php folder_alt, folder_img, forum_id, icons, replies, row, template_vars, topic_id, topic_type, unread_topic, view_topic_url 3.1.10-RC1 Add template variables to a subscribed/bookmarked topic row.
core.ucp_pm_compose_modify_parse_before includes/ucp/ucp_pm_compose.php enable_bbcode, enable_sig, enable_smilies, enable_urls, error, message_parser, preview, subject, submit 3.1.10-RC1 Modify private message
core.ucp_profile_modify_signature includes/ucp/ucp_profile.php enable_bbcode, enable_smilies, enable_urls, error, message_parser, preview, signature, submit 3.1.10-RC1 Modify user signature on editing profile in UCP
core.ucp_profile_modify_signature_sql_ary includes/ucp/ucp_profile.php sql_ary 3.1.10-RC1 Modify user registration data before submitting it to the database
core.user_set_group_attributes includes/functions_user.php action, group_attributes, group_id, group_name, user_id_ary, username_ary 3.1.10-RC1 Event to perform additional actions on setting user group attributes
core.viewforum_get_announcement_topic_ids_data viewforum.php forum_data, forum_id, g_forum_ary, sql_anounce_array, sql_ary 3.1.10-RC1 Event to modify the SQL query before the announcement topic ids data is retrieved
core.viewforum_modify_topicrow viewforum.php row, s_type_switch, s_type_switch_test, topic_row 3.1.0-a1 Modify the topic data before it is assigned to the template

Template Events

Identifier Prosilver Placement (If applicable) Subsilver Placement (If applicable) Added in Release Explanation
mcp_move_before mcp_move.html mcp_move.html 3.1.10-RC1 Add content before move topic/post form
mcp_topic_postrow_post_details_after mcp_topic.html mcp_topic.html 3.1.10-RC1 Add content after post details in topic moderation
mcp_topic_postrow_post_details_before mcp_topic.html mcp_topic.html 3.1.10-RC1 Add content before post details in topic moderation
memberlist_email_before memberlist_email.html memberlist_email.html 3.1.10-RC1 Allow adding customizations before the memberlist_email form.
overall_header_headerbar_after overall_header.html 3.1.10-RC1 Add content at the end of the headerbar
overall_header_headerbar_before overall_header.html 3.1.10-RC1 Add content at the beginning of the headerbar
posting_editor_subject_append posting_editor.html posting_body.html 3.1.10-RC1 Add field, text, etc. to the posting after the subject text box
posting_editor_subject_prepend posting_editor.html posting_body.html 3.1.10-RC1 Add field, text, etc. to the posting before the subject text box
posting_topic_review_row_post_details_after posting_topic_review.html posting_topic_review.html 3.1.10-RC1 Add content after post details in topic review
posting_topic_review_row_post_details_before posting_topic_review.html posting_topic_review.html 3.1.10-RC1 Add content before post details in topic review
topiclist_row_topic_title_after search_results.html, viewforum_body.html, mcp_forum.html search_results.html, viewforum_body.html, mcp_forum.html 3.1.10-RC1 Add content into topic rows (after the elements containing the topic titles)
viewforum_body_topicrow_row_before viewforum_body.html viewforum_body.html 3.1.10-RC1 Add content before list of topics.

ACP Template Events

Identifier Placement Added in Release Explanation
acp_posting_buttons_custom_tags_before acp_posting_buttons.html 3.1.10-RC1 Add content before the custom BBCodes in the ACP