363  /  382
Справочник

Компонент интеграции визуального редактора

Просмотров: 37143
Дата последнего изменения: 24.01.2024
Роберт Басыров
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5
Недоступно в лицензиях:
Ограничений нет

Создадим компонент, интегрирующий популярный редактор TinyMCE в Bitrix Framework.

Загрузите свежую версию редактора с сайта производителя.

В своем пространстве имен в папке /local создайте структуру папок и файлов:

  • /bitrix/components/tools/;
    • /bitrix/components/tools/editor.tiny.mce/;
      • /bitrix/components/tools/editor.tiny.mce/templates/;
        • /bitrix/components/tools/editor.tiny.mce/templates/.default/;
      • /bitrix/components/tools/editor.tiny.mce/tiny_mce/ - папка для дистрибутива редактора;
      • component.php — логика компонента;
      • .parameters.php — файл для описания входящих параметров.

Скопируйте скаченный дистрибутив в папку /tiny_mce.

В файл component.php добавляем код:

<? if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();
	$APPLICATION->AddHeadScript($this->__path .'/tiny_mce/tiny_mce.js');

	$sNameTextArea   =  (isset($arParams['TEXTAREA_NAME'])   == false) ? 'content'   : $arParams['TEXTAREA_NAME'];
	$sIdTextArea   	 =  (isset($arParams['TEXTAREA_ID'])     == false) ? '' 		 : $arParams['TEXTAREA_ID'];
		if ('' == trim($sIdTextArea))
		$sIdTextArea = 'content';
	$sEditorID 		 =  (isset($arParams['INIT_ID'])  	     == false) ? 'textareas' : $arParams['INIT_ID'];
	$iTextareaWidth  =  (isset($arParams['TEXTAREA_WIDTH'])  == false) ? '100%'      : $arParams['TEXTAREA_WIDTH'];
	$iTextareaHeight =  (isset($arParams['TEXTAREA_HEIGHT']) == false) ? '300'       : $arParams['TEXTAREA_HEIGHT'];
	$sText 			 =  (isset($arParams['TEXT']) 			 == false) ? ''       	 : $arParams['TEXT'];
	?>

<script type="text/javascript">

<? 
if ($arParams['TYPE_EDITOR'] == 'TYPE_1')
{
	?>
	tinyMCE.init(
		{
			language : 'ru',
			mode 	 : "textareas",
			//elements : "<?=$sEditorID?>",
			editor_selector : "<?=$sEditorID?>",
			theme    : "advanced",
			plugins  : "safari, spellchecker, upload.images.komka, wordcount, fullscreen",
			theme_advanced_buttons1 : "formatselect,fontselect,fontsizeselect,bold,italic,underline,link,justifyleft,justifycenter, 
                                       justifyright,pasteword,pastetext,images,|,bullist,numlist,|,undo,redo,|,spellchecker,fullscreen",
			theme_advanced_buttons2 : "",
			theme_advanced_buttons3 : "",
			theme_advanced_toolbar_location   : "top",
			theme_advanced_toolbar_align      : "left",
			theme_advanced_statusbar_location : "bottom",
			theme_advanced_resizing           : false,
			content_css                       : "<?=$this->__path?>/example.css",
			height : "<?=$iTextareaHeight?>",
			spellchecker_languages : '+Русский=ru,English=en',
			spellchecker_word_separator_chars : '\\s!\"#$%&()*+,-./:;<=>?@[\]^_{|}'
		}
	);
	<? 
}
elseif($arParams['TYPE_EDITOR'] == 'TYPE_2')
{
	?>
		tinyMCE.init({
				language : 'ru',
				mode 	 : "textareas",
				editor_selector : "<?=$sEditorID?>",
				theme    : "advanced",
				plugins : "safari,spellchecker,pagebreak,style,layer,table,save,advhr,advimage,advlink,emotions,iespell,inlinepopups,insertdatetime,preview,media,searchreplace,print,contextmenu,paste,directionality,fullscreen,noneditable,visualchars,nonbreaking,xhtmlxtras,template,imagemanager,filemanager",
				theme_advanced_buttons1 : "save,newdocument,|,bold,italic,underline,strikethrough,|,justifyleft,justifycenter,justifyright,justifyfull,|,styleselect,formatselect,fontselect,fontsizeselect",
				theme_advanced_buttons2 : "cut,copy,paste,pastetext,pasteword,|,search,replace,|,bullist,numlist,|,outdent,indent,blockquote,|,undo,redo,|,link,unlink,anchor,image,cleanup,help,code,|,insertdate,inserttime,preview,|,forecolor,backcolor",
				theme_advanced_buttons3 : "tablecontrols,|,hr,removeformat,visualaid,|,sub,sup,|,charmap,emotions,iespell,media,advhr,|,print,|,ltr,rtl,|,fullscreen",
				theme_advanced_buttons4 : "insertlayer,moveforward,movebackward,absolute,|,styleprops,spellchecker,|,cite,abbr,acronym,del,ins,attribs,|,visualchars,nonbreaking,template,blockquote,pagebreak,|,insertfile,insertimage",
				theme_advanced_toolbar_location : "top",
				theme_advanced_toolbar_align : "left",
				theme_advanced_statusbar_location : "bottom",
				theme_advanced_resizing : true,
				content_css : "<?=$this->__path?>/example.css",
				height : "<?=$iTextareaHeight?>",
				template_external_list_url : "js/template_list.js",
				external_link_list_url : "js/link_list.js",
				external_image_list_url : "js/image_list.js",
				media_external_list_url : "js/media_list.js",
				template_replace_values : {username : "Some User", staffid : "991234"}
			}
		);
	<? 
}
?>

