YITH Donations - Плагин WordPress

Руководство по настройке YITH Donations для WooCommerce-сайта

YITH Donations стоит рассматривать не как отдельную форму пожертвований, а как способ встроить донаты в уже работающий магазин WooCommerce. В этом руководстве разберём, как подготовить сайт, где включать форму, как связать пожертвование с товаром, когда делать донат обязательным, как проверить заказ и какие ошибки чаще всего мешают пользователю завершить оплату.

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

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

Какую задачу решает плагин и где он особенно полезен

Главная идея YITH Donations - принимать сумму, которую пользователь выбирает сам или выбирает из заранее предложенных вариантов, и проводить её через привычный процесс WooCommerce. В отличие от отдельной кнопки оплаты, донат становится частью магазинной логики: он попадает в корзину, проходит через доступные платежные методы, отображается в заказе и может быть связан с конкретным товаром.

Такой подход удобен, когда сайт уже живёт на WooCommerce. Например, магазин продаёт цифровые материалы и хочет дать покупателям возможность поддержать автора; некоммерческий проект раздаёт бесплатные товары, но просит добровольный взнос; организатор мероприятия продаёт билеты и предлагает добавить пожертвование в пользу партнёрской инициативы. В этих сценариях не нужно строить отдельную платформу сбора средств, если хватает простого донатного потока внутри магазина.

Сценарии, в которых YITH Donations выглядит естественно

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

Отдельный сценарий - обязательный донат для выбранного товара. Документация YITH описывает режим, при котором товар нельзя добавить в корзину без связанного пожертвования, а удаление обязательной донатной позиции из корзины удаляет и связанный товар. Такой режим нужен редко, но он полезен для "плати сколько считаешь нужным" вокруг бесплатного продукта или для товара, где взнос является частью условия участия.

Когда лучше выбрать другой тип решения

Если проекту нужна полноценная фандрайзинговая система с отдельными кампаниями, донорскими кабинетами, сложной отчётностью, целями сборов, регулярными платежами без дополнительной интеграции или публичной стеной доноров, YITH Donations может оказаться слишком узким. Он силён именно там, где донат связан с WooCommerce-покупкой или простой формой. Для крупной НКО с несколькими программами, отчётами и сегментацией доноров стоит сравнить его с решениями из раздела альтернатив.

Практическое правило: если у вас уже есть WooCommerce и донат должен идти через корзину или товар, начинайте с YITH Donations. Если пожертвования являются главным продуктом сайта, а магазин не нужен, сначала сравните специализированные donation-платформы для WordPress.

Что проверить перед установкой на рабочий сайт

Перед включением донатной формы важно проверить не только совместимость плагина, но и весь путь пользователя. Донат проходит через корзину, заказ, платежный метод и письма, поэтому слабое место может находиться не в YITH Donations, а в WooCommerce, теме или платёжном модуле.

Базовая готовность WooCommerce

Проверьте, что WooCommerce установлен, активен и уже умеет создавать обычные заказы. Если магазин ещё не настроен, сначала закончите базовые разделы: валюта, страницы корзины и оформления заказа, налоговые правила, платежные методы, письма магазина. YITH Donations добавляет донатную механику поверх этой базы, но не заменяет её.

• Проверьте, открываются ли страницы Cart и Checkout без ошибок.
• Сделайте обычный тестовый заказ без доната, чтобы убедиться, что платежный метод работает.
• Проверьте письма WooCommerce: администратор должен видеть уведомление, а покупатель - подтверждение заказа.
• Убедитесь, что на сайте нет агрессивного кеширования страниц корзины и оформления заказа.

Отдельный донатный товар и налоги

В официальном FAQ YITH указано, что плагин создаёт специальный продукт для пожертвования. Это важно для налогов и отчётности: если пожертвование не должно облагаться налогом, нужно проверить налоговый статус именно этого продукта, а не только глобальные настройки магазина. В разных юрисдикциях правила отличаются, поэтому здесь нельзя давать универсальный юридический совет. Но техническая проверка проста: откройте созданный продукт в WooCommerce и посмотрите его налоговый статус, класс налога и видимость.

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

Проверка темы, блоковой корзины и кеша

Старые обсуждения на WordPress.org показывают типичные вопросы вокруг корзины: донат не отображается, добавляется дважды, сумма сбрасывается, форма ведёт себя странно после удаления позиции. Часть таких симптомов может быть связана с темой, AJAX-корзиной, мини-корзиной, кешем или устаревшим шаблоном WooCommerce. Поэтому перед запуском стоит проверить форму на стандартной теме или на тестовой копии сайта.

Не начинайте с правки кода. Сначала отключите кеш для корзины и оформления заказа, проверьте стандартный checkout без ускорителей, затем включайте остальные оптимизации по одной. Такой порядок быстрее покажет, где конфликт.

