Make SpecialContributionsBeforeMainOutput hook more useful

The current id number is useless for IP addresses, so it now
passes a proper User object.

For context, the SpecialPage instance is also provided.

Change-Id: Ie196611d504b3969bcdfb5c589716af2f3c54e14

diff --git a/docs/hooks.txt b/docs/hooks.txt
index 53382f4..ebc412b 100644 (file)
--- a/docs/hooks.txt
+++ b/docs/hooks.txt
@@ -2208,7 +2208,9 @@ $sp: SpecialPage object, for context
 &$fields: Current HTMLForm fields
 
 'SpecialContributionsBeforeMainOutput': Before the form on Special:Contributions
-$id: User identifier
+$id: User id number, only provided for backwards-compatability
+$user: User object representing user contributions are being fetched for
+$sp: SpecialPage instance, providing context
 
 'SpecialListusersDefaultQuery': Called right before the end of
 UsersPager::getDefaultQuery().

diff --git a/includes/specials/SpecialContributions.php b/includes/specials/SpecialContributions.php
index af6a35b..551b972 100644 (file)
--- a/includes/specials/SpecialContributions.php
+++ b/includes/specials/SpecialContributions.php
@@ -168,7 +168,7 @@ class SpecialContributions extends SpecialPage {
                // Add RSS/atom links
                $this->addFeedLinks( array( 'action' => 'feedcontributions', 'user' => $target ) );
 
-               if ( wfRunHooks( 'SpecialContributionsBeforeMainOutput', array( $id ) ) ) {
+               if ( wfRunHooks( 'SpecialContributionsBeforeMainOutput', array( $id, $userObj, $this ) ) ) {
                        $out->addHTML( $this->getForm() );
 
                        $pager = new ContribsPager( $this->getContext(), array(