Traduccion: ThE KuKa - http://www.phpbb-es.com
Conste que esta guía ha sido "rescatada" de los foros de phpBB2 pero creo que sirve para saber "interpretar" las ordenes que se nos da a la hora de instalar un MOD.
Esto es lo que nos encontramos en el fichero de instalación de un MOD, por ejemplo: install.txtCódigo: Seleccionar todo
##############################################################
## MOD Title: mod_title_goes_here
## MOD Author: your_phpBB_username < your_email > (your_real_name) your_url
## MOD Description: some_description_goes_here
## MOD Version: x.x.x
##
## Installation Level: (Easy/Intermediate/Advanced)
## Installation Time: ~x Minutes
## Files To Edit:
## file_1
## file_2
## file_3, etc
## Included Files: (n/a, or list of included/required files)
##############################################################
Código: Seleccionar todo
##############################################################
## Titulo del MOD: titulo_del_MOD_aqui
## Autor del MOD: su_phpBB_nick < el_email > (su_nombre_real) su_url
## Descripcion del MOD: some_description_goes_here
## Version del MOD: x.x.x
##
## Nivel de Instalacion: (Facil/Intermedio/Avanzado)
## Tiempo de Instalacion: ~x Minutos
## Archivos a Editar:
## archivo_1
## archivo_2
## archivo_3, etc
## Archivos Incluidos: (n/a, o lista de archivos incluidos/requeridos)
##############################################################
Código: Seleccionar todo
##############################################################
## For Security Purposes, Please Check: http://www.phpbb.com/mods/ for the
## latest version of this MOD. Downloading this MOD from other sites could cause malicious code
## to enter into your phpBB Forum. As such, phpBB will not offer support for MOD's not offered
## in our MOD-Database, located at: http://www.phpbb.com/mods/
##############################################################
Código: Seleccionar todo
##############################################################
## Por razones de seguridad, comprueba : http://www.phpbb.com/mods/downloads/ para las
## últimas versiones de este MOD. Descargar este MOD de otros sitios podria facilitar que
## introdujeras código peligroso en tu Foro . Asi como phpBB no ofrecerá soporte para MOD'S
## no ofrecidos en nuestra base de datos, situada en: http://www.phpbb.com/mods/downloads/
##############################################################
Código: Seleccionar todo
##############################################################
## Author Notes:
##
##############################################################
Código: Seleccionar todo
##############################################################
## Notas del Autor:
##
##############################################################
Código: Seleccionar todo
##############################################################
## MOD History:
##
## YYYY-MM-DD - Version x.x.x
## - version notes go here
##
##############################################################
Código: Seleccionar todo
##############################################################
## Historial del MOD:
##
## YYYY-MM-DD - Version x.x.x
## - notas de la version aqui
##
##############################################################
Código: Seleccionar todo
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##############################################################
Código: Seleccionar todo
##############################################################
## Antes de añadir este MOD recuerda hacer una copia de seguridad de todos los archivos relacionados.
##############################################################
Código: Seleccionar todo
##############################################################
## Possible Actions:
##
## SQL
## COPY -> COPIAR
## OPEN -> ABRIR
## FIND -> BUSCAR - ENCONTRAR
## REPLACE WITH -> REEMPLAZAR POR
## AFTER, ADD -> DESPUES, AÑADIR
## BEFORE, ADD -> ANTES, AÑADIR
## IN-LINE FIND -> EN LA LINEA, BUSCAR - ENCONTRAR
## IN-LINE AFTER, ADD -> EN LA LINEA, DESPUES AÑADIR
## IN-LINE BEFORE, ADD -> EN LA LINEA, ANTES, AÑADIR
## IN-LINE REPLACE WITH -> EN LA LINEA, REEMPLAZAR POR
##############################################################
Código: Seleccionar todo
#
#-----[ SQL ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ COPY ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ OPEN ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ FIND ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ REPLACE WITH ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ AFTER, ADD ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ BEFORE, ADD ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ IN-LINE FIND ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ IN-LINE AFTER, ADD ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ IN-LINE BEFORE, ADD ]------------------------------------------
#
Código: Seleccionar todo
#
#-----[ IN-LINE REPLACE WITH ]------------------------------------------
#
SQL - Realizar una declaracion SQL.
COPY - Copiar archivos en la ubicacion en el servidor.
OPEN - Abrir un archivo especifico.
FIND - Buscar / Encuentrar un "pedazo" de codigo dentro del archivo abierto.
REPLACE WITH - Reemplazar un "pedazo" de codigo (lo que "FIND" nos indica) por este codigo.
AFTER, ADD - Despues de un "pedazo" de codigo, añade este "pedazo" de codigo.
BEFORE, ADD - Antes de un "pedazo" de codigo, añade este "pedazo" de codigo.
IN-LINE FIND - Buscar / Encontrar un "pedazo" de codigo dentro de una linea de codigo.
IN-LINE AFTER, ADD - Despues de un "pedazo" de codigo, en la línea de código, añade este "pedazo" de codigo.
IN-LINE BEFORE, ADD - Antes de un "pedazo" de codigo, en la línea de código, añade este "pedazo" de codigo.
IN-LINE REPLACE WITH - El codigo a 'remplazar' por la línea de codigo anterior en 'IN-LINE FIND'
Aqui estan los ejemplos de cada "Accion":
Código: Seleccionar todo
#
#-----[ SQL ]------------------------------------------
#
CREATE TABLE `phpbb_config` (
`config_name` varchar(255) NOT NULL default '',
`config_value` varchar(255) NOT NULL default '',
PRIMARY KEY (`config_name`)
) TYPE=MyISAM;
Código: Seleccionar todo
#
#-----[ COPY ]------------------------------------------
#
copy foo_body.tpl to templates/subSilver/foo_body.tpl
copy foo_body.tpl to templates/subSilver/
copy *.* to templates/subSilver/
Código: Seleccionar todo
#
#-----[ OPEN ]------------------------------------------
#
includes/constants.php
Código: Seleccionar todo
#
#-----[ FIND ]------------------------------------------
#
{L_NEW_POSTS}
FIND es simplemente una manera para que el usuario final sepa exactamente donde va a ocurrir algo mas.
Código: Seleccionar todo
#
#-----[ REPLACE WITH ]------------------------------------------
#
{L_YOUR_VARIABLE}
REPLACE WITH es una manera de substituir lo que "BUSCAMOS / ENCONTRAMOS" con FIND por un nuevo bloque de codigo
Código: Seleccionar todo
#
#-----[ AFTER, ADD ]------------------------------------------
#
&img src="templates/subSilver/images/some_new_image.gif" alt="{L_YOUR_VARIABLE}"/&
AFTER, ADD es una manera de mandar al usuario final, agregar un nuevo bloque de codigo DESPUES de su "BUSQUEDA" con FIND
Código: Seleccionar todo
#
#-----[ BEFORE, ADD ]------------------------------------------
#
&img src="templates/subSilver/images/some_new_image.gif" alt="{L_YOUR_VARIABLE}"/&
BEFORE, ADD es una manera de mandar al usuario final, agregar un nuevo bloque de codigo ANTES de su "BUSQUEDA" con FIND
IN-LINE FIND con esta accion debes buscar/encontrar codigo en una línea de codigo.
Código: Seleccionar todo
#
#-----[ IN-LINE FIND ]------------------------------------------
#
user_from = '" . str_replace("\'", "''", $location) . "',
IN-LINE AFTER, ADD es la manera de agregar directamente codigo, despues de la linea actual de codigo.
Código: Seleccionar todo
#
#
#-----[ IN-LINE AFTER, ADD ]------------------------------------------
#
user_from_flag = '$user_flag',
IN-LINE BEFORE, ADD es la manera de agregar directamente codigo, antes de la linea actual de codigo.
Código: Seleccionar todo
#
#
#-----[ IN-LINE REPLACE WITH ]------------------------------------------
#
user_from_flag = '$user_flag',
Código: Seleccionar todo
user_from = '" . str_replace("\'", "''", $location) . "',
Código: Seleccionar todo
user_from_flag = '$user_flag',
Esto concluye nuestras once (11) "Acciones" a la hora de instalar un MOD.
Finalmente, el verdadero final de un MOD, incluye:
Código: Seleccionar todo
#
#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
# EoM
Código: Seleccionar todo
#
#-----[ GUARDAR/CERRAR TODOS LOS ARCHIVOS ]------------------------------------------
#
# Fin de Modificaciones
Antes de añadir un MOD recuerda hacer una copia de seguridad de todos los archivos relacionados.
phpBB a incluido dos nuevas acciones en las instrucciones de MODs, acciones que intentare explicar aqui.
Código: Seleccionar todo
#-----[ DIY INSTRUCTIONS ]------------------------------------------
Traduccion de DIY ' Do It Yourself ' o 'Hazlo tu mismo' (poco mas o menos).
Estas instrucciones pueden incluir una consulta SQL, modificar el CHMOD de archivos, etc.
Código: Seleccionar todo
#-----[ INCREMENT ]-------------------------------------