From 95e81fb402c1eccf2c7772914ef301fd4043d9f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erik=20Fr=C3=A8rejean?= <erikfrerejean@phpbb.com>
Date: Tue, 10 Apr 2012 20:18:05 +0200
Subject: [PATCH] [feature/events] Adding core.adm_page_header_override event

Add an event that adds the possibility to override the
phpBB `adm_page_header` function.

PHPBB3-9550
---
 phpBB/includes/functions_acp.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/phpBB/includes/functions_acp.php b/phpBB/includes/functions_acp.php
index 47caecef02..c2ed623ece 100644
--- a/phpBB/includes/functions_acp.php
+++ b/phpBB/includes/functions_acp.php
@@ -22,6 +22,7 @@ function adm_page_header($page_title)
 {
 	global $config, $db, $user, $template;
 	global $phpbb_root_path, $phpbb_admin_path, $phpEx, $SID, $_SID;
+	global $phpbb_dispatcher;
 
 	if (defined('HEADER_INC'))
 	{
@@ -30,6 +31,16 @@ function adm_page_header($page_title)
 
 	define('HEADER_INC', true);
 
+	// A listener can set this variable to `true` when it overrides this function
+	$adm_page_header_override = false;
+
+	$vars = array('page_title', 'adm_page_header_override');
+	extract($phpbb_dispatcher->trigger_event('core.adm_page_header_override', compact($vars)));
+	if ($adm_page_header_override)
+	{
+		return;
+	}
+
 	// gzip_compression
 	if ($config['gzip_compress'])
 	{