() translation by (you can also view the original English article)
Як нами багаторазово було згадано тут, на WP Tuts (і як ви, безсумнівно, помітили), ніколи раніше не було кращих часів, щоб стати розробником WordPress. Чи це клієнтська робота чи розробка продукту (теми або плагіни), знайомство з екосистемою WordPress - це більше питання "де", ніж "як".
WordPress має космічну документацію по API для розробників, незалежно від рівня досвіду. Але активний розвиток співтовариства і добре документовані API не дає платформі імунітету від поганої практики розробки.
Як і в більшості аспектів веб-розробки, просто тому, що щось працює ще не означає, що це було побудовано належним чином. Але як перед розробниками і майстрами справи, перед нами стоїть завдання переконатись, що продукт, який ми випускаємо працює і побудовано правильно. Якщо продивитись вихідний код цілого ряду тем або плагінів, можна побачити, що розробники випускають продукт, що працює, але який не був спроектований якнайкращим чином. Особливо це тлумачення вірне, якщо мовити про налаштування тем, сторінок меню, перевірок і так далі.
І ми хочемо це зупинити.
У цій серії ми збираємось зануритися в WordPress Settings API. Ми збираємося поглянути на те, що це таке, чому це важливо і як цього досягти у нашій роботі.
Наша кінцева мета для цієї серії статей полягає в тому, щоб стати справжнім довідником для Settings API незалежно від рівня вашого досвіду. У кінці ви повинні будете мати чітке розуміння API і справжніх прикладів того, як усе робити належним чином.
Для того, щоб бути повним, потрібно почати з самих азів. Отже, перш ніж написати будь-який код або попрацювати над будь-якими прикладами, ми повинні представити Settings API, що це таке і чому має значення.
Settings API Встановлено
На самому базовому рівні, Settings API являє собою набір функцій наданих WordPress, які спрощують процес впровадження меню, сторінок налаштувань та збереження, перевірку та отримання даних, введених користувачем.
Досить просто, чи не так?
Протягом цієї серії ми будемо занурюватись у кожний аспект, але це повинно надати просте визначення того, з чим ми можемо працювати протягом решти статей.
Чому ми маємо використовувати Settings API?
Тепер, коли ми розуміємо, чим Settings API насправді є, ми повинні подивитися, чому ми хотіли б використовувати саме його, а не вручну введені дані, серіалізацію та перевірку даних самі по собі.
Комунікація з WordPress Core
Settings API забезпечене розробниками платформи WordPress для того, щоб розширити програму було дуже легко. Таким чином, чи не буде розумним використовувати ті функції, що надаються авторами самої платформи?
Звісно, цілком можливо обійти ці функції і "грубою силою" додати власний функціонал, і дійсно ніхто не може це зупинити, але ж це вимагає від нас робити непотрібну роботу, ігнорує рекомендації групи розробників WordPress Core і, в кінцевому рахунку, може змінити користувацький досвід у панелі керування.
Рішення використовувати можливості, що надаються для розробників і від розробників гарантує, що ми будемо спілкуватися з основною програмою належним чином.
Безкоштовні речі "Із Коробки"
Використання Settings API не означає лише впевненість у тому, що ми проводимо розробку через рекомендовані канали. Це також означає впевненість, що наші інтерфейси користувача слідують кращій практиці платформи, і що наші дані дезінфіковано тими самими механізмами, що їх використовують й інші частини WordPress. Хоча, нам не боляче від того, що це може зекономити нам дуже багато часу.
Коли ви починаєте будувати ваші інтерфейси таким чином, що вони використовують існуючі стилі WordPress та Settings API, ваша робота стане виглядати більш тісно інтегрованою з остачею системи.
Це означає, що коли користувачі почнуть користуватися вашою роботою, вони не будуть почуватися так, ніби використовують утиліти сторонніх виробників працюючи зі своїм блогом. Замість цього, вони працюють з покращенням (на відміну від, скажімо, доповнення) основної платформи.
Треба визнати, що використання рідних стилів WordPress не є справжньою частиною Settings API і вищезазначене є свого роду суб'єктивною точкою зору, але різноманітні аспекти Settings API - такі як сторінки меню представлення - використовують рідні стилі WordPress. То чи не є логічним те, що решта вашої роботи повинна слідувати цьому прикладу?
Більш Безпечний, Більш Стійкий
Використовуючи переваги функцій, що є рідними для WordPress, замість використання своїх власних, ви можете бути впевнені, що налаштування збереження, отримання та перевірки управляються належним чином. Врешті-решт, Settings API надає більшість тих можливостей, на які спирається основна програма.
Крім того, Settings API керується тими ж правилами, що й решта API WordPress . Таким чином, коли програма оновлюється та/або внесені якісь зміни, функціям потрібно буде пройти через звичайний процес несхвалення. Це дає вам достатньо часу попрацювати над модернізацією вашого проекту перед тим, як сумісність буде зламано. Це не обов'язково у випадку, якщо ви згортаєте власну функціональність.
Майбутня Дорожня Карта
На даний час ви повинні мати чітке розуміння того, що таке Settings API, і чому ви повинні використовувати його у розробці тем і плагінів.
Звичайно, це все лише аргументи - ми ще не розглядали ніяких практичних прикладів. У решті частин цієї серії ми оглянемо наступне:
- Меню, Розділи і Вкладки Навігації
- Налаштування розділів реєстрації
- Примітивні елементи (поля вводу, текстові поля, розкривні списки, радіо кнопки, прапорці)
- Простий, працюючий приклад
До кінця серії ви повинні мати все необхідне для того, щоб почати створення впевнених, основаних на WordPress продуктів.
