База знаний

Установка, работа с модами, тарифы, API. Решения типичных проблем.

🚀 Начало работы

Что такое K&S Mods?

⏱ 2 мин

K&S Mods — это библиотека из 210+ готовых модификаций (модов) для сайтов на Tilda.

Что мы делаем:

  • Расширяем возможности Tilda: добавляем функции которых нет в стандартных блоках
  • Меняем дизайн стандартных блоков (T658, CL46, GL11/20 и др.)
  • Создаём анимации, эффекты, hover-состояния
  • Добавляем e-com функции: счётчик остатков, fake-orders, кастомную корзину
  • Делаем micro-interactions: кнопка наверх, smooth-scroll, шум, glitch

Как это работает:
  1. Ставите наш Chrome-плагин K&S Mods
  2. Открываете свой Tilda-проект в редакторе
  3. Жмёте кнопку K&S в углу → выбираете мод → один клик
  4. Плагин автоматически вставляет нужный код в HEAD страницы
  5. Публикуете сайт — мод работает у всех посетителей

Чем мы отличаемся от Nolim:
  • На 35-50% дешевле
  • Моды живут на CDN, а не в плагине — работают у 100% посетителей сайта
  • 10 модов бесплатно навсегда
  • Российский продукт, ИП Степанижов

Первые шаги — за 5 минут

⏱ 5 мин

Шаг 1. Установите плагин

Откройте Chrome Web Store, найдите «K&S Mods — моды для Тильды» → установите.

Или скачайте ZIP с ksmods.ru/plugin/ и установите вручную через chrome://extensions/ → Developer mode → Load unpacked.

Шаг 2. Залогиньтесь

Клик на иконку плагина → введите email → получите OTP-код (для тестов: используйте dev OTP отображаемый в самом popup).

Шаг 3. Откройте свой Tilda-проект

Перейдите на tilda.cc/projects/?projectid=ВАШ_ID — плагин активируется автоматически.

Шаг 4. Подключите bundle

В popup плагина нажмите зелёную кнопку «Подключить bundle к проекту» — плагин автоматически вставит <script src="cdn.ksmods.ru/v1/bundle.min.js"></script> в HEAD проекта.

Шаг 5. Примените первый мод

Откройте любую страницу проекта → слева появится зелёная K&S кнопка → клик → откроется sidebar с 210 модами → выберите → Apply.

Шаг 6. Опубликуйте сайт

Кнопка «Опубликовать» в Tilda → ждать ~30 сек → мод работает на live.

📦 Установка плагина

Установка плагина в Chrome

⏱ 3 мин

Вариант A · Chrome Web Store (рекомендуется)

  1. Откройте chromewebstore.google.com
  2. Нажмите «Установить»
  3. Подтвердите permissions
  4. Закрепите иконку плагина в тулбаре (правый клик → Pin)

Вариант B · Manual install (для бета-тестеров)

  1. Скачайте ZIP: ksmods.ru/plugin/download/ksmods-chrome-v2.zip (~500 КБ)
  2. Распакуйте куда удобно (например ~/Downloads/ksmods-chrome-v2/)
  3. НЕ удаляйте папку — Chrome будет читать файлы оттуда
  4. Откройте chrome://extensions/
  5. Включите «Режим разработчика» (тумблер правый верхний)
  6. Жмите «Загрузить распакованное» → выберите папку
  7. Готово — иконка K&S появится в тулбаре

Поддерживаемые браузеры

  • ✅ Google Chrome (основной)
  • ✅ Microsoft Edge — работает (тот же ZIP)
  • ✅ Yandex Browser — работает
  • ✅ Opera — работает
  • ✅ Arc Browser — работает
  • ❌ Safari — НЕ работает (Apple использует другой стандарт расширений)
  • ❌ Firefox — НЕ работает (нужен отдельный билд под Manifest V2)

Permissions плагина — что мы используем

⏱ 2 мин

Наш плагин запрашивает 5 разрешений Chrome. Объясняем что зачем:

storage

