Merge "API: Add hooks for ApiQueryBase's query and row-processing"
authorjenkins-bot <jenkins-bot@gerrit.wikimedia.org>
Fri, 7 Oct 2016 04:36:45 +0000 (04:36 +0000)
committerGerrit Code Review <gerrit@wikimedia.org>
Fri, 7 Oct 2016 04:36:45 +0000 (04:36 +0000)
1  2 
RELEASE-NOTES-1.28

diff --combined RELEASE-NOTES-1.28
@@@ -61,6 -61,9 +61,9 @@@ production
    on the wiki farm with a different domain, MediaWiki will instead alter the redirect
    URL to include a ?cpPosTime parameter that triggers the database synchronization when
    the URL is followed by the client. The same-domain case uses a new cpPosTime cookie.
+ * Added new hooks, 'ApiQueryBaseBeforeQuery', 'ApiQueryBaseAfterQuery', and
+   'ApiQueryBaseProcessRow', to make it easier for extensions to add 'prop' and
+   'show' parameters to existing API query modules.
  
  === External library changes in 1.28 ===
  
    indicated by a 'fromencoded' boolean alongside the existing 'from' parameter.
  * (T28680) action=paraminfo can now return info about all submodules of a
    module without listing them all explicitly.
 +* (T146770) It is now possible to assert that the current user is a specific
 +  named user, using the 'assertuser' parameter.
  
  === Action API internal changes in 1.28 ===
  * Added a new hook, 'ApiMakeParserOptions', to allow extensions to better
  * ApiResult::setParsedLimit() was removed (deprecated since 1.25)
  * ApiResult::setRawMode() was removed (deprecated since 1.25)
  * ApiResult::size() was removed (deprecated since 1.25)
+ * Added new hooks, 'ApiQueryBaseBeforeQuery', 'ApiQueryBaseAfterQuery', and
+   'ApiQueryBaseProcessRow', to make it easier for extensions to add 'prop' and
+   'show' parameters to existing API query modules. A query module can enable
+   these hooks by passing an array for $hookData to ApiQueryBase::select() and
+   by calling ApiQueryBase->processRow() before adding a row's data to the
+   result.
  
  === Languages updated in 1.28 ===
  
@@@ -214,9 -221,6 +223,9 @@@ changes to languages because of Phabric
  * IP::isConfiguredProxy() and IP::isTrustedProxy() were removed. Callers should
    migrate to using the same functions on a ProxyLookup instance, obtainable from
    MediaWikiServices.
 +* The ArticleAfterFetchContent, ArticleInsertComplete, ArticleSave, ArticleSaveComplete,
 +  ArticleViewCustom, EditPageGetDiffText, EditPageGetPreviewText and ShowRawCssJs hooks
 +  will now emit deprecation warnings if used.
  
  == Compatibility ==