Open-filemanager

free filemanager for tinymce 3-4, ckeditor 4 or standalone version

Бесплатный файлменеджер для управления файлами. Легкий, гибкий, быстрая загрузка, легко настраивать и расширять. Поддержка транслита, преобразование изображений, гибкая настройка прав на каждый каталог в отдельности, мультизагрузка, CSRF защита, поддержка модулей

Требования

PHP 5.2+ Наличие Jquery IE 8+ (или любой другой браузер) GD библиотека (для возможности преобразовывать изображения)

Настройка

Вся настройка параметров указана в самом начале файла. Для удобства обновления - вы можете настроить файл open-fileserver-config.php в аналогичной папке с изменением настроек по умолчанию, или использовать свой файл с конфигурацией, указав его в GET['config'] параметре. Если параметр передан - файл с настройками должен иметь путь с open-filemanager-config-{GET['config']}.php

Пример файла конфигурации для файл-менеджера

if (!$open_filemanager)die('sorry'); $basefolder='images/userfiles'; // базовая директория для работы с изображениями $upload_extensions=array('gif','jpeg','jpg','png'); // допустимые расширения файлов для загрузки $csrf_secret='mysecretphrase'; // ваш защитный ключ для обеспечения CSRF защиты $basehttp='http://'.$_SERVER['HTTP_HOST'].'/'; // путь к начальной папке с сайтом $replace_when_exists=true; // замена изображения при совпадении имен $lazy_load=true; // ленивая загрузка изображений (включена по умолчанию) $translit=true; // включен ли транслит (рекомендуется) $soft_check=0; // более мягкая проверка путей. Проверяться будут на схожесть последние soft_check символов $modify_images=array( 'aspect-ratio-modify'=>'crop', // преобразование изображений к нужным пропорциям (crop,resize,false) 'aspect-ratio-crop-position'=>100, // выбор части обрезаемого изобржения - при обрезании 'aspect-ratio-prop'=>2/3, // пропорции итогового изображения 'max-width'=>false, // максимальная ширина изображения 'max-height'=>1000, // максимальня высота изображения 'quality'=>50, // качество изображения (от 0 до 100) 'format'=>false // исходный формат. (jpg,png,gif,false==source) ); // подгружаемые скрипты. Если вы захотите расположить их где-то в другом месте - можете изменить их положение легко $include=array( array('type'=>'js','href'=>'//code.jquery.com/jquery-1.11.0.min.js'), array('type'=>'js','href'=>$basehttp.'/js/open-filemanager.js'), array('type'=>'css','href'=>$basehttp.'/css/open-filemanager.css'), ); if ($lazy_load)$include[]=array('type'=>'js','href'=>$basehttp.'/js/lazyload.js'); // скрытие и отображение только конкретных файлов в каталоге. Имена файлов должны идти в качестве ключей массивов $show_files=array(); // key as filename/foldername $hide_files=array(); // key as filename/foldername // права доступа. Установите нужный показатель, например переменную в сессии, например if ($_SESSION['read-only']){ $rights=array('access'=>true,'file'=>array('read'=>true,'choose'=>true),'folder'=>array('read'=>true)); // access // flle - read,delete,rename,upload,choose // folder - read,delete,rename,create }

Настройка для работы с tinymce 4. Пример подключения

tinymce.init({ ... file_browser_callback: function(field_name, url, type, win) { tinyMCE.activeEditor.windowManager.open({ url: "open-filemanager.php", width: 782, height: 440, close_previous: "no", inline: "yes" }, { window : win, input: field_name }); } });

Настройка для работы с ckeditor 4. Пример подключения

$('textarea').ckeditor({ ... filebrowserBrowseUrl :'open-filemanager.php', filebrowserImageBrowseUrl : 'open-filemanager.php', ... });

Вызов файл-менеджера в качестве автономного решения

В примере указывается подключение отдельного файла с конфигурацией open-filemanager-config-content.php в аналогичном каталоге и передается функция обратного вызова set_pp. На случай обращения из множества полей на одной странице. Не забудьте предоставить права на выбор файла $rights['file']['choose']=true; в конфигурации

window.open("open-filemanager.php?config=content&choose=set_pp", "get_image", "width=800,height=800,status=no,toolbar=no,menubar=no,scrollbars=yes"); function set_pp(image){ alert(image); }

Встраивание менеджера inline внутри страницы

Для встраивания менеджера внутрь своей формы и обрамления - используйте буферизацию в логическом файле Пример

$rights=array('access'=>true, 'file'=>array('read'=>true,'delete'=>true,'rename'=>true,'upload'=>true)); ob_start(); require 'open-filemanager.php'; $manager=ob_get_contents(); ob_clean();

и вывод в файле (месте) шаблонов

<div class="wrapper" style="margin: 20px;border: 1px solid #333;"> <?=$manager?> </div>

Пример файла конфигурации для определения настроек в зависимости от каталога

Структура приведенная ниже позволяет задать для каждой папки свою группу любых настроек, от прав, до правил обработки изображений. Все настройки накладываются на предыдущие, если они указаны в списке

