MyBB-Es.com - Soporte para los Foros MyBB en Español » Recursos para MyBB » Plugins Premium » Edson Ordaz v » [Tutorial] Crear un plugin básico para MyBB

Enviar respuesta 
[Tutorial] Crear un plugin básico para MyBB
Ausente Edson Ordaz
Mensaje: #1
[Tutorial] Crear un plugin básico para MyBB
Developer!
*******
Administradores

Avatar de Edson Ordaz

Info del foro de este user
Mensajes: 1,695
Registro en: Oct 2009
Reputación: 410

El objetivo de este tutorial es mostrarte, en simple pasos, como se crea un plugin para MyBB. Este plugin es bastante simple, ya que no utiliza todas las funciones básicas del sistema.
Solamente sirve de ejemplo para que puedas encontrar el camino correcto en esto.
La mejor manera de aprender a desarrollar un plugin es saber como funcionan otros. Personalmente te recomiendo investigar y modificar el plugin hello.php (que ya viene incluido en MyBB), aunque cualquier plugin simple servirá.

También.... hay que tener algo bien en claro: Qué es un plugin?

Definición de Plugin: escribió:Los plugins son básicamente funciones en PHP que son ejecutadas en ciertos puntos a lo largo de la ejecución de MyBB.
Estos "ciertos puntos" -llamados hooks- estan ubicados sobre la mayor parte de archivos de MyBB (Ver lista completa).

Un plugin normalmente realiza dos cosas:
  • Enlaza funciones a determinados hooks
  • Edita los templates del theme para editar el "Look & Feel" del diseño.

Que son los templates? escribió:Los templates son pequeñas porciones de código HTML pero que pueden incluir variables (PHP). Puedes ver todos los templates existentes en:
Panel de Administración -> Plantillas y Estilos -> Plantillas -> Templates Predeterminados
*Extraido de la wiki de MyBB.



Los requisitos para poder desarrollar un plugin son:
  • Conocimientos medios de PHP y HTML.
  • Un editor de texto (Que no sea el bloc de notas. El Notepad++ sirve).
  • Ganas y mucha paciencia.


La función de nuestro futuro plugin será mostrar un mensaje a los invitados incitando a que se registren.
Como no se me ocurre ningún nombre decente, este plugin se llamará "registrate_loco".



Primer paso: Información del Plugin
Creamos un archivo llamado "registrate_loco.php" en la carpeta inc/plugins de MyBB con el siguente contenido:
Código PHP:
<?php

if(!defined("IN_MYBB"))
{
    die("Direct initialization of this file is not allowed.<br /><br />Please make sure IN_MYBB is defined.");
}

function registrate_loco_info()
{
    return array(
                "name" => "Registrate loco",
                "description" => "Muestra un mensaje a los usuarios no identificados invitando a que se registren o se identifiquen.",
                "website" => "",
                "author" => "Santiago Dimattia",
                "authorsite" => "http://www.teleportz.com.ar",
                "version" => "1.0",
                "guid" => "",
                "compatibility" => "16*"
            );
}

?>


Como pueden ver, lo primero que hace el archivo es comprobar si la constante IN_MYBB existe. Si no existe, paramos la ejecución del archivo mostrando un lindo mensaje (Ya que esto significa que se intenta acceder al archivo directamente o desde una aplicación externa. Cuestiones de seguridad).

Luego creamos una funcion con el nombre "registrate_loco_info". Recordar que esta función debe contener el nombre del archivo php agregando un "_info" al final.

Esta función le da a MyBB todos los datos del plugin, las cuales son:
  • name: El nombre del plugin.
  • description: Una descripción del plugin.
  • website: El sitio oficial del plugin (Generalmente es la dirección del plugin en la sección de mods de MyBB, aunque puede ser otra o inexistente, como en este plugin).
  • author: El nombre del autor.
  • authorsite: El sitio web del autor.
  • version: La version del plugin. Ejemplos: 0.5, 0.5.9, 1.0 o 2.6.1.
  • guid: Un ID unico para el plugin que MyBB utiliza para comprobar si existen nuevas versiones disponibles (Este ID te lo genera la sección de Mods de MyBB cuando añades el plugin).
  • compatibility: Lista de versiones de MyBB compatibles con este plugin, separadas por coma. Soporta asteriscos. Ejemplos: 14*, 16*, 14*,16*.

