Este tema intenta explicar cómo se instala un MOD a los que, como yo, sois súper novatos, súper torpes, y –probablemente- os consideráis incapaces de instalar un MOD.

Si ese no es tu caso, si tú ya tienes una mínima idea de cómo va esto de los foros phpBB, no hace falta que leas este tema para aprender a instalar un MOD. Mejor lee este Manual en el que Janu lo explica perfectamente:

Pero, lo dicho, si perteneces a los súper novatos, no tienes por qué renunciar a instalar un MOD, ni tienes que andar buscando que alguien te lo instale. Este tema pueda ayudarte (y si, antes de instalar un MOD, quieres saber más sobre qué es eso de los MOD, mira un manual que hay en JanuWeb sobre qué son los MOD).


Suponemos, claro, que ya te has descargado el MOD a tu ordenador. Pues venga, vamos a instalarlo.

1. Descomprime el archivo que te has bajado. Sea cual sea el MOD que te hayas descargado a tu ordenador, lo habrás descargado en una carpeta comprimida. Por tanto, lo primero es descomprimirlo. Algunos MOD vienen comprimidos con un programa y otros con otros (WinZip, WinRar...), así que si, por un casual, no logras descomprimirlo con tu descompresor habitual (casi todos los ordenadores traen preinstalado WinZip), tendrás que buscar en internet el programa con que se ha descopmprimido (o usar un descompresor casi “universal”: ¿has probado ALZip?).

2. Si al descomprimirlo, salen varias carpetas y archivos (no es frecuente, pero a veces pasa), crear una carpeta nueva con el nombre del MOD (o el que quieras, vaya), y mete todo lo que se ha descomprimido en esa carpeta que has creado (supongo que no hace falta decirlo, pero por si las moscas: para crear una carpeta nueva en, por ejemplo, el escritorio, pincha en él con el botón derecho del ratón, y verás la opción de crear nueva carpeta).

3. Entre todos los archivos del MOD, busca uno que se llama “install.txt” (en rarísimas ocasiones no se llama así, sino que se llama “nombre_del_mod.txt”, o “instructions.txt”; sea como sea, busca un archivo “loquesea.txt”). Normalmente, está muy a la vista, pero hay MODs que lo pueden tener dentro de algunas de sus carpetas (generalmente, en una carpeta /docs/). Esté donde esté, tienes que encontrarlo.

4. Si no aparece ningún “install.txt”, mira a ver si hay un archivo cuyo icono es como un trocito de película, como los negativos de las cámaras fotográficas no digitales. Si encuentras ese archivo y pinchas dos veces sobre él, se te abrirá con el Windows Media o con alguno de tus reproductores de vídeo. Pero si no se abre o no te quieres liar, hazlo más fácil: ábrelo con cualquier editor de texto (sigue leyendo para informarte más de esto).

5. Abre ese archivo “install.txt” (o el que sea desde lo que hemos dicho). Y ábrelo con un editor de texto. ¿Cuál? Lo más simple –y no te hace falta más- es abrirlo con el Bloc de Notas de tu ordenador. También puedes abrirlo con programas más específicos (por ejemplo, con el gratuito NotePad). Pero evita abrirlo con Word (no es cosa ahora de explicar por qué: digamos en rápido que Word te podría añadir algún código invisible a los códigos que trae ese archivo). También puedes abrirlo con el DreamWeaver, pero (por lo mismo de antes) no lo abras con el FrontPage.

Y si no te suenan de nada estos programas que estamos citando, pasa de ellos. Para instalar un MOD es más que suficiente que uses un editor de texto sencillo (que no sea Word).


6. Lee detalladamente ese archivo. Verás que son las instrucciones para instalar ese MOD. Y lo verás en este orden (usamos como ejemplo el mismo que se usa en el manual citado antes de Janu; pero quede claro que esto lo vas a encontrar, casi idéntico, en prácticamente todos los MOD):

• Información sobre el MOD: nombre, autor/es, descripción de qué hace ese MOD, y versión. Como veremos luego, lo de la versión es importante.
  
