Yori
11 Августа 2021
Какие обязательные вопросы стоит включить в документацию и базовые страницы на сайте, чтобы они были и в базе у тех, кто будет устанавливать движок с нуля?
Какие вопросы возникают при установке LibArea или позже?
В состоянии на данный момент любой, имеющий базовые понятия о клонировании проекта с github, настройке конфигов и импорте дампа базы данных в свою базу — без проблем установит движок. Установить нужные права для файлов и папок и 777 для папок storage и uploads и все. Мне вот интересно когда изменяется база данных… миграций пока нет… Конечно можно отследить изменения в базе и выполнить какие-то запросы и обновиться, но хочется вообще обновлять проект нажатием одной кнопки из админки. Ну это мои хотелки, а в целом дело движется хорошо, главное чтобы Evg не сгорел в этих бесконечных обновлениях и улучшениях:) Документация нужна… я например впервые узнал что-то про политику безопасности, которая реализована в HLEB, которой не видел в других проектах… да и много чего еще. Главное чтобы на написание этой документации не уходило масса времени… Написать один раз и потом изредка добавлять что-то.
За эти дни получил много вопросов. Основное, работа с «пользовательской стороной», с Frontend, чтобы можно было максимально вольно делать что-то своё. Хорошо. Делаю релиз, раз ошибок нет и в следующей версии давайте именно поработаем над этим.
<?= config('facets.page); ?>Где, до первой точки — имя файла в папке config, а далее ключ (название) массива.
config('конфиг')
url('url')
__('перевод')и некоторые другие.
Далее. Создам ещё один шаблон чтобы проверить переопределение основного шаблона. И посмотрим разные задачи. Например:
Чтобы вообще не трогать и таскать основные файлы шаблона из папки default.
В самих шаблонах упростить конструкции, где возможно убрать передаваемые переменные в массиве, как сейчас:
<?= Tpl::insert('/footer', ['user' => $user]); ?>Если нам не нужны добавлять туда свои переменные, то конструкции могут быть предельно простыми:
<?= Tpl::insert('/footer'); ?>И всё это задокументировать. С Front-end разобраться, от этого зависит максимальная гибкость во многом. А сделав это, можно идти и на backend, более глубже.
Я только за! Базовые (основные вопросы) просто необходимы. По поводу установки и папки
publicэто уже есть, что надо ещё?Сейчас установлю версию с GitHub и посмотрю ещё раз на начальную установку и содержание всего.
P.S. Этот вопрос поднят.
Раз уж закрепили пост, то вот список того, что нужно задокументировать.