Установка и первая проверка после активации

Установка выполняется стандартным способом для WordPress-плагина: через загрузку ZIP-архива в Plugins или через другой штатный механизм, который используется на вашем сайте. После активации не спешите сразу включать все точки показа формы. Сначала убедитесь, что плагин появился в админ-панели, создал нужные настройки и не сломал обычную корзину.

Первый безопасный запуск

1. Откройте админ-панель WordPress и перейдите в раздел установленных плагинов.
2. Активируйте YITH Donations и проверьте, что WooCommerce остаётся активным.
3. Найдите настройки плагина в панели YITH или в разделе, где на вашем сайте сгруппированы YITH-плагины.
4. Не включайте обязательные донаты на товарах до того, как проверите обычный добровольный сценарий.
5. Создайте тестовый заказ с небольшим донатом и убедитесь, что заказ появился в WooCommerce - Orders.

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

Минимальный набор проверок после активации

Основные настройки: сумма, стиль формы и платежные методы

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

Предустановленные суммы или свободный ввод

Плагин позволяет задать предустановленные суммы через разделитель |. Например, набор 10|20|30 показывает несколько быстрых вариантов. Если поле оставить пустым, пользователь сможет ввести произвольную сумму. Выбор зависит от сценария.

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

Как подобрать минимальную и максимальную сумму

Минимум защищает форму от случайного нулевого или слишком маленького значения, максимум - от ошибочного ввода. Не ставьте максимальную сумму слишком низкой, если у вас есть крупные доноры, но и не оставляйте её бездумно высокой на тестовом сайте. После изменения диапазона обязательно проверьте две границы: сумму ниже минимума и сумму выше максимума. Пользователь должен получить понятную реакцию, а корзина не должна принимать некорректное значение.

Стиль предустановленных сумм

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

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

Платежные методы для заказов с донатом

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

Не отключайте платежные методы наугад. Сначала сделайте тестовый заказ с каждым методом, который хотите оставить. Если после добавления доната метод исчезает, проверьте не только YITH Donations, но и ограничения самого платежного плагина, валюту, страну покупателя, минимальную сумму и настройки доставки. В WooCommerce подобные условия часто пересекаются.

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

Донат на странице товара: добровольный взнос или обязательное условие

Один из самых продуктовых сценариев YITH Donations - связать форму пожертвования с конкретными товарами. В документации это делается через вкладку Products & Donations: администратор добавляет товары в список, после чего форма может появляться на странице выбранного товара.

Когда форма на товаре уместнее формы в корзине

Форма на странице товара работает лучше, когда причина пожертвования связана именно с этим товаром. Например, вы отдаёте электронную книгу бесплатно, но просите поддержать автора; продаёте мерч для благотворительной акции; предлагаете билет на событие, где часть поддержки идёт на отдельную инициативу. Пользователь видит контекст до добавления товара в корзину и понимает, почему его просят указать сумму.

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

Обязательная донатная связка

Опция обязательного пожертвования делает донат условием покупки или загрузки связанного товара. Документация уточняет важный нюанс: если обязательный донат удалить из корзины, связанный товар тоже удаляется, потому что позиции связаны. Это поведение нужно заранее объяснить команде поддержки и проверить в тестовой корзине.

Обязательный режим не стоит включать для обычных товаров без сильной причины. Он меняет привычную логику магазина: пользователь ожидает добавить товар, а получает требование выбрать сумму. Если текст на странице товара слабый, это выглядит как ошибка или скрытая доплата. Используйте этот режим только там, где донат действительно является частью сценария.

Как безопасно протестировать обязательный режим

1. Выберите один тестовый товар, который не участвует в рекламных кампаниях и не получает много трафика.
2. Добавьте его в список товаров с донатом и включите обязательность.
3. Проверьте сумму ниже минимума, корректную сумму и удаление доната из корзины.
4. Оформите тестовый заказ и проверьте, как позиции отображаются в заказе и письме.
5. Отключите обязательность, если пользователи могут воспринять её как неожиданную плату.

Форма в корзине, виджет и шорткод: где лучше просить поддержку

YITH Donations даёт несколько точек вывода формы: корзина, товар, виджет и шорткод. Это не просто разные способы вставки. Каждая точка отвечает за свой момент решения пользователя.

Форма в корзине

Корзина подходит для короткого добровольного взноса. Пользователь уже выбрал товары, видит итог и может добавить небольшую сумму как поддержку проекта. Здесь не стоит размещать длинные тексты, сложные поля или несколько конкурирующих призывов. Чем короче форма, тем меньше риск, что она отвлечёт от оформления заказа.

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

Виджет для боковых областей и служебных страниц

