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

15 разделов в документации Wacis — от первого сайта до контент-заводов. Это не план, а описание того, что уже работает.

Я разложил документацию по маршруту, которым обычно идёт разработчик.

Сначала — регистрация, создание сайта и первый вход в панель управления. Потом установка решения из Marketplace и шаблона оформления. После этого — правка вёрстки и возврат исходной версии, если эксперимент не зашёл.

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

Их важно развести сразу. Справочник — это данные: поля и записи. Модуль выводит данные на сайт. Вид — одна из вёрсток модуля. Пакет собирает справочники, модули и логику в решение.

Например, пакет «Магазин» может завести несколько справочников и модулей. У одного модуля может быть несколько видов: плитка, список или другая вёрстка. А справочник может жить без модуля — данные есть, просто их пока никто не показывает.

Отдельно вынесены шорткоды, визуальный редактор, решения, выгрузка, сервисы, API и контент-заводы.

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

#Wacis #CMS #вебразработка

Частая ошибка: бот проверку проходит, а заявки в Telegram не приходят. В Wacis это обычно не проблема чата.

Проверка связи отвечает только на два вопроса: бот живой и указанный чат доступен.

Она не проверяет, просит ли конкретная форма отправлять уведомление.

Поэтому сценарий выглядит странно. Вы создаёте бота через @BotFather, добавляете его в группу, указываете токен и чат в «Настройки → Настройки API → Уведомления о заявках», нажимаете «Проверить связь». Всё зелёное.

Потом отправляете форму — тишина.

Если это форма из решения «Формы», проверьте поле «Действия после отправки». Для отправки в Telegram там нужна строка telegram.

Правильный порядок такой:

1. Создать отдельного бота для уведомлений.
2. Добавить его в рабочую группу для заявок.
3. Узнать chat id. Для группы он начинается с -100, минус — часть номера.
4. Вписать токен и чат в настройки уведомлений.
5. Проверить связь.
6. Для формы из конструктора добавить telegram в действия после отправки.
7. Отправить тестовую заявку.

Заявка при этом всё равно сохраняется в справочник «Заявки». Уведомление — отдельный слой, чтобы не открывать панель вручную.

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

#Wacis #CMS #Telegram #ВебРазработка

Связки в Wacis — отдельные решения. Форма может работать без CRM, а CRM — без задач.

Это сделано намеренно.

В разделе решений каждое решение описано по трём вещам: что приносит на сайт, как настраивается и что с чем связывается.

Например, «Формы» дают конструктор форм и заявки. CRM даёт заявки, воронки и статусы. «Задачи» дают задачи, статусы и комментарии.

Но связь между ними не зашита внутрь основного решения.

Если нужно, чтобы отправленная форма заводила заявку в CRM, ставится связка «CRM и формы». Она ставится из Marketplace и требует обе стороны.

Если нужно, чтобы новая заявка создавала задачу, ставится связка «Задачи по сделкам».

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

Для разработчика это проще сопровождать. Для клиента проще объяснять: на сайте стоит только та логика, которая реально нужна.

Когда собираете сайт на Wacis, начинайте с отдельных решений. А связи добавляйте только там, где в сценарии есть действие между ними.

#Wacis #CMS #Marketplace #РазработкаСайтов

«Написал {module.vacancies} — на странице пусто». Значит, модуля с таким именем нет: опечатка или он не сохранён.

В Wacis вызов несуществующего модуля убирается со страницы. Посетителю не показываются внутренности движка, а причина уходит в журнал сервера.

Что проверить первым:

1. Имя модуля.

В поле «Имя» должна быть латиница, например vacancies. Именно этим именем модуль вызывается в шаблоне: {module.vacancies}.

2. Сохранён ли модуль.

Раздел «Виды» появляется после сохранения. Там задаётся вёрстка. Сама разметка живёт не в модуле, а в его видах.

3. Есть ли справочник.

Если модуль должен выводить записи, в настройках должен быть выбран справочник. Пустой справочник — это статический блок.

4. Есть ли {item} в разметке списка.

Минимальная схема такая: общая разметка содержит {item}, а разметка записи описывает одну карточку. Без {item} список может открыться, но записи не появятся.

5. Совпадают ли имена полей.

Метка вида {module.vacancies.title} сработает только если первая часть совпадает с именем модуля, а title — с именем столбца справочника.

Отдельная оговорка для PFM.

