Форматирования BB кода в 1С-Битрикс

Часто возникает ситуация, когда надо отформатировать текст, вывести его без лишних тегов или преобразовать BB код в теги, в этом нам помогут функция и метод convert. В документации Битрикс этот метод используется в разных классах textParser, forumTextParser, CSocNetTextParser и в других, но трудно понять какой метод или функцию использовать, к тому же в документации нет хороших примеров и код там не совсем рабочий.
Например этот код у меня не сработал:

//$parser = new textParser();
//$detailText = $parser->convert($_POST['DETAIL_TEXT']);

а этот работает:

$parser = new CTextParser;
$detailText = $parser->convertText($_POST['DETAIL_TEXT']);

Как видим, здесь используется класс CTextParser. Также можно использовать следующий код:

$parser = new forumTextParser();

Здесь используется уже forumTextParser.
Иногда может понадобиться подключить модуль форума, что бы сработали нужные нам функции и мы не получили ошибку.
CModule::IncludeModule("forum");
Во всех перечисленных классах существует метод convert, который и делает то, что нам нужно, а именно заменяет BBCode.
Также в этот метод, мы можем передать вторым параметром массив параметров для форматирования сообщения, со значениями Y или N:

//$Forum = new CForumNew();
//$arAllow = $Forum->ALLOW;
$arAllow["SMILES"] = "Y";
$arAllow["CODE"] = "Y";
$arAllow["HTML"] = "Y";
$arAllow["NL2BR"] = "Y";
$arAllow["QUOTE"] = "Y";
$detailText = $parser->convert($_POST['DETAIL_TEXT'], $arAllow);
//$detailText = $_POST['DETAIL_TEXT'];

Проверка на BB код IMG

$pattern = '/\[IMG ID=(\d*)]/';
preg_match_all($pattern, $detailText, $matches);
 
if (count($matches) >= 2){
	foreach($matches[1] as $k=>$match){
		$photoPath = CFile::GetPath($match);
 
		$detailText = str_replace($matches[0][$k], "<img src='".$photoPath."' alt='' />", $detailText);
	}
}

После форматирования, можно занести текст в инфоблок, следующим образом

$el = new CIBlockElement;
 
$PROP = array();
$PROP["SOURCE"] = htmlspecialchars($_POST['SOURCE']);
$PROP["SITE"] = htmlspecialchars($_POST['SITE']);
$PROP["IS_ANONYMOUS"] = isset($_POST['anonymous']) ? 1 : 0;
 
$photos = array();
foreach($_POST['FILES'] as $fileId){
	$url = CFile::GetPath($fileId);
	$photos[] = CFile::MakeFileArray($_SERVER["DOCUMENT_ROOT"].$url);
}
 
if (count($photos) > 0){
	$PROP["ADDITIONAL_PHOTO"] = $photos;
}
 
$arLoadProductArray = Array(
	"MODIFIED_BY"    => $USER->GetID(),
	"IBLOCK_SECTION_ID" => $_POST['SECTION'],        
	"IBLOCK_ID"      => $arParams["IBLOCK_ID"],
	"DATE_ACTIVE_FROM" => date("d.m.Y H:i:s"),
	"PROPERTY_VALUES"=> $PROP,
	"NAME"           => $_POST['NAME'],
	"ACTIVE"         => "N",      
	"DETAIL_TEXT"    => $detailText,
	"DETAIL_TEXT_TYPE" => "html"
);
 
$newsId = $el->Add($arLoadProductArray)

Что бы указывать BB код картинок и текста нам понадобятся компоненты, которые выводят форму с нужными нам кнопками для форматирования 1. Компонент main.post.form

<?$APPLICATION->IncludeComponent(
	"bitrix:main.post.form",
	"",
	($formParams = Array(
		"FORM_ID" => "news_form",
		"SHOW_MORE" => "Y",
		"PARSER" => Array("Bold", "Italic", "Underline", "Strike", "ForeColor",
			"FontList", "FontSizeList", "RemoveFormat", "Quote", "Code", "InsertCut",
			"CreateLink",
			"Image",
			"Table",
			"Justify",
			"InsertOrderedList",
			"InsertUnorderedList",
			"SmileList",
			"Source",
			"UploadImage",
			"InputVideo",
			"MentionUser",
		),
		"BUTTONS" => Array(
			"UploadImage",
			"UploadFile",
			"CreateLink",
			"InputVideo",
			"Quote",
		),
		"UPLOAD_FILE" => array(
		  "INPUT_NAME" => 'FILES',
		  "INPUT_VALUE" => (!empty($arResult["MESSAGE"]["FILES"]) ? array_keys($arResult["MESSAGE"]["FILES"]) : false),
		  "MAX_FILE_SIZE" => "10000000",
		  "MULTIPLE" => "Y",
		  "MODULE_ID" => "iblock",
		  "ALLOW_UPLOAD" => ($arParams["FORUM"]["ALLOW_UPLOAD"] == "N" ? false :
			 ($arResult["FORUM"]["ALLOW_UPLOAD"] == "Y" ? "I" : $arResult["FORUM"]["ALLOW_UPLOAD"])),
		  "ALLOW_UPLOAD_EXT" => $arResult["FORUM"]["ALLOW_UPLOAD_EXT"]
	   ),
	   "UPLOAD_FILE_PARAMS" => array("width" =>1024, "height" => 1024),
 
		"TEXT" => Array(
			"NAME" => "DETAIL_TEXT",
			"VALUE" => htmlspecialcharsBack($_POST["DETAIL_TEXT"]),
			"HEIGHT" => "120px",
			"WIDTH" => "100%"),
 
 
 
	)),
	false,
	Array("HIDE_ICONS" => "Y")
);?>
 

2. Компонент fileman.light_editor

<?$APPLICATION->IncludeComponent(
	"bitrix:fileman.light_editor",
	"",
	Array(
		"CONTENT" => $_POST['DETAIL_TEXT'],
		"INPUT_NAME" => "DETAIL_TEXT",
		"INPUT_ID" => "detail_text",
		"WIDTH" => "100%",
		"HEIGHT" => "224px",
		"RESIZABLE" => "Y",
		"VIDEO_ALLOW_VIDEO" => "N",
		"USE_FILE_DIALOGS" => "N",
		"FLOATING_TOOLBAR" => "Y",
		"ARISING_TOOLBAR" => "N",
		"ID" => "detail_editor_id",
		"JS_OBJ_NAME" => "detail_editor_js_obj_name",
		"INIT_BY_JS" => false
	),
false
);?>

Вместо компонентов, также конечно можно использовать и обычное текстовое поле input или textarea, но лучше использовать готовые компоненты на своих страницах с нужными кнопками и затем форматировать их на сервере, как указанно выше.
Загрузка