Виджет YITH Donations for WooCommerce полезен на страницах, где нет конкретного товара, но есть смысл попросить поддержку. Например, страница "О проекте", блог, документация, страница бесплатных материалов. В таких местах пользователь не находится в покупательском режиме, поэтому лучше дать чуть больше контекста: на что пойдут средства, какие суммы предложены и что произойдёт после отправки формы.

Шорткод для контентной страницы

Документация указывает шорткод [yith_wcds_donations] и его параметры: donation_amount, donation_amount_style, show_extra_desc, extra_desc_label. Это самый гибкий способ собрать отдельную страницу поддержки без отдельного конструктора форм.

Пример шорткода для страницы поддержки проекта:

[yith_wcds_donations donation_amount="10|20|30" donation_amount_style="radio" show_extra_desc="on" extra_desc_label="Tell us more about why you are donating, we are so grateful!"]

В русскоязычном контенте английский текст поля лучше заменить через настройки labels, локализацию или корректный параметр, если он подходит вашему сценарию. Не переводите настоящий системный label в коде наугад, если не проверили, где именно он выводится.

Безопасное оформление блока со шорткодом

Если нужно визуально отделить форму на странице, не правьте файлы плагина. Создайте блок-группу в редакторе WordPress, добавьте ей CSS-класс donation-box и поместите внутрь шорткод. Затем добавьте небольшой CSS в дочернюю тему или в штатное поле дополнительных стилей темы:

.donation-box {
  padding: 24px;
  border: 1px solid #e4e7ec;
  border-radius: 10px;
  background: #f8fafc;
}

.donation-box .button,
.donation-box button {
  min-height: 44px;
}

Этот фрагмент не зависит от внутренних классов YITH Donations: он оформляет вашу внешнюю обёртку и базовые кнопки внутри неё. Проверка простая - обновите страницу, убедитесь, что отступы и кнопка стали удобнее, затем временно удалите класс donation-box или CSS, если результат не подошёл.

Тексты, письма и локализация: как не потерять доверие донора

Для пожертвований текст важнее, чем для обычной товарной опции. Пользователь должен понимать, что он добавляет, почему сумма появляется в корзине и какое письмо получит после заказа. YITH Donations поддерживает настройку текстовых labels и письма пользователю, сделавшему пожертвование. На официальной странице также указана совместимость с WPML и Loco Translate.

Какие тексты стоит проверить первыми

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

• Кнопка должна говорить действие, а не просто повторять название функции.
• Подпись поля причины нужна только там, где вы действительно читаете и используете эти ответы.
• Текст ошибки должен объяснять, какую сумму можно указать.
• Письмо благодарности должно отличаться от обычного письма о покупке, если пожертвование имеет отдельный смысл.

Письмо благодарности и шаблоны WooCommerce

YITH указывает, что содержимое письма для пользователей, сделавших пожертвование, можно редактировать. Также заявлена интеграция с YITH WooCommerce Email Templates, которая позволяет глубже настроить внешний вид писем, если этот дополнительный продукт установлен. В базовом сценарии достаточно проверить текст и доставляемость письма. В брендированном магазине можно подключить шаблоны, но не начинайте с этого, пока не убедитесь, что сам донат корректно попадает в заказ.

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

Практический пример: сбор поддержки для бесплатного цифрового продукта

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

Цель

Нужно получить страницу товара, где пользователь видит бесплатный материал и может добавить пожертвование в размере одной из предложенных сумм. Донат не должен быть неожиданной доплатой, а заказ должен корректно пройти через WooCommerce.

Подготовка

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

Шаги настройки

1. В общих настройках задайте предустановленные суммы, например 5|10|20, и выберите понятный стиль отображения.
2. Установите минимальную сумму, если не хотите принимать пустой или символический ввод.
3. Откройте вкладку Products & Donations и добавьте бесплатный цифровой товар в список.
4. Оставьте пожертвование добровольным, если материал должен быть доступен без оплаты.
5. Отредактируйте текст рядом с формой: объясните, что поддержка помогает развивать бесплатные материалы.
6. Сделайте тестовую покупку: один раз без доната, один раз с донатом.

Ожидаемый результат и проверка

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

Нюанс, который часто забывают

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

Как проверять результат после настройки

Проверка результата должна идти по всему пользовательскому пути, а не только по внешнему виду формы. Донатная форма может выглядеть правильно, но сумма не попасть в заказ, письмо может не объяснить смысл пожертвования, а платежный метод может исчезнуть на checkout.

Путь проверки для администратора

1. Откройте страницу товара или страницу со шорткодом в режиме обычного посетителя.
2. Выберите предустановленную сумму и добавьте донат.
3. Повторите тест со свободной суммой, если она разрешена.
4. Перейдите в корзину и проверьте название позиции, сумму, налоги и удаление позиции.
5. Оформите заказ через тестовый или безопасный метод оплаты.
6. Откройте заказ в админ-панели и проверьте состав позиций.
7. Проверьте письмо покупателя и письмо администратора.