Una buena práctica de desarrollo es agregar el nombre del plugin delante de TODAS las funciones, para así evitar errores de compatibilidad con otros plugins que usen la misma función.




Primer paso: Segunda parte (?)

Ademas de la función de información, también se encuentran las siguientes:
  • registrate_loco_install: Ejecutada al instalar el plugin desde el panel de administración. Ideal para realizar cambios en la base de datos.
  • registrate_loco_is_installed: Ejecutada cuando se accede a la administración de plugins. Debe devolver TRUE si el plugin se encuentra instalado o FALSE si no lo está (Generalmente esto se averigua consultando a la base de datos por si existe una tabla o un campo en especial).
  • registrate_loco_uninstall: Ejecutada al desinstalar el plugin desde el panel de administración.
  • registrate_loco_activate: Ejecutada al activar el plugin desde el panel de administración. Ideal para realizar cambios en los templates, en la traducción, etc.
  • registrate_loco_deactivate: Ejecutada al desactivar el plugin desde el panel de administración.

Nota:
  • Recordar que estas funciones, al igual que la de información, debe contener el nombre del archivo PHP seguido de la acción correspondiente.
  • La rutina de instalación no es obligatoria. Si no deseas usarla, simplemente no crees las siguientes funciones: xxx_install, xxx_is_installed, xxx_uninstall.





Segundo paso: Rutina de activación


Debido a que este plugin es muy básico, solamente usara las funciones que se ejecutan al activar y desactivar el plugin.

Lo que haremos en la activación es lo siguiente:
  • Crear un nuevo set de configuraciones para el plugin
  • Crear dos nuevas configuraciones: Una para activar/desactivar el plugin y otra para modificar el texto que se mostrará.
  • Actualizar el template "header" agregando una variable extra, la cual contendrá el aviso.


Empezemos. Creamos el grupo de opciones:
Código PHP:
<?php

function registrate_loco_activate()
{
    // Creamos el grupo de opciones
    $query = $db->simple_select("settinggroups", "COUNT(*) as rows");
    $rows = $db->fetch_field($query, "rows");

    $new_groupconfig = array(
        'name' => 'registrate_logo', 
        'title' => 'Registrate loco',
        'description' => 'Opciones para cambiar el texto del aviso o activar y desactivar el plugin.',
        'disporder' => $rows+1,
        'isdefault' => 0
    );

    return true;
}

?>

Y luego las dos opciones correspondientes:

Código PHP:
<?php

function registrate_loco_activate()
{
    // Creamos las opciones
    $new_config = array();
        
    $new_config[] = array(
        'name' => 'registrate_loco_active',
        'title' => 'Activar plugin',
        'description' => 'Selecciona si deseas activar el plugin.',
        'optionscode' => 'yesno',
        'value' => '1',
        'disporder' => 10,
        'gid' => $group['gid']
    );

    $new_config[] = array(
        'name' => 'registrate_loco_texto',
        'title' => 'Texto del aviso',
        'description' => 'Cambia el texto del aviso',
        'optionscode' => 'textarea',
        'value' => '<a href="member.php?action=register">Registate</a> ahora para poder participar del concurso de una vaca y poder postear en los foros! (Si! Una vaca!)',
        'disporder' => 10,
        'gid' => $group['gid']
    );
    
    foreach($new_config as $array => $content)
    {
        $db->insert_query("settings", $content);
    }
    
    return TRUE;
}

?>




Segundo paso, segunda parte: Rutina de activación - Modificando el template

Ahora debemos actualizar el template para añadir la variable que contendrá el aviso.

Para modificar los templates deberemos incluir el archivo inc/adminfunctions_templates.php y utilizar una función llamada find_replace_templatesets.

