CodeCanyon WooCommerce Shipping Tracking - Плагин WordPress

Руководство по настройке CodeCanyon WooCommerce Shipping Tracking для заказов, писем и отслеживания доставки

CodeCanyon WooCommerce Shipping Tracking нужен не просто для добавления номера отправления в заказ. В нормальной настройке он связывает заказ WooCommerce, перевозчика, трек-номер, письмо клиенту, страницу просмотра заказа, форму отслеживания и, при необходимости, расчёт ожидаемой даты отправки. В этом руководстве разберём, как превратить плагин в понятный рабочий процесс для магазина, а не оставить его на уровне «вставили код и забыли».

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

Я не буду пересказывать карточку товара. Важнее понять, какие настройки влияют на реальный результат: где вводится трек-номер, когда клиент увидит ссылку, как работают несколько отправлений в одном заказе, зачем нужны свои перевозчики, где пригодятся шорткоды и почему автоматический импорт через CSV нужно тестировать особенно аккуратно.

Какую задачу закрывает плагин в WooCommerce-магазине

Главная задача плагина - связать логистическую информацию с жизненным циклом заказа. В стандартном WooCommerce заказ может иметь статусы, письма и заметки, но полноценное поле для перевозчика и трек-номера обычно появляется через отдельное расширение. CodeCanyon WooCommerce Shipping Tracking добавляет такой слой: администратор выбирает компанию доставки, вводит номер отслеживания, при необходимости добавляет дату отправки и текстовое пояснение, а покупатель видит эти данные в привычных местах.

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

По подтверждённым источникам плагин поддерживает заранее заданные перевозчики, собственные компании доставки, несколько трек-номеров в одном заказе, вывод данных в письмах WooCommerce и на странице просмотра заказа, визуальную временную шкалу для отслеживания, CSV-импорт, форму отслеживания через шорткод, интеграцию с WPML для пользовательских сообщений и настройку шаблонов фрагмента, который вставляется в email и order details.

Ключевая проверка: плагин приносит пользу только тогда, когда трек-номер появляется там, где клиент уже ищет информацию - в письме о заказе и в разделе аккаунта, а не только в админ-панели.

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

Кому CodeCanyon WooCommerce Shipping Tracking подходит, а кому лучше смотреть шире

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

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

Когда плагин будет удобен

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

Когда может не хватить возможностей

Если магазину нужен полноценный центр логистики с автоматическими уведомлениями по каждому событию перевозчика, SMS, аналитикой задержек, брендовыми страницами отслеживания и сложной интеграцией с 3PL, одного локального плагина может быть мало. В таком случае лучше сравнить его с AfterShip, TrackShip или Advanced Shipment Tracking в связке с внешним сервисом мониторинга.

Ещё один случай - магазин, где трек-номера должны приходить из ERP, склада или службы доставки по API. У CodeCanyon WooCommerce Shipping Tracking есть документированная функция для чтения данных и CSV-импорт, но источники не подтверждают полноценный публичный REST API для записи данных в стиле отдельных shipment endpoints. Поэтому интеграции нужно проектировать осторожно: сначала проверить CSV и доступные hooks, потом уже планировать автоматизацию.

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

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

Техническая совместимость

Сначала проверьте версию WordPress, WooCommerce, PHP и тему. В карточке CodeCanyon указана совместимость с несколькими актуальными ветками WordPress и WooCommerce, но финальное решение всё равно нужно принимать на тестовой копии сайта. Если магазин использует кастомные статусы, конструктор писем, плагины PDF-инвойсов, сложный checkout или HPOS, создайте тестовый заказ и проверьте весь путь от оплаты до письма клиенту.

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

Рабочий процесс склада

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

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

Письма, кеш и тема

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

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

Установка и первичная проверка без лишнего риска

Установка выполняется как у обычного ZIP-плагина WordPress: через Plugins, Add New, Upload Plugin, выбор архива, Install Now и Activate Plugin. WordPress.org в своей документации описывает этот путь как штатный способ установки ZIP-файла, если плагин получен не из каталога WordPress.org.

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

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

