¿Cómo agregar la configuración para el complemento personalizado en el menú de configuración de WordPress?

Objetivo del blog:

El objetivo de este blog es ayudarlo a saber cómo se crea la configuración de cualquier complemento personalizado. Hoy en día, la mayoría de los complementos contienen configuraciones que permiten a los usuarios alterar la funcionalidad del complemento según su elección. En este blog, estamos creando el complemento personalizado para su referencia. Los requisitos básicos para agregar la configuración del complemento son:

  • Para registrar la configuración de un complemento
  • Para crear una página de opciones para un complemento
  • Para mostrar la configuración del complemento en la página de opciones

Pasos para agregar la configuración del complemento:

1.?Create your custom plugin folder inside the “plugins” folder of your Woo Commerce site.
In the sample code, we have created a folder “custom-plugin”.

2.?Create a new PHP file inside your “custom-plugin” folder. The name of the file must be same as custom plugin folder. In the sample code, we have created a file “custom-plugin.php”.

3.?You need to register the settings of each field of your custom plugin. This step whitelist your plugin setting options (fields) that are used to save the plugin setting data in the wp_options table. Here, I have registered the setting for my custom-plugin as shown below and added that code to the “custom-plugin.php” file.

/ * * Nombre del complemento: complemento personalizado * Descripción: Este complemento es el complemento personalizado y creado por velsof * Versión: 1.0.0 * Autor: Velsof * / function custom_plugin_register_settings () {register_setting ('custom_plugin_options_group', 'first_field_name'); register_setting ('custom_plugin_options_group', 'second_field_name'); register_setting ('custom_plugin_options_group', 'third_field_name'); } add_action ('admin_init', 'custom_plugin_register_settings');

Para obtener más información sobre "register_setting", puede consultar el documento "https://developer.wordpress.org/reference/functions/register_setting/

4. En este paso, debe crear la página de opciones para su complemento personalizado y agregar la opción en el submenú de la configuración de Word Press. En el código de muestra, hemos escrito el código de la página de opciones a continuación y lo hemos agregado al archivo "custom-plugin.php".

function custom_plugin_setting_page () {// add_options_page (string $ page_title, string $ menu_title, string $ capacidad, string $ menu_slug, invocable $ function = '') add_options_page ('Custom Plugin', 'Custom Plugin Setting', 'manage_options', ' custom-plugin-setting-url ',' custom_page_html_form '); // custom_page_html_form es la función en la que he escrito el HTML para mi formulario de complemento personalizado. } add_action ('admin_menu', 'custom_plugin_setting_page');

Después de completar este paso, podrá ver la opción de su complemento personalizado en la configuración de Word Press como se muestra en la imagen a continuación:

Agregar configuración para plugin personalizado en el menú de configuración de WordPress

5. En este paso, debe crear el formulario para mostrar las opciones (campos) en la página de configuración del complemento personalizado. Aquí, he creado una función "custom_page_html_form" como se muestra a continuación y agregué la misma al archivo "custom-plugin.php".

function custom_page_html_form () {?> <div class = "wrap"> <h2> Encabezado de página de configuración del complemento personalizado </h2> <form method = "post" action = "options.php"> <? php settings_fields ('custom_plugin_options_group' ); ?> <table class = "form-table"> <tr> <th> <label for = "first_field_id"> Nombre del primer campo: </label> </th> <td> <input type = 'text' class = "regular-text" id = "first_field_id" name = "first_field_name" value = "<? php echo get_option ('first_field_name');?>"> </td> </tr> <tr> <th> <etiqueta para = "second_field_id"> Segundo nombre de campo: </label> </th> <td> <input type = 'text' class = "regular-text" id = "second_field_id" name = "second_field_name" value = "<? php echo get_option ('second_field_name');?> "> </td> </tr> <tr> <th> <label for =" third_field_id "> Tercer nombre de campo: </label> </th> <td> < input type = 'text' class = "regular-text" id = "third_field_id" name = "third_field_name" value = "<? php echo get_option ('third_field_name');?>"> </td> </tr> < / table> <? php submit_button (); ?> </div> <? php}?>

Después de completar este paso, se creará el formulario de su complemento personalizado y los datos se guardarán en la base de datos al hacer clic en el botón "Guardar cambios" como se muestra a continuación:

¿Cómo agregar la configuración para el complemento personalizado en el menú de configuración de WordPress?

Nota:?If you get the error “options page not found” on saving the setting of the custom plugin. Then you need to follow the below steps:

1.Open “options.php” file (File Location: wp\wp-admin\options.php).

2.Add the custom plugin option group in the $whitelist_options array.

Ejemplo:

$ whitelist_options ['custom_plugin_options_group'] = array ('primer_campo_nombre', 'segundo_campo_nombre', 'tercer_campo_nombre');

Puedes descargar el código de muestraaquí.

Resumen

Después de leer este documento, podrá agregar la configuración de su complemento personalizado en el menú de configuración de WordPress.


Shivam Verma

Shivam Verma

Shivam Verma is an experienced software engineer in PHP development and Database design. His area of interest is website development. He likes to be aware of his surroundings and to learn new things by observing others. He believes that by doing this we can learn new things and can also enhance our knowledge everyday. He has started writing technical blogs with a view to help others in studying and learning new things in an easy way.

Leave a Reply

Your email address will not be published. Required fields are marked *