Allow extensions to set a custom error message in the BlockIp hook

Change-Id: I2e3773e22c78370e6ca1de49e7b0976b68d8d76b

diff --git a/docs/hooks.txt b/docs/hooks.txt
index b617430..51cf65c 100644 (file)
--- a/docs/hooks.txt
+++ b/docs/hooks.txt
@@ -772,6 +772,7 @@ $block: Block object (which is set to be autoblocking)
 'BlockIp': Before an IP address or user is blocked.
 $block: the Block object about to be saved
 $user: the user _doing_ the block (not the one being blocked)
+&$reason: if the hook is aborted, the error message to be returned in an array
 
 'BlockIpComplete': After an IP address or user is blocked.
 $block: the Block object that was saved

diff --git a/includes/specials/SpecialBlock.php b/includes/specials/SpecialBlock.php
index 1aa8006..61b59b9 100644 (file)
--- a/includes/specials/SpecialBlock.php
+++ b/includes/specials/SpecialBlock.php
@@ -695,8 +695,9 @@ class SpecialBlock extends FormSpecialPage {
                $block->isAutoblocking( $data['AutoBlock'] );
                $block->mHideName = $data['HideUser'];
 
-               if ( !wfRunHooks( 'BlockIp', array( &$block, &$performer ) ) ) {
-                       return array( 'hookaborted' );
+               $reason = array( 'hookaborted' );
+               if ( !wfRunHooks( 'BlockIp', array( &$block, &$performer, &$reason ) ) ) {
+                       return $reason;
                }
 
                # Try to insert block. Is there a conflicting block?