El nuevo código completo del sitio - Erwin.Ried.cl / artículo

Hace muchos meses publiqué el código del sitio, ahora y por cuarta vez haré lo mismo. Esta vez es diferente pues ya el sitio lleva muchos meses de trabajo y ya no es un pequeño código con mínimas funcionalidades.

Claramente aún falta mucho trabajo como para afirmar que se alcanzó un punto cúlmine de su desarrollo.

0. Preliminares

¿Qué incluye?

· Código PHP/HTML completo. (sitio principal, buscador de documentos, panel de administración, editor bbcode en el panel de administración, código Javascript (js) completo, sección para dispositivos móviles, generación de RSS)
· Archivos fuente de CorelDraw 12 y Photoshop CS de todas las imágenes y gráficos.
· Código SQL para configurar la base de datos instantáneamente.

¿Qué no incluye?

· Actualizaciones
· Hosting u otro servicio similar.

¿Qué pido a cambio?

En realidad nada, pero si encuentras un error o algún detalle me encantaría escucharlo

1. Puesta en marcha

Con la última versión del sitio, el procedimiento de puesta en marcha tiene un asistente. Esto significa que el proceso es tan simple como:

A) Primero se copian los archivos del sitio al directorio correspondiente (Vista previa)

B) Luego se abre el directorio predeterminado del servidor (Vista previa)

C) El asistente ahora preguntará un par de datos, si utiliza EasyPHP, puede presionar "Siguiente" sin escribir nada para establecer la configuración predeterminada (Vista previa)

D) Listo, en menos de un minuto el sitio está funcionando (Vista previa)

Para más información, lea el archivo de instrucciones incluído en el paquete descargable del código del sitio.

2. Manejo de funciones básicas y avanzadas

En la última versión disponible (v1.5) se incluyen diversas mejoras y novedades:

* Desde el asistente de configuración puede seleccionarse un modo de "plantillas" que ayudan a la personalización del sitio

* El visor de eventos ahora puede crear un mapa básico de equipos que se conectaron al sitio (se mejorará en versiones posteriores):

* El visor de eventos ahora puede realizar filtros por direcciones de usuario (IP):

* Mejoras en el modo de vista simple de los documentos

* Nuevos parámetros para la etiqueta IMG, para añadir imágenes a los documentos:

Código:

Formato tradicional (el sitio analiza el tamaño y formato, por ejemplo 

para adecuar el ancho máximo o alto de la misma):

[img]<ruta relativa o absoluta de la imagen>[/img]



Omitir el recuadro de copyright personalizable:

[img=nocopyright]<ruta relativa o absoluta de la imagen>[/img]



Quitar el borde de la imagen:

[img=noborder]<ruta relativa o absoluta de la imagen>[/img]



De igual forma pueden combinarse parámetros:

[img=nocopyright,noborder]<ruta relativa o absoluta de la imagen>[/img]



Adicionalmente puede evitarse que el sitio inspeccione el formato y tamaño 

(para incluir animaciones, imágenes transparentes o con formato especial):

[img=noanalyze]<ruta relativa o absoluta de la imagen>[/img]



Aún más, puede adjuntarse parámetros HTML a la imagen:

[img=noanalyze,<parámetros>]<ruta relativa o absoluta de la imagen>[/img]



Como por ejemplo, para añadir un texto alternativo, borde y título:

[img=noanalyze,'border=1, alt="Imagen especial", 

title="Otra imagen más"']<ruta relativa o absoluta de la imagen>[/img]

F) Mejoras en la administración de réplicas de comentarios nuevos filtros:

* Otras novedades varias: el asistente ahora detecta advertencias en el proceso, el código del sitio tiene licencia GPL ahora, se puede reactivar un sitio en mantención por medio de servicios (ver más abajo), hay secciones como el "acerca de" totalmente configurables por parámetros de comportamientos (desde la sesión de administración), entre otros.

Estas propiedades se añaden a las ya tradicionales del sitio:

* Formato de edición basado en código similar al de foros y otros portales para añadir compatibilidad:

* Categorías y organización de artículos automática:

* Explorador de archivos:

* Asistente de mantenimiento:

* Comportamiento del sitio basado en variables:

* Administrador de comentarios y réplicas:

* Asistentes para subir contenidos:

* Administrador de enlaces y noticias:

* Capacidades básicas de estadística:

* Soporte para usuarios, grupos y privilegios:

Esta función fue mejorada en la versión actual del código

* Administrador de encuestas y visor de resultados:

Esta función es nueva en esta versión del código

* Caché de imágenes y documentos:

Esta función es nueva en esta versión del código

* Historial de eventos por usuario:

* Directorio, buscador, sindicación RSS, acceso WAP, historial de cambios de versión, usuarios en línea, entre otros

3. Advertencias, recomendaciones y detalles

-Para administrar el sitio se recomienda utilizar Internet Explorer debido a ciertas incompatibilidades con otros navegadores de los editores internos (por ejemplo el editor de documentos)

-Antes de publicar un sitio basado en partes o modificaciones de este código verifique los siguientes elementos:

Código:

 - El archivo "inc/sessioncookie.php", para que el nombre 

   de la cookie esté en relación con su sitio (opcional)



 - El archivo "index.php", para que el nombre 

   de la cookie esté en relación con su sitio (opcional)



 - El archivo "register.php", para que la contraseña que 

   reciben los nuevos usuarios concuerde con su sitio (opcional)



 - El archivo "find.php", para personalizar el buscador externo incrustado (opcional)



 - Los siguientes comportamientos (desde el panel de

   administración del sitio):



  - Ruta del servidor

    session.browser.server.path 

  - Código del recuadro de publicidad

    website.ads.banner.code

  - Código de enlaces de publicidad

    website.ads.links.code

  - Código de seguimiento del sitio

    website.ads.stats.code

