Войти

Требования к интеграции


  1. Все рабочие файлы должны храниться к папке /local/.
  2. Не допускается кастомизация системных компонентов для вывода той или иной информации.
  3. Не допускается кастомизация дефолтовых шаблонов как компонентов, так и сайта, для внесения правок в шаблоны их следует копировать и работать с собственными экземплярами шаблонов.
  4. Стандартный путь для шаблонов сайта - /local/templates/site_name_template_name.
  5. Стандартный путь для самописных компонентов - /local/components/_name_space_/_component_name.
  6. Стандартный путь для шаблонов компонентов - /local/templates/.default/components/_name_space_/_template_name.
  7. Стандартный путь для .CSS файлов - /local/include/tpl/css/_name.css.
  8. Стандартный путь для .JS файлов - /local/include/tpl/js/_name.js.
  9. Стандартный путь для картинок используемых в шаблонах - /local/include/tpl/images/.
  10. Стандартный путь для включаемых областей - /local/include/_name.php.
  11. Header в каждом шаблоне должен подключаться отдельным файлом - /local/include/page_header.php и содержать в себе все общие .css и .js
  12. Общий порядок подключения .CSS файлов - 1) базовый .css шаблона сайта, далее остальные (различные плагины и прочие .css). Последним подключается блок из трех файлов 1) custom.css, 2) colors.css, 3) media-queries.css.
  13. При написании какого-либо js, скрипт должен находиться в файле /local/include/tpl/js/main.js исключая те случаи когда скрипт технически невозможно вынести в отдельный файл.
  14. Footer в каждом шаблоне должен подключаться отдельным файлом - /local/include/page_footer.php.
  15. При нарезке .html шаблона нужно учитывать следующие правила. В header отходит вся верхняя часть страницы, включая шапку и горизонтальное меню. Footer, помимо самого подвала, может содержать в себе колонку навигации (правую или левую). Все, что не вошло в Header и Footer, будет считаться контентной областью и заполняться содержимым из index.php запрошенной страницы.
  16. Все элементы интерфейса должны быть представлены либо компонентами, либо включаемыми областями, т.е. должна быть полная поддержка интерфейса "эрмитаж".
  17. Шаблоны компонентов также должны учитывать возможность работы с динамической информацией из публичной части сайта. К примеру мы должны иметь возможность не только редактировать параметры компонента новостей, но и конкретную новость прямо из публичной части.
  18. Не допускается какая-либо выборка информации в шаблонах компонентов, в шаблоне компонента происходит работа с массивом $arResult, соответственно работа по формированию данного массива должна происходить в теле компонента либо в файле result_modifier.php конкретного шаблона вывода.
  19. Все компоненты должны использовать стандартное системное кэширование, и при этом корректно работать. Стремиться к минимальному количеству некэшированных запросов к БД. А также обращать внимание на время исполнения запросов.

Подробнее относительно шаблонов сайта и CSS.

  1. Проект должен содержать 4 (четыре) глобальных CSS файла, подключенных в заданном порядке.

  • main.css, содержащий стили для всех шаблонов сайта, для разграничения зон CSS файла можно использовать комментарии и name_space в именах классов.

  • custom.css, данный файл содержит в себе все модификации и дополнения к базовому файлу main.css

  • colors.css, содержащий в себе классы с цветами, на каждый цвет приходится по (3) три записи вида - ".color_white{} .color_white_bg{} .color_white_border{}".

  • media-queries.css, содержащий все кастомные правила медиа запросов, как правило используется для подгонки адаптива.

  1. Необязательные CSS файлы для шаблонов.

  • Другие различные CSS файлы к примеру от плагинов.

  1. При написании шаблонов для компонентов не используем style.css, все стили должны быть написаны в custom.css (делается для того чтобы не искать css по всем шаблонам).


Подробнее относительно файла normalize.css

  1. Данный файл представляет из себя некоторый микс из стандартного normalize.css и базовой типографики. [ссылка на файл]

  2. Файл должен присутствовать в каждом проекте и подключаться первым из всех стилевых таблиц.

  3. Данный файл нельзя кастомизировать.

  4. Для кастомизации типографики используется файл typography.css.


Подробнее относительно файла typography.css

  1. Данный файл представляет из себя кастомизированную типографику для конкретного проекта.

  2. В самом начале файла должны быть объявлены основные цвета сайта, эти цвета должны перебивать типографику из normalize.css.

  3. Файл подключаться вторым по счету, сразу за normalize.css.


Подробнее относительно типографики сайта /t/

  1. Любой проект содержащий вышеописанный normalize.css, должен содержать раздел типографики /t/.

  2. Раздел типографики должен быть закрыт от неавторизованных юзеров.

  3. Раздел типографики может дополняться своими элементами, но при этом не стоит удалять типовую типографику описанную в normalize.css.

  4. Каждый элемент на странице должен быть правильно описан.
    Например описание тега "<h1>" - <h1>H1</h1>.
    Будет выглядеть так: <pre class="brush:as3; toolbar:false;"><h1>H1</h1></pre>.

  5. Чтобы указанное выше описание адекватно отработало и показало исходный код элемента, нужно подключить js скрипт code_style.js. [ссылка на файл]

Комментарии (1)

  1. Михаил 22.07.2016 Ответить
    В стандартных путях CSS/JS ничего не сказано про стандартные библиотеки

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