Хранение JWT-токена авторизации и кэша списка модов в chrome.storage.local. Никаких данных не отправляется наружу.

activeTab

В popup-окне определяем URL текущей открытой вкладки — чтобы показать кнопку «Подключить bundle к этому проекту». Содержимое вкладки не читаем — только URL.

alarms

Фоновый service worker раз в час проверяет статус подписки (chrome.alarms.create с periodInMinutes: 60). Это нужно чтобы автоматически обновлять бейдж на иконке когда у вас истекает или возобновляется подписка.

clipboardRead

Когда плагин открывает редактор HEAD-кода Tilda — читает из буфера обмена JS-снипет K&S Mods (который сам же туда положил при Apply), и вставляет в текстовое поле автоматически.

clipboardWrite

Кнопка «Apply» в sidebar плагина и popup: при выборе мода генерируется JS-снипет и копируется в буфер. Это ключевой UX — «один клик, чтобы скопировать код мода».

host_permissions

  • https://tilda.cc/* https://tilda.ru/* — для работы в Tilda редакторе
  • https://*.tildacdn.com/* https://*.tilda.ws/* — для opt-in features на live-сайтах
  • https://ksmods.ru/* — для авторизации и проверки подписки
Что мы НЕ делаем:
  • Не читаем содержимое других сайтов
  • Не собираем personal data
  • Не имеем доступа к паролям, банковским картам, формам
  • Не подгружаем external код (всё в ZIP плагина)

⚡ Работа с модами

Как применить мод — пошагово

⏱ 3 мин

1. Откройте Tilda-страницу в редакторе

URL должен быть вида tilda.cc/page/?pageid=12345&projectid=67890

2. Откройте K&S Apply Sidebar

Слева на странице появится плавающая зелёная кнопка «K&S Mods» — клик → справа выезжает sidebar.

3. Найдите мод

  • Поиск по названию (например «hero» или «button»)
  • Фильтр FREE / PRO
  • Категории в верхней части

4. Кликните на мод

Откроется форма настройки:
  • Применить кbody (весь сайт) или Конкретный блок (по rec-ID)
  • Куда подключитьТолько эта страница (рекомендуется) или Весь проект (для глобальных модов типа smooth-scroll)
  • Параметры мода — цвет, текст, размер и т.п. (зависит от мода)

5. Нажмите Apply

Плагин автоматически:
  1. Генерирует JS-сниппет
  2. Копирует его в буфер
  3. Открывает HEAD-редактор Tilda для этой страницы
  4. Вставляет код в ACE-редактор
  5. Нажимает «Сохранить»
  6. Показывает toast «✓ Код добавлен»

6. Опубликуйте страницу

Закройте вкладку HEAD-редактора → вернитесь к странице → нажмите «Опубликовать» сверху справа → подождите 20-40 сек.

7. Проверьте результат

Откройте live URL вашего сайта — мод работает.

Совет: используйте preview

В v2.1+ плагин показывает мод сразу в редакторе (как у Nolim), не дожидаясь публикации. Если preview не нравится — можно изменить параметры и применить заново.

Per-page vs Global scope

⏱ 2 мин

Только эта страница (рекомендуется)

Код мода идёт в HEAD страницы (не проекта). Действует только когда юзер открыл именно эту страницу. На главной и других страницах — мода нет.

Используйте для:

  • Hero-секций (hero-marquee-title, hero-zoom, hero-split)
  • Каталога одной категории (5-tovarov-v-ryad)
  • Кастома кнопки или таймера на лендинге
  • Любой странице-специфичной логики

Весь проект (осторожно)


Код идёт в HEAD проекта. Применяется ко всем страницам сайта. Применяйте только для модов которые должны работать глобально.

Используйте для:

  • smooth-scroll — плавный скролл на всём сайте
  • up-button — кнопка наверх на каждой странице
  • noise-effect — общий шум-эффект
  • update-years — © 2026 в футере
  • color-browser — theme-color для мобильного Safari
  • bread-crumbs — крошки везде где есть структура

