Документация для разработчиков
Темная тема

addPHPParser

Описание и параметры

Добавляет функцию-обработчик всех фрагментов PHP в исходном коде редактируемого документа. Функции, добавленные таким образом, будут обрабатывать фрагменты PHP кода до замены его на стандартную иконку PHP кода, при загрузке редактируемого документа, а также при переключении из режима кода, в WYSIWYG.

void
oBXEditorUtils.addPHPParser(
	function handler[,
	int orderInd]
);

Параметры метода

Параметр Описание
handler Функция, объявленная в глобальной области видимости.
В качестве единственного параметра принимает строку (содержимое php-кода). Должна вернуть строку (контент с внесёнными в него изменениями) или false. В случае если возвращается false, изменения в код не вносятся.
Кроме того, следует обратить внимание на то, что на обработку функции передается весь код php-фрагмента, включая открывающие и закрывающие теги.
orderInd Позиция парсера при обработке. Необязательный параметр. По умолчанию, парсеры обрабатывают код в порядке, соответствующему очередности их подключения.
Передав в orderInd, например, 0, можно добиться того, что этот обработчик будет обрабатывать код в 1-ю очередь.
Но, если в последствии будет зарегестрирован ещё обработчик с orderInd=0, то он будет выполняться раньше.

Пример добавления PHP-парсера

function myPHPParser(str)
{
	//Если фрагмент PHP равен <?MyPHPFunction();?>, он заменяется на иконку
	if (str=='<?MyPHPFunction();?>')
		return '<img src="icon.gif" title="Image Title" __bxtagname="customtag">';
	return false;
}
//Добавление парсера
oBXEditorUtils.addPHPParser(myPHPParser);


© «Битрикс», 2001-2024, «1С-Битрикс», 2024