WordPress

Inscreva-se em nosso canal no Youtube Daviwp

Como exigir a instalação de plugins necessários para o tema

03/05/2015 WordPress (0) comentário

Neste tutorial vamos aprender como exigir a instalação de plugins necessários para o tema WordPress.

Na criação ou customização de um tema WordPress, você poderá utilizar essa função para exibir uma mensagem no painel administrativo para forçar a instalação de determinados plugins essenciais ou recomendados para uma boa gestão do tema. A mensagem será exibida já contendo os links para instalar e ativar os plugins.

É possível escolher a fonte de onde vem o plugin, se é do diretório oficial (web), diretório privado (web) ou linkar para uma pasta em que o plugin está localizado no tema. Com isso fica mais fácil a gestão de plugins. Uma das melhores formas e mais utilizadas é linkar para o diretório oficial do WordPress, pois o plugin sempre estará atualizado.

Se você é igual eu que sempre instala determinados plugins para uma boa gestão do seu tema, esta função irá ajudar e muito. Também é ótima para os que vende temas, por exemplo no Themeforest. Uma das exigências é que o Tema tenha uma boa documentação e uma boa experiência para o usuário.

Exibir Mensagens Plugin Recomendado

Basicamente iremos precisar de fazer três coisas:

Parte 1 – Baixar os arquivos necessários para a função

Você vai precisar de baixar dois arquivos para configurar as funções. Clique aqui para baixar.

Assim que baixar, crie dentro da pasta do tema uma pasta com o nome de “tgm” extraia os dois arquivos que são:

class-tgm-plugin-activation.php e plugins-list.php e copie os arquivos para a pasta “tgm”.

Parte 2 – Editando o arquivo baixado com os plugins que eu preciso

Abra o arquivo de nome “plugins-list.php”, este é o arquivo que você precisa editar e inserir os plugins para serem exigidos juntos com a instalação do tema.

Neste exemplo, vamos inserir 3 plugins do diretório oficial do WordPres para serem exigidos na instalação do tema:

  • WordPress SEO by Yoast (Plugin de SEO)
  • W3 Total Cache (Plugin de Cache)
  • Wordfence Security (Plugin para melhorar a segurança do WP)

Como informado anteriormente, existem mais duas fontes de chamar os plugins, que são: diretório privado ou linkando para uma pasta dentro do tema. Estes não iremos abordar, más no arquivo “plugins-list.php” eles aparecem comentados, é simples sua manipulação.

Vá até a linha em que existe a função:
“function my_theme_register_required_plugins()” 
depois do “$plugins = array” você encontrará os três exemplos dos plugins mencionados acima, que estão envolvidos dentro de uma “array”.

Você pode editar essa linha de código por exemplo e chamar os plugins que quiser que estão no diretório oficial do WordPress:

       array(
           'name'      => 'WordPress SEO by Yoast',
           'slug'      => 'wordpress-seo',
           'required'  => false,
       ),

Em ‘name’      => ‘WordPress SEO by Yoast’,  você irá trocar este nome pelo “Nome original do plugin” exatamente como está no diretório oficial. Altere o texto em que está

‘WordPress SEO by Yoast’ o que estiver dentro de aspas simples.

Como Exigir A Instalação De Plugins

Estamos utilizando o plugin All In One SEO Pack para exemplificar

Em nosso exemplo ficaria assim:

       array(
           'name'      => 'All in One SEO Pack',
           'slug'      => 'wordpress-seo',
           'required'  => false,
       ),

Próximo passo, alterar o “slug” do plugin. É bem simples, veja na URL do plugin:

https://wordpress.org/plugins/all-in-one-seo-pack/  é só copiar o texto da forma que está após plugins:

Nome Slug Plugin

Em nosso próximo exemplo ficaria assim:

       array(
           'name'      => 'All in One SEO Pack',
           'slug'      => 'all-in-one-seo-pack',
           'required'  => false,
       ),

Lembre-se, copie sem as barras.

Em  ‘required’  deixe como false, mesmo.

Se precisar de mais plugins é só copiar este trecho de código e repetir o mesmo procedimento para cada plugin que você precisar.

Parte 3 – Editando o arquivo functions.php

Abra o arquivo “functions.php” do seu tema e inclua o código:

/*-----------------------------------------------------------------------------------*/
/* Este código chama os arquivos que exigem a instalação dos plugins necessários para o tema.
/*-----------------------------------------------------------------------------------*/
require_once( get_template_directory() . '/tgm/class-tgm-plugin-activation.php' );
require_once( get_template_directory() . '/tgm/plugins-list.php' );

Este código fará com que estes dois arquivos sejam ativados no tema.

Repare que eles estão na pasta chamada “tgm”

Editando Arquivo Functions

Veja abaixo algumas telas da função:

Tela 001

Tela 002

Tela 003

Tela 004

Tela 005

A documentação oficial utilizada para executar as funções pode ser acessado neste link:

https://github.com/thomasgriffin/TGM-Plugin-Activation

Função criada por  Thomas Griffin

Espero que tenham gostado deste tutorial, qualquer dúvida é só comentar.

Até a próxima.

André Páscoa

André Páscoa, fundador da Resultados Na Web, uma iniciativa que veio para ajudar empreendedores que atuam na internet. É apaixonado por Marketing Digital, SEO, Design e Empreendedorismo.