Справочник темы

Разделы

• Admin Panel — Gutenberg переключатель, админ-бар, виджеты дашборда
• Security — XML-RPC, REST API, скрытие версии, URL входа
• Extensions — Обработчик форм, SMTP, Telegram, reCAPTCHA
• WooCommerce — Настройки WooCommerce
• Theme Settings — Бэкенд полей (SCF/ACF), инструменты миграции
• Search — Настройки страницы поиска

Из PHP-шаблона (Query Presets)

Создайте пресет в под-вкладке Post/Term Query Presets, задайте Query Code и вызывайте его в коде шаблона:

• Posts: $q = new WP_Query(tf_get_query('your-code'));
• Terms: $terms = tf_get_term_query('your-code');
• Auto-apply: привяжите пресет к архиву типа записи или таксономии на вкладке «Auto-apply», и он автоматически переопределит основной запрос (через pre_get_posts) — без правки шаблона.

Через HTML-атрибуты (Custom Queries)

Назовите запрос в под-вкладке Custom Queries / Term Queries, затем сошлитесь на него на элементе-цикле — или впишите аргументы прямо в атрибут. Шаблоном повторения служит только первый дочерний элемент.

• По имени: <div wp-select="catalog"> … </div> (псевдоним: wp-query-name)
• Инлайн: <div wp-query="'post_type'=>'product','posts_per_page'=>8">
• Список термов: <div wp-term-query="'taxonomy'=>'product_cat','parent'=>0"> · wp-term-select="name"
• WooCommerce: <div wp-product-query="get_related_products(4)">

Внутри цикла — поля

На элементах внутри цикла выводите значения через атрибуты WordPress или атрибуты полей ACF/SCF:

• WordPress: wp="post-title", wp="post-image", wp="post-link", wp="term-title", wp="term-link"
• ACF / SCF: fld-text, fld-image, fld-link, fld-loop (альтернативный формат: f_text, f_image, f_loop)

Совместимость

Рантайм читает три источника по приоритету: пресеты TF, затем Query Master (старые импортированные сайты), затем запросы устаревшего конфигуратора. Новые пресеты всегда сохраняются в хранилище TF; существующие данные продолжают работать.

Произвольные типы записей

Каждая строка соответствует register_post_type(). Поле «Name» — это ключ типа записи (строчные латинские буквы, без пробелов). Задайте множественное/единственное/меню-название, иконку Dashicons, поддерживаемые возможности (заголовок, редактор, миниатюра, …), URL-слаг архива, REST/Gutenberg, публичную доступность, тумблер «Публичный архив» (выключите ленту /slug/ для служебных типов) — и необязательную «Страницу разводящей», которая делает архив редактируемым (см. раздел «Разводящие страницы архивов» ниже).

Произвольные таксономии

Каждая строка соответствует register_taxonomy(). Выберите «Иерархическая» (как категории) или «Плоская» (как метки), свяжите с одним или несколькими типами записей и задайте слаг и видимость в REST.

Как они связаны

Новые типы записей и таксономии автоматически появляются в выпадающих списках пресетов запросов. Постоянные ссылки обновляются при сохранении. Шаблоны следуют соглашениям WordPress: single-{type}.php, archive-{type}.php, taxonomy-{taxonomy}.php.

Как это работает

На архивной странице вашего Webflow-проекта (archive-post, archive-product, archive-{type}) разместите атрибуты полей ВНЕ цикла списка — то есть вне элемента с меткой wp="posts" / wp="products". Такие поля автоматически прикрепляются к разводящей странице в админке и выводятся с неё на URL архива.

• Вне цикла работает любое одиночное поле: fld-text, fld-image, fld-link, fld-bg-image, fld-editor и остальное семейство fld-*, а также wp="post-title" и wp="post-content" — они печатают заголовок и содержимое самой разводящей страницы.
• Поля ВНУТРИ цикла сохраняют обычный смысл: они читают каждую выводимую запись, как и раньше.
• На мультиязычных сайтах разводящая страница определяется для каждого языка автоматически (Polylang / WPML): каждая локаль редактирует свой перевод разводящей.
• SEO: для архивов произвольных типов записей разводящая страница также питает Yoast — архив получает её SEO-заголовок и корректный canonical, включая страницы пагинации.

Блог

Разводящая блога — это родная «Страница записей» WordPress. Создайте страницу (например /blog/), назначьте её в Настройки → Чтение, и поля, размещённые вне цикла на шаблоне archive-post, прикрепятся к этой странице — дополнительной настройки не нужно.