</script>
<textarea id="<?=$sIdTextArea?>" class="<?=$sEditorID?>"  name="<?=$sNameTextArea?>" style="width:<?=$iTextareaWidth?>"><?=$sText?></textarea>
<? $this->IncludeComponentTemplate();?>

Файл .parameters.php


<? if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();

$arComponentParameters = array(
	"PARAMETERS" => array(
		"TYPE_EDITOR" => Array(
			"PARENT" => "SETTINGS",
			"NAME" => "Режим редактора",
			"TYPE" => "LIST",
			"VALUES" => array('TYPE_1' => 'Упрощенные редактор', 'TYPE_2' => 'Полной редактор'),
		),

		'INIT_ID' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "ID редатора (уникальный)",
			"TYPE" => "STRING",
			"DEFAULT" => '',
		),
		
		'TEXT' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "Контент который нужно вставить в редактор",
			"TYPE" => "STRING",
			"DEFAULT" => $_POST['content'],
		),
		
		'TEXTAREA_NAME' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "Имя поля TEXTAREA",
			"TYPE" => "STRING",
			"DEFAULT" => 'content',
		),
		
		'TEXTAREA_ID' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "ID поля TEXTAREA",
			"TYPE" => "STRING",
			"DEFAULT" => 'content',
		),
		
		'TEXTAREA_WIDTH' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "Ширина редактора",
			"TYPE" => "STRING",
			"DEFAULT" => '100%',
		),

		'TEXTAREA_HEIGHT' => array(
			"PARENT" => "SETTINGS",
			"NAME" => "Высота редактора",
			"TYPE" => "STRING",
			"DEFAULT" => '300',
		),
	)
);
?>

Важные моменты в коде файла component.php, которые надо пояснить. Подключение собственно редактора:

<?  $APPLICATION->AddHeadScript($this->__path .’/tiny_mce/tiny_mce.js’); ?>

Подключение стилей, которые вынесены в папку с компонентом чтобы было удобнее, это настройка уже в js, в коде инициализации:

content_css : ‘<?=$this->__path?>/example.css’,
Внимание! если на странице 2 или более редакторов, то мы идентифицируем их по имени класса editor_selector : ‘<?=$sEditorID?>’.

Собственно сама область текста для которой это все и делается:

<textarea id=’<?=$sIdTextArea?>’  name=’<?=$sNameTextArea?>’ style=’width:<?=$iTextareaWidth?>’><?=$sText?></textarea>

Как использовать

Подключается вот в таком виде:

<? echo $_POST['content'] ?>
<? echo $_POST['content2'] ?>
<form action="" method="post" name="">
<? $APPLICATION->IncludeComponent("tools:editor.tiny.mce", ".default", array(
	"TEXT" => $_POST["content"], // контент из запроса который нужно вставить
	"TEXTAREA_NAME" => "content", // имя поля
	"TEXTAREA_ID" => "content",         // id поля
	"TEXTAREA_WIDTH" => "100%",  // ширина
	"TEXTAREA_HEIGHT" => "300",    // высота
	"INIT_ID" => "ID" // ID самого редактора
),
false
);
?>
<input value="submit" name="sub" type="submit" />
</form>
41
Курсы разработаны в компании «1С-Битрикс»

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии