• Configuración del cliente
  • Opciones
  • Panel superior
  • Menú

Configuración del cliente¶

elFinder puede ser configurado de varias formas:

1. Al instanciar:

1 $(selector).elfinder({
2   option1: value1,
3   option2: value2
4 })

2. antes de la inicialización y después de incluir los ficheros elFinder (se pueden sobreescribir todos los parámetros):

1 var opts = {
2   option1: value1,
3   option2: value2,
4   option3: value3
5 }
6 elFinder.prototype.options = $.extend({}, elFinder.prototype.options, opts)

o bien sólo las opciones discretas:

1 elFinder.prototype.options.option1 = value1;

Opciones¶

Parámetro	Tipo	Descripción
url	String	URL del conector. El único parámetro requerido
lang	String	Idioma de la interfaz. Hay que incluir el fichero js/i18n/elfinder.LANG.js, donde LANG es el código de dos letras para el idioma, por ejemplo es
cssClass	String	Clase CSS adicional para el contenedor
wrap	Integer	Cantidad de símbolos en los que se dividen los nombres de ficheros largos en modo "iconos". Por defecto - 14. No dividir los nombres - 0
places	String	Nombre de la carpeta "favoritos". Se aplica la configuración de la Locale. Por defecto - Places. Indique un String vacío "", para quitar "favoritos"
placesFirst	Boolean	¿Poner "favoritos" en primer lugar en el árbol de ficheros/directorios en el panel de navegación? Por defecto - true
editorCallback	Función o null	Función para callback del editor WYSIWYG (CKEditor, TinyMCE, elRTE, etc). Recibe un argumento (String) - la URL del fichero seleccionado
cutURL	String	indica el substring desde el inicio de la URL del fichero hay que cortar antes de pasar el valor a editorCallback. Puede contener una parte de la url, un string vacío o bien la palabra clave root -- cortar la raíz de la URL
closeOnEditorCallback	Boolean	¿Cerrar el Finder después de la llamada de editorCallback? Por defecto - true. (no funciona con CKEditor, TinyMCE)
view	String	Apariencia del directorio por defecto. Posibles valores: icons, list. Por defecto - icons
width	Integer o String	Ancho de la ventana del gestor. Por defecto no está puesto, el ancho se indica en el fichero CSS source:src/css/elfinder.css
height	Integer	Alto de la ventana del gestor. Por defecto no está puesto, el ancho se indica en el fichero CSS source:src/css/elfinder.css
disableShortcuts	Boolean	Desactivar los atajos del teclado (excepto las flechas y el espacio). Por defecto - false
rememberLastDir	Boolean	Abrir el último directorio visitado después de recargar la página o bien después de cerrar/abrir el navegador
cookie	Object	Parámetros cookie (apariencia del directorio actual, último directorio abierto, "favoritos"). Por defecto - {expires : 30, domain : '', path : '/', secure : false}
toolbar	Array	Grupos de botones en el panel superior. Por defecto - Todos los botones/comandos posibles. Para configuración - ver el capítulo correspondiente
contextmenu	Object	Contenidos del menú. Por defecto - todos los comandos posibles. Para configuración - ver el capítulo correspondiente
dialog	Object	Opciones para la ventana de jQueryUI dialog en la que se abrirá elFinder. Si la opción docked es true - elFinder se abrirá en la página con la opción de "despegar" a una ventana aparte con los parámetros indicados aquí
docked	Boolean	Permitir "despegar" elFinder a una ventana aparte (más adelante en la documentación - docked mode)
autoReload	Integer	Número de minutos, pasado el cual el contenido del directorio actual y el árbol de directorios se refrescan. Por defecto - 0 (deshabilitado)

Panel superior¶

Por defecto en el panel superior están habilitados todos los botones/comandos. Si el comando está deshabilitado en el conector, no se mostrará en el panel superior incluso si se indica en la configuración del cliente.

La opción toolbar - es un array de dos dimensiones. El primer elemento son grupos de botones que visualmente se separarán en el panel. El segundo - botones dentro del grupo. Tanto los grupos de botones como los botones dentro de un grupo serán ordenados de acuerdo al orden indicado en la configuración.

Lista de todos los comandos disponibles: back, reload, open, select, quicklook, info, rename, copy, cut, paste, rm, mkdir, mkfile, upload, duplicate, edit, archive, extract, resize, icons, list, help.

Ejemplo:

1 $(selector).elfinder({
2   toolbar : [
3     ['back', 'reload'],
4     ['select', 'open'],
5     ['mkdir', 'mkfile', 'upload']
6   ],
7   ...
8 })

Menú¶

El menú es definido por la opción contextmenu (Object).

Ejemplo:

 1 $(selector).elfinder({
 2   contextmenu : {
 3     // Comandos para el directorio actual
 4     cwd : ['reload', 'delim', 'mkdir', 'mkfile', 'upload', 'delim', 'paste', 'delim', 'info'], 
 5     // Comandos para el fichero seleccionado
 6     file : ['select', 'open', 'delim', 'copy', 'cut', 'rm', 'delim', 'duplicate', 'rename'], 
 7     // Comandos para grupos de ficheros
 8     group : ['copy', 'cut', 'rm', 'delim', 'archive', 'extract', 'delim', 'info'] 
 9   },
10   ...
11 })