Ви придбали преміум-тему на ThemeForest, запустили сайт, усе працює. Минає пів року, і в адмінці з’являється сповіщення: тема застаріла, а разом із нею і пара критичних уразливостей. Ручне оновлення через завантаження ZIP із ThemeForest, завантаження та заміну файлів, сценарій, який по-справжньому дратує. Особливо коли тем більше ніж одна.

Раніше для цього існував Envato WordPress Toolkit, невеликий плагін, який підтягував ваші покупки з ThemeForest і оновлював теми за пару кліків. Але Envato офіційно замінив його на плагін Envato Market, більш сучасний, з автентифікацією через OAuth-токен замість застарілих API-ключів. А старий Toolkit переїхав до архіву на GitHub і більше не підтримується.

У цьому посібнику, покрокове налаштування Envato Market з нуля: від отримання персонального токена до автоматичних оновлень тем, включно з нюансами для тих, хто переходить зі старого Toolkit.

💡 Швидкий огляд:

• Генеруєте персональний токен Envato в налаштуваннях облікового запису ThemeForest
• Завантажуєте та встановлюєте плагін Envato Market з офіційного GitHub-репозиторію
• Вводите токен та ім’я користувача, плагін сам підтягує всі придбані теми
• Оновлюєте теми в один клік прямо з адмінки WordPress

Що сталося зі старим Envato Toolkit

Якщо ви все ще користуєтеся Envato WordPress Toolkit, час переходити. Плагін виключено з офіційної підтримки: його репозиторій на GitHub переїхав до envato-archive, а механізм API-ключів, на якому він працював, визнано небезпечним. Envato повністю перейшла на персональні токени через OAuth, вони прив’язані до конкретного набору дозволів, їх можна відкликати будь-якої миті, і вони не «витікають» через логи сервера так, як старі ключі.

Новий плагін, Envato Market, живе в активному репозиторії і періодично отримує оновлення. Зовні він схожий: та сама інтеграція з адмінкою, той самий список покупок. Але під капотом, сучасна автентифікація та надійніший механізм перевірки оновлень.

Генеруємо персональний токен Envato

Персональний токен — це новий стандарт автентифікації Envato API, який прийшов на зміну старим 32-символьним ключам. Його потрібно створити до встановлення плагіна: система Envato обробляє новий токен не миттєво, і плагін може не розпізнати його в перші хвилини.

Зайдіть на build.envato.com, авторизуйтеся під своїм обліковим записом ThemeForest і натисніть Create a token. Дайте токену осмислене ім’я, наприклад, «Автооновлення тем на сайті клієнта», і виставте дозволи:

• View and search Envato sites, обов’язково
• View your Envato account username, обов’язково
• View your purchases, обов’язково
• Verify purchases, опціонально, але корисно для тем із системою ліцензування
• Решту дозволів залиште вимкненими

Після створення скопіюйте токен. На відміну від старого API-ключа, токен показується один раз, закрили вкладку, і доступ до нього втрачено. Збережіть у менеджер паролів.

Завантажуємо та встановлюємо плагін Envato Market

На відміну від звичайних плагінів, Envato Market не розміщено в каталозі wordpress.org, він поширюється лише через GitHub. Перейдіть на сторінку envato.github.io/wp-envato-market і завантажте ZIP із папки docs/.

Важливо: не натискайте «Download ZIP» на головній сторінці GitHub-репозиторію, архів називатиметься wp-envato-market-master, і WordPress не розпізнає його як плагін. Беріть ZIP саме з папки docs/, він запакований правильно.

Далі, стандартне встановлення:

• В адмінці WordPress перейдіть до Плагіни → Додати.
• Натисніть Завантажити плагін, виберіть завантажений ZIP.
• Натисніть Встановити, потім Активувати.

Після активації в бічному меню адмінки з’явиться пункт Envato Market.

Налаштування: прив’язуємо токен до покупок

Відкрийте Envato Market в адмінці. Ви побачите два поля: ім’я користувача Envato та персональний токен. Вставте токен, який скопіювали на попередньому кроці, вкажіть логін від ThemeForest і натисніть Save Changes.

Плагін опитає Envato API і виведе список усіх тем і плагінів, придбаних із цього облікового запису. Якщо список порожній, зачекайте 10-15 хвилин і оновіть сторінку. Envato потрібен час, щоб «пропалити» свіжий токен через свою інфраструктуру. Якщо не допомагає, перевірте, чи в токена увімкнено дозвіл «View your purchases» і чи ви ввійшли саме під тим обліковим записом, з якого купували теми.

