В то время, как стандартный редактор шаблонов полезен для небольшого редактирования, для более больших и комплексных изменений, редактирование с использованием привычных программных средств (IDE) является более предпочтительным. Invision Community позволяет это сделать с помощью Режима дизайнера.
Что такое Режим дизайнера?
Режим дизайнера позволяет вам использовать привычную среду разработки путём экспорта всех шаблонов и CSS файлов на диск в качестве отдельных файлов, а затем повторного импорта файлов обратно, когда вы закончите разработку.
При активном Режиме дизайнера, программное обеспечение позволит менять файлы шаблонов и CSS стилей и видеть изменения в режиме реального времени.
Режим дизайнера не должен использоваться на живом сообществе, т.к. будет сообщество будет иметь некоторые последствия использования ресурсов. Мы всегда рекомендуем производить разработку тем в Режиме дизайнера на тестовых установках.
Включение Режима дизайнера
Первый шаг активации - создать директорию под названием "themes" в корневой директории вашего сообщества (там же, где расположен ваш файл conf_global.php). Установите CHMOD для директории 777.
Далее, перейдите на страницу вашего админцентра Кастомизация > Внешний вид > Темы. В верхней части страницы нажмите на кнопку Режим дизайнера. Переключите настройку после прочтения информационного сообщения и сохраните изменения. IPS4 начнёт запись файлов темы на диск.
После завершения, вы увидите структуру директорий, подобную этой в директории /themes на вашем сервере:
Список файлов тем на диске
Все установленные темы экспортируются при включённом Режиме дизайнера; родительская директория в этой структуре носит название ID темы. Вы можете увидеть ID темы после включения режима дизайна на странице списка тем:
Просмотр номеров ID тем
Каждая директория темы содержит четыре ключевые части:
-
/css
CSS код для темы, сгруппированные сначала по приложению, затем по расположению (front/admin/global). -
/html
Используемые темой HTML шаблоны с расширением *.phtml, сгруппированные сперва по приложению, затем по расположению (front/admin/global), и по области применения. -
lang.php
Файл языка, в который вы можете добавить собственные языковые строки, необходимые для вашей темы. Строки должны быть в формате: -
'ключ_фразы_без_пробелов' => "Фраза" -
/resources
Ресурсы для темы (в основном изображения), сгруппированные сначала по приложению, затем по расположению (front/admin/global), затем по типу.
Редактирование шаблонов
Когда вы редактируете *.phtml файл шаблона, экспортированные Режимом дизайнера, вы увидите специальный тег в первой строке каждого файла, похожий на этот:
<ips:template parameters="$title,$html,$location=array()" />
В этом теге содержатся переменные, которые принадлежит данному шаблону. Важно не изменять данную строку в файлах шаблонов, иначе это приведёт к ошибке темы.
Завершение работы в Режиме дизайнера
Когда вы внесли все изменения, вы можете отключить Режим дизайнера для импорта файлов обратно на сайт (обратите внимание, что вы можете включить Режим дизайнера позже, если захотите продолжить).
Чтобы это сделать, вернитесь назад к странице списка тем в меню Кастомизация > Внешний вид > Темы, и нажмите на красную кнопку "Режим дизайнера включён". Когда вы отключите настройку, вы увидите уточняющее сообщение, запрашивающее ваше подтверждение на синхронизацию изменений.
Убедитесь, что опция "Синхронизация изменений" активирована при сохранении, иначе ваши изменения будут утеряны.
Вы можете указать темы индивидуально, чтобы их синхронизировать, или все сразу. Вы также можете автоматически удалить файлы с диска при синхронизации тем.