Переопределение методов модулей с помощью ...Hook'ов!

В LiveStreet 0.4 появилась возможность переопределять не только целиком модули, но и отдельные методы. Это позволить разным плагинам бесконфликтно переопределять разные методы одного модуля.

Принцип действия этого механизма основан на Hook'ах:

1. Вызов каждого метода сопровождается выполнением хуков — module_ModuleName_MethodName_before и module_ModuleName_MethodName_after, соответственно ДО и ПОСЛЕ вызова метода модуля. В первом случаи в хук передаются параметры вызова метода, во втором передается результат выполнения метода модуля.
2. На module_ModuleName_MethodName_before можно повесить специальный хук — delegate, результат выполнения которого и будет «результатом» выполнения метода модуля

Пример:

<?php 
class HookTest extends Hook {
	public function RegisterHook() {
		$this->AddDelegateHook('module_text_parser_before','testHook',__CLASS__,-3);
	}

	public function testHook($aVars) {
		return 'Topic text > '.$aVars[0];
	}
}
?>

Здесь происходит переопределение метода Parser модуля Text, в результате к тексту топика будет добавлена строчка 'Topic text > ', при этом исходный метод (Text_Parser()) выполнен не будет.

Список методов для делегирования:

Hook_AddDelegateModule($sName,$sCallBack,$iPriority=1)
Hook_AddDelegateFunction($sName,$sCallBack,$iPriority=1)
Hook_AddDelegateHook($sName,$sCallBack,$iPriority=1,$aParams=array())

Использование этих актуально только для хуков методов модулей.

Важное замечание:
Если на module_ModuleName_MethodName_before висит несколько хуков, то сначала они разбиваются на две группы: стандартные и делегирующие. Внутри каждой группы хуки сортируются по приоритету, затем выполняется стандартная группа и только затем делегирующая. Причем в делегирующей группе выполняется только первый хук, остальные отбрасываются для исключения конфликтов.