Wacis (Вейсис) - SaaS CMS, CRM и готовые решения

Миф: тема для CMS должна тащить с собой код. В Wacis тема — это вёрстка модулей, настройки и зависимости, но не PHP внутри архива.

Откуда взялось убеждение, понятно.

Во многих проектах тема давно стала контейнером для всего подряд: шаблонов, хелперов, обработчиков, правок .htaccess. Поставил тему — получил не только внешний вид, но и чужую логику на сайте.

В Wacis граница проведена иначе.

Тема описывает, как выглядят модули, и какие настройки нужны этой разметке. Обязательный файл — theme.json. Рядом могут лежать demo.json, preview.png, assets/style.css, assets/script.js и packages, если теме нужно своё решение.

Файлы .php, .phtml, .sh, .htaccess и подобные отклоняются с объяснением. Причина простая: тема — это вёрстка, а чужой код на сайте означает чужой код на сайте.

Если вёрстка использует модули из решений, они перечисляются в requires_packages. При установке система сама поставит недостающие решения, включит выключенные и только потом уложит виды.

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

Проверка тоже без ручного шаманства: собрать zip, загрузить через «Шаблоны → Загрузить тему из архива» и нажать «Применить». Если не хватает решения, справочника или поля, установка скажет, чего именно, и не сделает половину работы.

#Wacis #CMS #ВебРазработка #Шаблоны

Контент-завод для ВК пишет посты по описанию дела и выпускает их в сообщество по расписанию.

Это инструмент для случаев, когда сообщество нужно вести регулярно, но не хочется каждый раз начинать с пустого листа.

Путь в кабинете: Контент → Контент-завод для ВК.

Настройка идёт мастером в пять шагов.

Сначала задаёте номер сообщества и ключ доступа. Нужен ключ сообщества с правами на стену, не личный ключ пользователя.

Потом описываете бизнес: чем занимаетесь и о чём писать. Это главный слой управления тоном и темами.

Дальше ставите расписание: дни недели и время выхода.

На шаге с примерами завод делает два пробных поста. Его лучше не пропускать: по ним видно, где описание дела слишком общее, где не хватает фактов, где тон уехал не туда.

После оплаты установки проект запускается.

Посты лежат в трёх стопках: на публикации, опубликованные и забракованные. Пока пост не вышел, его можно поправить, перенести или снять. Забракованный не пропадает: его можно отредактировать и поставить на новое время.

Предел тоже важен.

Завод не заменяет факты о вашем деле. Если описание слабое, посты будут требовать правок. Если проект на паузе или не хватает денег на балансе, новые посты не пишутся и не выходят.

Удаление тоже не чистит отложенные записи внутри ВКонтакте. Если запись уже стоит в отложенных, убрать её можно только в самом сообществе: Записи → Отложенные.

#Wacis #ВКонтакте #Контент #Инструменты

Выгрузили записи через API, отдали на фронт — а там в списке висят черновики и статья, запланированная на пятницу. Клиент видит то, что видеть не должен.

Причина простая. API отдаёт всё: и опубликованное, и черновики, и запланированное. Это не баг.

API — это управление, а не витрина. Он показывает содержимое справочника целиком, потому что иначе им нельзя было бы управлять.

Витрину вы просите отдельно: параметр published=1 возвращает ровно то, что видит посетитель сайта.

Порядок действий, когда делаете публичную выдачу:

1. Смотрите перечень справочников: GET /api/v1/lists/. Оттуда берёте id — он подставляется во все остальные адреса.
2. Смотрите поля: GET /api/v1/lists/4/fields/. Делать это стоит до первой записи, писать можно только в объявленные поля.
3. Запрашиваете записи с published=1, limit и offset.

Вторая ловушка там же. Запись с датой публикации в будущем не показывается на сайте, пока не наступит время, но часы считаются по UTC, а не по местному поясу. Разница вылезает как раз на записях, поставленных «на сегодня вечером»: у вас уже вечер, а по UTC ещё нет.

И про постраничку. В ответе есть count — это сколько записей всего, а не сколько пришло в этой пачке. По нему и считаете страницы. Больше 500 за раз не отдаётся, по умолчанию limit 50.

Чтобы пройти справочник целиком — цикл с limit=500 и увеличением offset, выход по пустому records.

