Fichero "léame" de mlog

Esto es el software de weblog que hice para mi weblog, Tirando Líneas.

La idea al hacerlo era que fuese muy sencillo de instalar, muy sencillo de manejar, muy sencillo de modificar y muy sencillo de tirar a la basura, si fuere menester. Las tres primeras cosas las he conseguido; la última aún no la he comprobado.

mlog tiene las siguientes características:

Esto del backlinking quiere decir que si alguien pone un enlace al weblog en otra página, y alguien pulsa en ese enlace y llega al weblog, la URL de ese enlace aparecerá en la página del weblog. Mira en Tirando Líneas para verlo en acción.

Bueno, entremos en materia...

Instalación

Descripción corta: Crea un fichero config.php que se ajuste a tu configuración, copia todos los ficheros de mlog, dentro de sus respectivos subdirectorios, al sitio más adecuado. Después, crea las tablas, crea un autor, y listo.

La descripción larga viene a continuación, por partes.

Crear el fichero config.php

Primero, copia el fichero config_ejemplo.php a config.php, y ábrelo con tu editor de texto favorito (joe, Emacs, vi, notepad...). Verás varias lineas que empiezan por "define ("; esas son las que hay que editar.

Primero hay que configurar las preferencias generales del weblog. Para ML_TITLE escoge un buen nombre, con gancho. Y para ML_SLOGAN un lema con tanto o más gancho que el título. En ML_URL introduce la dirección web en la que aparecerá tu weblog. En ML_SKIN puedes poner el nombre del estilo que quieres utilizar en el weblog; en el directorio plantillas/ tienes todos los estilos; puedes crear tú el tuyo (faltaría más). En ML_LANG pon el código ISO-639 del idioma en el que va a estar tu weblog. Si pones uno distinto de "es" (español) o "en" (inglés) vas a tener que hacer tú la traducción, ojo...

Por ejemplo, esta es la primera parte del fichero config.php de Tirando Líneas:

# Título del weblog
define ("ML_TITLE", "Tirando líneas");
define ("ML_SLOGAN", "Las elucubraciones de Jacobo Tarrío");
# URL base del weblog (se usa para los canales RDF)
define ("ML_URL", "http://lambenor.free.fr/mlog/");
# "Skin" del weblog
define ("ML_SKIN", "tirandolineas");
# Fichero de idioma del weblog
define ("ML_LANG", "es");

Lo siguiente es la configuración del sistema de base de datos, en el que se van a almacenar las historias, los comentarios, ... En ML_DBTYPE se indica el tipo de base de datos (por ahora, sólo hay mysql). En ML_DBHOST has de introducir el nombre o IP del ordenador servidor de base de datos. En ML_DBUSER tiene que estar el nombre de usuario en la base de datos, y en ML_DBPASS la contraseña correspondiente. En ML_DBNAME debes introducir el nombre de la base de datos, y en ML_PREFIX un prefijo para los nombres de las tablas de mlog. Este prefijo es para que, si no puedes tener más de una base de datos, al menos puedas hacer que las tablas de mlog no tengan el mismo nombre que otras tablas ya existentes. También sirve para tener varios weblogs de mlog en la misma base de datos, por ejemplo...

Mi configuración (con la contraseña tapada, por supuesto) de la base de datos de Tirando Líneas es:

# Parámetros de la base de datos
define ("ML_DBTYPE", "mysql");
define ("ML_DBHOST", "localhost");
define ("ML_DBUSER", "jtarrio");
define ("ML_DBPASS", "noteladigo");
define ("ML_DBNAME", "mlog");
define ("ML_PREFIX", "");

Al final, viene una pequeña opción para introducir URLs que no queremos que aparezcan entre los backlinks. En ML_NOREFER hay que introducir una expresión regular que encaje con las URLs indeseadas. Si no sabes qué es una expresión regular, es muy fácil; simplemente, pon una lista de palabras (nombres de dominio, por ejemplo) que aparecen en los URLs que no quieres, separados por barras verticales (|; la que aparece en la tecla del uno en un teclado español). Eso sí, a los signos de interrogación, asteriscos y signos más ponles una barra invertida delante (\; la que hay en la tecla a la izquierda del uno), que si no te harán cosas raras. Por ejemplo, en Tirando Líneas no quiero que aparezcan los buscadores...