• En algunos MOD verás que dice que es compatible con determinada versión de phpBB (a veces lo dice más abajo, en las “notas del autor”), casi siempre versiones anteriores a la última de phpBB (que es la que debes tener tú). ¿Significa eso que no puedes instalar este MOD en tu última versión de phpBB? No, ni mucho menos. Eso significa que el autor ha comprobado el funcionamiento del MOD con determinada versión de phpBB, y que no garantiza que funcione con versiones anteriores de phpBB. Pero nada se dice de versiones posteriores (la tuya) de phpBB. En principio, no tendrás problema en instalarlo. En todo caso, si cuando estés instalando el MOD comoe xplicaremos más abajo, ves que no encuentras algo de lo que te dice el MOD que busques, ya sabes: pregunta en JanuWeb (eso sí, sin olvidar poner los datos que se piden para dar mejor soporte).
  
• Si está traducido al castellano, vendrá el traductor.
  
• Luego, se informa de la mayor o menos facilidad que tiene este MOD para ser instalado (fácil, medio, o difícil), y del tiempo aproximado que puede llebar el instalarlo. De este asunto, que conviene matizar bastante y no asustarse la primera vez que se lee, se habla despacio en el manual de JanuWeb sobre qué son los MODs.
  
• Se indican dos datos importantes y que comentaremos más abajo: los archivos de tu foro que tú vas a tener que editar (“files to edit”, “archivos a editar”), y los archivos que te proporciona el MOD y que, simplemente, tendrás que subir a tu alojamiento (“included files”, “archivos incluidos”).
  
• Se te avisa de que compruebes si esta versión del MOD que te has bajado (a lo mejor de algunas de las varias páginas que recopilan MODs) es la última versión que existe. Para ello se te invita a visitar la web del creador del MOD (o la de phpBB Group, depende de MODS: esto también se explica en el ya citado manual general sobre MODs). Pues... ¡hazlo! Comprueba que, verdaderamente, vas a instalar la última versión existente del MOD. Si instalas una versión antigua, corres el riesgo de instalar una versión a la que se le haya descubierto algún peligro.
  
• Todo MOD informa también de su licencia (siempre es de código abierto). Y casi todos informan de la historia de ese MOD desde su primeras versiones. También son frecuentes las “notas del autor”.

7. Y aquí hay que hacer un aviso. Lo más común es que casi todo lo anterior esté en inglés. Si no sabes inglés, tampoco pasa nada porque no te enteres de todo lo que ahí se dice. Pero, de cualquier forma (aunque sea usando un traductor de los que hay en la RED), hay dos cosas a los que es impepinable que estés atento:

- Lo de dónde comprobar si tienes la última versión del MOD (ya explicado).
- Y, ojo, las “notas del autor” (“author notes”). Y es que hay veces (no muchas, pero las hay), que en esas “author notes” el autor del MOD ha metido un aviso sobre si para instalar ese MOD hay que tener previamente instalado otro, o sobre dos formas posibles de instalarlo, o sobre lo que sea. Ya digo que no es frecuente, pero hay MOD que esos avisos los ponen aquí, en las “notas del autor”.

8. Capítulo aparte merece algo que todos los MOD (repito, ¡todos!) avisan. Algo que, curiosamente, hay bastante gente que se olvida de hacer:


O dicho en castellano: “Antes de añadir este MOD a su foro, usted debería hacer una copia de seguridad (‘Back Up’) de todos los archivos a los que hace referencia este MOD”.

Lo que te está diciendo el autor del MOD es algo tan elemental como que te guardes una copia de los archivos que vas a modificar al instalar este MOD. ¿Por qué?: por la muy sencilla razón de que, en caso de que algo no funcionara bien después de que instalaras el MOD, te bastaría volver a subir esos archivos que te guardaste antes de instalar el MOD (y que, por tanto, no están modificados) para que tu foro volviera a funcionar tan perfectamente como funcionaba antes de instalar ese MOD.

¿A que es algo elemental y de pura lógica? Pues te asombraría saber la cantidad de gente que no lo hace y que, claro, si tiene problemas, se encuentra con que no tiene forma de volver a poner su foro tal y como estaba antes de que le aparecieran los errores que le ha provocado la instalación del MOD (ojo: en muy pocos casos un MOD da errores; casi siempre se trata de un problema no del MOD, sino de que algo hizo mal quien lo instaló, o sea, tú; por eso es imprescindible tener copia “limpia” de los archivos que se van a modificar).

9.   Por tanto, haz eso lo primero:

- Mira los archivos que vas a tener que modificar (lo leíste antes, los “files to edit”).
- Con tu programa FTP (Nico, Filezilla... el que uses para subir archivos a tu alojamiento) descargarte a tu ordenador esos archivos tal y como los tienes en tu foro: o sea, de tu alojamiento (servidor) bájalos a tu ordenador.


