: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
* @class elFinder places/favorites ui
* @author Dmitry (dio) Levashov
jQuery.fn.elfinderplaces = function(fm, opts) {
return this.each(function() {
navdir = fm.res(c, 'navdir'),
collapsed = fm.res(c, 'navcollapse'),
expanded = fm.res(c, 'navexpand'),
hover = fm.res(c, 'hover'),
clroot = fm.res(c, 'treeroot'),
dropover = fm.res(c, 'adroppable'),
tpl = fm.res('tpl', 'placedir'),
ptpl = fm.res('tpl', 'perms'),
spinner = jQuery(fm.res('tpl', 'navspinner')),
suffix = opts.suffix? opts.suffix : '',
* Convert places dir node into dir hash
* @param String directory id
id2hash = function(id) { return id.substr(6); },
* Convert places dir hash into dir node id
* @param String directory id
hash2id = function(hash) { return 'place-'+hash; },
* Convert places dir hash into dir node elment (jQuery object)
* @param String directory id
hash2elm = function(hash) { return jQuery(document.getElementById(hash2id(hash))); },
* Save current places state
var hashes = [], data = {};
hashes = jQuery.map(subtree.children().find('[id]'), function(n) {
jQuery.each(hashes.reverse(), function(i, h) {
key = 'places'+(opts.suffix? opts.suffix : ''),
if (typeof dat === 'string') {
// old data type elFinder <= 2.1.12
dat = jQuery.grep(dat.split(','), function(hash) { return hash? true : false;});
jQuery.each(dat, function(i, d) {
dirs[dir[0]] = dir[1]? dir[1] : dir[0];
} else if (jQuery.isPlainObject(dat)) {
* example for preset places
* elfinderInstance.bind('placesload', function(e, fm) {
* //if (fm.storage(e.data.storageKey) === null) { // for first time only
* if (!fm.storage(e.data.storageKey)) { // for empty places
* e.data.dirs[targetHash] = fallbackName; // preset folder
fm.trigger('placesload', {dirs: dirs, storageKey: key}, true);
hashes = Object.keys(dirs);
data : {cmd : 'info', targets : hashes},
data.files && data.files.length && fm.cache(data.files);
jQuery.each(data.files, function(i, f) {
jQuery.each(dirs, function(h, f) {
add(exists[h] || Object.assign({notfound: true}, f));
if (fm.storage('placesState') > 0) {
* Return node for given dir object
* @param Object directory object
create = function(dir, hash) {
return jQuery(tpl.replace(/\{id\}/, hash2id(dir? dir.hash : hash))
.replace(/\{name\}/, fm.escape(dir? dir.i18 || dir.name : hash))
.replace(/\{cssclass\}/, dir? (fm.perms2class(dir) + (dir.notfound? ' elfinder-na' : '') + (dir.csscls? ' '+dir.csscls : '')) : '')
.replace(/\{permissions\}/, (dir && (!dir.read || !dir.write || dir.notfound))? ptpl : '')
.replace(/\{title\}/, dir? (' title="' + fm.escape(fm.path(dir.hash, true) || dir.i18 || dir.name) + '"') : '')
.replace(/\{symlink\}/, '')
.replace(/\{style\}/, (dir && dir.icon)? fm.getIconStyle(dir) : ''));
* Add new node into places
* @param Object directory object
if (dir.mime !== 'directory') {
if (!fm.files().hasOwnProperty(hash)) {
fm.trigger('tree', {tree: [dir]});
node = create(dir, hash);
root.addClass(collapsed);
sortBtn.toggle(subtree.children().length > 1);
* @param String directory hash
* @return String removed name
remove = function(hash) {
var name = null, tgt, cnt;
cnt = subtree.children().length;
root.removeClass(collapsed);
places.removeClass(expanded);
subtree.slideToggle(false);
* @param String directory hash
moveup = function(hash) {
var self = hash2elm(hash),
ctm = fm.getUI('contextmenu');
menuTimer && clearTimeout(menuTimer);
ctm.find(':first').data('placesHash', hash);
menuTimer = setTimeout(function() {
if (ctm.find(':first').data('placesHash') === hash) {
* @param Object directory
* @param String previous hash
update = function(dir, preHash) {
tgt = hash2elm(preHash || hash),
node = create(dir, hash);
tgt.parent().replaceWith(node);
* Remove all dir from places
root.removeClass(collapsed);
places.removeClass(expanded);
subtree.slideToggle(false);
jQuery.each(dirs, function(h, f) {
var dir = fm.file(h) || f,
if (subtree.children().length) {
jQuery.each(subtree.children(), function() {
var current = jQuery(this);
if ((dir.i18 || dir.name).localeCompare(current.children('.'+navdir).text()) < 0) {
ret = !node.insertBefore(current);
!hash2elm(h).length && subtree.append(node);
sortBtn = jQuery('<span class="elfinder-button-icon elfinder-button-icon-sort elfinder-places-root-icon" title="'+fm.i18n('cmdsort')+'"></span>')
.on('click', function(e) {
* Node - wrapper for places root
hash : 'root-'+fm.namespace,
name : fm.i18n(opts.name, 'places'),
root = wrapper.children('.'+navdir)
.on('click', function(e) {
if (root.hasClass(collapsed)) {
places.toggleClass(expanded);
fm.storage('placesState', places.hasClass(expanded)? 1 : 0);
subtree = wrapper.children('.'+fm.res(c, 'navsubtree')),
places = jQuery(this).addClass(fm.res(c, 'tree')+' elfinder-places ui-corner-all')
.appendTo(fm.getUI('navbar'))
.on('mouseenter mouseleave', '.'+navdir, function(e) {
jQuery(this).toggleClass('ui-state-hover', (e.type == 'mouseenter'));
.on('click', '.'+navdir, function(e) {
! p.hasClass('elfinder-na') && fm.exec('open', p.attr('id').substr(6));
.on('contextmenu', '.'+navdir+':not(.'+clroot+')', function(e) {
hash = self.attr('id').substr(6);
fm.trigger('contextmenu', {
label : fm.i18n('moveUp'),
callback : function() { moveup(hash); save(); }
label : fm.i18n('rmFromPlaces'),
callback : function() { remove(hash); save(); }
self.addClass('ui-state-hover');
fm.getUI('contextmenu').children().on('mouseenter', function() {
self.addClass('ui-state-hover');
fm.bind('closecontextmenu', function() {
self.removeClass('ui-state-hover');
accept : '.elfinder-cwd-file-wrapper,.elfinder-tree-dir,.elfinder-cwd-file',
hoverClass : fm.res('class', 'adroppable'),
classes : { // Deprecated hoverClass jQueryUI>=1.12.0
'ui-droppable-hover': fm.res('class', 'adroppable')
dir = jQuery.grep(helper.data('files'), function(h) { return (fm.file(h).mime === 'directory' && !dirs[h])? true : false; });
helper.data('dropover', helper.data('dropover') + 1);
if (fm.insideWorkzone(e.pageX, e.pageY)) {
helper.addClass('elfinder-drag-helper-plus');
fm.trigger('unlockfiles', {files : helper.data('files'), helper: helper});
jQuery(this).removeClass(dropover);
helper.removeClass('elfinder-drag-helper-move elfinder-drag-helper-plus').data('dropover', Math.max(helper.data('dropover') - 1, 0));
jQuery(this).removeData('dropover')
jQuery.each(helper.data('files'), function(i, hash) {
if (dir && dir.mime == 'directory' && !dirs[dir.hash]) {
resolve && helper.hide();
.on('touchstart', '.'+navdir+':not(.'+clroot+')', function(e) {
if (e.originalEvent.touches.length > 1) {
var hash = jQuery(this).attr('id').substr(6),
.data('tmlongtap', setTimeout(function(){
fm.trigger('contextmenu', {
label : fm.i18n('rmFromPlaces'),
callback : function() { remove(hash); save(); }
'x' : e.originalEvent.touches[0].pageX,
'y' : e.originalEvent.touches[0].pageY
.on('touchmove touchend', '.'+navdir+':not(.'+clroot+')', function(e) {
clearTimeout(jQuery(this).data('tmlongtap'));
if (e.type == 'touchmove') {
jQuery(this).removeClass(hover);
if (jQuery.fn.sortable) {
subtree.addClass('touch-punch')
var dir = jQuery(e.target).parent();
dir.children().removeClass('ui-state-hover');
return jQuery('<div class="ui-widget elfinder-place-drag elfinder-'+fm.direction+'"></div>')
.append(jQuery('<div class="elfinder-navbar"></div>').show().append(dir.clone()));
var target = jQuery(ui.item[0]),
top = places.offset().top,
left = places.offset().left,
height = places.height(),
if (!(x > left && x < left+width && y > top && y < y+height)) {
remove(id2hash(target.children(':first').attr('id')));
update : function(e, ui) {
// "on regist" for command exec
jQuery(this).on('regist', function(e, files){
jQuery.each(files, function(i, dir) {
if (dir && dir.mime == 'directory' && !dirs[dir.hash]) {