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

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
Наверх