// права по умолчанию $rights=array('access'=>true,'file'=>array('read'=>false,'delete'=>false,'rename'=>false,'upload'=>false,'choose'=>false),'folder'=>array('read'=>true,'delete'=>false,'rename'=>false,'create'=>false)); // for each folder if (!$_GET['folder'])return true; $links=explode('/',substr($_GET['folder'],1)); foreach ($links as $item){ $folder[]=$item; switch (implode('/',$folder)){ case 'myimages': // категория пользователя. В ней у пользователя есть все права $rights=array('access'=>true,'file'=>array('read'=>true,'delete'=>true,'rename'=>true,'upload'=>true,'choose'=>true),'folder'=>array('read'=>true,'delete'=>true,'rename'=>true,'create'=>true)); break; case 'myimages/blog': // категория блогов для пользователя. В ней у пользователя действует ограниченый список прав и существуют свои правила для заливки изображений $rights['folder']=array('read'=>false,'delete'=>false,'rename'=>false,'create'=>false); $modify_images=array( 'aspect-ratio-modify'=>'crop', 'aspect-ratio-crop-position'=>100, 'aspect-ratio-prop'=>2/3, 'max-width'=>false, 'max-height'=>1000, 'quality'=>50, 'format'=>'jpg' ); case 'public': // публичная категория. В ней у пользователя есть права только на просмотр $rights=array('access'=>true,'file'=>array('read'=>true,'delete'=>false,'rename'=>false,'upload'=>false,'choose'=>true),'folder'=>array('read'=>true,'delete'=>false,'rename'=>false,'create'=>false)); break; } }

Подключение собственных модулей

У вас есть возможность встроить и вызывать свои модули для работы с open-filemanager. Будь то генератор текстов, изображений, заливальщик, преобразователь и т.д. Чтобы зарегистрировать модуль - нужно указать его в архиве $modules в виде структуры

$modules['text-generator']=array( 'header'=>'Создать надпись', // заголовок в меню 'link'=>'gettext.html' // ссылка на файл модуля 'for'=>'{folder:true,file:true,empty:true}'; // права действия модуля );

Модуль откроется в отдельном окне. Для получения модулем текущего каталога open-filemanager - используйте код

var folder=opener.folder;

Для получения текущего выделенного объекта - можете использовать конструкцию вида

var selected=opener.get_path($('.selected'));

Примечание: Проверка прав на каталог осуществляется в рамках модуля. Open-filemanager лишь вызывает его с указанием директории и позволяет обратиться и произвести какие-либо манипуляции через объект opener.

Подключение TinyPNG

Для использования tinypng - вам потребуется получить api key на сайте и прописать его в настройки open-filemanager а также подключить классы tinify https://github.com/tinify/tinify-php Подгрузку классов можно использовать через autoload, а можно принудительно указать классы Пример использования файла настроек

$tinypng_key='my API key'; $tinypng_repeat=1; require 'class/Tinify/Source.php'; require 'class/Tinify/ResultMeta.php'; require 'class/Tinify/Exception.php'; require 'class/Tinify/Client.php'; require 'class/Tinify.php'; require 'class/Tinify/Result.php';

Параметр $tinypng_repeat - указывает на число повторений при загрузке изображения. Одно изображение прокручивается через api указаное количество раз. Таким образом достигается наилучший результат.

Краткая история версий

2.8b

Добавлен механизм использования tinypng.org api сжатия изображений Возможность указания набора прав для собственных модулей. На новый объект, папку или файл

2.7

Добавлена поддержка мобильных устройств Исправлен баг issue#1 Когда tinymce находился внетри фрейма

2.6

Добавлена возможность передавать множество произвольных параметров в GET строке

2.5

Загрузка и чтение файлов с любым расширением

2.4

Поддержка CKEditor 4

2.3

CSRF защита Формат изображений для загрузки - по умолчанию выбран изображения Добавлена иконка для директорий Директории располагаются в самом начале, а не в перемешку с файлами Увеличена область показа миниатюрки Добавлена поддержка собственных модулей Добавлена возможность настроить отдельные настройки на каждый каталог в отдельности Добавлена возможность скрыть конкретные файлы, или отобразить только указаные файлы из всего каталога Небольшие исправления с транскрипцией

2.2

Возможность указания нечеткой проверки путей soft_check Вызов в качестве автономного пикера файлов Возможность вызова файл-менеджера с разными конфигурациями (для разнообразного использования в рамках одного сайта)

2.1

Все настройки перечислены до кодов для удобной конфигурации

2.0

Мультизаливка файлов Гибкая настройка прав Преобразование изображений Замена изображений при совпадении имен Встраивание менеджера внутрь страницы Возможность указать собственные настройки в отдельном файле для удобства обновления

1.0

Базовый функционал Настройка прав Транслит Заливка файлов Выбор файлов для TinyMCE 3 и TinyMCE 4

Планы

локализация Drag&Drop upload Поиск файлов Отображение хлебных крошек Перестройка работы в качестве класса

Страница проекта

http://kosmom.ru/web/open-filemanager