Если модуль даёт справочнику собственные адреса, у справочника должно быть поле url. А в разметке записи нужен вывод содержимого, например {module.vacancies.content}. Иначе текст записи молча пропадёт.

#Wacis #CMS #вебразработка #модули

Раньше старые метки могли всплыть в теме как мусорный текст. Теперь всё неподставившееся вычищается на последнем шаге.

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

До этого при правке старой темы приходилось держать в голове, какие метки ещё живые, а какие уже отменены. Например, в разметке мог остаться вызов для метрики или старый формат поля записи.

Если такая строка не раскрылась, был риск увидеть её там, где её точно не ждёшь: в HTML страницы или прямо в интерфейсе для посетителя.

Сейчас порядок подстановки заканчивается уборкой. Сначала вставляется содержимое записи в вид страницы. Потом раскрываются блоки, поля страницы, настройки, места для чужого кода и formguard.

После этого всё, что не подставилось, вычищается.

Отменённые метки тоже не печатаются. Оставшаяся в старой теме {yandex_metrika} не покажется посетителю. Для кода владельца вместо неё используется {before_head_close_code}.

Вторая правка — справочник меток собран в одном месте. В нём видно, чем вызвать блок, как ограничить список, включить paginate, выбрать view, вывести поле записи, поле текущей страницы, настройку или картинку.

Отдельно описан {formguard}. Он ставится в каждую форму отдельно и несёт свежую подпись времени. Поэтому страницу с ним нельзя кешировать целиком: иначе всем посетителям досталась бы одна подпись, и проверка потеряла бы смысл.

#Wacis #CMS #шаблоны #вебразработка

Миф: связь между справочниками — это просто выбрать другой справочник в поле. На деле там три настройки, и каждая влияет на базу.

Откуда взялся миф, понятно. В админке выбираете тип поля «Выбор из справочника», и кажется, что главное уже сделано: поле знает, откуда брать варианты.

Но после выбора типа появляются три настройки подряд.

Справочник — куда смотрим. Например, category.

Что сохранять — какой столбец цели ляжет в базу. Например, id.

Что показывать — какой столбец увидит человек. Например, title.

Заполнять нужно все три. Если не указать «что сохранять», поле может завестись «успешно», но потом пустое имя столбца попадёт в список полей запроса. Каждая страница, где читается этот справочник, ответит ошибкой базы.

Главная развилка — что именно хранить.

Если это настоящая ссылка на запись, храните id, показывайте title или name. Так статья ссылается на категорию, пункт меню — на меню. Категорию можно переименовать, связь останется: в базе лежит номер.

Если это выбор из перечня значений, храните name, показывайте title. Например, тип Open Graph: в базе article, в интерфейсе «Статья». Здесь важно само значение, а не отдельная запись.

В вёрстке модуль подставляет сохранённое значение. Если хранится id, {module.blog.category} выведет номер. Чтобы вывести название, либо храните title, либо выводите отдельный блок категорий с отбором по текущей записи.

#Wacis #CMS #ВебРазработка #Справочники

В Wacis модуль не хранит данные. Он выводит их на сайт: целой страницей или отдельным блоком внутри чужой разметки.

Разделение простое, но экономит время, когда сайт разрастается.

PFM — модуль-страница. Он владеет адресом и отдаёт документ целиком. Например, страница услуги, статья блога или карточка товара. Посетитель открывает адрес, ядро находит запись и рисует документ.

BFM — модуль-блок. Он сам по себе никуда не выводится. Его вставляют в разметку меткой вида {module.menu}. Так работают шапка, подвал, меню, форма, сетка работ, отзывы.

У PFM работает один основной вид. У BFM основного вида нет намеренно: один и тот же блок на соседних страницах может выглядеть по-разному. Поэтому вид задаётся на месте вызова, например {module.menu:view=premiere.menu}.

Ещё важная деталь: модуль и справочник — не одно и то же. Обычно они называются одинаково, но это не правило. В метке первая часть — имя модуля, а не имя справочника.

Как пользоваться без путаницы:

1. Открыть раздел «Модули» в нижней части меню панели.
2. Посмотреть имя, тип и число видов.
3. Править вёрстку оттуда же, а не искать её в справочниках.

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

#Wacis #CMS #вебразработка #модули

10 минут — окно, в котором CRM отсекает повторную отправку формы с тем же содержимым.

