Knowband Blog | Ecommerce Modules

Como adicionar configuração para plugin personalizado no menu de configuração do WordPress?


Objetivo do blog:

O objetivo deste blog é ajudar você a saber como é criada a configuração de qualquer plugin personalizado. Atualmente, a maioria dos plugins contém configurações para permitir que os usuários alterem a funcionalidade do plugin de acordo com sua escolha.


Neste blog, estamos criando o plugin personalizado para sua referência. Os requisitos básicos para adicionar a configuração do plugin são:

Etapas para adicionar a configuração do plug-in:

1.�Crie sua pasta de plugins personalizada dentro da pasta “plugins” do seu site Woo Commerce. No código de exemplo, criamos uma pasta “custom-plugin”.

2.�Crie um novo arquivo PHP dentro da pasta “custom-plugin”. O nome do arquivo deve ser o mesmo da pasta do plugin personalizado. No código de exemplo, criamos um arquivo “custom-plugin.php”.

3.�Você precisa registrar as configurações de cada campo do seu plugin personalizado. Esta etapa lista as opções de configuração do plug-in (campos) que são usadas para salvar os dados de configuração do plug-in na tabela wp_options. Aqui, registrei a configuração do meu plug-in personalizado conforme mostrado abaixo e adicionei esse código ao arquivo “custom-plugin.php”.

/* * Nome do Plugin: Plugin Customizado * Descrição: Este plugin é o plugin customizado e criado por velsof * Versão : 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 saber mais sobre “register_setting” você pode verificar o documento “https://developer.wordpress.org/reference/functions/register_setting/

4. Nesta etapa, você precisa criar a página de opções para seu plugin personalizado e adicionar a opção no submenu da configuração do Word Press. No código de exemplo, escrevemos o código da página de opções abaixo e adicionamos o mesmo ao arquivo “custom-plugin.php”.

function custom_plugin_setting_page() { // add_options_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '' ) add_options_page('Custom Plugin', 'Custom Plugin Setting', 'manage_options', ' custom-plugin-setting-url', 'custom_page_html_form'); // custom_page_html_form é a função na qual escrevi o HTML para meu formulário de plugin personalizado. } add_action('admin_menu', 'custom_plugin_setting_page');

Após concluir esta etapa, você poderá ver a opção do seu plugin personalizado na configuração do Word press, conforme mostrado na imagem abaixo:

5. Nesta etapa, você precisa criar o formulário para exibir as opções (campos) na página de configuração do plugin personalizado. Aqui, criei uma função “custom_page_html_form” conforme mostrado abaixo e adicionei a mesma ao arquivo “custom-plugin.php”.

function custom_page_html_form() { ?> Cabeçalho de página de configuração de plug-in personalizado  Nome do primeiro campo: "> Nome do segundo campo: "> Nome do terceiro campo: ">

Após concluir esta etapa o formulário do seu plugin personalizado será criado e os dados serão salvos no banco de dados ao clicar no botão “Salvar alterações” conforme mostrado abaixo:

Observação: �Se você receber o erro “página de opções não encontrada” ao salvar a configuração do plug-in personalizado. Então você precisa seguir os passos abaixo: 1. Abra o arquivo “options.php” (Localização do arquivo: wp\wp-admin\options.php). 2.Adicione o grupo de opções de plugin personalizado no array $whitelist_options.

Exemplo:

$whitelist_options['custom_plugin_options_group'] = array('first_field_name', 'second_field_name', 'third_field_name');

Você pode baixar o código de exemplo�aqui.

Resumo

Depois de ler este documento, você poderá adicionar a configuração do seu plugin personalizado no menu de configurações do WordPress.