Каталог WooCommerce

Каталог магазина использует страницу «Магазин» WooCommerce как разводящую. Поля вне цикла товаров на шаблоне archive-product прикрепляются к странице магазина и выводятся на URL каталога.

Произвольные типы записей

У архива произвольного типа записей в WordPress нет родной разводящей, поэтому её добавляет ThemeForge: создайте страницу, URL которой совпадает со слагом архива (например /portfolio/ для типа со слагом архива «portfolio»), затем выберите её в строке этого типа в панели темы. URL архива продолжает выводить шаблон ленты, а выбранная страница несёт его редактируемые поля. Если архивный шаблон вашего Webflow-проекта объявляет группу полей, ThemeForge создаёт (или усыновляет) разводящую автоматически — на всех языках сайта, так же как WooCommerce создаёт свою страницу «Магазин».

Привязанная страница ВЛАДЕЕТ URL архива: переименуйте страницу — и архив переедет вместе с ней (поле слага скрывается, пока страница привязана). Без привязанной страницы слаг берётся из панели темы. Сама страница напрямую никогда не показывается — она поверхность редактирования позади архива.

Полезно знать

• Групповые поля вне цикла (повторитель, группа, flexible content, галерея) читаются с разводящей так же, как одиночные. Единственное исключение — группа с loop-mode="0": вкладка «Логи» проекта помечает её как «archive-scope-unsupported».
• Поле, размещённое ВНУТРИ цикла списка, принадлежит выводимым записям — объявите его на соответствующем шаблоне single-{type}, чтобы оно появилось на экранах редактирования этих записей.
• Если разводящая не настроена, ничего не ломается: архив выводится ровно как раньше. Добавить разводящую можно в любой момент без перегенерации темы.

Возможности

• SMTP отправка email (по умолчанию: smtp.gmail.com:465/SSL)
• reCAPTCHA v3 / v2
• Telegram уведомления
• Защита от спама без ключей — включена на новых сайтах
• Автоответ отправителю формы
• JustValidate клиентская валидация
• CPT tf_form_entry — хранение заявок в WordPress
• CSV экспорт

Защита от спама

Работает без ключей и внешних сервисов. На новом сайте включена сразу; на сайте, который уже принимает заявки, включается переключателем «Базовая защита от спама» в «Формы → Настройки».

• Отсеивает заявки, в которых заполнено скрытое поле-ловушка, отправленные без скрипта страницы или быстрее, чем человек успевает набрать текст, с несколькими ссылками или в обход картинки-капчи. Частота отправки с одного адреса ограничена.
• Отсеянные заявки никуда не отправляются: 30 дней они лежат в папке «Спам» раздела «Записи». Ошибочно отсеянную можно вернуть действием «Не спам».
• Собственные формы WordPress защищает отдельный переключатель «Защита от спама для форм WordPress», включённый по умолчанию: комментарии и отзывы о товарах, регистрация и сброс пароля. Комментарий, который бот отправил, не открывая страницу, отклоняется и никуда не сохраняется; пограничный попадает в «Комментарии → Спам»; подозрительная регистрация или запрос сброса отклоняется с просьбой повторить. Форма входа и вошедшие пользователи не проверяются.
• Картинка-капча говорит на языке страницы: тексты задаются для каждого языка, а символы — те, что посетитель наберёт без переключения раскладки (украинские буквы, русские, латиница или цифры).

От ботов, которые целенаправленно имитируют человека, защищает reCAPTCHA с ключами Google — её можно включить в тех же настройках.

wp-field — ключ поля, переживающий переименование

По умолчанию поле формы уезжает под подписью, набранной в Webflow. Переименуете подпись позже — шаблон письма и карта передачи, которые на неё ссылались, перестанут совпадать, причём молча: заявка всё равно приходит. Разметьте поле (или его обёртку с подписью) — и ключ перестанет зависеть от подписи.

<input type="tel" wp-field="phone">

<div class="row" wp-field="phone">
  <label for="tel">Телефон</label>
  <input type="tel" id="tel">
</div>

Ключ проставляется в поле при генерации темы, поэтому настраивать потом ничего не нужно. Используйте латиницу, цифры, _ и -; имена, занятые конвейером форм, не принимаются и попадают в журнал проекта. Поля, имя которых задано WordPress или WooCommerce — комментарии, отзывы, оформление заказа — размечаются своими метками.

