Про визуальный редактор:

Автор движка считает визуальный редактор вещью ненужной и бесполезной. Однако процесс глобальной профанации зашёл весьма далеко, и многим вебмастерам уже не по силам обойтись без интерфейсов для домохозяек (для которых подобные редакторы изначально и создавались).

Всяко бывает.

Специально для таких людей существует великое множество разнообразных WYSIWYG редакторов. Больших и маленьких, простеньких и сложных. И автору скрипта не влом показать, как пристёгивается к "Нане" один из них, выбранный практически произвольно, но при этом имейте ввиду следующее:

У разработчика нет никакого желания завязывать на WYSIWYG редактор все сущности и возможности своего движка.
Автору не интересно отслеживать обновления WYSIWYG тулзы, и актуализировать её.
Памятуя, что все без исключения WYSIWYG редакторы форматируют HTML код на свой манер, любая неадекватность, возникшая после нажимания многочисленных кнопок редактора, полностью и всецело возлагается на этот самый визуальный редактор.
Также понимайте, что потеря контента редактируемых документов, обусловленная неумелым тыканием в кнопки редактора, без всякого понимания, что при этом должно произойти, целиком лежит на совести тыкающего. Не экспериментируйте над документами, контент которых нигде и никак не сохранён.

С чем будем работать?

CKEditor [Frederico Knabben]

Это просто ссылка на оффсайт проекта. Там не нужно ничего скачивать.

Дистрибутив редактора, интегрированного в "Нану":

А вот это надо себе скачать: http://nanocms.name/tmp/ckeditor.zip

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

Работоспособно под PHP 5

Инсталляция:

Распакуйте скачанный архив.

Вложенность его директорий повторяет структуру "Наны", и Вам должно быть сразу понятно, куда какие фолдеры должны в итоге попасть на Вашем web-сервере (реальном или локальном- и там и там всё абсолютно работоспособно).

Обратите внимание: в качестве Наны, на которую ставится визуальный редактор, пригодна Базовая, но никак не "Крошечная".

Установка Статмодуля, Мембероны, и прочих расширений помех не создаёт.
Порядок установки расширений (что сначала, что потом) также не существенен.
Осуществите загрузку содержимого архива в соответствующие папки Наны любым FTP клиентом. Никакие права доступа или моды загрузки при этом контролировать не нужно.
В файле ./data/settings.php в списке плагинов упомяните этот:

# Какие модули нужно включить (должны быть в наличии):

   $_s['modul']=array(
      'ckeditor',
      'design',
   );

Обратите внимание: модуль 'ckeditor' прописывается непосредственно перед модулем дизайна 'design'

Сохраните файл сеттингов, подвергшийся модификации, на сервере.
Подумайте, какие файлы в папке ./data/content/ (а возможно, и расположенные глубже, если в указанной папке есть ещё какие-то фолдеры) Вы будете редактировать визуальным редактором.

Поставьте на все такие файлы права доступа 666.
Чтобы их в принципе можно было модифицировать из-под админки.

Понимайте также, что на папку, документы которой Вы намереваетесь редактировать визуальным редактором, необходимо поставить права доступа 777.

Если всего этого не сделать, то модификация документов редактором будет невозможна- поимеете кучу варнингов на экран, и этим всё закончится.

Проконтролируйте также, чтобы на папку tmp в корне скрипта также стояли права доступа 777.

Это всё.

Обратите самое пристальное внимание на пятый пункт данной инструкции: фактически, путём простановки прав на запись к папкам с документами движка, а также на сами документы, Вы задаёте, какие документы можно отдавать редактору, а какие нет.

Излишне говорить, что к файлам с PHP скриптами внутри редактор допускать не нужно. PHP скрипты будут убиты.

Также помните, что речь идёт только о папке ./data/content/ и фолдерах, вложенных в неё (если таковые имеются), и документах в этих папках. Никакие другие фолдеры и файлы ввиду не имеются.

Работа с визуальным редактором:

Авторизуйтесь в админке.
После успешной авторизации при переходе на документы Наны в топменю справа должны появиться вот такие кнопки:

Если подобных кнопок не наблюдается, значит, права доступа на документ (или папку этого документа) не поставлены в соответствии с пунктом 5 инструкции по установке.
1. Нажимание кнопки редактирования поместит документ в форму редактора с тремя изменяемыми областями:
  
  - Поле редактирования тайтла документа.
  - Редактор HTML кода с кучкой панелек инструментов.
  - Поле пути до документа относительно корня скрипта.
  
  По завершении редактирования нажатие кнопки сохранения под этой формой (или иконки с изображением дискетки в одной из панелек визуального редактора- это одно и то же) сохранит документ по указанному пути. Если, естественно, права доступа на файл и его папку позволят это.
2. При нажатии на кнопку удаления документа в расположении ./tmp/deleted.php на всякий пожарный случай создастся копия удаляемого документа, а в исходном расположении документ перестанет существовать (если права доступа на сам документ и его папку позволят стирание файла).
3. Кнопки создания нового документа нет.
  Она не нужна.
  Открытие на редактирование любого имеющегося документа с сохранением по новому пути (третий элемент формы редактирования) создаст новый документ со всеми необходимыми правами доступа.
  
  При этом будьте добры указывать в качестве директории документа существующий фолдер в пределах ./data/content/, а в качестве имени документа- сочетание мелких латинских букв и цифр, исключая любые другие символы. Расширение документа должно быть .php
Выход из админки дезактивирует редактор.

Следует понимать, что интегрированный в Нану визуальный редактор работает с документами в формате хранения данных, оговоренном спецификацией структура документа. Существенное изменение этой структуры не позволит редактору понять, где что.

Также понимайте, что визуальный HTML редактор редактирует только HTML код, и напрочь не понимает PHP и его синтаксис. Если делаете попытку редактировать файл, содержащий в себе какие-то PHP скрипты сверх спецификации формата хранения, то все эти PHP скрипты умрут.

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

По пути ./i/ckeditor/config.js живёт любопытный файлик, позволяющий:

Выбрать язык визуального редактора.
Полный список возможных языков смотрите в ./i/ckeditor/lang/_translationstatus.js
Их там много, минимальные русский и английский обязательно есть.
Задать цвет панелек редактора. Для эстетов.
Выбрать скин редактора. Возможны три варианта:

1. kama
2. office2003
3. v2

...вот так мелкая CMS-ка и обрастает плагинами, в десятки раз её большими...

Комментариев: 2

Оставить комментарий.