Dicha función acepta 3 parámetros:
  • El nombre del template a modificar.
  • Expresion regular (Lo que será reemplazado).
  • El contenido por lo que se le debe reemplazar.

Realizamos el cambio:
Código PHP:
<?php

function registrate_loco_activate()
{
    // Editamos el template "header"
    require MYBB_ROOT."/inc/adminfunctions_templates.php";
    find_replace_templatesets('header', '#{\$unreadreports}#', '{$unreadreports}<!-- RegistrateLoco -->{$alerta_para_invitados}<!-- /RegistrateLoco -->');
    
    return TRUE;
}

?>


Bien! Ya terminamos esta parte. La función completa quedaría así.

Código PHP:
<?php

function registrate_loco_activate()
{
    // Creamos el grupo de opciones
    $query = $db->simple_select("settinggroups", "COUNT(*) as rows");
    $rows = $db->fetch_field($query, "rows");

    $new_groupconfig = array(
        'name' => 'registrate_logo', 
        'title' => 'Registrate loco',
        'description' => 'Opciones para cambiar el texto del aviso o activar y desactivar el plugin.',
        'disporder' => $rows+1,
        'isdefault' => 0
    );

    // Creamos las opciones
    $new_config = array();
        
    $new_config[] = array(
        'name' => 'registrate_loco_active',
        'title' => 'Activar plugin',
        'description' => 'Selecciona si deseas activar el plugin.',
        'optionscode' => 'yesno',
        'value' => '1',
        'disporder' => 10,
        'gid' => $group['gid']
    );

    $new_config[] = array(
        'name' => 'registrate_loco_texto',
        'title' => 'Texto del aviso',
        'description' => 'Cambia el texto del aviso',
        'optionscode' => 'textarea',
        'value' => '<a href="member.php?action=register">Registate</a> ahora para poder participar del concurso de una vaca y poder postear en los foros! (Si! Una vaca!)',
        'disporder' => 10,
        'gid' => $group['gid']
    );
    
    foreach($new_config as $array => $content)
    {
        $db->insert_query("settings", $content);
    }

    // Editamos el template "header"
    require MYBB_ROOT."/inc/adminfunctions_templates.php";
    find_replace_templatesets('header', '#{\$unreadreports}#', '{$unreadreports}<!-- RegistrateLoco -->{$alerta_para_invitados}<!-- /RegistrateLoco -->');
    
    return TRUE;
}

?>

Notese que agregué 2 cositas:

Código:
// Para poder acceder a la base de datos:
global $db;

Devuelvo true (medio inútil... si)
return TRUE;




Tercer paso: Rutina de desactivación

Con un poco de ingeniería inversa, deshacemos los cambios realizados en la activación:

Código PHP:
<?php

function registrate_loco_deactivate()
{
    global $db;
    
    // Borrar el grupo de opciones
    $query = $db->simple_select("settinggroups", "gid", "name = \"registrate_loco\"");
    $rows = $db->fetch_field($query, "gid");

    $db->delete_query("settinggroups", "gid = {$rows}");
    
    // Borrar las opciones
    $db->delete_query("settings", "gid = {$rows}");

    rebuild_settings();
    
    // Editar el template header
    require MYBB_ROOT."/inc/adminfunctions_templates.php";
    find_replace_templatesets('header', '#' . preg_quote('<!-- RegistrateLoco -->{$alerta_para_invitados}<!-- /RegistrateLoco -->') . '#', '');
    
    return TRUE;
}

?>



Cuarto paso: Definir el mensaje para los invitados

Ahora solo nos queda definir la variable $alerta_para_invitados (La cual se encuentra en el template) para que muestre nuestro aviso.

Para realizar esto crearemos una función y la enlazaremos al hook "global_start". Este hook, como su nombre lo indica, se ejecuta justo antes de cargar el archivo global.php.

Dentro de esta función lo que haremos primero será comprobar si el usuario se encuentra identificado o no.
Si se encuentra identificado, no haremos nada, simplemente definiremos la variable como "nada".
En cambio, si se encuentra sin identificar, definiremos la variable con el contenido de la opción que creamos anteriormente.

