Add_settings_field() - Създава поле за опции за посочения раздел (посочения блок с настройки)

Създава поле за опции за посочения раздел (посочения блок с настройки).

Тази функция се използва заедно с други функции на API за настройки, които улесняват създаването на страница с настройки на плъгина.

За тази функция трябва вече да са известни параметрите $page (плъгин или администраторска страница) и $section (блок на страницата, където ще се показва полето).

Важно: всяка опция трябва да бъде регистрирана с функцията register_setting() и тази функция отговаря само за добавяне на полето за опция (HTML код) към страницата в правилната секция.

Функцията за обратно извикване (параметър $callback) трябва да изведе полетата на формуляра за въвеждане и да ги попълни със съществуващи данни в базата данни.

Данните се записват автоматично.

Атрибутът име на тага за въвеждане трябва да е равен на параметъра $option_name в register_setting() , а идентификаторът на тага за въвеждане трябва да е равен на параметъра $id. Резултатът трябва незабавно да се покаже на екрана (ехо). Стойността на атрибута value обикновено се попълва с функцията get_option().

Тази функция може да се използва и за добавяне на допълнителни полета за опции към съществуващи страници с настройки на WordPress, като например: медии, четене. Полетата могат да се добавят към съществуващи секции или можете да създадете своя собствена секция с помощта на add_settings_section(), където след това можете да прикачите полето за опции.

се завръща

Не връща нищо.

Използване

Допълнителни параметри, които трябва да бъдат предадени на функцията за обратно извикване. Например в двойката ключ/стойност можем да предадем параметъра $id, който след това използваме за атрибута id на полето за въвеждане, така че когато се щракне върху етикета в крайния изход, фокусът на курсора да попадне в нашето поле.

• етикет_за - Низ. Ако е посочено, заглавието на настройката ще бъде обвито с етикет
• клас - String.CSS клас за добавяне към етикета

По подразбиране: array()

#1. Нека добавим ново поле за опции към главната страница с настройки на WordPress (общи).

myprefix трябва да е уникален, като например някакъв префикс на вашия плъгин или тема. Също така, предайте последния параметър, където посочвамеid иoption name за атрибутите на етикета: id и name:

В резултат на това на страницата "Общи" в самия край ще получим нова напълно работеща опция:

---