Como crear un plugin.

El plugin esta funcionando correctamente, cuando tengo mas de tres temas de soporte por resolver es que me manda un mp avizandome que no puedo crear mas temas y me manda un mensaje sobre esto .

No puedo crear nuevos temas, esta versión es de pruebas aun ya que la final no recuerdo de que ira aún en cuanto me ponga en contacto con Abdon veremos que cosa.,

Primero que nada debemos saber lo básico, que MyBB maneja sus propias funciones y aparte de eso, nosotros debemos respetar la estructura de tus plugins.

1.- El nombre de tu plugin debe ser igual al de las funciones principales de MyBB para ser reconocido, esto es:

miplugin.php -> Nombre de mi plugin.
miplugin_install
miplugin_uninstall
miplugin_activate
miplugin_deactivate
miplugin_is_installed

Las demás puedes llamarlas como desees, las que incluirás en los enganches de MyBB. Aunque es recomendable ponerle nombres alusivos a tu plugin para evitar que haya variables repetidas .

miplugin_funcion1
miplugin_funcion2

En fin, después de esto debemos comenzar con nuestro primer plugin, primero que nada abriremos un archivo con tu editor de textos y comenzaremos a escribir nuestro código.

1.- Seguridad del archivo, para que no sea abierto por accidente y no tengan acceso a el:


2.- Llamado a los enganches a utilizar:


Aqui pondremos el nombre del enganche donde aplicaremos el uso de nuestra nueva funcion . Hay varias formas de manejarlo, como por ejemplo:

Lo cual nos da una prioridad de ejecución y el archivo donde se ejecutará dicha sentencia en ese orden, pero con esto se requiere de mayor seguirdad a la hora de escribir, asi que la primer forma nos va bien .

3.- Escribir la información del plugin que vamos a visualizar nosotros al ir a la zona de Plugins:


La funcion debe llevar como dije el nombre del archivo, seguido del nombre de la función prestablecida de MyBB, estos datos siempre son importantes respetarlos o no te funcionará tu plugin .

Los llamados a las variables globales van primeramente, que son para decidir que vamos a utilizar como objetos de nuestra función , sin embargo por ahora dejo este ejmplo que es como me gusta trabajar a mi, un enlace de configuración directo, y las opciones describiendo mas o menos que hace cada cosa .

Lo segundo es crear el enlace que les digo, aunque no es forzoso, pero a mi me va mejor asi .

tercero es traer el array de datos:

name, es el nombre de tu plugin
description, la descripción alusiva a lo que hace tu plugin .
website, el sitio donde esta instalada la mod.
author, nombre del creador del plugin
authorsite, el sitio web del autor, para localizarlo si es necesario en caso de tener dudas respecto a su plugin.
version, la version actual de tu plugin, la cual es prograsiva respecto a los nuevos cambios que hagas.
guid, la guia que identifica tu plugin de los demás y que permite que tengas un rastreo desde la zona de mods de MyBB, ellos mismos te lo dan cuando envías tu plugin, asi que antes de comprimirlo crealo y antes de que te digan que subas el archivo te darán esta guía para que tu plugin pueda ser puesto ahi y decir en que versión va, si hay updates desde la zona de plugins de MyBB,. etc.
compatibility, Compatibilidad de tu plugin, por defecto puedes poner que para todas las versiones, con un *, pero puedes utilizar versiones expresas, para decir que solo funciona en x version o cantidad de versiones:

Ejemplos:
12* - Funciona en versiones 1.2.x de MyBB
14* - Funciona en versiones 1.4.x de MyBB.
16* - Funciona en versiones 1.6.x de MyBB.
14*, 16* - Funciona en versiones 1.4.x y 1.6.x de MyBB
1214, 1416, 1611 - Funciona solo en las versiones 1.2.14, 1.4.16 y 1.6.11, que por ahora son las finales de cada área .

Y asi sucesivamente, es preferible poner en la lista las versiones donde los hayas probado, aunque se supone que si funciona en la versión mas reciente, debiera funcionar en las previas, según lo que mencionan en el sitio oficial, pero lo mejor es asegurarte de ello .

4.- Cuando instalamos crear las opciones a elegir, o en su caso nuevas tablas o cosas que debamos utilizar, dependiendo de la funcionabilidad del plugin, en este caso no es necesario instalar nada, asi que simplemente creamos las opciones.


Ya intente explicarlas dentro del plugin para evitar problemas, son muy intuitivas cada una de estas opciones y las que son permitidas básicamente por este sistema.

5.- Crear una opción que nos diga si esta instalado el plugin, mediante una consulta sencilla de que si existe la opción x, devuelva true, en caso contrario, devuelva false.


Esta no la he probado aún, pero se supone que asi debe funcionar, casi siempre se comprueba que una tabla creada exista, y asi asegurarnos de que al eliminar pues no este instalado dicho plugin, aunque por ahora es por motivo de pruebas, cada quien puede jugar con estos valores y descubrir como hacerlos funcionar mejor .

6.- Eliminar las cosas que se crearon, en este caso mis opciones de la base de datos .


7.- Creamos las opciones de activar y desactivar, que consisten en lo mismo que las previas de install y uninstall, sin embargo crearemos aqui los cambios en plantillas, podemos hacer mas cosas, como crear hojas de estilo, plantillas, etc. Pero como dije es algo sencillo, asi que simplemente pegamos esto .