1. Откройте админ-панель WordPress и убедитесь, что после активации появился пункт, связанный с Shipping tracking.
2. Создайте или выберите тестовый заказ, который не содержит реальных персональных данных клиента.
3. Добавьте перевозчика и тестовый номер отслеживания, лучше на заранее выбранной службе, где понятен формат ссылки.
4. Сохраните заказ и проверьте, не возникли ли предупреждения PHP, ошибки сохранения или конфликты с метабоксами WooCommerce.
5. Откройте страницу заказа в аккаунте тестового покупателя и проверьте, что блок отслеживания отображается не только в админке.
6. Сгенерируйте письмо статуса заказа и посмотрите, есть ли в нём ожидаемый фрагмент отслеживания.

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

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

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

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

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

Компании доставки и собственные перевозчики

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

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

Ограничение для временной шкалы: по документации продукта visual timeline не работает для custom defined companies. Для собственных перевозчиков используйте ссылку и понятный текст, а не обещание статусов движения.

Несколько отправлений в одном заказе

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

Практичная схема такая: для каждой посылки укажите перевозчика, трек-номер, дату передачи перевозчику и короткий custom text. Текст должен объяснять различие между отправлениями: «Первая коробка с аксессуарами», «Основной товар», «Отдельная доставка от поставщика». Не превращайте custom text в длинное письмо, потому что он будет виден рядом с трек-данными и может перегрузить блок.

Фрагмент для письма и страницы заказа

Один из сильных режимов продукта - настройка HTML-фрагмента, который вставляется в письмо и order details. Здесь важно не увлечься дизайном. Покупателю нужны три вещи: кто доставляет, какой номер отслеживания, куда нажать. Вводные фразы, баннеры и длинные инструкции лучше оставить для отдельной страницы помощи.

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

Статусы заказов и отправка писем

В WooCommerce письмо Completed order обычно связано с завершением заказа и часто означает, что заказ отправлен. Плагин по умолчанию добавляет отслеживание в письма при статусе completed, но позволяет выбрать другие статусы и даже custom statuses. Это гибко, но требует дисциплины.

Для физического товара чаще всего безопасный порядок такой: заказ оплачен и находится в processing, менеджер собирает отправку, вводит трек-номер, затем переводит заказ в completed или отправляет активное уведомление с выбранным tracking code. Если магазин переводит заказ в completed до появления трек-номера, покупатель может получить письмо без полезной ссылки.

Quick assign и любимая компания

Quick assign полезен, когда менеджеру нужно быстро назначить данные отправки без полного открытия каждого заказа. Этот режим особенно ценен в магазине с потоком однотипных отправлений. Но скорость не должна ломать точность: перед массовым использованием убедитесь, что favourite shipping company действительно соответствует большинству заказов.

Если любимый перевозчик выбран неправильно, менеджер будет быстрее совершать одну и ту же ошибку. Поэтому настройте favorite company только после наблюдения за реальным потоком отправок. Для смешанной логистики лучше оставить выбор перевозчика явным.

Оценка даты отправки и доставки

Плагин умеет показывать estimated shipping date на карточке товара через шорткод [wcst_show_estimated_date] или автоматический вывод, если такая опция включена. Правила оценки могут учитывать товары, категории или теги, дни отправки, cut-off hour, задержку отправки, праздники и нерабочие дни. Это уже не просто трекинг, а управление ожиданиями до покупки.

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

Шорткоды, временная шкала и страница отслеживания на сайте

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

Форма отслеживания через [wcst_tracking_form]

Документация продукта указывает шорткод [wcst_tracking_form], который выводит форму с выбором компании доставки и вводом tracking code. Дополнительный параметр company_id позволяет заранее выбрать перевозчика и скрыть select menu, а button_classes добавляет CSS-классы к кнопке. Это удобно, если магазин хочет сделать отдельную страницу «Отследить заказ» под одного основного перевозчика.

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

Отслеживание внутри сайта через track_in_site

Параметр track_in_site="true" нужен, когда после ввода tracking code пользователь должен увидеть статус на сайте, а не просто перейти к перевозчику. Этот режим зависит от поддержки перевозчика и данных, которые можно получить. Если carrier не поддерживается или трек-номер ещё не активен у службы доставки, результат может быть пустым или неполным.

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

Временная шкала в деталях заказа

Визуальная шкала полезна, когда клиенту нужно понять не только ссылку на перевозчика, но и состояние доставки: отправлено, в пути, доставляется, доставлено. В источниках по продукту указано, что timeline выводится на странице order details, если используется соответствующий шорткод внутри сообщения для деталей заказа.

