API налаштувань та налаштування теми

Коли було б доцільно використовувати API налаштувань, а коли було б краще скористатися настроювачем тем?

Цілий ранок, гуляючи навколо, я не зміг знайти жодного добре розглянутого та останнього керівництва з цього приводу. Хоча це ще рано говорити, я вважаю, що налаштування теми є першочерговим першим кроком до залучення більше можливостей редагування, подібних до Squarespace . Хтось знає про плани щодо заходу API налаштувань на користь налаштування теми? Якщо ми всі потихеньку рухатимемося до нього, чи краще нам дотримуватися API налаштувань? Чи можуть вони жити пліч-о-пліч, і якщо так, то де б лежав розподіл обов'язків?

settings-api theme-customizer

— Дре
джерело

Відповіді:

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

Настроювач не визначає / не може визначати / реєструвати нові параметри, які ще не були зареєстровані ні через API налаштувань, ні через API тематичних модулів. Сказав інший спосіб: API Customizer не є API для додавання налаштувань безпосередньо до або отримання налаштувань безпосередньо з бази даних; скоріше, API інтерфейсу використовує або API налаштувань, або API тематичних модусів для збереження налаштувань у базі даних або для отримання їх параметрів.

Таким чином, API Customizer не є альтернативою одному з існуючих API параметрів ; скоріше, це альтернатива сторінці налаштувань . Настроювачеві не важливо, чи налаштування зареєстровано через API налаштувань чи API тематичних модулів, і такі налаштування можна змішувати та співставляти в Customzer. Справді, в більшості випадків, такі параметри є змішані і підібрано: призначений для користувача заголовком і призначений для користувача фон є тематичними Модифікаціями і сайт Назва та опис параметрів API.

Щоб зрозуміти, як саме налаштування та елементи керування зареєстровані за допомогою API інтерфейсу, рекомендую прочитати чудові навчальні посібники Отто:

Отже, питання не є або / або щодо зазначених API. Відповідними або / або питаннями будуть:

Використовуйте або API налаштувань або Theme Mods API для реєструвати існуючі налаштування для перегляду через API Настроювач
Використовуйте або Customizer API або користувальницької теми Налаштування сторінки , щоб дозволити користувачеві параметри налаштовують Theme .

— Чіп Беннетт
джерело

Спасибі Чіп. Я все ще не на 100% стежу за вами, але ви мені дали достатньо, щоб ще раз розглянути проблему. Я думаю, що моя плутанина випливає з перекриття функціональності та подібності в назвах. Чи є сторінка, яка чітко документує випадки використання (більш абстрактно) різних API? Мені не пощастило переглядати кодекс; вона зосереджена лише на гайках та болтах застосування API.

— Дре

Я додав ще, щоб спробувати пояснити трохи більш поглиблено. Дивіться також, особливо, посилання на підручники з налаштування програми Отто; Думаю, вони допоможуть з’ясувати речі.

— Чіп Беннетт

Ви, пан, джентльмен.

— Дре

Настільки ж просто, що може бути інколи: API налаштувань не є Налаштуванням тем. Обидва різні речі для різних завдань.

API налаштувань

Ви або пишете плагін, або маєте тему, яка не має варіантів, які не потребують візуального відгуку? Перейдіть з цією опцією.

Тема "Настроювач"

Потрібно мати параметри, які мають візуальний вплив, який повинен бачити користувач? Перейдіть з цією опцією.

— кайзер
джерело

Це був мій вихідний висновок. Однак існує велика кількість функціональних перекриттів між цими двома, саме це призводить до початкових питань. Крім того, ідея розділити параметри теми на два місця залежно від того, візуальні вони чи ні, не вважають мене проблематичним з точки зору UX. Це не означає, що я не згоден з вами; Я просто вимагаю думок на цьому етапі. Вся сама тема дещо каламутна. Можливо, деякі чітко визначені вказівки "з висоти" будуть корисні. Дякуємо за ваш внесок!

— Др

@ Здогадуєтесь, ви трохи це неправильно прочитали: Якщо у вас є навіть один єдиний варіант, який потребує візуального зворотного зв’язку, перейдіть із програмою ThemeCustomizer. Отже, правило: Тема -> Настроювач тем | Плагін -> API налаштувань.

— кайзер

Як правило, усі визначені Темою варіанти повинні мати презентаційний вплив. :) Це сказав: кастомизация API вимагає або до API налаштувань або в тематичний Mods API для того , щоб існувати. API налаштування - це не альтернатива одному з цих двох API, а скоріше альтернатива для сторінки налаштувань теми .

— Чіп Беннетт

У вас, хлопці, є якісь проблеми із опосередкованістю у налаштуваннях? Мені це здається досить темпераментним і в 3.5.1, і тим більше в 3.6 (багажник). Я знаходжу, що кнопки заголовка та кнопки закриття / збереження часто просто не реагують належним чином на клацання і іноді потрібно натискати на них кілька разів (і тим більше в багажник). Це і в FF, і в Chrome.

— t31о

@ t31os Раніше була ця проблема, але без послідовності. Але не пробували вже досить давно. Я б запропонував console.log()усім вашим діям, щоб ви бачили, що спрацьовує і що перебиває. Налагодження JavaScript не просте ...

— кайзер