Это защита от простого дубля: человек нажал кнопку дважды, форма ушла повторно, но клиент в CRM заводится один раз.

Важно не читать это как полноценное объединение дублей. Более поздний повтор уже не считается тем же событием. Если заявка пришла снова позже, это отдельная запись.

CRM в Wacis работает как второй адресат формы. Заявка в разделе «Заявки» остаётся всегда. Если CRM снята, связка осталась или при заведении клиента произошла ошибка, исходная заявка не теряется. В журнале будет отметка об ошибке.

Чаще проблема не в дублях, а в настройке действий формы.

Если у формы нет действий, связка с CRM считается включённой. Но если вы добавили хоть одно действие, например email, строку crm нужно добавить отдельно. Иначе заявки перестанут попадать в CRM.

Минимальная проверка такая:

1. Откройте нужную форму.
2. Посмотрите «Действия после отправки».
3. Если там уже есть email или другие действия, добавьте строку crm.
4. Проверьте, что поля формы сопоставляются с полями клиента.

По умолчанию ожидаются name, phone и email. Если у вас imya, tel и pochta, задайте map. Иначе данные не лягут туда, куда вы их ждёте.

Для комментария используйте поле типа «многострочное». Длина текста не считается признаком смысла: ссылка на файл тоже длинная, но это не комментарий клиента.

#Wacis #CRM #формы #вебразработка

Частая ошибка в теме: положить свой модуль портфолио как portfolio. На одном сайте он может столкнуться с чужим решением.

Сценарий простой.

Вы делаете тему для книжного дизайнера. Системное «Портфолио» не подходит: там заголовок, тег, цена, картинка. А нужна работа как издание: клиент, год, задача.

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

Ошибка начинается в коде:

portfolio

Так делать нельзя. Код решения должен начинаться с кода темы и дефиса:

moya-tema-portfolio

Причина не в стиле именования. Если две темы привезут похожие решения с одинаковым кодом, они столкнутся на одном сайте. Вторая перепишет справочник первой.

Правильный порядок такой:

1. Дайте решению код с префиксом темы: moya-tema-portfolio.

2. В theme.json укажите его в bundled_packages списком, даже если решение одно:

["moya-tema-portfolio"]

3. В packages/moya-tema-portfolio/manifest.json укажите тот же code. Расхождение между bundled_packages и manifest.json даст отказ на установке.

4. Не кладите в packages/ PHP-файлы. Внутри решения темы может быть только manifest.json.

5. Укажите core_version со знаком, например >=1.0.0.

Ещё один момент: вид укладывается после установки решений темы. Это важно, потому что вид ищет модуль по имени. Если модуля ещё нет, вид не ляжет, и тема встанет с пустым блоком.

Чужое при этом не трогается. Если на сайте уже есть системное portfolio с записями, тема поставит своё решение旁,

#Wacis #CMS #РазработкаСайтов #Вебмастер

1 адрес на все справочники: /api/v1/lists/…. Через него внешняя программа читает и пишет данные сайта по HTTP.

В Wacis справочник — это не отдельная сущность API с собственным роутом. Статьи, товары, заявки и любые другие справочники работают по одной схеме.

Нужный справочник выбирается номером в адресе:
/api/v1/lists/{id}/records/

Так API не приходится переписывать, когда владелец сайта заводит новый справочник. Появился новый раздел с данными — у него есть id, поля и записи. Внешний скрипт продолжает работать с теми же методами.

Что доступно по HTTP:
GET — список справочников, поля, записи и одна запись.
POST — создать запись.
PATCH или PUT — изменить только присланные поля.
DELETE — удалить запись.

Сами справочники и их поля через API не создаются и не удаляются. Это изменение схемы базы, поэтому оно остаётся в панели.

Минимальный старт такой:
завести ключ в Настройки → Ключи API;
узнать id справочника в панели или через GET /api/v1/lists/;
слать запросы с Authorization: Bearer <ключ>.

Важная мелочь: завершающий слеш обязателен. Без него сервер делает редирект. Для GET обычно без разницы, а PATCH и DELETE могут повториться как GET и без тела. В итоге запрос «прошёл», но запись не изменилась.

Если подключаете склад, 1С, мобильное приложение или свой скрипт выгрузки — начинайте с перечня справочников и их полей. Так интеграция не завязывается на названия в админке.

#Wacis #API #CMS #ВебРазработка