Текущая версия: различия между версиями
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) Нет описания правки |
||
| Строка 1: | Строка 1: | ||
== Описание == | == Описание == | ||
Стабильная версия CMS 1. | Стабильная версия CMS 1.6+ | ||
Для работы CMS необходимо и достаточно склонировать репозиторий, скачать дамп БД и прописать настройки к ней в файле settings.php | Для работы CMS необходимо и достаточно склонировать репозиторий, скачать дамп БД и прописать настройки к ней в файле settings.php | ||
Большинство функционала доступно с версии 1.4. | Большинство функционала доступно с версии 1.4. | ||
| Строка 52: | Строка 52: | ||
Для программной части используется views/ | Для программной части используется views/ | ||
== Структура панели администрирования (старая) == | == Структура панели администрирования (/app/admin/ - старая) == | ||
'''admin/''' - панель администрирования, на сайте доступ через adm/ (можно задать любой другой через указание константы define('ADMIN_PREFIX', 'adm'); в /define.php) | '''admin/''' - панель администрирования, на сайте доступ через adm/ (можно задать любой другой через указание константы define('ADMIN_PREFIX', 'adm'); в /define.php) | ||
admin/'''admin.php''' - основной файл | admin/'''admin.php''' - основной файл административной панели | ||
admin/'''home.php''' - главная страница | admin/'''home.php''' - главная страница административной панели (если не предполагается - в начале файла добавить редирект) | ||
admin/'''blocks/''' - общая верстка панели администрирования | admin/'''blocks/''' - общая верстка панели администрирования | ||
| Строка 85: | Строка 85: | ||
admin/'''views/''' - страницы админки | admin/'''views/''' - страницы админки | ||
== Структура ядра == | == Структура ядра (/app/) == | ||
classes/''' - ядро движка и системные классы | classes/''' - ядро движка и системные классы | ||
| Строка 134: | Строка 134: | ||
Содержимое папки следует добавлять в .gitgnore | Содержимое папки следует добавлять в .gitgnore | ||
content/''' | content/'''uploads''' - пользовательские файлы, в т.ч. изображения | ||
content/'''pages''' - пользовательские файлы, загруженные в | content/'''pages''' - пользовательские файлы, загруженные в административной панели через tinymce | ||
content/'''popups/''' - содержит json-файлы с настройками форм | content/'''popups/''' - содержит json-файлы с настройками форм | ||
content/''' | content/'''catalog/''' - изображения каталога | ||
content/''' | content/'''catalog/catalog/6301fe43f126aa0358bec5e25efd531d/''' - изображения для товара из каталога catalog с артикулом 001 | ||
content/'''slides/''' - изображения для слайдеров | content/'''slides/''' - изображения для слайдеров | ||
| Строка 149: | Строка 149: | ||
'''css/''' (на некоторых версиях stylesheets) - таблицы стилей, используемые на сайте | '''css/''' (на некоторых версиях stylesheets) - таблицы стилей, используемые на сайте | ||
css/''' | css/'''main.css''' - Основной стилевой файл | ||
css/'''media.css''' - стилевой файл, отвечающий за адаптацию | css/'''media.css''' - стилевой файл, отвечающий за адаптацию | ||
| Строка 167: | Строка 167: | ||
js/'''common.js''' - общий файл со скриптами | js/'''common.js''' - общий файл со скриптами | ||
js/'''jquery-2.2.4.min.js''' - JQuery 2.2.4 (ранее использовалась версия 1.12.4, полная совместимость) | js/'''jquery-2.2.4.min.js''' - JQuery 2.2.4 (ранее использовалась версия 1.12.4, полная совместимость) | ||
== Модуль поддержки языков (/app/lang) == | == Модуль поддержки языков (/app/lang и /local/lang) == | ||
lang/'''en.php''' | lang/'''en.php''' | ||
| Строка 182: | Строка 180: | ||
Вызов через '''{% lang aboutus %}''', в *.php '''APP::ParseLangValue("news")''' | Вызов через '''{% lang aboutus %}''', в *.php '''APP::ParseLangValue("news")''' | ||
== Расширения (/extensions) == | == Расширения (/app/extensions и /local/extensions) == | ||
[[Расширения]] | [[Расширения]] | ||
| Строка 191: | Строка 189: | ||
== Страницы сайта (/views) == | == Страницы сайта (/views) == | ||
[[Views]] | [[Views]] | ||
== Файлы в корневой директории == | == Файлы в корневой директории == | ||
'''.htaccess''' - обработка логики движка, все символические пути прописываются вручную через этот файл | '''.htaccess''' - обработка логики движка, все символические пути прописываются вручную через этот файл | ||
'''index.php''' - основной файл сайта, в основном в нем меняются только обертки для основных блоков в body, а также устанавливается метрика | '''index.php''' - основной файл сайта, в основном в нем меняются только обертки для основных блоков в body, а также устанавливается метрика | ||
== Файл настроек сайта (settings.php) == | == Файл настроек сайта (settings.php) == | ||
'''settings.php''' - содержит типовые настройки сайта, такие как подключение к базе данных, и другие. | '''settings.php''' - содержит типовые настройки сайта, такие как подключение к базе данных, и другие. | ||
Версия от 13:25, 5 июня 2023
Описание
Стабильная версия CMS 1.6+ Для работы CMS необходимо и достаточно склонировать репозиторий, скачать дамп БД и прописать настройки к ней в файле settings.php Большинство функционала доступно с версии 1.4.
Типовые вопросы
Всплывающие окна
Для создания всплывающего окна необходимо прописать путь в js /direct/test
Код всплывающего окна положить в /views/direct/test.api.php
Где test - название вашего всплывающего окна
Чтобы получить список дочерних страниц:
$Page = APP::getPage();
$albums = PAGECONSTRUCTOR::getPageChildren($Page->itemKey, $Page->group);
Установить страницу админки по-умолчанию:
Добавить в настройки опцию admin_homepage
Типичные ошибки
Корневая директория для блоков - /views/
TPL of the page not found - не найден шаблон в папке tpl/
Ошибка 404 после обновления - некорректно заполнена переменная $_CARD_TEMPLATES в define.php
Может принимать значения вида array('catalog' => 'catalog', 'project' => 'testcatalog'); а также допустимо значение в виде пустого массива array();
Общая структура системы
Системные файлы хранятся в app/
Для кастомизации программных модулей используется local/
Для общих шаблонов используется tpl/
Для программной части используется views/
Структура панели администрирования (/app/admin/ - старая)
admin/ - панель администрирования, на сайте доступ через adm/ (можно задать любой другой через указание константы define('ADMIN_PREFIX', 'adm'); в /define.php)
admin/admin.php - основной файл административной панели
admin/home.php - главная страница административной панели (если не предполагается - в начале файла добавить редирект)
admin/blocks/ - общая верстка панели администрирования
admin/blocks/aside.php - левое меню в админке
admin/blocks/head.php - блок <head> для всех страниц в админке
admin/blocks/header.php - верхнее меню в админке
admin/img/ - изображения, используемые в админке
admin/js/ - javascript-файлы используемый в админке
admin/js/main.js - основной файл с логикой работы админки
admin/js/tinymce - редактор tinymce
admin/js/tinymce/plugins/jbimages/config.php - файл настроек плагина загрузки изображений, переменная $config['img_path'] = '/content/upload';
admin/css/ - таблицы стилей для админки
admin/css/main.css - основные стили админки
admin/css/jstree.min.css - древо страниц
admin/views/ - страницы админки
Структура ядра (/app/)
classes/ - ядро движка и системные классы
classes/class.cache.php - классы кэширования данных
classes/class.db.php - классы подключения к базе данных
classes/class.debug.php - класс логгера
classes/core.php - ядро
classes/methods.php - описание системных вызовов движка, таких как post,get,api (частичная поддержка)
classes/utils.php - общие функции движка (interface OPTIONS, class EXECUTION_TIME)
classes/Pattern - объект страницы
lib - Сторонние библиотеки
modules - Модули
Типовые подключаемые блоки (/blocks)
blocks/ - типовые подключаемые блоки
blocks/aside.php - меню со списком категорий каталога
blocks/crumbs.php - хлебные крошки
blocks/footer.php - подвал сайта
blocks/head.php - блок <head> для всех страниц сайта
blocks/header.php - блок <header> для всех страниц сайта
Система кэширования (/app/cache)
Система кэширования реализована в виде нескольких частей:
1) кэширование основных опций (options)
2) кэширование шаблонов (различие с опциями во множественных значениях одного типа)
3) кэширование объектов каталога (cache/catalog)
4) пользовательские объекты кэша (cache/custom) - используются разработчиками сайтов
Пользовательский контент (/content)
Содержимое папки следует добавлять в .gitgnore
content/uploads - пользовательские файлы, в т.ч. изображения
content/pages - пользовательские файлы, загруженные в административной панели через tinymce
content/popups/ - содержит json-файлы с настройками форм
content/catalog/ - изображения каталога
content/catalog/catalog/6301fe43f126aa0358bec5e25efd531d/ - изображения для товара из каталога catalog с артикулом 001
content/slides/ - изображения для слайдеров
Таблицы стилей (/css)
css/ (на некоторых версиях stylesheets) - таблицы стилей, используемые на сайте
css/main.css - Основной стилевой файл
css/media.css - стилевой файл, отвечающий за адаптацию
Библиотека fancybox (/fancybox)
Шрифты (/fonts)
Шрифты в формате .otf .eot .svg .ttf .woff .woff2
Изображения (/img)
img/ - изображения, используемые на сайте
img/picture-default.png - картинка, используемая по-умолчанию в каталоге
Скрипты Javascript (/js)
js/ - скрипты, используемые на сайте
js/common.js - общий файл со скриптами
js/jquery-2.2.4.min.js - JQuery 2.2.4 (ранее использовалась версия 1.12.4, полная совместимость)
Модуль поддержки языков (/app/lang и /local/lang)
lang/en.php
lang/ru.php
Запись значения через $msg["en"]["news"] = "News";
Вызов через {% lang aboutus %}, в *.php APP::ParseLangValue("news")
Расширения (/app/extensions и /local/extensions)
Папка общих шаблонов конкретных страниц (/tpl)
Страницы сайта (/views)
Файлы в корневой директории
.htaccess - обработка логики движка, все символические пути прописываются вручную через этот файл
index.php - основной файл сайта, в основном в нем меняются только обертки для основных блоков в body, а также устанавливается метрика
Файл настроек сайта (settings.php)
settings.php - содержит типовые настройки сайта, такие как подключение к базе данных, и другие.