Código PHP:
<?php

// Enlazamos la función al hook. Esta funcion acepta varios parámetros, pero solo estos dos son requeridos:
// 1) El nombre del hook
// 2) El nombre de la función
$plugins->add_hook('global_start', 'registrate_loco_mostrar_aviso');

function registrate_loco_mostrar_aviso()
{
    global $mybb, $alerta_para_invitados;
    
    // Si el plugin se encuentra desactivado, no hacemos nada.
    if($mybb->settings['registrate_loco_active'] == '0')
    {
        return FALSE;
    }
    
    // Comprobamos si el usuario esta logueado
    if($mybb->user['uid'] != 0)
    {
        // Si el uid del usuario es indistinto a cero, el usuario se encuentra identificado
        $alerta_para_invitados = '';
    }
    else
    {
        // Si el uid es igual a 0, el usuario no se encuentra identificado
        $alerta_para_invitados = $mybb->settings['registrate_loco_texto'];
    }
}

?>


Y con esto terminamos el plugin!
Juntando todos los pedazos de código que hemos hecho, el archivo registrate_loco.php quedaría de esta manera:

Código PHP:
<?php

if(!defined("IN_MYBB"))
{
    die("Direct initialization of this file is not allowed.<br /><br />Please make sure IN_MYBB is defined.");
}

$plugins->add_hook('global_start', 'registrate_loco_mostrar_aviso');

function registrate_loco_info()
{
    return array(
                "name" => "Registrate loco",
                "description" => "Muestra un mensaje a los usuarios no identificados invitando a que se registren o se identifiquen.",
                "website" => "",
                "author" => "Santiago Dimattia",
                "authorsite" => "http://www.teleportz.com.ar",
                "version" => "1.0",
                "guid" => "",
                "compatibility" => "16*"
            );
}

function registrate_loco_activate()
{
    global $db;
    
    // Crear el grupo de opciones
    $query = $db->simple_select("settinggroups", "COUNT(*) as rows");
    $rows = $db->fetch_field($query, "rows");

    $new_groupconfig = array(
        'name' => 'registrate_logo', 
        'title' => 'Registrate loco',
        'description' => 'Opciones para cambiar el texto del aviso o activar y desactivar el plugin.',
        'disporder' => $rows+1,
        'isdefault' => 0
    );
    
    $group['gid'] = $db->insert_query("settinggroups", $new_groupconfig);
    
    // Crear las opciones
    $new_config = array();
        
    $new_config[] = array(
        'name' => 'registrate_loco_active',
        'title' => 'Activar plugin',
        'description' => 'Selecciona si deseas activar el plugin.',
        'optionscode' => 'yesno',
        'value' => '1',
        'disporder' => 10,
        'gid' => $group['gid']
    );

    $new_config[] = array(
        'name' => 'registrate_loco_texto',
        'title' => 'Texto del aviso',
        'description' => 'Cambia el texto del aviso',
        'optionscode' => 'textarea',
        'value' => '<a href="member.php?action=register">Registate</a> ahora para poder participar del concurso de una vaca y poder postear en los foros! (Si! Una vaca!)',
        'disporder' => 10,
        'gid' => $group['gid']
    );
    
    foreach($new_config as $array => $content)
    {
        $db->insert_query("settings", $content);
    }
    
    rebuild_settings();
    
    // Editar el template header
    require MYBB_ROOT."/inc/adminfunctions_templates.php";
    find_replace_templatesets('header', '#{\$unreadreports}#', '{$unreadreports}<!-- RegistrateLoco -->{$alerta_para_invitados}<!-- /RegistrateLoco -->');
    
    return TRUE;
}