Что НЕ делать


  • ❌ Не применяйте hero-marquee-title глобально — поломает все hero-секции на сайте
  • ❌ Не применяйте fake-orders-notification глобально — может выводить уведомления в неподходящих местах
  • ❌ Не применяйте 5-tovarov-v-ryad глобально если каталоги разные

Совет


Если сомневаетесь — выбирайте «Только эта страница». Можно потом перенести в global если поймёте что нужно везде.

10 бесплатных модов навсегда

⏱ 1 мин

Без подписки (FREE-tier) доступны 10 ключевых модов:

  1. ks-up-button — кнопка «Наверх» при скролле
  2. ks-smooth-scroll — плавный скролл якорей
  3. ks-color-browser — theme-color для mobile Safari
  4. ks-update-years — © 2026 автоматом
  5. ks-noise-effect — зернистый шум поверх сайта
  6. ks-back-button — кнопка «Назад» в шапке
  7. ks-bread-crumbs — хлебные крошки из URL
  8. ks-share-goods — кнопка «Поделиться» на товаре
  9. ks-copytext — копирование промокода с toast
  10. ks-text-depending-time — приветствие по времени суток
Все остальные 200+ модов — по подписке PRO от 490 ₽/мес.

Триал — 100 ₽ / 3 дня

Если хотите попробовать все 210 модов — оформите триал. Не понравится — деньги не списываются автоматически.

💳 Тарифы и оплата

Тарифы и что входит

⏱ 2 мин

Free навсегда

  • ✅ 10 модов
  • ✅ Любое количество сайтов
  • ✅ Без регистрации
  • ❌ PRO-модов нет
  • ❌ AI-чата нет
  • ❌ Поддержки нет

PRO — месяц · 490 ₽

  • ✅ Все 210+ модов
  • ✅ Любое количество сайтов
  • ✅ AI-чат с 6 моделями (GPT-5, Claude Sonnet, Gemini, Qwen)
  • ✅ Шаблоны Tilda
  • ✅ Поддержка в Telegram
  • ✅ Ранний доступ к новым модам
  • ✅ Возврат денег в 14 дней без вопросов

PRO — год · 1490 ₽ (экономия 4390 ₽ / год)

Всё как в месячной + персональный Slack/TG-чат с командой K&S + приоритетная поддержка.

Триал · 100 ₽ / 3 дня

Доступ ко всему PRO на 72 часа. Без автопродления.

Сравнение с Nolim

NolimK&S Mods
---------
Месяц750 ₽490 ₽
Год2990 ₽1490 ₽
FREE моды010

Способы оплаты

Карта МИР / Visa / Mastercard через Robokassa. СБП. Юр.лицам — счёт с НДС от ИП Степанижов Е.Ю.

Как заморозить подписку

⏱ 1 мин

Если вам сейчас не нужны моды (отпуск, проект приостановлен) — можно заморозить подписку, не теряя денег.

Что происходит

  • Доступ к PRO-модам приостанавливается
  • Установленные моды продолжают работать на ваших сайтах (bundle.min.js на CDN)
  • Дни оставшейся подписки сохраняются на счёте
  • Когда возобновите — дни добавляются с того места где остановились

Как заморозить

  1. Зайдите на ksmods.ru/lk/ (войдите по email)
  2. В разделе «Подписка» жмите «Заморозить»
  3. Подтвердите
Плагин при следующем запуске синхронизируется и переключится в FREE-режим.

Как разморозить

То же место → «Возобновить». Доступ сразу же восстанавливается.

Ограничения

  • Замораживать можно не чаще 2 раз в месяц
  • Минимальный срок заморозки — 1 день, максимальный — 90 дней
  • Если 90 дней прошло — подписка автоматически возобновляется и дни тратятся

Возврат денег

⏱ 1 мин

Мы возвращаем деньги без вопросов в течение 14 дней с момента покупки.

Как запросить возврат

Напишите на hi@ksmods.ru с темой «Возврат» и укажите:
  • Email с которого оплачивали
  • Дату покупки
  • Тариф
