Іноді у ваших рецептах вам знадобиться включити дані про користувача або публікацію, і ці дані можуть відрізнятися для кожного запуску рецепту. Можливо, є рецепт, який ви хочете запустити для кількох користувачів, і в рецепті є дія для надсилання електронного листа користувачеві, і ви хочете звертатися до користувача на ім'я. Ці динамічні фрагменти даних усередині рецептів називаються «токенами» і можуть бути включені до будь-якої дії рецепту.
Типи токенів
Uncanny Automator пропонує 3 типи жетонів для використання в рецептах:
- Універсальні токени : ці токени завжди доступні в кожному рецепті та можуть бути використані для передачі інформації про користувача, публікацію, дату тощо.
- Токени-тригери: Коли до рецепту додається тригер, доступні токени, що відповідають цьому тригеру, додаються до списку доступних токенів. Під час надсилання форми отримання значення в другому полі буде типом токена «тригер».
- Токени дій : Коли до рецепта додається дія, токени, пов'язані з її виводом, стають доступними для дій, що виконуються після неї. Прикладом може бути передавання нового ідентифікатора публікації іншій дії діями, які створюють запис.
Використання жетонів у рецептах
Щоразу, коли є можливість використати токен у полі, ви побачите значок зірочки (*) праворуч від цього поля. Натиснувши на цей значок, розгорнеться меню з доступними токенами. Система токенів виглядає так:
У верхній частині списку знаходяться універсальні жетони, які з’являються в кожному рецепті. Розділи «Тригери» та «Дії» нижче відображатимуться, якщо для тригерів та/або дій у рецепті доступні жетони. Використовуйте значки праворуч від типу жетона, щоб розгорнути цей розділ і показати всі доступні жетони.
Щоб додати токен до поля дії, просто виберіть його. Це додасть цей токен до вашої дії, простою мовою, зі спеціальним стилем, який вказує на те, що це токен. Підтримуйте, що рецепт пов’язаний з користувачем, і ми хочемо включити ім’я та прізвище в поле (обидва токени «Загальні»); поле в рецепті відображатиме наступне:
Значки всередині сірої області таблеток показують значок інтеграції, якщо він є. Відображений заголовок є описовою міткою для токена. У цьому прикладі, якщо під час виконання рецепту надсилається електронний лист пов’язаному користувачеві, і це була тема листа, користувач отримає електронний лист із темою листа, в якій буде вказано його ім’я та прізвище.
У деяких випадках певні токени вимагатимуть додаткової інформації. Наприклад, якщо ви хочете повернути дані для певного метаключа публікації, вам потрібно вказати Automator, на яку публікацію орієнтуватися (за ідентифікатором) і для якого метаключа повертати дані. Коли токен вимагає додаткової інформації, він покаже додаткове модальне вікно, ось таке:
Ви навіть побачите праворуч, що передача ідентифікатора публікації та метаключа може здійснюватися за допомогою токенів (як показано * праворуч), тому динамічні дані дійсно можна використовувати будь-де. У цьому прикладі, можливо, я хочу повернути значення метаключа «організація» для певної сторінки, пов’язаної з тригером. Токен виглядатиме так:
У цьому новому прикладі токена показано, що ідентифікатор публікації передається автоматично з тригера (це тригер WordPress, звідси і значок), а метаключ «організація» жорстко закодований, оскільки цей ключ застосовуватиметься до всіх запусків рецептів.
Універсальні токени
Універсальні токени включають будь-які токени, доступні для використання в будь-якій дії, яка може приймати токени. У цій категорії є кілька важливих типів токенів:
- Загальні : це просто типи токенів, які можна використовувати для отримання та використання даних про користувача, сайт або рецепт. Прикладами токенів цього типу є ім'я користувача, посилання для скидання пароля, URL-адреса сайту тощо.
- Дата : Щоб використовувати дату, час WordPress або навіть позначку часу Unix, використовуйте токени в цьому розділі.
- Розширений : зазвичай це складніші токени, такі як робота безпосередньо з метаданими користувачів та публікацій.
- Модифікатори : Токени в цьому розділі дозволяють маніпулювати даними, наприклад, виконувати обчислення для метазначення, щоб збільшити його на 1.
Тригерні токени
Дуже типово використовувати значення, які фіксуються в тригері пізніше в діях. Припустимо, ви надсилаєте форму, яка має створити користувача, і запис форми містить інформацію про користувача, яка буде використана для створення облікового запису. Ви б використовували токени тригера для заповнення інформації про користувача всередині дій та селектора користувачів.
Токени тригерів унікальні для кожного тригера. Якщо у вас виникають проблеми з пошуком потрібного вам значення в певному тригері, можливо, подібний тригер має більш відповідні токени.
Порада : Чи знаєте ви, що на нашому вебсайті можна переглянути список усіх доступних токенів? Просто відвідайте будь-яку сторінку інтеграції на нашому вебсайті (наприклад, http://staging.automatorplugin.com/integration/woocommerce/) та знайдіть + поруч із тригером. Натисніть на нього, щоб розгорнути список доступних токенів, ось так:
Жетони дій
Іноді вам може знадобитися передати дані від однієї дії до іншої , яка виконується пізніше в рецепті. Прикладом використання цього типу токена може бути рецепт, який створює нову публікацію, а потім твітить про нову публікацію після надсилання форми. В інших випадках, щоб надіслати твіт, дії потрібна URL-адреса нової публікації, щоб вона могла містити посилання на неї. У цьому полягає сила токенів дій.
Не всі дії підтримують передачу даних через токени, і ці типи токенів найчастіше застосовуються під час створення об'єктів, таких як замовлення, сторінки, користувачі та записи форм. Щоб переглянути список доступних токенів дій, переконайтеся, що ви спочатку додали дію, яка передаватиме дані до іншої дії. У багатьох випадках має сенс додати невелику затримку до дії, якій потрібні дані, щоб переконатися, що дія створення об'єкта завершена.
Після додавання необхідних дій відкрийте список токенів для дії, яка отримує дані, та знайдіть новий Дії . Виберіть відповідні токени зі списку, щоб включити їх до свого рецепту.