Что смотреть в заказе WooCommerce

В заказе важны четыре вещи: сумма пожертвования, название позиции, налоговый статус и связь с основным товаром, если донат обязательный. Если у вас есть бухгалтерская или CRM-интеграция, проверьте, как она получает донатную позицию. Некоторые интеграции смотрят только на товары, некоторые - на итог заказа, некоторые - на метаданные позиции. Лучше узнать это на тестовом заказе, чем после реального сбора.

Практичные идеи применения на разных типах сайтов

YITH Donations не обязан использоваться только классической благотворительной организацией. Его сила в том, что он встраивает поддержку в WooCommerce-сценарий. Ниже - идеи, которые опираются на подтверждённые функции плагина: форма на товаре, форма в корзине, шорткод, виджет, предустановленные суммы, дополнительное поле и обязательная связка с товаром.

Магазин цифровых материалов

Для бесплатных шаблонов, PDF, уроков или архивов можно добавить добровольную форму на странице товара. Пользователь получает материал без давления, но видит понятный способ поддержать автора. Быстрая проверка - сравнить заказы с донатом и без доната, чтобы убедиться, что доступ к файлу не зависит от добровольного взноса, если вы этого не планировали.

Благотворительный магазин с мерчем

Если магазин продаёт товары и параллельно собирает средства, форма в корзине работает как аккуратный дополнительный шаг. Здесь важна короткая формулировка: "Добавьте поддержку к заказу" и 2-3 предустановленные суммы. Не перегружайте корзину длинной историей кампании, лучше дайте ссылку на отдельную страницу с отчётом.

Сообщество или образовательный проект

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

Товар с условием участия

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

Ограничения, совместимость и спорные настройки

Любой плагин, который вмешивается в корзину и заказ, нужно оценивать осторожно. Официальная страница YITH указывает совместимость с рядом популярных тем, WPML, Loco Translate, Aelia Currency Switcher и некоторыми YITH-интеграциями, но это не означает автоматическую совместимость с каждым кастомным checkout, кешем и платёжным модулем.

Кеш и оптимизация

Корзина и оформление заказа должны оставаться динамическими. Если кеширующий плагин сохраняет HTML корзины или блокирует AJAX-обновления, сумма пожертвования может отображаться некорректно. Начинайте диагностику с исключения страниц корзины, оформления заказа и аккаунта из полного кеша. Затем проверьте мини-корзину, если тема выводит её в шапке.

Блоковая корзина и классические шаблоны

На современных WooCommerce-сайтах корзина и оформление заказа могут быть собраны через блоки или через классические шаблоны темы. Если форма не появляется там, где вы ожидаете, сначала проверьте, какой тип корзины используется. Некоторые расширения лучше работают с классическими hooks, другие уже поддерживают блоковые области. Для YITH Donations важно проверять фактический вывод на вашем сайте, а не только наличие настройки.

Регулярные пожертвования

Официальная интеграция с YITH WooCommerce Subscription позволяет превратить продукт, созданный YITH Donations, в subscription-based product при наличии премиальной версии соответствующего плагина. Это не означает, что регулярные пожертвования доступны сами по себе в базовой настройке YITH Donations. Если вам нужен recurring-сценарий, заранее проверьте нужную интеграцию, платежный метод и письма.

SEO и индексация

Донатная форма сама по себе не должна быть SEO-инструментом. Важно другое: не создавайте пустые технические страницы только ради формы и не индексируйте служебные страницы корзины. Если делаете отдельную страницу поддержки, она должна содержать нормальный текст: цель сбора, прозрачность, условия, ответы на вопросы. Форма через шорткод - лишь часть страницы, а не весь контент.

Когда YITH Donations будет удачным выбором

YITH Donations стоит использовать, когда пожертвование должно жить внутри WooCommerce: рядом с товаром, в корзине, в заказе, в письмах и в привычном checkout-потоке. Плагин особенно полезен для магазинов, авторских проектов, небольших фондов и сообществ, где нужна не тяжёлая fundraising-платформа, а понятная возможность добавить поддержку к покупке или вывести отдельную форму через shortcode.

Перед рабочим запуском проверьте четыре вещи: корректную сумму в корзине, налоговый статус донатного товара, доступные платежные методы и письмо пользователю. Если всё работает на тестовом заказе, можно скачать ZIP-архив и развернуть сценарий на своём сайте аккуратно: сначала добровольный донат, затем форма в нужных местах, и только после этого - обязательные связки для отдельных товаров.

Главный критерий выбора простой: если пользователю понятно, зачем он добавляет сумму, а администратору понятно, где эта сумма видна в WooCommerce, плагин выполняет свою задачу. Если же проект требует отдельной donor-системы с кампаниями, отчётами и регулярными программами, лучше сравнить альтернативы до того, как строить весь сбор вокруг корзины.