Не перегружайте timeline дополнительными текстами. Если рядом уже есть carrier, tracking code и статусы движения, длинные пояснения будут мешать. Лучше добавить короткий заголовок и оставить подробности на стороне перевозчика. Проверяйте этот блок на мобильной ширине, потому что длинные номера отслеживания и названия служб доставки часто ломают сетку темы.

Практический пример: один заказ, две посылки и письмо клиенту

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

Цель

Покупатель должен увидеть, что заказ отправлен двумя посылками: первая уже передана основному перевозчику, вторая будет отправлена отдельно. У каждой посылки есть свой tracking code, компания доставки и короткое пояснение. Если покупатель откроет письмо или страницу заказа, он поймёт, какой номер относится к какой части заказа.

Подготовка

• На тестовом сайте установлен и активирован WooCommerce.
• Плагин CodeCanyon WooCommerce Shipping Tracking активирован и виден в админке.
• В списке компаний есть основной перевозчик или создана custom company с рабочей ссылкой.
• Настроен вывод tracking info для нужного статуса заказа.
• Есть тестовый email-перехватчик или безопасный тестовый адрес покупателя.

Шаги

1. Откройте тестовый заказ в админ-панели WooCommerce.
2. В блоке shipping tracking добавьте первое отправление: carrier, tracking number, dispatch date и короткий custom text.
3. Добавьте второе отправление с другим tracking number и пояснением, например «Вторая коробка с аксессуарами».
4. Сохраните заказ без отправки реального письма, если сначала нужно проверить админскую часть.
5. Откройте страницу заказа в аккаунте тестового покупателя и убедитесь, что оба отправления видны отдельно.
6. После проверки отправьте нужное уведомление или переведите заказ в статус, который должен включать tracking info в email.

Проверка

В письме и order details должны быть два отдельных трек-номера. Ссылки должны вести к правильным перевозчикам, а custom text должен помогать различить посылки. Если в письме отображается только одно отправление, вернитесь в заказ и проверьте, не сохранён ли второй tracking code в неправильном формате или не был ли он добавлен после отправки письма.

Нюанс с повторной отправкой уведомления

Если письмо уже ушло без второго трек-номера, не отправляйте клиенту серию хаотичных сообщений. Лучше обновить данные, выбрать нужные tracking codes для active notification, проверить шаблон и отправить одно аккуратное письмо с пояснением. Внутренне зафиксируйте правило: уведомление клиенту отправляется после полного заполнения всех отправлений, которые уже известны менеджеру.

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

У CodeCanyon WooCommerce Shipping Tracking есть несколько режимов, которые можно использовать не только «по умолчанию». Ниже - идеи, основанные на подтверждённых функциях: несколько отправлений, custom text, шорткод формы, оценка дат, CSV-импорт и вывод в письмах. Это не обязательные сценарии, но они помогают понять, как пользоваться CodeCanyon WooCommerce Shipping Tracking в реальном магазине.

Частичная отгрузка для заказов из нескольких складов

Если один заказ собирается из двух складов, используйте несколько tracking codes и custom text. В custom text укажите, какая часть заказа относится к конкретной посылке. Результат для клиента - меньше неопределённости: он видит, почему пришёл один номер, а второй отличается.

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

Страница «Отследить заказ» для гостевых покупателей

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

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

Оценка отправки для товаров под заказ

Для товаров, которые отправляются не каждый день, настройте estimation rules. Покажите expected shipping date на карточке товара через [wcst_show_estimated_date] или автоматический вывод. Это помогает клиенту принять решение до оплаты, особенно если товар производится, комплектуется или приходит от поставщика.

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

Пакетный импорт для склада или fulfilment-партнёра

CSV-импорт нужен, когда трек-номера приходят пачкой. В таком сценарии менеджер не открывает каждый заказ, а загружает файл с order_id, статусом, флагом уведомления, dispatch date, custom text и tracking info. Это ускоряет работу, но повышает цену ошибки в файле.

Перед массовым импортом всегда делайте тест на 2-3 заказах. Проверьте, что статус меняется только там, где нужно, уведомление уходит ожидаемым письмом, а несколько отправлений разделяются корректно. После этого можно расширять импорт на реальную партию.

CSV-импорт и автоматическая загрузка трек-номеров

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

Какие поля проверить в файле

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

