Descripciòn de los Documentos
Php-residence permite imprimir documentos insertados por el usuario. Estos documentos pueden
representar contratos de alquiler, recibos fiscales, formularios para las autoridades pùblicas,
resùmenes para el personal del hotel o cualquier otro documento a imprimir con datos presentes en
php-residence. De hecho se pueden insertar en los documentos algunas variables predefinidas que
contienen los datos de las reservas y de los clientes.
Las variables se distinguen por estar encerradas en paréntesis cuadras. Su lista completa
està disponible cuando se modifica un documento desde "configurar y personalizar" y contiene,
ademàs de las predefinidas, las que haya añadido el usuario. El usuario de hecho puede añadir
variables personalizadas que cambian su valor segùn el de otras variables. Se puede crear por
ejemplo una variable [cuartos] que asuma el valor "un cuarto" si la tarifa seleccionada
corresponde a una doble, "dos cuartos" si la tarifa corresponde a una triple.
Los documentos pueden tener cuatro formatos distintos. El primer formato es el HTML y permite
mirar el documento directamente desde el navegador. El segundo es el RTF que tiene la ventaja,
con respecto al HTML, de poder definir los màrgenes de las pàginas a imprimir porque los archivos
RTF se abren en elaboradores de texto como Word u OpenOffice. El tercer formato es el texto simple,
ùtil si hay que guardar archivos preformatados en xml o similares.
El ùltimo formato disponible es el email que permite enviar correos electrònicos directamente
desde php-residence. Para que esto sea posible el servidor sobre el que funciona php-residence tiene
que estar adecuadamente configurado para permitir enviar emails. El mensaje tendrà como texto
predefinido el del documento pero se podrà modificar antes de enviarlo. El destinatario predefinido
serà la direcciòn de correo electrònico del cliente, si està disponible. Tambièn es posible salvar
un archivo a adjuntar al correo electrònico, lo que puede ser ùtil para adjuntar mapas o
imàgenes.
Los documentos en formato HTML o RTF pueden ser salvados como archivos sobre el servidor
donde corre php-residence. La segunda parte de los nombres de los archivos serà compuesta por el
año y un nùmero progresivo con respecto al ùltimo archivo presente en el directorio donde
estos son salvados. Este nùmero progresivo serà disponible, como variable, tambièn dentro del
documento, haciendo posible la registraciòn de una serie de facturas.
Se puede mirar el documento de una sola reserva o tambièn el de màs reservas juntas. Por
ejemplo desde la pàgina con todas las reservas podemos seleccionar, tambièn temporalmente, las
reservas de las que queremos ver el documento y despuès escoger el documento a mirar. En este caso,
si el texto del documento no tiene lìmites para las secciones a repetir, el documento serà repetido
por entero para cada reserva, y con documento en formato email se podràn enviar tantos correos
electònicos distintos cuantas son las reservas. Sin embargo si el texto contiene lìmites para la
repeticiòn entonces solo las secciones delimitadas seràn repetidas, y con formato email podremos
enviar un ùnico correo electronico con todas las direcciones de los clientes en el campo del
destinatario. En las partes del documento que no son repetidas se pueden insertar algunas variables
con valor que contiene la suma de los valores de todas las reservas.
Otra manera de obtener repeticiones dentro del documento es creando un bucle con los valores
de una variable del documento contenidos en un array. Por ejemplo se puede asignar al array de manera
predefinida los valores de las fechas incluidas entre las seleccionadas, creando un bucle que se repite
para cada fecha.
Se pueden crear tambièn partes de documento a repetir dentro de cada reserva, para generar
listas con las variables disponibles. Por ejemplo todas las variables que acaban con "_huesped"
pueden ser utilizadas para crear la lista con los datos de los huéspedes.