define ("ML_NOREFER", "lambenor.free.fr|/search\?|google|altavista|alltheweb|ozu.es|nedstat");

Quedan unas cuatro líneas al final del fichero, pero como pone que no se editen, obedeceremos y no las tocaremos...

Copiar todos los ficheros de mlog

Esto depende de dónde quieras hospedar tu weblog; si va a estar en tu ordenador personal, mira las instrucciones del servidor web que vayas a usar. Si va a estar en un proveedor externo, mira en su web, que seguro que lo pone allí. Eso sí, asegúrate de que la estructura de directorios se conserva, que si no esto no va a andar ni para atrás.

Crear las tablas y crear el primer autor

Esto es relativamente fácil; al menos, mientras sólo siga soportando MySQL. Para hacerlo, tienes en el fichero sql/mlog.sql un listado de comandos SQL necesarios para crear las tablas; si no quieres utilizar un prefijo en los nombres de las tablas, sáltate el siguiente párrafo.

Para añadir el prefijo, edita el fichero sql/mlog.sql para añadirle el prefijo a los nombres de las tablas, en las instrucciones "CREATE TABLE". Por ejemplo, si quisieras que las tablas se llamaran "mlog_stories", "mlog_comments", etc en lugar de "stories" o "comments" a secas, tendrías que cambiar el comando "CREATE TABLE stories" a "CREATE TABLE mlog_stories", y así sucesivamente.

Hecho esto, en la última linea del fichero tienes el comando SQL para añadir un autor a la base de datos; cambia "sample author" por el nombre que quieras usar, y "MD5sumofpassword" por el hash MD5 de la contraseña que desees usar. Si ya sabes cómo obtener el hash MD5, sáltate el siguiente párrafo.

He añadido en mlog una forma muy sencilla de obtener el hash MD5 de un texto. Imagínate que has instalado mlog en el URL http://www.ejemplo.com/weblog/, y que quieres obtener el hash MD5 de la contraseña "pepitoperez". Podrías hacerlo yendo al siguiente URL: http://www.ejemplo.com/weblog/admin.php?op=md5&texto=pepitoperez. Lo que te devuelve es el hash MD5 (por cierto, el hash MD5 de "pepitoperez" es "cf1eecc293b6236a872eac898936afc8").

Pues ya está; si, por ejemplo, el autor fuera "El Dioni" con contraseña "pepitoperez", la línea sería:

INSERT INTO authors VALUES ('El Dioni', 'cf1eecc293b6236a872eac898936afc8');

Ahora este fichero SQL puedes volcarlo a la base de datos con la herramienta de volcado que ponga tu proveedor a tu disposición, o mediante el cliente en modo texto de MySQL, o copiando las lineas a mano, o como prefieras...

Creación de historias en mlog

Para crear una historia (o para borrarla, o para modificarla) has de entrar en admin.php; o sea, en Tirando Líneas, yo, para crear una historia, tengo que entrar en http://lambenor.free.fr/mlog/admin.php e introducir mi nombre y contraseña; si todo va bien, entro en la pantalla con el listado de historias.

Junto a cada historia hay un enlace para modificarla y otro para borrarla; encima del listado hay un enlace que permite crear una nueva historia.

El formulario de edición de historias permite poner un título, fecha y hora y el texto. El texto se ha de escribir empleando HTML. Puedes poner cualquier fecha, pero ten en cuenta que las historias salen ordenadas cronológicamente. Además, nunca aparecerá en la página principal ninguna historia que tenga fecha posterior a la actual; esto sirve para escribir historias hoy y hacer que aparezcan mañana automáticamente... ;-)

Y quedan más cosas por decir, pero ya me aburro de teclear y siempre será mejor que tú mismo pruebes lo que puedes hacer. Hala, con Dios.


Jacobo Tarrío
Last modified: Sat Aug 10 00:33:58 CEST 2002