Стратегія ініціалізації налаштувань плагіна
Щоразу, коли ви працюєте над плагіном, який пропонує сторінку для своїх налаштувань, є кілька способів збереження та отримання інформації.
Ти можеш:
- використовувати API налаштувань ,
- використовувати спеціальну сторінку та дзвінки, які є гібридом двох,
- використовувати певний тип гібриду між сторінкою підменю (або сторінкою меню) та іншими функціями.
Чим більше я працював з WordPress, тим менше і менше я переймаюся використанням API налаштувань і вибираю трохи гібридний підхід.
Залежно від вимог проекту реалізація буде різною; однак я намагаюся використовувати відносно послідовний спосіб створення функціональності.
І хоча ця публікація не буде розповідати про різні способи створення моїх сторінок, пов’язаних класів тощо, вона запропонує один із способів ініціалізації налаштувань плагіна під час роботи над вашим проектом або проектом для когось іншого.
Ініціалізація налаштувань плагіна
Для цієї публікації припустимо, що вимоги передбачають збереження значень сторінки як асоціативного масиву, який дезінфікується та серіалізується в плагіні.
Крім функцій дезінфекції, які вам знадобляться, ви також знаєте, що працюватимете з:
- таблиця параметрів,
- і, як такий, унікальний ключ для параметрів, що зберігаються в таблиці параметрів
У контексті об’єктно-орієнтованого програмування я зазвичай маю кілька класів, налаштованих для роботи з усією цією функціональністю, але я в першу чергу стурбований тим, щоб показати спосіб ініціалізації налаштувань плагіна.
Але чому?
Якщо ви завантажуєте сторінку, яка призначена для отримання параметрів із бази даних, а значення не ініціалізовано, ви побачите попередження на екрані або щось з’явиться у файлі журналу налагодження.
Усе залежить від того, як у вас налаштована локальна інсталяція, а також від того, як визначено конфігурацію вашого хоста.
Незважаючи на це, ви хочете переконатися, що ви ініціалізували параметри плагіна, щоб у вас принаймні був набір рядків у базі даних і початкові значення або порожні значення, встановлені для плагіна.
Як це зробити
Як згадувалося раніше, оскільки я прихильник використання класів у своїй роботі, я зазвичай встановлюю клас, який відповідає за читання та запис значень до бази даних. І це включає ініціалізацію налаштувань плагіна.
Для цього я зазвичай працюю за такою процедурою:
- ініціалізувати клас,
- перевірте, чи існує опція в базі даних,
- якщо ні, то ініціалізуйте його,
- якщо так, то нічого не робіть.
Початковий код для цього може виглядати приблизно так :
Але оскільки це власна функція, її можна викликати в конструкторі вашого класу, або ви можете позначити її як публічну та викликати поза класом. Однак для цієї публікації я розміщую виклик для цього в конструкторі :
Після ініціалізації значень можна встановити атрибут класу :
Хоча є аргументи, що це не слід робити в конструкторі, мені подобається мати властивості класу, ініціалізовані в конструкторі згаданого класу.
А оскільки клас відповідає за підтримку посилання на налаштування, то має сенс ініціалізувати налаштування тут.