Ответим в течение 24 часов. Деньги возвращаем на ту же карту в течение 3-7 рабочих дней (зависит от вашего банка).

Что не возвращаем

  • Если прошло больше 14 дней
  • Если вы уже выпустили клиенту коммерческий сайт с нашими модами и работа была оплачена клиентом

После возврата

  • Доступ PRO сразу отключается
  • Bundle на CDN продолжает работать, но новые моды применять не сможете
  • Можно вернуться к нам в любой момент — данные сохраняются

🤝 Партнёрка

Партнёрская программа

⏱ 2 мин

Приглашайте друзей-дизайнеров — получайте бонусные дни подписки.

Как работает

  1. В Личном кабинете у вас есть реферальная ссылка — например ksmods.ru?ref=a6ae062c
  2. Делитесь её — друзья переходят и регистрируются
  3. Когда друг оплачивает подписку — вам начисляется бонус

Сколько бонусных дней

  • Друг оплатил месяц (490 ₽) → вам +30 дней к подписке
  • Друг оплатил год (1490 ₽) → вам +60 дней
  • Друг купил триал (100 ₽) → бонусов нет, но он засчитывается как привлечённый

Без лимитов

Количество рефералов не ограничено. Если приведёте 20 друзей в год — получите 1.5-3 года бесплатной подписки.

Как отследить рефералов

В Личном кабинете → Партнёрка видно:
  • Кто перешёл по ссылке
  • Кто из них оплатил
  • Сколько бонусных дней начислено
  • Текущий рейтинг среди партнёров

Топ-партнёры

Каждый месяц определяем топ-3 партнёра — даём дополнительные +90 дней в подарок к подписке.

🛠 Решение проблем

Мод не работает — что делать

⏱ 3 мин

Чек-лист

1. Bundle подключён?

Откройте свой сайт → DevTools (F12) → Console → введите:
fetch('https://cdn.ksmods.ru/v1/bundle.min.js').then(r => console.log('OK:', r.status))
Должно ответить OK: 200. Если нет — подключите bundle через popup плагина «Подключить bundle к проекту».

2. CSS-класс на body?

DevTools → Elements → <body> → ищем class="... ks-XXX ...". Если нет — мод не активировался.

3. ksMods runtime запустился?

Console:
window.ksMods
Должно быть Object с methods register, activate. Если undefined — bundle не загрузился.

4. Не блокирует ли AdBlock?

Если установлен uBlock / AdGuard — он может блокировать загрузку bundle. Добавьте cdn.ksmods.ru в whitelist.

5. Не Tilda-блок ли мешает?

Некоторые моды (5-tovarov-v-ryad, custom-cart) переопределяют стандартные Tilda CSS-классы через !important. Если у вас в HEAD проекта есть собственные CSS-overrides — они могут перебивать наши.

6. На какой странице мод применён?

Если вы выбрали Только эта страница — мод работает только там. Проверьте URL.

7. Сайт опубликован?

Сохранения HEAD недостаточно — нужно Опубликовать (или «Опубликовать все страницы» для project-scope). Tilda кэширует страницы.

Если ничего не помогло

Напишите @ksmods_support в Telegram — указывайте:
  • Какой мод не работает
  • URL вашего сайта
  • Скриншот body class из DevTools
  • Скриншот Console (если есть ошибки)
Отвечаем обычно в течение 1-2 часов в рабочие дни.

Плагин не отображается в Tilda

⏱ 2 мин

Проверки

1. Иконка плагина видна?

В правом верхнем углу Chrome рядом с адресной строкой должна быть зелёная иконка K&S. Если нет — кликните на пазл 🧩 и Pin плагин.

2. URL правильный?

Плагин активируется только на:
  • tilda.cc/projects/?projectid=... (список страниц)
  • tilda.cc/page/?pageid=...&projectid=... (редактор страницы)
  • tilda.ru/projects/... tilda.ru/page/... (старый домен)
Если вы на tilda.cc/admin/ или tilda.cc/identity/ — плагин не активируется (нет нужного content script).