function registrate_loco_deactivate()
{
    global $db;
    
    // Borrar el grupo de opciones
    $query = $db->simple_select("settinggroups", "gid", "name = \"registrate_loco\"");
    $rows = $db->fetch_field($query, "gid");

    $db->delete_query("settinggroups", "gid = {$rows}");
    
    // Borrar las opciones
    $db->delete_query("settings", "gid = {$rows}");

    rebuild_settings();
    
    // Editar el template header
    require MYBB_ROOT."/inc/adminfunctions_templates.php";
    find_replace_templatesets('header', '#{\$unreadreports}#', '{$unreadreports}<!-- RegistrateLoco -->{$alerta_para_invitados}<!-- /RegistrateLoco -->');
    
    return TRUE;
}

function registrate_loco_mostrar_aviso()
{
    global $mybb, $alerta_para_invitados;
    
    // Si el plugin se encuentra desactivado, no hacemos nada.
    if($mybb->settings['registrate_loco_active'] == '0')
    {
        return FALSE;
    }
    
    // Comprobamos si el usuario esta logueado
    if($mybb->user['uid'] != 0)
    {
        // Si el uid del usuario es indistinto a cero, el usuario se encuentra identificado
        $alerta_para_invitados = '';
    }
    else
    {
        // Si el uid es igual a 0, el usuario no se encuentra identificado
        $alerta_para_invitados = $mybb->settings['registrate_loco_texto'];
    }
}

?>

Creditos: Santiago - MyBBHispano

Se crean plugins privados.... CLICK AQUI
05-03-2011 10:26 PM
Encuentra todos sus mensajes Responder
Publicidad
*******
Sin conexión Cluster
Mensaje: #2
RE: [Tutorial] Crear un plugin básico para MyBB
Administrador
*******
Administradores

Avatar de Cluster

Info del foro de este user
Mensajes: 4,308
Registro en: Feb 2009
Reputación: 236

sin duda un tutorial muy completo y va para importantes


El dolor es inevitable, el sufrimiento es opcional. Thumbsup
05-03-2011 11:16 PM
Visita su sitio web Encuentra todos sus mensajes Responder
Ausente Ignnacio
Mensaje: #3
RE: [Tutorial] Crear un plugin básico para MyBB
CounterStrike PRO!
******

Avatar de Ignnacio

Info del foro de este user
Mensajes: 1,242
Registro en: Jan 2009
Reputación: 59

Completo, gracias edson me pondré a ver php y después seguiré esto.
Yo ya iba a subirlo a importantes pero solstice se adelanto xD.

De vuelta a Mybb-Es.
05-03-2011 11:24 PM
Visita su sitio web Encuentra todos sus mensajes Responder
Sin conexión DarkEternity
Mensaje: #4
RE: [Tutorial] Crear un plugin básico para MyBB
Miembro Avanzado
****

Avatar de DarkEternity

Mensajes: 75
Registro en: Aug 2008
Reputación: 1

muchas gracias por el aporte personalmente me gusta mucho este tipo de foro y ayudar en todo lo que se pueda gracias

No Hay preguntas Estupidas Sino Estupidos que Preguntan
07-03-2011 01:06 PM
Encuentra todos sus mensajes Responder
Sin conexión DARKNESSDH
Mensaje: #5
RE: [Tutorial] Crear un plugin básico para MyBB
Real G4 Life II
******
Super Moderadores

Avatar de DARKNESSDH

Info del foro de este user
Mensajes: 2,144
Registro en: Feb 2009
Reputación: 71

Tengo varias preguntas

Que sirve esto
Código PHP:
$rows = $db->fetch_field($query, "rows"); 

en especial el fetch_field

luego creando las opciones pusiste