Otro punto importante es la configuración de los mensajes de aviso. El servidor debe tener configurado correctamente el envío de correo electrónico y se deben configurar (por defecto viene en su forma más simple posible) los siguientes comportamientos desde la sesión de administración:

El formato de correo HTML básico debe utilizar la siguiente estructura:

Código:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML><HEAD>

<META http-equiv=Content-Type content="text/html; charset=iso-8859-1">

<HTML><HEAD>

<META http-equiv=Content-Type content="text/html; charset=iso-8859-1">

<META content="MSHTML 6.00.2900.2802" name=GENERATOR></HEAD>

<BODY></BODY></HTML>

El mensaje dentro de la etiqueta "BODY" puede estar conformado por variables que son automáticamente administradas por el sitio:

Código:

%user_name%

Nombre de usuario, por ejemplo el seudónimo del autor del comentario



%user_mail%

Dirección de correo del autor del usuario



%user_comment%

Cuerpo del comentario



%comment_id%

Identificador interno del comentario (id de la base de datos)



%comment_doc%

Identificador interno del documento al que hace referencia el comentario 

(id de la base de datos, del documento)



%document_title%

Título del documento relacionado con el identificador del mismo



%website_owner%

Nombre del dueño del sitio, configurado en el parámetro 'website.owner'



%website_name%

Nombre del sitio, configurado en el parámetro 'website.name'



%website_self%

Dirección de la portada del sitio, definido inicialmente como localhost,

configurado en el parámetro 'website.url.index'



%website_comments%

Dirección del administrador de comentarios del sitio, en la sesión de 

administración (puede requerir el inicio de sesión del administrador)



%website_panel%

Dirección del panel de administración del sitio (puede requerir el inicio 

de sesión del administrador)

Por ejemplo en el cuerpo del mensaje se podría utilizar:

Código:

<DIV>El usuario %user_name% (<EM><A 

href="mailto:%user_mail%?subject=Respuesta a tu comentario en 

%website_name%">%user_mail%</A></EM>) escribió un nuevo comentario en 

la página <A href="%website_self%">%website_self%</A>, en el

artículo 

"<A

href="%website_self%/?modo=visor&elemento=%comment_doc%">%document_title%</A>".</DIV>

<DIV></DIV>

<DIV>Para administrar los comentarios, <A href="%website_comments%">haga clic




aquí</A>.</DIV><BR /><BR />

<DIV>Los detalles del comentario son:</DIV>

<DIV><EM>%user_comment%</EM></DIV><BR /><BR />

<DIV>Puede deshabilitar estos avisos en las configuraciones del sitio, desde el 

<A href="%website_panel%">panel de administración</A>.</DIV>

4. Expandir el funcionamiento del sitio

¿Cómo utilizar los usuarios del sitio en otros servicios?

Esto es relativamente simple, desde el servicio adicional debemos realizar una llamada a:

Código:

* Invocación: 

<servicio>?clase=usuario&modo=credencial&parametro1=<usuario>&parametro2=<clave>

         

* Retorno:

Caracter cero (0) o uno (1) representando estado de la comprobación

Por ejemplo, para comprobar al usuario "erwin" con contraseña "1234" desde una aplicación de Visual Studio, hacemos una llamada y leemos los datos del siguiente URL:

Código:

http://erwin.ried.cl/inc/services.php?clase=usuarios&modo=credencial&parametro1=erwin&parametro2=1234

En el caso de tener instalado el sitio localmente con EasyPHP la llamada sería así:

Código:

http://127.0.0.1/inc/services.php?clase=usuarios&modo=credencial&parametro1=erwin&parametro2=1234

Hay que tener en cuenta que los datos no viajan encriptados, por lo que si se utilizará con propósitos serios debería recibir modificaciones para añadir seguridad. En próximas versiones se añadirá seguridad adicional y nuevas funciones a estos procedimientos.

Adicionalmente hay otras funcionalidades disponibles por defecto utilizando este mismo mecanismo:

Código:

<servicio>?clase=usuario&modo=(des)activar&parametro1=<usuario>&parametro2=<clave>

En donde el modo puede ser "activar" o "desactivar", realiza esas operaciones en el sitio. Es útil para hacer mantención general del sitio o de su base de datos, aunque el sitio puede desactivarse desde la sesión (con el registro: "website.status"), la activación debe ser por medio de este método (no se puede accesader a la sesión de un sitio desactivado)

5. Cosas que aún faltan

-Mejorar el primitivo buscador y los resultados que proporciona

-Mejorar las consultas a la base de dato

-Permitir a los usuarios adicionales administrar los comentarios escritos en sus documentos personales

-Añadir configuraciones adicionales para elementos que aún deben ser modificados desde archivos, como los especificados en el punto tres de este documento (con las últimas versiones este trabajo es mucho menor, pues el asistente ajusta la mayoría de los requerimientos)

-Implementar soporte para páginas en varias secciones como comentarios, noticias, documentos

6. Descarga

Actualizado el 2/12/2007 (Versión 1.6.11)

Código fuente:
ried_public_code-2007-12-02.zip

Dentro del sitio se pueden ver los cambios por versión accediendo por medio de ?modo=cambios, por ejemplo http://127.0.0.1/?modo=cambios

Archivos fuentes de los gráficos (opcional):
ried_public_sources_2006-11-27.zip