Para ahorrarme tiempo las explique detalladas dentro de cada cosa, solo falta decir que randomvar es nuestra variable, podemos ponerle el nombre que queramos, pero igualmente debemos hacerlo en los llamados posteriores .

8.- Por ultimo creamos nuestras funciones y sus respectivos enganches, los cuales pueden ir en cada función o hasta arriba en la lista de funciones, yo prefiero hacerlo asi, ya que con esto identificamos que funciones existen y poder ir a cada una de ellas dependiendo el enganche que este tomando:


Como podemos ver es el nombre de la funcion que coge el enganche que utilizamos y aqui asignamos el valor a nuestra variable randomvar y la declaramos como global para que aparezca, de lo contrario, puede no aparecer en algunas versiones de MyBB, pero mejor que aparezca en todas, declaramos como global y le asignamos los datos del tercer resultado de nuestro plugin que es un cuadro de texto.

Al instalarlo nos aparece el enlace de configuración y mas detalles de cada funcion por los textos asignados y con esto ya tendríamos nuestro primer plugin funcional, pero con esto en la siguiente entrega de tutoriales, veremos como aplicar las opciones expuestas, cada una de las cuatro para que dependiendo una u otra cosa haga algo nuestro plugin, después iremos viendo los estilos, plantillas y mas cosas que son interesantes a la hora de crear plugins tenerlas en cuenta, saludos.

DNT.

Hay un detallito...
Siempre falta lo difícil, hacer las funciones XD
Muy buen tuto, aunque no sé de que va el plugin de ejemplo, es un anuncio supongo, no?

Adiós

Es lo que menciono en el punto 8, ahi creas tu propia función con enganche a la hook donde aparecerá tu contenido, asi mismo el contenido mostrado cogido de las opciones que se encuentran en el plugin, porque asi debe ser y las funciones son algo complejo, pero una ves que le entiendes, es que puedea crear funciones mas complejas.

Estas te sirven para repetir alguna cuestion a detallar, por ejemplo, si yo quisiera que se ejecutara una suma de dos datos al dar un clic, simplemente creo una función que me haga la suma de dos datos y de ahi cojo las variables para esto:

Ejemplo:

Yo me creo un boton con una acción suma:

<a href = "#" onclick="suma($a,$b)">Sumar Datos</a>

Luego de aqui, simplemente agregamos la funcion para esto .

function suma($a, $a){

$a = this->value['primer_dato'];
$b = this->value['segundo_dato'];
$resultado = int_value($a) + int_value($b);

echo "La suma de ".$a." y ".$b." nos da como resultado ".$resultado;
}


Y con esto cada que des clic se va a imprimir en pantalla la suma de datos, asignados previamente o como uno desee . En el ejemplo puse como resultados ficticios de un array a las variables, pero igualmente puedes ponerle los valores que desees o simplemente jugar con las funciones prestablecidas de MyBB o crear las tuyas propias y anidarlas, en fin es un mundo extenso, donde hay que sabe que se toca, yo la verdad sólo la utilizo en ocasiones porque si es algo laborioso .

Sí, el problema es que se tiene que aprender php, luego conocer mybb y ya al final, si eres joven aun para entonces, haces el plugin XD

Aquí dejo la lista de hooks(ganchos) para los plugins de mybb...
Registrate o inicia tu sesión para ver este contenido

Esa lista ya es muy vieja, algunos hooks ya no existen, otros cambiaron de posición y quizá exista alguno que otro nuevo, pero lo que si he visto yo es que cambiaron de posición y unos ya no existen de los de esa lista, hay otros que nisiquiera he probado porque no me he visto en la necesidad .

Pero esa lista como referencia es muy útil .

Es la única ayuda que yo conozco que proporciona mybb.com a los creadores de plugins XD

Adiós

Si lo que queremos es poner una nueva página, simplemente la vamos a agregar a una función de una hook, como misc, index, etc, en mi caso la voy a poner en el indice .

Lo primero es cambiar nuestra hook y nuestra funcion principal únicamente y los resultados deben ser favorables .



Esa hook nos va a tomar una nueva función anidada al archivo index.php, lo cual aprovecharemos para crear una nueva página cuado ingresemos una ruta x.

Por ejemplo:


como lo indico si nosotros vamos al navegador y escribimos una ves activado el plugin y que las condiciones se cumplen la ruta:

Registrate o inicia tu sesión para ver este contenido

Nosotros veremos una nueva página con el contenido del plugin, esto es muy útil ya que podemos trabajar con las variables para mostrar distintos contenidos, los cuales iremos viendo poco a poco .

Siempre he querido hacer plugins , tengo conocimientos de PHP pero no a un nivel avanzado, creo que para el desarrollo de plugins entra PHP orientado a objetos. Siguiendo un tutorial paso a paso creo que cualquiera podría crear un plugin simple, pero me pregunto cómo es que se hacen plugins más complejos como el Sistema de Agradecimientos o el MyAlerts, que son plugins que tienen que tener conexión con la base de datos. Otra de mis preocupaciones es... cuándo saber que un plugin no te deja la base de datos vulnerable a inyeccionese SQL??

Creo que primero voy a intentar crear un theme para MyBB y luego pasaré a intentar hacer mis primeros plugins, ojalá sea en este año, como dijo angeluz, "y ya, si aun eres joven, creas plugins" DD