#wacis #api #вебразработка

Вёрстка вида в Wacis разложена на четыре отдельных окна, а не на одно.

До содержимого — открывающая обёртка: <section><div class="wrap">. Разметка — оболочка списка, внутри метка {item}. Разметка записи — одна карточка, она повторяется по числу записей. После содержимого — закрывающая обёртка, парно к «До».

Рядом ещё два окна: CSS и JS этого вида.

Раньше это было одно окно, которое разбиралось при сохранении. Устройство пряталось, добавлялся шаг, где можно ошибиться. Четыре окна соответствуют тому, как движок собирает страницу на самом деле.

Что важно знать до первой правки.

Стили из окна CSS уходят отдельным файлом и кешируются браузером. Визуальный редактор пишет свои правила в это же окно между двумя пометками: внутри он переписывает всё целиком, править там руками бесполезно. Выше и ниже — ваша территория.

Справа предпросмотр: вид рисуется по-настоящему, с данными сайта и стилями страницы. Ширину окна можно переключать и смотреть поведение на телефоне и на широком мониторе, не открывая сайт отдельно.

Сохранение — кнопка вверху или Ctrl+S (⌘+S на Mac), работает в любом окне. Предупреждения о несохранённых изменениях нет: закрыли вкладку — потеряли правку.

После сохранения кеш готовых страниц сбрасывается сам.

Если записи не выводятся — в «Разметке» нет метки {item}. Если карточки пустые — поля пишутся строго как {module.имя_модуля.имя_поля}.

#wacis #вебразработка #cms #вёрстка

10 минут — окно, в котором точно такая же заявка повторно не заводится. Посетитель нажал «Отправить» дважды, а не оставил две заявки.

Это решение form: конструктор форм и хранилище заявок.

Если заявка совпадает с предыдущей и прошло меньше 10 минут, второй записи в разделе «Заявки» не появится.

Рядом работает правило поважнее. Заявка сохраняется в базе первой, до всех действий после отправки, и независимо от них. Почта может не уйти, Telegram — не ответить, заявка останется на месте. Поэтому строка save в действиях ничего не делает: она оставлена ради полноты списка. Убрав её, вы заявок не потеряете.

Что именно отработало, видно в самой заявке — поле «Что отработало»:
save: заявка сохранена
email: отправлено
telegram: не отправлено

С вложениями та же логика. Поле типа «Файл» принимает до 20 МБ на файл, файлы кладутся в /uploads/forms/, а не в общую библиотеку картинок. Не приняли файл — заявка всё равно уходит, а в поле остаётся пометка о причине.

Что с этим делать. Жалобы «письма не приходят» разбирайте не с настроек почты, а с поля «Что отработало» в заявке: если там email: не отправлено — идти в Настройки → Настройки API, а если строки email нет вовсе — действие просто не прописано в форме.

#wacis #формы #вебразработка #cms

Спрашивают: завёл в манифесте поле типа select, а страницы со справочником стали отдавать ошибку базы. Ответ: не указаны select_by и select_show.

Связь в поле-выборке описывается тремя ключами, а не одним.

select — на какой справочник смотрим. select_by — что храним, столбец цели. select_show — что показываем, тоже столбец цели.

Если оставить только select, поле заведётся. Тип есть, а на что смотреть — не сказано, и поле пустое.

Дальше хуже. Пустое «что хранить» попадает в список столбцов запроса. И каждая страница, где читается этот справочник, отвечает ошибкой базы. Не одна запись, не одна форма — каждая страница.

У нас это ронял живые сайты дважды.

И вот оговорка. Установщик проверяет многое: имя справочника, наличие справочника у модуля, имя модуля, core_version, доступность зависимостей. Отказ на любом шаге откатывает всё сделанное, половины решения не остаётся.

Но неполное описание выборки через эти проверки проходит. Решение встанет целиком, без ошибок при установке. Разваливаться начнёт потом, на чтении.

Поэтому правило простое: увидели "type": "select" — рядом обязаны стоять select, select_by и select_show. Все три.

Для справки, как это выглядит целиком:

{ "name": "category", "type": "select", "select": "category", "select_by": "id", "select_show": "title" }

#wacis #вебразработка #cms