Uma Estratégia para Inicializar as Configurações do Plugin
Sempre que você estiver trabalhando em um plug-in que oferece uma página para suas configurações, existem várias maneiras de salvar e recuperar as informações.
Você pode:
- use a API de configurações ,
- usar uma página personalizada e chamadas que são um híbrido dos dois,
- use algum tipo de híbrido entre uma página de submenu (ou uma página de menu) e outra funcionalidade.
Quanto mais eu trabalho com o WordPress, menos e menos me preocupo em usar a API de Configurações e optar por uma abordagem um pouco híbrida.
Dependendo dos requisitos do projeto, a implementação irá variar; no entanto, tento usar uma maneira relativamente consistente de criar a funcionalidade.
E embora este post não aborde as várias maneiras pelas quais eu crio minhas páginas, classes relacionadas e assim por diante, ele oferecerá uma maneira de inicializar as configurações do plug-in ao trabalhar em seu projeto ou em um projeto para outra pessoa.
Inicializando as configurações do plug-in
Para esta postagem, suponha que os requisitos exigem o armazenamento dos valores de uma página como uma matriz associativa que é higienizada e serializada de dentro do plug-in.
Além da funcionalidade de higienização que você vai precisar, você também sabe que vai trabalhar com:
- a tabela de opções,
- e, como tal, uma chave única para as opções armazenadas na tabela de opções
Agora, no contexto da programação orientada a objetos, normalmente tenho várias classes configuradas para lidar com toda essa funcionalidade, mas estou principalmente preocupado em mostrar uma maneira de inicializar as configurações do plug-in.
Mas por que?
Se você carregar uma página destinada a recuperar opções do banco de dados e os valores não tiverem sido inicializados, você verá avisos na tela ou algo aparecerá no arquivo de log de depuração.
Tudo isso depende de como você configurou sua instalação local e de como seu host tem sua configuração definida.
Independentemente disso, você quer ter certeza de que inicializou as configurações do plug-in para que você tenha pelo menos a linha definida no banco de dados e os valores iniciais ou valores vazios definidos para o plug-in.
Como fazer isso
Como mencionado anteriormente, como sou fã de usar classes no meu trabalho, costumo configurar uma classe que é responsável por ler e gravar valores no banco de dados. E isso inclui inicializar as configurações do plugin.
Para fazer isso, geralmente trabalho usando o seguinte processo:
- inicializar a classe,
- verifique se existe uma opção no banco de dados,
- se não, então inicialize-o,
- se sim, não faça nada.
O código inicial para fazer isso pode ser algo assim :
Mas como isso está em sua própria função, ele pode ser chamado dentro do construtor de sua classe ou você pode marcá-lo como público e chamá-lo fora da classe. Para este post, porém, estou fazendo uma chamada para ele no construtor :
E uma vez que os valores foram inicializados, um atributo na classe pode ser definido :
Embora haja um caso a ser feito de que isso não deve ser feito no construtor, eu gosto de ter propriedades de classe inicializadas dentro do construtor da referida classe.
E como a classe é responsável por manter uma referência às configurações, faz sentido inicializar as configurações aqui.