Pues había tomado más notas de las que creía y prefiero apuntarlas aquí en el wiki.
En la entrada en la que hablaba sobre la recuperación de este programa para mi uso olvidé anotar ciertos detalles que, si bien se indican en los archivos ejemplos y en su documentación, no está de más contar brevemente.
Traducciones del interfaz
No he tenido problemas con el idioma en el que uso el programa (el español) pero los autores lo han puesto fácil también en este aspecto y en la documentación correspondiente ya cuenta cómo utilizan el mecanismo gettext y disponen de proyecto en Launchpad.
Respecto a la configuración las líneas correspondientes son:
$config->custom->appearance['language'] = 'es_ES';
Particularidades de la configuración
Los autores recomiendan que si existe un archivo llamado /etc/phpldapadmin/config_default.php es mejor no tocarlo porque será sobreescrito en las actualizaciones del programa. Lo adecuado es hacerlo en /etc/phpldapadmin/config.php y ayudarse de los comentarios para saber sobre variables y usos.
Donse sea posible anular un valor predeterminado lo indicado es utilizar una variable llamada custom con la misma estructura que su homónima bajo $config y realizar los cambios allí:
// Valor predeterminado
$config->appearance['language'] = 'en_EN';
// Valor establecido por el usuario
$config->custom->appearance['language'] = 'es_ES';
En el archivo config.php existen dos tipos de líneas comentadas:
- Si comienzan con una doble barra (//) indican que el valor está predeterminado en el programa (o en el archivo config_default.php).
- Si comienzan con un sostenido (#) es para avisar de que no hay un valor predeterminado en el que basarse.
/* The height and width of the tree. If these values are not set, then
no tree scroll bars are provided. */
// $config->custom->appearance['tree_height'] = null;
# $config->custom->appearance['tree_height'] = 600;
Depuración del programa
El programa incluye, como es normal, un mecanismo para registrar eventos en el mismo controlado por estos valores:
- $config->custom->debug[‘level’]: valor numérico en forma de máscara de bits que indica qué registrar.
- $config->custom->debug[‘addr’]: limita el registro a la sesión procedente de una IP.
- $config->custom->debug[‘file’]: archivo donde registrar eventos con permisos para el usuario del servidor web.
- $config->custom->debug[‘append’]: conmutador que define si añadir al archivo de registro o comenzar uno nuevo por cada petición HTPP.
- $config->custom->debug[‘syslog’]: conmutador que activa o desactiva el envío a syslog de estos mensajes y no al archivo.
En el caso de emplear un archivo en el sistema para registrarlo lo idóneo es cuidar también de que éste no crezca demasiado. Es recomendable crear una tarea para el mecanismo de rotado:
/var/log/phpldapadmin/*.log {
weekly
rotate 4
compress
size 10M
missingok
create 0640 www-data www-data
}