TGM Plugin Activation la clase para recomendar plugins



TGM Plugin Activation es una sencilla libreria en php que nos va a permitir recomendar plugins en temas o en otros plugins.

Alguna vez habréis visto un tema y al instalarlo te recomienda instalar plugins para que puedas usar todas las funcionalidades que trae, pues esta librería lo hace realidad de una forma muy sencilla.

También te permite si son tus propios plugins, subirlos en el tema y que se los instalen desde alli.

 

Hace mucho tiempo que la descubri y aunque era mas sencilla, ahora esta mucho mejor organizada.

url oficial: http://tgmpluginactivation.com/

 

Pasos para hacerla funcionar :

 

Descargar la librería

Cuando la vais a descargar hay un pequeño formulario que te generara un zip, en el formulario tendréis que indicar si queréis usarla en un tema o en un plugin. En esta demostración vamos a hacerla en un tema.

Nos pedirá que rellenemos 3 opciones:

  • Text Domain:   // para la internacionalización
  • Function Prefix: // para generar los nombres de las funciones
  • Name: // nombre del tema.

Es un poco para que cuando te haga el ejemplo te ponga la nomenclatura de las funciones.

 

tgm-configuracion

Descargando el zip

Ya lo tenemos descargado así que vamos a descomprimirlo.

  • languages ( directorio)  aquí guardan los idiomas
  • plugins ( directorio) , esta carpeta es para poner nuestros propios plugins, los que no estén en el repositorio de WordPress
  • class-tgm-plugin-activation.php   clase principal
  • example.php  un ejemplo que utilizaremos para escribir nuestras dependencias.

 

carpeta-con-ficheros-del-plugin-tgm

 

Instalación en el tema

Nos creamos una carpeta que se llame tgm y no vamos a mover todos los ficheros, solo para esta prueba copiaremos en nuestro tema:

  • class-tgm-plugin-activation.php
  • languages
  • plugins // solo si tenemos plugins nuestros que queramos incluir en el tema.
  • example.php // el ejemplo o podemos crearnos nosotros uno

 

4.- Crear clase base

Podemos usar example.php o crearnos una clase como por ejemplo, vamos a crearnos una clase de ejemplo y la vamos a incluir en el functions.php con require.

 

 

La clase recomendaciones.php

Para crear nuestros recomendados / requeridos , realmente lo que hay que hacer es lo siguiente:

  • requiere_once a la clase principal class-tgm-plugin-activation
  • registrar los plugins

 

Vamos a ver unos ejemplos de como registrar los plugins en diferentes situaciones:

 

Ejemplo para recomendar un plugin del repositorio de WordPress

 

Imaginar que al instalar el tema quereis recomendar varios plugins o que sean obligatorios teneis que declarar

 

Ejemplo para recomendar un plugin de github

 

 

Ejemplo para recomendar un plugin dentro de nuestro tema

 

 

Ejemplo para recomendar un plugin de una url

 

 

 

Resultado final de recomendaciones.php

ejemplo-final-tgm