MOD Template - Tutorial Traducido

Instalación, actualizaciones, aplicación de mods... Todo lo que necesitas saber sobre los Foros phpBB para gestionarlos en tu sitio web.

Moderadores: fabriciano, randy

MOD Template - Tutorial Traducido

Notapor ThE KuKa » 20-04-2005 19:43

Tema basado en el MOD Template - Tutorial de AbelaJohnB

Traduccion: ThE KuKa

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 consulta SQL.

COPY - Copiar archivos en la ubicacion en el servidor.

OPEN - Abrir un archivo especifico.

FIND - Buscar / Encontrar 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, o instrucciones a la hora de instalar un MOD, y sobre todo paciencia, mucha paciencia.

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

S@lu2
Avatar de Usuario
ThE KuKa
Veterano
 
Mensajes: 108
Registrado: 19-07-2003 21:44
Ubicación: Sabadell



Notapor fabriciano » 05-09-2005 21:18

phpBB ha incluido dos nuevas acciones en las instrucciones de MODs, acciones que intentare explicar aqui.

Código:
#-----[ 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:
#-----[ 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.
_______________________________
NOTA: La explicación anterior corresponde a ThE KuKa. Orginalmente ha sido publicado en:

http://www.tomatoma.ws/foros/viewtopic. ... 1375#31375

Un saludo.
Fabriciano González González
Webmaster de Batiburrillo.net
Avatar de Usuario
fabriciano
Administrador
 
Mensajes: 10376
Registrado: 04-09-2001 15:34
Ubicación: Lugo


Volver a Foros phpBB (Versión 2)