Código PHP:
$new_config = array(); 
y despues
Código PHP:
$new_config[] = array( 
Dos veces

para que sirve hacer eso?

ahora en esta parte
Código PHP:
foreach($new_config as $array => $content) 

que funcion tiene foreach?

porque no simplemente pusiste

Código PHP:
$db->insert_query("settings", $new_config); 

el new_config

Bueno esos son los puntos que a simple vista no entendi..

Gx-Reloaded Blog - Programas E Informacion Gratuita
DARKNESSDH

Si no cumples las reglas se cerrara tu Tema Leelas
16-05-2011 11:56 PM
Visita su sitio web Encuentra todos sus mensajes Responder
Ausente Edson Ordaz
Mensaje: #6
RE: [Tutorial] Crear un plugin básico para MyBB
Developer!
*******
Administradores

Avatar de Edson Ordaz

Info del foro de este user
Mensajes: 1,695
Registro en: Oct 2009
Reputación: 410

Fetch_field es un comando que crea MyBB dsde el db_mysql mañana te lo explico bien como funviona exactamente xq ando en el cel...

Los new config son como arreglos y digamos que todo se gusrada en ese el primerones array(); xq llevara varios datos no solo uno.
Y el foreach es como para imprimir todos osea hace que se instalentodos mas o menos sirve como el while!!!

Se crean plugins privados.... CLICK AQUI
17-05-2011 12:02 AM
Encuentra todos sus mensajes Responder
Sin conexión DARKNESSDH
Mensaje: #7
RE: [Tutorial] Crear un plugin básico para MyBB
Real G4 Life II
******
Super Moderadores

Avatar de DARKNESSDH

Info del foro de este user
Mensajes: 2,144
Registro en: Feb 2009
Reputación: 71

aaaa ^^"!

osea el $new_config = array(); se utiliza cuando hay mas de dos grupos por asi decirlo?

y cuando solo hay uno se utilizaria solo el

$new_config[] = array(
aca todo
)

el foreach y el Fetch_field no entendi muy bien mañana me explicas

Gx-Reloaded Blog - Programas E Informacion Gratuita
DARKNESSDH

Si no cumples las reglas se cerrara tu Tema Leelas
17-05-2011 12:06 AM
Visita su sitio web Encuentra todos sus mensajes Responder
Ausente Edson Ordaz
Mensaje: #8
RE: [Tutorial] Crear un plugin básico para MyBB
Developer!
*******
Administradores

Avatar de Edson Ordaz

Info del foro de este user
Mensajes: 1,695
Registro en: Oct 2009
Reputación: 410

Si mañana te explico esos 2 y si asi se usaria para uno solo pero sin el []

Se crean plugins privados.... CLICK AQUI
17-05-2011 12:09 AM
Encuentra todos sus mensajes Responder
Sin conexión Tute_14
Mensaje: #9
RE: [Tutorial] Crear un plugin básico para MyBB
Miembro Avanzado
****

Avatar de Tute_14

Info del foro de este user
Mensajes: 65
Registro en: Oct 2011
Reputación: 1

Lindo, lindo. :3
Después me fijo si lo hago.


19-11-2011 04:53 PM
Encuentra todos sus mensajes Responder
Sin conexión sahashi
Mensaje: #10
RE: [Tutorial] Crear un plugin básico para MyBB
Usuario Vip
*****

Avatar de sahashi

Info del foro de este user
Mensajes: 148
Registro en: Nov 2011
Reputación: 8

Gracias por el tuto pero como podria hacer uno para cambiar el codigo una themplate y agregar css?


14-12-2011 03:26 PM
Visita su sitio web Encuentra todos sus mensajes Responder
« Tema previo | Tema siguiente »
Enviar respuesta 




Usuario(s) navegando en este tema: 1 invitado(s)

MyBB-Es.com
 

MyBB-Es.com es un foro dedicado a brindar soporte a los usuarios de MyBB de habla en español.

Subscribete a la Sindicación RSS y no te pierdas nada de lo que MyBB-Es.com tiene para ti.

Copyright ©
 

Producido por MyBB, © 2002-2012 Equipo de MyBB.com.
Créditos: MyBB-Es.com, © 2008-2012 Equipo de MyBB-Es.com.
MyBB-Es Logo: Volcan Villarica - Chile

Free PageRank Checker

 

MyBB-Es.com te sugiere echar un vistazo a: Comprar ropa por internet, Tarjetas de visita, Juegos de chicas, Servidores, web hosting y dominios, Diseño web Costa Rica, Mundo MyBB.

Hora: 22-05-2012, 10:23 AM