3. Залогинены в плагине?

Клик на иконку → должен показаться popup со статусом подписки. Если показывает форму login — введите email и OTP.

4. Reload плагина

chrome://extensions/ → у K&S Mods нажмите ↻ (Reload) → обновите страницу Tilda.

5. Конфликт с другим расширением?

Nolim может конфликтовать с K&S Mods (оба inject в Tilda редактор). Временно отключите Nolim и проверьте.

6. Включён режим инкогнито?

Плагины по умолчанию не работают в инкогнито. Включите вручную: chrome://extensions/ → K&S Mods → Details → «Разрешить в инкогнито».

🔧 Для разработчиков

К&S API endpoints

⏱ 3 мин

Базовый URL

https://ksmods.ru/api/

Auth

Все защищённые endpoints требуют JWT-токен в header:
Authorization: Bearer <JWT>
JWT выдаётся после успешного OTP-логина.

Endpoints

POST /api/auth/start

Запросить OTP-код на email. Body: {email: 'user@example.com'} Response: {ok: true, sent: false, devOtp: '123456'} (в dev-моде OTP в ответе, в prod — на почту)

POST /api/auth/verify

Подтвердить OTP и получить JWT. Body: {email: '...', code: '123456'} Response: {ok: true, token: '<JWT>', user: {...}, subscription: {...}}

GET /api/me

Текущий юзер + статус подписки. Response: {user: {userId, email, refCode}, subscription: {plan, expDate, daysLeft, status}}

GET /api/me/payments

История оплат. Response: {payments: [{ts, event, plan, invId}, ...]}

POST /api/me/freeze

Заморозить подписку.

POST /api/me/unfreeze

Разморозить.

POST /api/pay/start

Запросить URL оплаты Robokassa. Body: {plan: 'month'|'year'|'trial', email: '...'} Response: {url: 'https://auth.robokassa.ru/...', invId: '...'}

POST /api/chat/completions

AI-чат (только PRO). Body: {model: 'claude-haiku'|'gpt-5-mini'|..., messages: [{role, content}], stream: true} Response: SSE stream совместимый с OpenAI API.

GET /api/ref/stats?code=XXXX

Статистика по реферальному коду. Response: {signups: N, paid: M, bonusDays: K}

Rate Limits

  • Auth endpoints: 5 / минуту с одного IP
  • Chat completions: 100 / минуту для PRO юзеров
  • Прочее: 60 / минуту

Подключение bundle вручную

⏱ 2 мин

Если не хотите ставить плагин — можно подключить bundle прямо в HEAD сайта руками.

1. В Tilda HEAD проекта

<!-- K&S Mods · runtime -->
<script src="https://cdn.ksmods.ru/v1/bundle.min.js"></script>

2. Активация модов через body class

<script>
document.addEventListener('DOMContentLoaded', function(){
  document.body.classList.add(
    'ks-smooth-scroll',
    'ks-up-button',
    'ks-noise-effect',
    'ks-update-years',
    'ks-color-browser'
  );
  // Опции через setAttribute:
  document.body.setAttribute('ks-up-button-color', '#42FF00');
  document.body.setAttribute('ks-noise-effect-opacity', '0.05');
});
</script>

3. Активация на отдельных элементах

Для модов которые работают не на body, а на конкретных блоках (как hero-marquee-title):
<section class="ks-hero-marquee-title" data-ks-hero-marquee-title-text="SS26 COLLECTION"></section>

4. Активация через JS (для динамических элементов)

window.ksMods.activate('hero-marquee-title', {
  selector: '#rec123456',
  text: 'SS26 COLLECTION',
  color: '#42FF00'
});

Когда удобно вручную

  • Если делаете не Tilda-сайт (просто HTML/Webflow/etc)
  • Если нужен полный контроль над активацией
  • Если у вас уже большой HEAD-код и хотите всё в одном месте
  • Если делаете сайт без плагина в браузере дизайнера

Лимиты

Bundle весит 185 КБ (gzip 40 КБ). Загружается один раз и кэшируется CDN.