MOD Template - Tutorial Traducido

ThE KuKa · #1

Tema basado en el MOD Template - Tutorial de AbelaJohnB

Traduccion: ThE KuKa - http://www.phpbb-es.com

Esto es lo que nos encontramos en el fichero de instalacion de un MOD, por ejemplo: install.txt

Có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) 
##############################################################

Esta seria la traduccion:

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) 
##############################################################

Despues vemos esto:

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/ 
##############################################################

Su traduccion mas o menos seria esta:

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/ 
##############################################################

Despues vemos esto:

Código: Seleccionar todo

############################################################## 
## Author Notes: 
## 
##############################################################

Traduccion:

Código: Seleccionar todo

############################################################## 
## Notas del Autor: 
## 
##############################################################

Veremos esto:

Código: Seleccionar todo

############################################################## 
## MOD History: 
## 
##   YYYY-MM-DD - Version x.x.x 
##      - version notes go here 
## 
##############################################################

Traduccion:

Código: Seleccionar todo

############################################################## 
## Historial del MOD: 
## 
##   YYYY-MM-DD - Version x.x.x 
##      - notas de la version aqui 
## 
##############################################################

Ahora vemos esto:

Código: Seleccionar todo

############################################################## 
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD 
##############################################################

Traduccion:

Código: Seleccionar todo

############################################################## 
## Antes de añadir este MOD recuerda hacer una copia de seguridad de todos los archivos relacionados.
##############################################################

Posibles contenidos de ordenes (acciones) en la instalacion de un MOD y su traduccion:

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
##############################################################

Estas posibles acciones, las encontraras de este modo:

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 ]------------------------------------------ 
#

Esto eleva a once (11) las posibles "Acciones" a la hora de instalar un MOD

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;

Con este comando, el usuario-final necesitaría realizar la creacion de una tabla dentro de su base de datos SQL.

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/

Con este comando, debes subir/copiar los archivos del usuario (Autor del MOD) en el servidor.

Código: Seleccionar todo

# 
#-----[ OPEN ]------------------------------------------ 
# 
includes/constants.php

En este ejemplo, estamos abriendo el archivo: constants.php que esta ubicado, en el directorio 'includes' del directorio raiz del foro.

Código: Seleccionar todo

# 
#-----[ FIND ]------------------------------------------ 
# 

{L_NEW_POSTS}

En este caso, vamos a mirar dentro del archivo que hemos abierto previamente, y BUSCAMOS / ENCONTRAMOS el texto: {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}

En este caso, debes REEMPLAZAR {L_NEW_POSTS} POR {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}"/&

En este caso, DESPUES de {L_NEW_POSTS} estamos AGREGANDO una nueva imagen.

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}"/&

En este caso, ANTES de {L_NEW_POSTS} estamos AGREGANDO una nueva imagen.

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) . "',

Para buscar/encontrar codigo en una línea de codigo.

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',

Este ejemplo añade 'user_from_flag = '$user_flag', ' directamente despues de la linea de codigo que a BUSCADO / ENCONTRADO con la accion FIND

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',

Este ejemplo reemplaza:

Código: Seleccionar todo

user_from = '" . str_replace("\'", "''", $location) . "',

Por:

Código: Seleccionar todo

user_from_flag = '$user_flag',

por la linea de codigo que has utilizado en la acción IN-LINE FIND

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

Traduccion:

Código: Seleccionar todo

# 
#-----[ GUARDAR/CERRAR TODOS LOS ARCHIVOS ]------------------------------------------ 
# 
# Fin de Modificaciones

Espero os sirva de ayuda, a lo hora de "interpretar" las acciones, instrucciones u ordennes, a la hora de instalar un MOD, tambien existe este Tema que os servira de ayuda, dos cosas mas, paciencia y sobre todo...

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 ]------------------------------------------

Las INSTRUCCIONES de DIY son instrucciones que la persona que instala el MOD tendra que hacer antes de que el MOD este instalado del todo.
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 ]-------------------------------------

La accion de INCREMENTO se utiliza para agregar o restar a los números. Esto es mas utill para los colspans o los rowspans de la plantilla.

S@lu2