Два движка, один формат данных

По умолчанию — Secure Custom Fields: бесплатный плагин с WordPress.org, который сам обновляется и даёт все типы полей ACF PRO без лицензии. Хотите свой лицензированный ACF PRO? Установите его — тема определит его автоматически.

Как это работает

Тема автоматически определяет Polylang или WPML и загружает соответствующую интеграцию.

• Автоопределение: Polylang (pll_current_language) или WPML (ICL_SITEPRESS_VERSION)
• Хранение по локалям: каждый язык получает свой набор значений опций
• Фоллбэк: пустые поля локали наследуют значения из «Все (по умолчанию)»
• Пользовательские флаги: загрузка собственных флагов языков из Медиатеки

Управление опциями по языкам

Используйте переключатель языков на странице опций для редактирования значений каждого языка.

Автоперевод полей

Встроенный машинный перевод значений полей. Доступен в сайдбаре на страницах редактирования записей и опций.

• Кнопка «Перевести» у каждого текстового поля
• «Перевести всё» в сайдбаре — переводит все поля разом, включая скрытые вкладки и повторители
• Поля-ссылки пропускаются автоматически (определение по имени поля и паттерну URL)
• API-ключ не требуется — используется бесплатный Google Translate
• Поддержка WYSIWYG (визуальный редактор) — HTML-структура сохраняется

• user-functions.php — Пользовательские PHP функции
• css/user.css — Пользовательские CSS стили
• js/user.js — Пользовательский JavaScript

Порядок загрузки CSS: main.css → themeforge.css → user.css. Используйте user.css для переопределения стилей темы.

Действия импорта

Источник названия страницы

При создании WordPress-страниц во время импорта название берётся из исходного HTML в порядке приоритета:

1. <meta property="og:title"> — Open Graph
2. <title> — HTML title tag
3. Имя шаблона (например, «About» из page-about)

Разрешение имён изображений

Система импорта находит WordPress attachment ID по имени файла через цепочку fallback:

• URL-декодирование (обработка кириллицы: %D0%94%D0%B5... → Десерт...)
• Удаление 24-hex Webflow хеш-префикса (695a454c..._ → исходное имя)
• sanitize_file_name() + DB LIKE запрос для надёжного поиска

Импорт с учётом локали

Добавьте &lang=xx для импорта данных в конкретный язык. Метабокс импорта на странице редактирования автоматически определяет язык страницы.

Использование

• Оборачивает поля в именованную группу (метабокс в админке)
• Несколько wp-fields-group групп на странице поддерживаются
• На странице theme-options: все группы объединяются в один контейнер опций
• Без wp-fields-group: поля генерируют только PHP (без UI в админке)

Использование

• Ставится на тег <body> — по умолчанию редактор скрыт на шаблонах страниц с полями
• Используйте вместе с wp-fields-group, когда странице нужны и кастомные поля, и the_content()
• Не влияет на шаблоны записей (single, single-product) — у них редактор всегда виден

wp-menu

Простой рендеринг меню. Извлекает классы ссылок/дропдаунов из HTML-структуры Webflow. Выводит Webflow-совместимую разметку.

wp-menu-tree

Рекурсивное меню с кастомным шаблоном. Первый дочерний элемент = шаблон для каждого пункта. Поддерживает неограниченную вложенность.

wp-menu-tpl

Явные маркеры шаблонов внутри wp-menu-tree. "link" = простые пункты, "drop" = выпадающие с дочерними. Генерирует if/else по menu_children.

Одни и те же поля и данные

Переключение движка никогда не мигрирует и не переписывает контент — оба движка читают одни и те же ключи полей из wp_postmeta / wp_options. Существующие данные ACF из другой темы или ручной настройки подхватываются по имени поля, независимо от того, какой движок их создал.

Существующие и сторонние данные ACF

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

Общие хуки

WooCommerce-хуки

Определите эти функции в custom.js. Устаревшие имена с префиксом wfp_ также поддерживаются для обратной совместимости.

Запрос записей

Настраивается в Панель темы → Custom Queries. Каждый запрос содержит: имя, тип записи, количество на странице, пагинацию, фильтры таксономий.

Запрос терминов

Настраивается в Панель темы → Custom Term Queries. Каждый запрос содержит: имя, таксономию, hide_empty, orderby, order.

Общие

WooCommerce