########################################
Documento para desarrolladores
Para la versión 2.0beta1

by BLuEGoD - bluegod@bluegod.net
http://www.bluegod.net/galsel
########################################

****************************************
Introducción
****************************************

Gracias por tu interés en este documento, en principio he de describir
GalSel como:
Programa web con licencia GPL que incorpora constructor/gestor de galerías
propio desarrollado en PHP4 (usando orientación a objetos y librería GD),
HTML y JavaScript, además de CSS y MySQL. Incorpora una gestión
multigalería, numerosos elementos innovadores, un foro y un sistema de
administración.

Así GalSel está divido en tres módulos (en realidad clases) principales..
GalSel, foro y admin; para la gestión de las fotos, del foro, y de la
administración respectivamente.

Pido perdón por no comentar íntegramente el código, ya que solo lo hice en
tomas de decisiones concretas o para aclarar el por qué de alguna función
muy específica.

En esta versión beta, el código no está nada depurado, así que de momento
seguro que hace falta una optimización para versiones posteriores, aunque la
funcionalidad es lo primero. Como programador a medida que iba haciendo las
cosas me he dado cuenta de la posibilidad de cambiar algo para mejorar
alguna cosa, pero muchas veces no he podido hacerlo por falta de tiempo,
tambien cabe decir que todo el programa incluso las fotografías las he hecho
yo sin basarme en nada.. Esto tambien tiene una parte mala, ya que todos los
algoritmos de funcionamiento incluidos los matemáticos los he pensado y
desarrollado yo, sin basarme en ninguno que pudiese estar mejor o más
optimizado.. No obstante, la originalidad marca la diferencia :-).

No quise hacer un fichero tipo 'KNOWN_BUGS' aunque sí se de alguno que otro
que me he dejado para la posterior beta (beta2).

Consulte el documento de cambios en la web, así como el TODO si está
interesado en las versiones y cambios de GalSel, ya que este documento
podría estar desactualizado.

Debido a que es la primera versión que distribuyo para el uso de más gente,
no me he extendido demasiado en este documento así como en los demás
tampoco, esperando ver la aceptación y si realmente merece la pena mantener
todo esto actualizado.

****************************************
Curiosidades & Información adicional
****************************************

¿Como recuperar una password?

La password no está encriptada y queda reflejada en la BD de MYSQL, así que
bastaría con acceder al campo en cuestión de la tabla admi. En caso de no
poseer conocimientos sobre MySQL, intente instalar un gestor del tipo
phpMyAdmin para poder acceder a estos datos de manera más facil.

¿Como volver a reinstalar?

Deberá borrar la BD (galsel) creada en MySQL, una vez echo esto, cree un
fichero llamado .firstime en el directorio donde está ubicado GalSel, esto
se puede hacer con un echo "" >.firstime .A continuación vuelva a la
administración y entre con el password predeterminado.
http://www.supagina.com/galsel/fotos.php?adminweb=1

¿Como usar GalSel con register globals ON?

Bastaría con desactivar la función noglobals() en la línea 51 de fotos.php,
esto se haría anteponiendo dos barra a la función.. Quedaría así:
//noglobals();
Esto trae como consecuencia menos seguridad, ya que no he comprobado la
inicialización de todas las variables, aunque no debería haber ningún
problema debido al uso de muchas funciones en el programa, en las cuales las
variables de función no establecerían contacto con las globales.
Desde luego, no recomiendo el uso de register globals, aunque en un futuro
podría revisar mejor el código para que se pudiera usar sin probelmas, ya
que al contrario de lo que piensa muchos programadores, register globals ON
solo entraña riesgo si no se tiene cuidado :).

¿Podría utilizar este programa en un servidor?
¿Es este programa seguro?

La respuesta corta, es NO; primero porque es una versión beta, y segundo
porque porque hay varios ficheros no seguros que pueden entrañar un riesgo
de seguridad, ya que la instalación de GalSel es muy simple y estos ficheros
están accesibles muchas veces por varios usuarios, ya que es necesario que
los use el usuario de apache (www o www-data normalmente).. Un buen
administrador podría asegurarse de que no pasara nada con estos ficheros,
(.CARE.php por ejemplo). De todos modos, un programa no es seguro aunque el
programador lo diga, hace falta el uso de muchos usuarios y la resolución de
muchos bugs e incidencias, es por ello, que este programa que acaba de salir
entraña más riesgo que otro que estea desde hace tiempo en el mercado.

Más información en http://www.bluegod.net/galsel/

A developers e interesados en el estado del programa, les recomiendo que se
subscriban a la lista de correo; en la página web encontrarán el e-mail para
darse de alta en la misma (Con mandar un correo en blanco a ese e-mail ya
estaría).


Un saludo, BLuEGoD (James López P.)