После импорта откройте несколько заказов из разных строк файла. Проверяйте не только успешные строки, но и крайние случаи: заказ с двумя отправлениями, заказ без изменения статуса, заказ с custom text, заказ с принудительным email.

Автоматический импорт по URL

В источниках по продукту указано, что плагин может загружать CSV по URL с заданным интервалом. Этот режим использует механизм WordPress cron через wp_schedule_event(). Важно понимать, что стандартный WordPress cron запускается при посещениях сайта, если время события наступило. На малопосещаемом сайте импорт может сработать позже ожидаемого.

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

Безопасные улучшения: аккуратный вывод и чтение данных без правки плагина

Не стоит править файлы плагина напрямую. При обновлении такие изменения потеряются, а при ошибке можно сломать вывод заказов. Для CodeCanyon WooCommerce Shipping Tracking безопаснее использовать настройки HTML-фрагмента, CSS темы, Code Snippets или дочернюю тему. Точный PHP API продукта ограничен тем, что публично описано: функция wcst_get_order_tracking_data($order_id) для чтения tracking data и actions до и после active notification email.

Небольшой CSS для блока отслеживания

Если блок tracking info выглядит слишком плотно в теме, начните не с PHP, а с CSS. Конкретные классы зависят от вывода вашей версии и темы, поэтому сначала откройте страницу заказа в браузере, найдите контейнер блока отслеживания через инспектор и замените селектор ниже на реальный. Это осторожная CMS-практика, а не привязка к выдуманному API.

/* Добавьте в дочернюю тему или в Additional CSS.
   Замените .wcst-tracking-box на реальный класс контейнера из инспектора. */
.wcst-tracking-box {
  margin-top: 16px;
  padding: 14px 16px;
  border: 1px solid #d8dee4;
  border-radius: 6px;
  background: #ffffff;
}

.wcst-tracking-box a {
  font-weight: 600;
  text-decoration: underline;
}

Проверка: откройте order details в аккаунте покупателя, обновите страницу без кеша и убедитесь, что изменился только блок отслеживания. Откат простой - удалить CSS. Если селектор найден неверно и стиль затронул другие элементы WooCommerce, сразу уберите правило и уточните контейнер.

Чтение tracking data в собственной служебной панели

Если разработчику нужно показать данные отслеживания в кастомной внутренней панели, можно использовать документированную функцию wcst_get_order_tracking_data($order_id), но только с проверкой существования функции. Не вставляйте такой код в шаблон публичной страницы без проверки прав доступа и экранирования данных.

<?php
// Пример для внутреннего шаблона или Code Snippets.
// Не выводите эти данные публично без проверки прав доступа.
if ( function_exists( 'wcst_get_order_tracking_data' ) ) {
    $tracking_items = wcst_get_order_tracking_data( $order_id );

    if ( ! empty( $tracking_items ) ) {
        foreach ( $tracking_items as $item ) {
            echo esc_html( $item['company_name'] ?? '' ) . ': ';
            echo esc_html( $item['tracking_number'] ?? '' );
            echo '<br>';
        }
    }
}
?>

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

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

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

Маршрут проверки

1. Создайте тестовый заказ с физическим товаром и обычной доставкой.
2. Добавьте tracking info в заказ и сохраните его.
3. Откройте заказ в аккаунте тестового покупателя и проверьте вывод блока.
4. Смените статус заказа или отправьте active notification по выбранному tracking code.
5. Проверьте email в HTML-виде и, если магазин использует plain text, текстовую версию письма.
6. Нажмите ссылку перевозчика и убедитесь, что трек-номер подставлен корректно.
7. Если используется [wcst_tracking_form], откройте страницу формы в приватном окне и выполните тестовый поиск.
8. Если используется estimated date, проверьте карточку товара, корзину и checkout.

Что считать успешным результатом

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

Отдельно проверьте поведение после повторного сохранения заказа. Некоторые конфликты проявляются именно на втором сохранении: данные перезаписываются, письмо уходит повторно, кастомный статус меняется не так, как ожидалось. Это особенно важно, если рядом стоят плагины складского учёта, PDF-инвойсов, кастомных статусов или конструкторы email-шаблонов.

Диагностика частых проблем с отслеживанием и письмами

Ошибки в плагинах отслеживания обычно возникают не из-за одной причины, а на стыке WooCommerce-статусов, шаблонов писем, перевозчиков и кеша. Ниже - практичная карта диагностики для CodeCanyon WooCommerce Shipping Tracking и похожего WooCommerce-процесса.

Трек-номер есть в заказе, но не попал в письмо

Симптом: в админке заказа tracking code сохранён, но клиент получил письмо без блока отслеживания. Возможная причина - письмо было отправлено до ввода трек-номера, выбран не тот статус для embedding, или email-шаблон переопределён темой или конструктором писем.

Проверьте статус заказа, настройки плагина для email embedding и фактическое письмо, которое отправляет WooCommerce. Если письмо уже ушло, используйте active notification для выбранного tracking code или отправьте корректное письмо вручную через штатный процесс магазина. Если проблема повторяется, временно отключите кастомный email builder на тестовой копии и сравните результат.

Ссылка перевозчика ведёт на общую страницу или не открывает трек

Причина часто в неверном carrier, формате tracking URL или собственном перевозчике без прямой подстановки номера. Для predefined companies сначала проверьте, что выбран правильный carrier ID. Для custom company откройте ссылку вручную и убедитесь, что сайт перевозчика умеет принимать номер в URL.

Если перевозчик изменил структуру ссылок, временно добавьте понятный custom text с инструкцией для клиента и проверьте, нет ли обновления плагина. В changelog продукта уже встречались исправления, связанные с tracking URL, поэтому устаревшая версия может быть причиной.

Timeline не отображается или показывает пустое состояние

Визуальная шкала зависит от supported carrier и корректного tracking code. Для custom defined companies, по описанию продукта, timeline не работает. Также статус у перевозчика может появиться с задержкой после создания отправления.

Проверьте тот же трек-номер на сайте перевозчика, затем проверьте шорткод внутри сообщения order details. Если ссылка у перевозчика работает, а timeline нет, отключите временно кеш страницы и конфликтующие оптимизаторы скриптов на тестовой среде. Если carrier кастомный, не пытайтесь «починить» timeline CSS-ом - используйте обычную ссылку и текст.

CSV-импорт изменил не тот статус или отправил лишнее письмо

Это обычно связано с полями order_status и force_email_notification. Если они заполнены без необходимости, импорт может не только добавить tracking info, но и изменить состояние заказа или повторно отправить уведомление.

Остановите массовый импорт, проверьте последние строки CSV, откройте 2-3 затронутых заказа и посмотрите order notes. Для следующей попытки используйте файл только на тестовых заказах. Если статус менять не нужно, оставьте соответствующее поле пустым. Если письма не должны уходить, не используйте флаг принудительного уведомления.

Страница с формой отслеживания кэшируется

Симптом - пользователь вводит номер, но видит старый результат, пустой блок или одинаковый ответ для разных попыток. Проверьте страницу с [wcst_tracking_form] без кеша, в приватном окне и под разными tracking codes. Если проблема пропадает без кеша, исключите эту страницу из кеширования и минификации форм.

Данные не сохраняются после редактирования заказа

Проверьте конфликт с другими плагинами, которые меняют order meta, статусы или экран редактирования заказа. В changelog продукта были исправления, связанные с сохранением заказа и взаимодействием со сторонними плагинами, поэтому начните с обновления на тестовой копии. Если проблема появилась после установки нового расширения склада, инвойсов или кастомных статусов, отключайте их по одному на тестовом сайте и фиксируйте результат.

Когда стоит использовать CodeCanyon WooCommerce Shipping Tracking

Этот плагин будет удачным выбором, если магазину нужен практичный слой отслеживания внутри WooCommerce: трек-номера в заказе, вывод в письмах и аккаунте, несколько отправлений, custom companies, шорткод формы, timeline для поддерживаемых перевозчиков, CSV-импорт и оценка дат отправки. Он особенно полезен там, где процесс ещё можно контролировать силами менеджера или склада, а не выносить полностью во внешнюю логистическую платформу.

Перед рабочим запуском проверьте четыре вещи: базовый заказ, письмо клиенту, страницу аккаунта и реальный carrier URL. Затем протестируйте дополнительные режимы - estimation rules, [wcst_tracking_form], CSV и active notification. Если всё совпадает с вашим процессом, можно загрузить архив с CodeCanyon WooCommerce Shipping Tracking и провести настройку на тестовой копии сайта.

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