Bueno gente, me propuse como meta de este post "armando un mod basico" enseñarles a colocar su propio copyright pero no solo editando un archivo y agregandolo como texto plano, sino, que vamos a hacer una variable que la podamos manejar desde la administracion > configuracion del foro > modificaciones.
Crearemos un input donde pondremos nuestro copyright y debemos lograr que se guarde en la base de datos y que se muestre donde queremos. Esto no solo serira para agregar un copyright, podemos poner todo el html que nos guste y en cualquier parte del foro, pero vamos a empezar por lo basico.
Antes que nada, abrimos nuestro foro de pruebas en localhost. (
Si no saben como, lean este post)
/* Nota: Recuerden utilizar siempre notepad++ para editar archivos */
Para este mod, vamos a editar los archivos index.template.php, ManageSettings.php y Modifications.english.php.
El archivo index.template.php es el archivo principal de los foros smf, en el podremos encontrar el header (logo, area de usuario, menu, buscador), el contenedor principal del foro que albergara todo el resto del foro, como el boardindex donde estan las categorias y foros, el display.template donde se ve el post, etc... y tambien vamos a encontrar el footer, donde esta el copyright y demas datos.
En este caso, nos vamos a centrar en el footer ya que ahi pondremos nuestro copyright.
En el archivo ManageSettings.php (se encuentra en la carpeta sources) vamos a crear la variable que luego pondremos en el index.template.php y es donde crearemos el input para escribir en administracion > configuracion del foro > modificaciones.
El archivo Modifications.english.php (se encuentra en la carpeta de lenguajes del theme default) lo vamos a utilizar para crear la variable de lenguaje.
Ahora bien, quizas no entiendan nada de lo que dije arriba, pero bueno, seguramente leyendolo 2 o 3 veces y con la practica luego van a entender cada cosa a la perfeccion, tratare de ser lo mas directo posible para explicar asi esto no se vuelve tan tecnico y luego no terminan entendiendo nada.
Lo primero que vamos a hacer es modificar el archivo ManageSettings.php para crear el input que vamos a utilizar en la administracion y su respectiva variable.
Abrimos el archivo ManageSettings.php y vamos a la linea 2020 donde encontraremos que dice lo siguiente:
// Mod authors, add any settings UNDER this line. Include a comma at the end of the line and don't remove this statement!!
Esto se encuentra dentro de un array,
$config_vars = array( y cierra
); (Si no saben lo que es un array por el momento no importa, mas adelante se lo explicaremos en la escuelita)
Esa frase en color verde nos dice que ahi podemos incluir settings (osea, nuestra variable), que se veran en la administracion donde les comente.
Abajo de esa frase, vamos a poner lo siguiente, copien, peguen y guarden la modificacion. Luego les explico el porque de cada cosa:
array('check', 'copypropio_enable'),
array('text', 'copypropio_text', '30'),
Ahora, abrimos en el foro la administracion > configuracion del foro > modificaciones, y veremos que hay un boton solito ahi sin nada mas. (si es que lo hicieron correctamente jejej) y un rectangulo larguito "input" de texto para poner su copy.
Bueno, les explico este codiguito:
check: es para que el input sea un tipo check, osea, un cuadrito para tildar y decir "esta activo o no". Nos va a servir para activar o desactivar el mod.
copypropio_enable: Este es el nombre de la variable para este boton check que es lo que terminaremos usando.
text: Este es un input de texto, donde podran poner el copyright luego.
copypropio_text: Es el nombre de la variable que usaremos para este input y el numero 30 es el largo del input, aunque es solo por apariencia porque no es el limite de caracteres, solo es el limite del largo.
Bueno, en este archivo ya no editaran nada mas, asi que pasaremos al archivo de lenguaje para darle vida a esa administracion porque hasta ahora solo hay un cuadradito y un rectangulo.
Abrimos el archivo Modifications.english.php y veran que esta vacio. Aqui pondremos el lenguaje de nuestro mod y sus variables.
Veremos que en la linea 2 dice lo siguiente:
// Version: 2.0; Modifications
Abajo de eso ponen lo siguiente y guardan la modificacion, luego les explico con detalle:
$txt['copypropio_enable'] = 'Enable Copy Propio';
$txt['copypropio_text'] = 'Write your copyright';
Vayan nuevamente a la administracion y veran que ya nuestras 2 nuevas opciones, tanto el check como el text, tienen ya su respectiva descripcion.
Esto nos permitira, por ejemplo, que cuando tengamos otro lenguaje como puede ser el español, hagamos lo mismo pero en el archivo Modifications.spanish_es.php pero en ves de ingles, utilizamos español. Quedaria algo asi:
$txt['copypropio_enable'] = 'Activar Copy Propio';
$txt['copypropio_text'] = 'Escribe tu copyright';
Bueno, hasta aca llega la primer parte, en la segunda hablare de como utilizar lo que creamos hasta el momento, a empaquetarlo y armar todo para que sea un mod listo para que los usuarios de la comunidad puedan utilizar.
Saludos y recuerden dar el Presente en esta leccion! Cualquier consulta pueden hacerla aqui.