¿Ya has hecho esa copia de seguridad? Si no lo has hecho, hazla. De verdad, no merece la pena seguir leyendo si no haces esa copia.

10. Hecho eso, el “install.txt” te empieza a decir, paso a paso, lo que tienes que hacer para instalar un MOD. Te lo dirá siguiendo un orden o siguiendo otro, te lo dirá con trozos de código muy largos o muy cortos, te lo dirá como le dé la gana... ¡pero siempre (siempre, siempre, siempre: en cualquier MOD, esté catalogado como fácil o difícil de instalar) te lo va a decir con alguna de las instrucciones que explicamos más abajo! Nunca vas a encontrar que para instalar un MOD tengas que hacer algo distinto de todo lo que vamos a comentar. Por eso es por lo que no tiene problema instalar un MOD, porque siempre te vas a encontrar con lo mismo.

Esas instrucciones que te vas a ir encontrando (repito que no forzosamente en este orden) son siempre algunas de las siguientes:

#-----[ OPEN ]------------------------------------------

“Open”, “abrir”.  Se trata de que abras el archivo que se te indica (siempre será uno de los “files to edit”). Y ábrelo con lo mismo que abriste el “install.txt”: con un sencillo editor de texto (el mismo Bloc de Notas de tu PC). Recuerda que dijimos arriba que puedes abrirlo con otros editores de texto, pero no con el Word; o que puedes abrirlo con el DreamWeaver, pero no con FrontPage. Pero lo dicho: basta cualquier editor de texto, por sencillo que sea.

Nota para esta instrucción y para todas las demás. En ese “install.txt” de todo MOD, los renglones que van precedidos por almohadillas (#) son las instrucciones del MOD: no tienes que hacer nada con ellas, ni copiarlas ni nada. Con lo que tú tienes que trabajar es con lo que NO tiene almohadilla (#) delante.
Por eso el MOD dirá, por ejemplo:


Lo de “open” es instrucción del MOD. Pero con lo que no tiene almohadilla delante (language/lang_english/lang_main.php) es con lo que tienes que hacer esa instrucción (en este caso, abrir ese archivo).

#-----[ COPY ]------------------------------------------

“Copy”, “Copiar”. Siempre vendrá después alguno de los archivos que traía el MOD (los “included files” que comentábamos arriba). Se trata, pues, de que con tu programa FTP copies ese archivo/s del MOD a la carpeta correspondiente de tu foro, que los subas a tu alojamiento (a tu servidor).

Es imprescindible que te fijes muy bien en dónde hay que copiar esos archivos. Si te dice (es un ejemplo) que copies root/tutu.php a root/admin./images/tutu.php, fíjate en cómo está organizado tu foro y entenderás que ese archivo tutu.php que te ofrece el MOD en su carpeta root, tienes que subirlo dentro de la carpeta images que, a su vez, está dentro de la carpeta admin. que, claro, esta en la raíz (la “root”) de tu foro. Pon mucho cuidado en no equivocarte a la hora de subir archivos a tu foro: fíjate bien en la ruta que te indican las instrucciones del MOD.

#-----[ UPLOAD ]------------------------------------------

“Upload”, “Cargar, Subir”. Es lo mismo que la instrucción anterior: “copy”.

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

“Find”, “Encontrar”. Se trata de que encuentres (en el archivo que te haya dicho antes el MOD que abras) el código que aparece después de ese “FIND” (recuerda: ¡el código cuyas líneas NO tengan delante almohadilla!). Puede ser un código muy breve o muy largo. Es igual. Con tu editor de texto, copia ese código que te pide encontrar el MOD y, luego, pásate al archivo que has abierto también con el editor de texto y búscalo allí (resumiendo, es algo que sabes hacer de sobra: buscar el texto de un documento en otro).


#-----[ BEFORE, ADD ]--------------------------------------

“Before, add”, “Antes, añadir”. Pues eso, el MOD te está diciendo que cojas el código que te ofrece después de ese “Before, add” y lo pongas “antes” (en la línea anterior, en el renglón anterior) del código que antes te dijo que encontraras. Ahora es tan sencillo como copiar (del MOD) y pegar (en el archivo que te ha dicho que abras). Copiar, claro, “antes” de lo que encontraste.
¿Te has liado ya ? ¿Quieres un ejemplo? Imagina que el MOD te dice esto:


Pues lo que tú haces es abrir con el editor de textos (en el que ya tienes abierto el install.txt) el archivo common.php (que ya te lo habías bajado para hacer la copia de seguridad dicha arriba). Con la función “buscar” del editor, buscas “pepe” en ese archivo. Y con el copiar y pegar, le añades antes “pepillo”, de modo que donde antes el common.php decía:


ahora dirá


¿Fácil, verdad? Pues igual de fácil es todo. Sigamos adelante con más instrucciones de las que puede darte un MOD


#-----[ AFTER, ADD ]--------------------------------------

“After, add”, “Después, añadir”. Es como antes, pero ahora el código hay que pegarlo “después” de lo que te hayan pedido buscar.

Ojo. Muchos errores en la instalación de MODs vienen de haberse equivocado en esto de “before” y “after”. Recuerda: “before = antes”, “after = después”.

#-----[ REPLACE WITH ]-------------------------------------------

“Replace with”, “Reemplazar con”. Ahora no es que copies algo antes o después de lo que buscaste, sino que reemplaces lo que buscaste por el código que te ofrece el MOD: borras lo que te dice que busques, y pones, en cambio, lo que te dice que “replace”.

#-----[ FIND AND DELETE ]------------------------------------------

“Find and delete”, “Encontrar  y borrar”. Pues eso, que busques el código que te indique el MOD y que lo borres del archivo que estás modificando.

#-----[ IN LINE, FIND ]------------------------------------------

“In line, find”, “En la línea, encontrar”. Esta instrucción te la darán siempre después de un FIND. El “find” te habrá dicho que encuentres una línea. Y, ahora, el “in line, find” te dice que encuentres determinado código dentro de esa línea.

#-----[ IN LINE, BEFORE ADD ]------------------------------------------

“In line, before add”, “En la línea, añade antes”. Se trata de que añadas lo que se te dice, pero no en la línea (el renglón) anterior, sino en esa misma línea. Esa es la diferencia entre “before add” (se añade en la línea anterior a la que se ha encontrado) e “in line, before add” (se añade antes, pero en la misma línea que se ha encontrado.

#-----[ IN LINE, AFTER ADD ]------------------------------------------

“In line, after add”, “En la línea, añade después”. Como antes, pero ahora se añade “after”, “después” de lo encontrado. Y se añade en la misma línea (no en la línea siguiente: eso sería “After, add”).

#-----[ EXECUTE ]------------------------------------------

“Execute”, “Ejecutar”. Lo de “ejecutar” es algo tan sencillo como que subas a tu servidor el archivo que te diga el MOD (y, claro, lo subas al sitio correcto: recuerda lo que se comentaba en “copy”), abras tu navegador, y escribas la URL (la ruta) de ese archivo.
Imagina que te dice lo siguiente:


Pues lo haces. Subes “install.php” a la raíz de tu foro (esto es, a la misma carpeta donde, entre otras carpetas y archivos, encuentras la carpeta “admin.”). Pones la dirección completa en tu navegador: http://dirección_de_tu_foro/install.php. Y le das a “enter” (navegas hasta esa dirección). Normalmente, te saldrá una pantalla diciendo que todo ha ido “ok” (u, ojalá no, diciendo que ha habido errores: si te sale eso de errores, cópialos exactamente, y pide soporte; la mayoría de las veces son cosas fácilmente solucionables).

#-----[ SQL ]------------------------------------------

Por alguna misteriosa razón, es la instrucción que más tememos los súper novatos. Probablemente, se deba al respeto (casi pánico) que tenemos a enredar en la Base de Datos de nuestro foro. Y es que si todas las demás instrucciones de un MOD se refieren a los archivos del foro, esta no se refiere a ellos, sino a la Base de Datos (si no entiendes la diferencia entre Archivos del foro y Base de Datos del Foro, mira un manual que tiene JanuWeb sobre eso). Está instrucción va a añadir tablas a nuestra base de datos (o a añadir campos a alguna tabla ya existente...).
Pero el caso es que no hay ningún problema en hacer esta instrucción. Puedes hacerlo de dos maneras (si la primera te suena a chino, utiliza la segunda; tiempo tendrás de ir aprendiendo qué significan los “palabros” de la primera ):

Instrucción SQL desde phpMyAdmin:

a. A través de phpMyAdmin, accede a la gestión de la base de datos de tu foro (que, evidentemente, está en tu servidor).
b. Busca un botón que pone “SQL” (o “consulta SQL”, o algo similar).
c. Pincha en ese botón. Se te abrirá una ventana en blanco.
d. Pega en esa ventana los códigos que te indique el MOD. Cópialos exactamente.
e. Pincha en “continuar” (o en “ejecutar”, o “next”... hay ligeras variaciones en los phpMyAdmin de cada servidor”).
f. Se te informará de que la consulta SQL ha sido ejecutada con éxito (o satisfactoriamente).

Instrucción SQL desde el generador:

a. Entra al generador de consultas SQL de JanuWeb. Lo tienes en el menú de navegación de la izquierda del portal y el índice de foros, dentro de “principal”.
b. Copia la instrucción SQL que te diga el MOD en la ventana del generador. Dale a “enviar”.
c. Debajo de esa ventana, te aparecerá una nueva con varias líneas de código. Dale al botón “descargar”.
d. Se descargará en tu ordenador un archivo llamado “db_update.php”.
e. Sube ese archivo a tu ordenador y ejecútalo (hemos hablado arriba de esto de “ejecutar”).
f. Ya está, ya has modificado tu Base de datos. Borra de tu servidor ese archivo “db_update.php”.


#-----[ DIY INSTRUCTIONS ]------------------------------------------

No me peguntes qué es eso de “diy” porque no tengo ni idea. Pero es igual. Bajo esta instrucción encontrarás siempre “instrucciones”, valga la redundancia. A lo mejor se te dice que borres unos archivos, o que hagas ciertas cosas en determinado orden, o lo que sea. Lo único que tienes que hacer es seguir esas instrucciones al pie de la letra.


#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
# EoM

Esta instrucción la encontrarás al final de todos los MOD. “Save/Close all files”, esto es, “Salvar/Cerrar todos los archivos” que has estado modificando.

Y, claro, subirlos con tu programa FTP a tu servidor, substituyendo los que allí tienes (por eso,  repetimos una vez más, tú te guardas una copia de esos archivos sin modificar, porque los vas a substituir en tu servidor por los archivos modificados).

(¿Te entra curiosidad por saber qué significa eso de “EoM”?: es “fin del MOD, “End of MOD” ).

11. Cuando has hecho todas las instrucciones del MOD (que ya has visto que pueden ser subir archivos que te proporciona el MOD, modificar archivos según las instrucciones del MOD y subirlos a tu servidor, o modificar tu Base de Datos con una consulta SQL)... habrás instalado el MOD. ¡Enhorabuena!

Comprueba que el MOD funcione, esto es, comprueba que has conseguido lo que querías hacer al instalarlo. Y no dejes de darte una vuelta por tu foro para comprobar que no hay errores inesperados en algún sitio (al publicar una respuesta, al ver un tema... no está mal comprobar que sigue funcionando bien el registrarse).

12. Y se acabó . Pero no dejes de tener en cuenta unos avisos finales:

a. Cuando un MOD te pida que edites un archivo de lenguaje, no edites sólo el archivo de la carpeta de lenguaje inglés (que es lo que te pedirá el MOD): edita también (o sólo, pero no está de más editar los dos) ese mismo archivo del lenguaje español (si no lo haces tendrás problema, porque tu foro lee la carpeta de lenguaje español).

b. Cuando un MOD te pida editar algo de la carpeta “templates” (esto es, de la carpeta donde están los estilos de tu foro), casi siempre te dirá que lo edites de la plantilla Subsilver (la plantilla por defecto de phpBB2). Pero si tienes instaladas otras plantillas, debes editar esos archivos de todas las plantillas que tengas. Quizá pienses que si usas una plantilla  distinta de la Subsilver, para qué vas a editar la Subsilver. Pues sí que debes editarla: si tuvieras algún problema con la plantilla que usas, siempre puedes mirar si el MOD funciona bien en Subsilver (y si funciona bien, ya sabes que el problema no está en el MOD, sino en cómo instalarlo en esa plantilla que usas tú). De hecho, verás que algunos MOD, cuando te van a dar alguna instrucción sobre archivos de la plantilla Subsilver, te avisan: “# Note: Do these instructions for all template files”, “# Nota: Haga estas instrucciones en todos los archivos de su template”.

_________________________________
En este mundo hay gente cuya vida o cuya dignidad
depende de un correo tuyo, de un clic de tu ratón.
Entra en la gran Red ciberactivista.
Web: www.pazyjusticia.com Foro: www.pazyjusticia.org/foro