Нюанс для власників кількох сайтів: можна створити окремий токен для кожного домену або один глобальний. Глобальний зручніше: вставили на всіх сайтах, і кожна тема бачить свою ліцензію. Але якщо передаєте сайт клієнту, краще відкликати глобальний токен і видати вузький, під конкретний домен.

Автоматичне оновлення тем

Після прив’язки токена на вкладці Themes з’явиться список придбаних тем із їхніми поточними версіями. Якщо для теми доступне оновлення, поруч із нею буде кнопка Update Available.

Натисніть її, WordPress відпрацює стандартний механізм оновлення: завантажить свіжий ZIP із серверів Envato, розпакує та замінить файли теми.

Перед оновленням, важливий момент, який стосується кастомізації. Якщо ви правили файли теми напряму (стилі, шаблони, functions.php), оновлення перезапише їх, усі зміни зникнуть. Це не стосується налаштувань, зроблених через кастомайзер WordPress або панель опцій теми: вони зберігаються в базі даних і залишаться.

Правильний підхід, дочірня тема. Усі правки коду виносьте в неї, а батьківську тему ніколи не чіпайте. Тоді кнопка «Update Available» стає безпечною: тиснете без страху втратити кастомізацію.

Плагін також додає автоматичну перевірку оновлень: WordPress періодично опитуватиме Envato API і показуватиме сповіщення про нові версії прямо в стандартному розділі оновлень.

⁉️🤔 Часті запитання

Чим персональний токен відрізняється від старого API-ключа?

Персональний токен працює через OAuth, ви задаєте конкретні дозволи, можете відкликати токен будь-якої миті, і він не «світиться» в URL-запитах. Старий API-ключ був одним безстроковим рядком без гранулярних прав. Envato вимкнула генерацію нових ключів, усі нові інтеграції, лише через токени.

Чи можна продовжувати користуватися старим Envato Toolkit?

Формально, так, якщо він у вас уже встановлений і працює. Але плагін не оновлюється з 2021 року, його репозиторій в архіві, а інфраструктура Envato поступово вимикає підтримку старих API-ключів. Рано чи пізно Toolkit перестане підтягувати покупки. Краще перейти зараз, поки він ще живий, ніж екстрено розбиратися, коли тема перестане оновлюватися.

Плагін Envato Market не бачить мої покупки, що робити?

Найчастіша причина, токен створено під іншим обліковим записом Envato (у багатьох кілька облікових записів для різних маркетплейсів). Перевірте, чи ви залогінені саме в той обліковий запис, з якого купували теми. Друга причина, свіжий токен ще не оброблено: зачекайте 15-30 хвилин. Третя, у токена не ввімкнено дозвіл «View your purchases».

Чи потрібно ставити Envato Market на кожен сайт окремо?

Так, плагін працює покадрово, на кожному сайті потрібна своя активація. Токен можна використовувати один і той самий на всіх сайтах (він прив’язаний до облікового запису, а не до домену), але плагін встановлюється та налаштовується на кожному сайті незалежно.

Що буде з кастомізацією теми після автооновлення?

Файли батьківської теми перезаписуються повністю. Налаштування з кастомайзера та панелі опцій теми зберігаються, вони в базі даних. Правки в коді, зроблені напряму у файлах теми, зникають. Використовуйте дочірню тему для будь-яких модифікацій коду — це найкраща практика, а не просто рекомендація.

Чи варто переходити з Envato Toolkit прямо зараз

Якщо ви все ще сидите на старому Toolkit, переходьте сьогодні. Процес займає 10 хвилин: деактивуєте Toolkit, ставите Envato Market, вставляєте токен. Токен створюється за хвилину, встановлення плагіна, ще пара хвилин, і все працює.

Головний профіт не в тому, що «старий ще оре». Профіт у тому, що новий плагін використовує інфраструктуру, яку Envato розвиває та підтримує. Старий Toolkit, тупикова гілка, і питання не «чи зламається», а «коли». Зазвичай це стається в найбільш невідповідний момент, коли вийшло оновлення теми, що закриває вразливість, а оновитися ви не можете.

Відірвіться на 10 хвилин, поставте Envato Market і забудьте про ручні оновлення тем назавжди.