FCKeditor

Обзор

Модуль позволяет Drupal заменить текстовые поля редактором FCKeditor. Этот HTML текстовый редактор имеет множество очень мощных функций, как у известного оффлайного редактора Word, только в web. Он относительно мало весит и не требует установки каких-либо программ на компьютере.

Требования

- Drupal 5.x
- PHP 4.3.0 или выше
- FCKeditor 2.3.x или выше (http://www.fckeditor.net/)

Установка и настройка

1. Скачайте модуль FCKeditor и загрузите в директорию с модулями (sites/all/modules).
2. С официального сайта FCKeditor скачайте сам редактор и скопируйте в директорию sites/all/modules/fckeditor папку под названием fckeditor
3. Включите модуль как обычно на странице модулей.
4. Назначьте права на использование редактора на странице Админка → Управление пользователями → Контроль доступа
5. Пройдите Админка → Настройки → FCKeditor, создайте профили. В каждом можно выбрать, какие текстовые поля будут заменены редактором. Выберите панель по умолчанию и сделайте другие дополнительные настройки.
6. Для того, чтобы работал расширенный текстовый редактор, нужно еще настроить фильтры для пользователей с правом использовать этот редактор.
   Либо дайте им право на формат ввода Full HTML, либо используйте следующие теги:
   <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tr> <td> <em> <b> <u> <i> <strong> <font> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite> <embed> <object> <strike> <caption>
7. Чтобы не делать лишние переводы строк (при нажатии на enter и shift+enter), нужно отключить фильтр "Преобразователь переводов строки" для выбранного формата ввода нажав настроить на странице Админка → Настройка → Форматы ввода (рекомендуется). Редактор при нажатии упомянутых кнопок автоматически вставит теги <p> и <br />, поэтому этот фильтр окажется лишним.
8. Измените файл /modules/fckeditor/fckeditor.config.js под ваши потребности (дополнительно). Вы можете копировать нужные строки из настроек по умолчанию в файле modules/fckeditor/fckeditor/fckconfig.js. Строки в fckeditor.config.js перекроют большинство из них.

Устранение проблем с установкой

Если FCKeditor не показывается, нужно проверить, все ли файлы расположены правильно. Директория /modules/fckeditor/fckeditor/ должна содержать следующие файлы: fckeditor.js, fckconfig.js, fckstyles.xml, fcktemplates.xml и папку editor. Правильная структура директорий такова:

Плагины: "Отделение анонса" и "Разбиение на страницы"

По умолчанию модуль FCKeditor идет с двумя плагинами, которые могут вставлять разделитель анонса(!--break--) и разделитель страниц ('<!--pagebreak-->'). Чтобы использовать pagebreak, нужно сначала скачать, включить модуль paging и разрешить его фильтр для вашего формата ввода.
Можно включить любой (или оба) из них.

1. Откройте /modules/fckeditor/fckeditor.config.js и раскомментируйте три строчки:
   FCKConfig.PluginsPath = '../../plugins/' ;
FCKConfig.Plugins.Add( 'drupalbreak' ) ;
FCKConfig.Plugins.Add( 'drupalpagebreak' ) ;

2. Вторым шагом будет добавление кнопки в панель (в том же файле). Кнопки называются: DrupalBreak, DrupalPageBreak.
   Например, если у вас массив кнопок определен таким образом:
   ['Image','Flash','Table','Rule','SpecialChar']
   
   Просто добавьте строчку
   
   ['Image','Flash','Table','Rule','SpecialChar', 'DrupalBreak', 'DrupalPageBreak']
   
   (помните об одиночных кавычках).

Загрузка изображений и файлов

Есть три способа загрузки файлов: используя встроенный обозреватель файлов, модуль типа IMCE или модуль upload из ядра.

Как включить обозреватель файлов?

Редактор предоставляет конечному пользователю гибкость создания собственного файлового обозревателя, который может быть интегрирован в него.
Встроенный обозреватель дает возможность пользователю просматривать файлы в особой директории на сервере и добавлять в нее новые (создавать папки и загружать файлы).

1. Чтобы включить обозреватель, нужно изменить файл настроек соединения:
   /modules/fckeditor/fckeditor/editor/filemanager/connectors/php/config.php
   
   (для FCKeditor 2.5+)

   или

   /modules/fckeditor/fckeditor/editor/filemanager/browser/default/connectors/php/config.php
и
modules/fckeditor/fckeditor/editor/filemanager/upload/php/config.php
   
   (для FCKeditor 2.3.x - 2.4.x)

   В этих файлах нужно включить обозреватель, добавив одну строчку, которая содержит файл со специальной функцией авторизации для Drupal (filemanager.config.php).

   Сразу после этой строки:

   $Config['UserFilesAbsolutePath'] = '' ;

   Добавьте этот код:

   require_once "../../../../../filemanager.config.php";
   
   (для FCKeditor 2.5+)

   или

   require_once "D:\\xampp\\htdocs\\drupal5b\\modules\\fckeditor\\filemanager.config.php"
   
   (для FCKeditor 2.3.x - 2.4.x)

   Файл config.php еще содержит некоторые другие важные установки, пожалуйста ознакомьтесь с ним и приведите в соответствие вашим нуждам (дополнительно).

2. Для Drupal 5.2 (и выше) требуется еще изменить файл settings.php в директории drupal (обычно sites/default/settings.php) и установить переменную $cookie_domain для целевого домена. Если вы этого не сделаете, FCKeditor решит, что файловый обозреватель выключен.
   (просто добавьте в этот файл строку $cookie_domain = 'example.com';, предварительно написав вместо примера свой домен)
3. Включение возможности загружать файлы – это риск для безопасности. Вот почему вам придется разграничить права доступа, чтобы включить файловый обозреватель для отдельных групп пользователей.
4. Наконец, настройте установки обозревателя для каждого профиля.

Модули: Image Assist

Image Assist может быть интегрирован с FCKeditor.
Чтобы сделать это, просто скопируйте файл modules/fckeditor/img_assist_fckeditor.js в папку модуля modules/img_assist/.

Дополнительная информация и лицензия

FCKeditor - Текстовый редактор для Интернета
Copyright (C) 2003-2006 Frederico Caldeira Knabben

Под GNU Lesser General Public License:
http://www.opensource.org/licenses/lgpl-license.php

Для более подробной информации посетите:
http://www.fckeditor.net/
http://drupal.fckeditor.net

Ниже прилагается файл со страницы создания профиля для fckeditor: