[
{
"path": ".gitignore",
"content": "vendor/\n_connector/\npublic/\ncomposer.lock\n"
},
{
"path": "LICENSE.md",
"content": "Software License Agreement\n==========================\n\nCopyright (c) 2023, CKSource Holding sp. z o.o. All rights reserved.\n\nCKFinder package for Laravel is licensed under the terms of the MIT license (see Appendix A).\n\nTrademarks\n----------\n\nCKFinder is a trademark of CKSource Holding sp. z o.o. All other brand\nand product names are trademarks, registered trademarks or service\nmarks of their respective holders.\n\nSources of Intellectual Property required by package\n----------------------------------------------------\n\nThe installation instruction requires user to run the following command to download\nCKFinder separately (the file manager itself):\n\n```bash\nartisan ckfinder:download\n```\n\nThe downloaded CKFinder distribution is licensed under a separate CKFinder License.\n\n---\n\nAppendix A: The MIT License\n---------------------------\n\nThe MIT License (MIT)\n\nCopyright (c) 2023, CKSource Holding sp. z o.o. All rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n"
},
{
"path": "README.md",
"content": "
\n\n# CKFinder 3 Package for Laravel 9+ [](https://twitter.com/intent/tweet?text=Check%20out%20CKFinder%20package%20for%20Laravel%20&url=https://github.com/ckfinder/ckfinder-laravel-package)\n\n[]()\n[](https://opensource.org/licenses/MIT)\n[](https://packagist.org/packages/ckfinder/ckfinder-laravel-package)\n[](https://packagist.org/packages/ckfinder/ckfinder-laravel-package)\n[](http://eepurl.com/c3zRPr)\n[](https://twitter.com/ckeditor)\n\nThis repository contains the CKFinder 3 Package for Laravel 9+. If you are looking for a package for older version of Laravel, please use [version 3](https://github.com/ckfinder/ckfinder-laravel-package/tree/v3.x.x).\n\n
\n\n## Installation\n\n1. Add a Composer dependency and install the package.\n\n ```bash\n composer require ckfinder/ckfinder-laravel-package\n ```\n\n2. Run the command to download the CKFinder code.\n\n After installing the Laravel package you need to download CKFinder code. It is not shipped with the package due to different license terms. To install it, run the following `artisan` command:\n\n ```bash\n php artisan ckfinder:download\n ```\n\n It will download the required code and place it inside an appropriate directory of the package (`vendor/ckfinder/ckfinder-laravel-package/`).\n\n3. Publish the CKFinder connector configuration and assets.\n\n ```bash\n php artisan vendor:publish --tag=ckfinder-assets --tag=ckfinder-config\n ```\n\n This will publish CKFinder assets to `public/js/ckfinder`, and the CKFinder connector configuration to `config/ckfinder.php`.\n \n You can also publish the views used by this package in case you need custom route names, different assets location, file browser customization etc.\n \n ```bash\n php artisan vendor:publish --tag=ckfinder-views\n ```\n \n Finally, you can publish package's configuration, assets and views using only one command.\n \n ```bash\n php artisan vendor:publish --tag=ckfinder\n ```\n\n4. Create a directory for CKFinder files and allow for write access to it. By default CKFinder expects the files to be placed in `public/userfiles` (this can be altered in the configuration).\n\n ```bash\n mkdir -m 777 public/userfiles\n ```\n\n **NOTE:** Since usually setting permissions to `0777` is insecure, it is advisable to change the group ownership of the directory to the same user as Apache and add group write permissions instead. Please contact your system administrator in case of any doubts.\n\n\n5. CKFinder by default uses a CSRF protection mechanism based on [double submit cookies](https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html#double-submit-cookie). On some configurations it may be required to configure Laravel not to encrypt the cookie set by CKFinder. To do that:\n\n **For Laravel <= 10:**\n\n Please add the cookie name `ckCsrfToken` to the `$except` property of `EncryptCookies` middleware:\n\n ```php\n // app/Http/Middleware/EncryptCookies.php\n\n namespace App\\Http\\Middleware;\n\n use Illuminate\\Cookie\\Middleware\\EncryptCookies as Middleware;\n\n class EncryptCookies extends Middleware\n {\n /**\n * The names of the cookies that should not be encrypted.\n *\n * @var array\n */\n protected $except = [\n 'ckCsrfToken',\n // ...\n ];\n }\n ```\n\n You should also disable Laravel's CSRF protection for CKFinder's path, as CKFinder uses its own CSRF protection mechanism. This can be done by adding `ckfinder/*` pattern to the `$except` property of `VerifyCsrfToken` middleware:\n\n ```php\n // app/Http/Middleware/VerifyCsrfToken.php\n\n namespace App\\Http\\Middleware;\n\n use Illuminate\\Foundation\\Http\\Middleware\\VerifyCsrfToken as Middleware;\n\n class VerifyCsrfToken extends Middleware\n {\n /**\n * The URIs that should be excluded from CSRF verification.\n *\n * @var array\n */\n protected $except = [\n 'ckfinder/*',\n // ...\n ];\n }\n ```\n\n **For Laravel >= 11:**\n\n Two calls must be added, which introduce exceptions in CSRF protection mechanism.\n\n First one configure Laravel not to encrypt the cookie set by CKFinder:\n\n ```php\n $middleware->encryptCookies(except: [\n 'ckCsrfToken',\n ]);\n ```\n\n Second one disables Laravel's CSRF protection for CKFinder's path:\n\n ```php\n $middleware->validateCsrfTokens(except: [\n 'ckfinder/*'\n ]);\n ```\n\n File `bootstrap/app.php` should look like this:\n\n ```php\n // bootstrap/app.php\n use Illuminate\\Foundation\\Application;\n use Illuminate\\Foundation\\Configuration\\Exceptions;\n use Illuminate\\Foundation\\Configuration\\Middleware;\n\n return Application::configure(basePath: dirname(__DIR__))\n ->withRouting(\n web: __DIR__.'/../routes/web.php',\n commands: __DIR__.'/../routes/console.php',\n health: '/up',\n )\n ->withMiddleware(function (Middleware $middleware): void {\n $middleware->validateCsrfTokens(except: [\n 'ckfinder/*'\n ]);\n $middleware->encryptCookies(except: [\n 'ckCsrfToken',\n ]);\n })\n ->withExceptions(function (Exceptions $exceptions): void {\n })->create();\n ```\n\nAt this point you should see the connector JSON response after navigating to the `/ckfinder/connector?command=Init` address.\nAuthentication for CKFinder is not configured yet, so you will see an error response saying that CKFinder is not enabled.\n\n## Configuring Authentication\n\nCKFinder connector authentication is handled by [middleware](https://laravel.com/docs/5.8/middleware) class or alias. To create the custom middleware class, use the artisan command:\n\n```bash\nphp artisan make:middleware CustomCKFinderAuth\n```\n\nThe new middleware class will appear in `app/Http/Middleware/CustomCKFinderAuth.php`. Change the `authentication` option in `config/ckfinder.php`:\n\n```php\n$config['authentication'] = '\\App\\Http\\Middleware\\CustomCKFinderAuth';\n```\n\nThe `handle` method in `CustomCKFinderAuth` class allows to authenticate CKFinder users. A basic implementation that returns `true` from the `authentication` callable (which is obviously **not secure**) can look like below:\n\n```php\npublic function handle($request, Closure $next)\n{\n config(['ckfinder.authentication' => function() {\n return true;\n }]);\n return $next($request);\n}\n```\n\nPlease have a look at the [CKFinder for PHP connector documentation](https://ckeditor.com/docs/ckfinder/ckfinder3-php/configuration.html#configuration_options_authentication) to find out\nmore about this option.\n\n**Note**:\nAlternatively, you can set the configuration option `$config['loadRoutes'] = false;` in `config/ckfinder.php`. Then you copy the routes from `vendor/ckfinder/ckfinder-laravel-package/src/routes.php` to your application routes such as ```routes/web.php``` to protect them with your Laravel auth middleware. \n\n```php\nRoute::any('/ckfinder/connector', '\\CKSource\\CKFinderBridge\\Controller\\CKFinderController@requestAction')\n ->name('ckfinder_connector');\n\nRoute::any('/ckfinder/browser', '\\CKSource\\CKFinderBridge\\Controller\\CKFinderController@browserAction')\n ->name('ckfinder_browser');\n```\n\n## Configuration Options\n\nThe CKFinder connector configuration is taken from the `config/ckfinder.php` file.\n\nTo find out more about possible connector configuration options please refer to the [CKFinder for PHP connector documentation](https://ckeditor.com/docs/ckfinder/ckfinder3-php/configuration.html).\n\n## Usage\n\nThe package code contains a couple of usage examples that you may find useful. To enable them, uncomment the `ckfinder_examples`\nroute in `vendor/ckfinder/ckfinder-laravel-package/src/routes.php`:\n\n```php\n// vendor/ckfinder/ckfinder-laravel-package/src/routes.php\n\nRoute::any('/ckfinder/examples/{example?}', 'CKSource\\CKFinderBridge\\Controller\\CKFinderController@examplesAction')\n ->name('ckfinder_examples');\n```\n\nAfter that you can navigate to the `/ckfinder/examples` path and have a look at the list of available examples.\nTo find out about the code behind them, check the `views/samples` directory in the package (`vendor/ckfinder/ckfinder-laravel-package/views/samples/`).\n\n### Including the Main CKFinder JavaScript File in Templates\n\nTo be able to use CKFinder on a web page you have to include the main CKFinder JavaScript file.\nThe preferred way to do that is to include the CKFinder setup template, as shown below:\n\n```blade\n@include('ckfinder::setup')\n```\n\nThe included template renders the required `script` tags and configures a valid connector path.\n\n```html\n\n\n```\n\n---\n\n## Useful Links\n\n * [CKFinder 3 usage examples](https://ckeditor.com/docs/ckfinder/demo/ckfinder3/samples/widget.html)\n * [CKFinder 3 for PHP connector documentation](https://ckeditor.com/docs/ckfinder/ckfinder3-php/)\n * [CKFinder 3 Developer's Guide](https://ckeditor.com/docs/ckfinder/ckfinder3/)\n * [CKFinder 3 issue tracker](https://github.com/ckfinder/ckfinder)\n"
},
{
"path": "composer.json",
"content": "{\n \"name\": \"ckfinder/ckfinder-laravel-package\",\n \"description\": \"CKFinder 3 package for Laravel\",\n \"type\": \"library\",\n \"license\": \"MIT\",\n \"require\": {\n \"php\": \">=8.1.0\",\n \"laravel/framework\": \"^9.0|^10.0|^11.0|^12.0\",\n \"pimple/pimple\": \"~3.0\",\n \"league/flysystem\": \"^3.0\",\n \"league/flysystem-aws-s3-v3\": \"^3.0\",\n \"league/flysystem-azure-blob-storage\": \"^3.0\",\n \"league/flysystem-ftp\": \"^3.0\",\n \"spatie/flysystem-dropbox\": \"^2.0|^3.0\",\n \"ext-json\": \"*\",\n \"ext-gd\": \"*\",\n \"ext-zip\": \"*\"\n },\n \"autoload\": {\n \"psr-4\": {\n \"CKSource\\\\CKFinderBridge\\\\\": \"src/\",\n \"CKSource\\\\CKFinder\\\\\": \"_connector/\"\n }\n },\n \"extra\": {\n \"laravel\": {\n \"providers\": [\n \"CKSource\\\\CKFinderBridge\\\\CKFinderServiceProvider\"\n ]\n }\n }\n}\n"
},
{
"path": "src/CKFinderMiddleware.php",
"content": " function() use ($request) {\n\n return false;\n }] );\n\n return $next($request);\n }\n}\n"
},
{
"path": "src/CKFinderServiceProvider.php",
"content": "loadRoutesFrom(__DIR__.'/routes.php');\n }\n $this->loadViewsFrom(__DIR__.'/../views', 'ckfinder');\n\n if ($this->app->runningInConsole()) {\n $this->commands([CKFinderDownloadCommand::class]);\n\n $this->publishes([\n __DIR__.'/config.php' => config_path('ckfinder.php')\n ], ['ckfinder-config']);\n\n $this->publishes([\n __DIR__.'/../public' => public_path('js')\n ], ['ckfinder-assets']);\n\n $this->publishes([\n __DIR__.'/../views/setup.blade.php' => resource_path('views/vendor/ckfinder/setup.blade.php'),\n __DIR__.'/../views/browser.blade.php' => resource_path('views/vendor/ckfinder/browser.blade.php')\n ], ['ckfinder-views']);\n\n return;\n }\n\n $this->app->bind('ckfinder.connector', function() {\n if (!class_exists('\\CKSource\\CKFinder\\CKFinder')) {\n throw new \\Exception(\n \"Couldn't find CKFinder conector code. \".\n \"Please run `artisan ckfinder:download` command first.\"\n );\n }\n\n $ckfinderConfig = config('ckfinder');\n\n if (is_null($ckfinderConfig)) {\n throw new \\Exception(\n \"Couldn't load CKFinder configuration file. \".\n \"Please run `artisan vendor:publish --tag=ckfinder` command first.\"\n );\n }\n\n $ckfinder = new \\CKSource\\CKFinder\\CKFinder($ckfinderConfig);\n\n return $ckfinder;\n });\n }\n}\n"
},
{
"path": "src/Command/CKFinderDownloadCommand.php",
"content": "error('The target public directory is not writable (used path: ' . $targetPublicPath . ').');\n\n return;\n }\n\n $targetConnectorPath = realpath(__DIR__ . '/../../_connector');\n\n if (!is_writable($targetConnectorPath)) {\n $this->error('The the connector directory is not writable (used path: ' . $targetConnectorPath . ').');\n\n return;\n }\n\n if (file_exists($targetPublicPath.'/ckfinder/ckfinder.js')) {\n $questionText =\n 'It looks like the CKFinder distribution package has already been installed. ' .\n \"This command will overwrite the existing files.\\nDo you want to proceed? [y/n]: \";\n\n if (!$this->confirm($questionText)) {\n return;\n }\n }\n\n /** @var \\Symfony\\Component\\Console\\Helper\\ProgressBar $progressBar */\n $progressBar = null;\n\n $maxBytes = 0;\n $ctx = stream_context_create([], [\n 'notification' =>\n function ($notificationCode, $severity, $message, $messageCode, $bytesTransferred, $bytesMax) use (&$maxBytes, &$progressBar) {\n switch ($notificationCode) {\n case STREAM_NOTIFY_FILE_SIZE_IS:\n $maxBytes = $bytesMax;\n $progressBar = $this->output->createProgressBar($bytesMax);\n break;\n case STREAM_NOTIFY_PROGRESS:\n $progressBar->setProgress($bytesTransferred);\n break;\n }\n }\n ]);\n\n $this->info('Downloading the CKFinder 3 distribution package.');\n\n $zipContents = @file_get_contents($this->buildPackageUrl(), false, $ctx);\n\n if ($zipContents === false) {\n $this->error('Could not download the distribution package of CKFinder.');\n\n return;\n }\n\n if ($progressBar) {\n $progressBar->finish();\n }\n\n $this->line(\"\\n\" . 'Extracting CKFinder to the ' . $targetPublicPath . ' directory.');\n\n $tempZipFile = tempnam(sys_get_temp_dir(), 'tmp');\n file_put_contents($tempZipFile, $zipContents);\n $zip = new \\ZipArchive();\n $zip->open($tempZipFile);\n\n $zipEntries = [];\n\n // These files won't be overwritten if already exists\n $filesToKeep = [\n 'ckfinder/config.js',\n 'ckfinder/ckfinder.html'\n ];\n\n for ($i = 0; $i < $zip->numFiles; $i++) {\n $entry = $zip->getNameIndex($i);\n\n if (in_array($entry, $filesToKeep) && file_exists($targetPublicPath . '/' . $entry)) {\n continue;\n }\n\n $zipEntries[] = $entry;\n }\n\n $zip->extractTo($targetPublicPath, $zipEntries);\n\n $fs = new Filesystem();\n\n $this->line('Moving the CKFinder connector to the ' . $targetConnectorPath . ' directory.');\n $fs->moveDirectory(\n $targetPublicPath . '/ckfinder/core/connector/php/vendor/cksource/ckfinder/src/CKSource/CKFinder',\n $targetConnectorPath,\n true\n );\n\n $this->line('Cleaning up.');\n\n $fs->delete([\n $tempZipFile,\n $targetPublicPath . '/ckfinder/config.php',\n $targetPublicPath . '/ckfinder/README.md',\n $targetConnectorPath . '/README.md'\n ]);\n\n $fs->deleteDirectory($targetPublicPath . '/ckfinder/core');\n $fs->deleteDirectory($targetPublicPath . '/ckfinder/userfiles');\n\n\n $this->info('Done. Happy coding!');\n }\n}\n"
},
{
"path": "src/Controller/CKFinderController.php",
"content": "middleware($authenticationMiddleware);\n } else {\n $this->middleware(\\CKSource\\CKFinderBridge\\CKFinderMiddleware::class);\n }\n }\n }\n\n /**\n * Action that handles all CKFinder requests.\n *\n * @param ContainerInterface $container\n * @param Request $request\n *\n * @return \\Symfony\\Component\\HttpFoundation\\Response\n */\n public function requestAction(ContainerInterface $container, Request $request)\n {\n /** @var CKFinder $connector */\n $connector = $container->get('ckfinder.connector');\n\n // If debug mode is enabled then do not catch exceptions and pass them directly to Laravel.\n $enableDebugMode = config('ckfinder.debug');\n\n return $connector->handle($request, HttpKernelInterface::MAIN_REQUEST, !$enableDebugMode);\n }\n\n /**\n * Action that displays CKFinder browser.\n *\n * @return string\n */\n public function browserAction(ContainerInterface $container, Request $request)\n {\n return view('ckfinder::browser');\n }\n\n /**\n * Action for CKFinder usage examples.\n *\n * To browse examples, please uncomment ckfinder_examples route in\n * vendor/ckfinder/ckfinder-laravel-package/src/routes.php\n *\n * @param string|null $example\n */\n public function examplesAction($example = null)\n {\n $example = strtolower($example);\n\n $knownExamples = [\n 'integration' => ['widget', 'popups', 'modals', 'full-page', 'full-page-open'],\n 'ckeditor' => ['ckeditor'],\n 'skins' => ['skins-moono', 'skins-jquery-mobile'],\n 'user-interface' => ['user-interface-default', 'user-interface-compact', 'user-interface-mobile', 'user-interface-listview'],\n 'localization' => ['localization'],\n 'other' => ['other-read-only', 'other-custom-configuration'],\n 'plugin-examples' => ['plugin-examples'],\n ];\n\n $navInfo = ['section' => null, 'sample' => null];\n\n foreach ($knownExamples as $section => $examples) {\n if (in_array($example, $examples)) {\n $navInfo['section'] = $section;\n $navInfo['sample'] = $example;\n\n return view('ckfinder::samples/'.$example, $navInfo);\n }\n }\n\n return view('ckfinder::samples/index', $navInfo);\n }\n}\n"
},
{
"path": "src/config.php",
"content": " 'laravel_cache',\n 'tags' => 'ckfinder/tags',\n 'cache' => 'ckfinder/cache',\n 'thumbs' => 'ckfinder/cache/thumbs',\n 'logs' => array(\n 'backend' => 'laravel_logs',\n 'path' => 'ckfinder/logs'\n )\n);\n\n/*============================ Images and Thumbnails ==================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_images\n\n$config['images'] = array(\n 'maxWidth' => 1600,\n 'maxHeight' => 1200,\n 'quality' => 80,\n 'sizes' => array(\n 'small' => array('width' => 480, 'height' => 320, 'quality' => 80),\n 'medium' => array('width' => 600, 'height' => 480, 'quality' => 80),\n 'large' => array('width' => 800, 'height' => 600, 'quality' => 80)\n )\n);\n\n/*=================================== Backends ========================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_backends\n\n// The two backends defined below are internal CKFinder backends for cache and logs.\n// Plase do not change these, unless you really want it.\n$config['backends']['laravel_cache'] = array(\n 'name' => 'laravel_cache',\n 'adapter' => 'local',\n 'root' => storage_path('framework/cache')\n);\n\n$config['backends']['laravel_logs'] = array(\n 'name' => 'laravel_logs',\n 'adapter' => 'local',\n 'root' => storage_path('logs')\n);\n\n// Backends\n\n$config['backends']['default'] = array(\n 'name' => 'default',\n 'adapter' => 'local',\n 'baseUrl' => config('app.url').'/userfiles/',\n 'root' => public_path('/userfiles/'),\n 'chmodFiles' => 0777,\n 'chmodFolders' => 0755,\n 'filesystemEncoding' => 'UTF-8'\n);\n\n/*================================ Resource Types =====================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_resourceTypes\n\n$config['defaultResourceTypes'] = '';\n\n$config['resourceTypes'][] = array(\n 'name' => 'Files', // Single quotes not allowed.\n 'directory' => 'files',\n 'maxSize' => 0,\n 'allowedExtensions' => '7z,aiff,asf,avi,bmp,csv,doc,docx,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pptx,pxd,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,sitd,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,webp,wma,wmv,xls,xlsx,zip',\n 'deniedExtensions' => '',\n 'backend' => 'default'\n);\n\n$config['resourceTypes'][] = array(\n 'name' => 'Images',\n 'directory' => 'images',\n 'maxSize' => 0,\n 'allowedExtensions' => 'bmp,gif,jpeg,jpg,png,webp',\n 'deniedExtensions' => '',\n 'backend' => 'default'\n);\n\n/*================================ Access Control =====================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_roleSessionVar\n\n$config['roleSessionVar'] = 'CKFinder_UserRole';\n\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_accessControl\n$config['accessControl'][] = array(\n 'role' => '*',\n 'resourceType' => '*',\n 'folder' => '/',\n\n 'FOLDER_VIEW' => true,\n 'FOLDER_CREATE' => true,\n 'FOLDER_RENAME' => true,\n 'FOLDER_DELETE' => true,\n\n 'FILE_VIEW' => true,\n 'FILE_UPLOAD' => true,\n 'FILE_RENAME' => true,\n 'FILE_DELETE' => true,\n\n 'IMAGE_RESIZE' => true,\n 'IMAGE_RESIZE_CUSTOM' => true\n);\n\n\n/*================================ Other Settings =====================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html\n\n$config['overwriteOnUpload'] = false;\n$config['checkDoubleExtension'] = true;\n$config['disallowUnsafeCharacters'] = false;\n$config['secureImageUploads'] = true;\n$config['checkSizeAfterScaling'] = true;\n$config['htmlExtensions'] = array('html', 'htm', 'xml', 'js');\n$config['hideFolders'] = array('.*', 'CVS', '__thumbs');\n$config['hideFiles'] = array('.*');\n$config['forceAscii'] = false;\n$config['xSendfile'] = false;\n\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_debug\n$config['debug'] = false;\n\n/*==================================== Plugins ========================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_plugins\n\n$config['plugins'] = array();\n\n/*================================ Cache settings =====================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_cache\n\n$config['cache'] = array(\n 'imagePreview' => 24 * 3600,\n 'thumbnails' => 24 * 3600 * 365\n);\n\n/*============================ Temp Directory settings ================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_tempDirectory\n\n$config['tempDirectory'] = sys_get_temp_dir();\n\n/*============================ Session Cause Performance Issues =======================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_sessionWriteClose\n\n$config['sessionWriteClose'] = true;\n\n/*================================= CSRF protection ===================================*/\n// http://docs.cksource.com/ckfinder3-php/configuration.html#configuration_options_csrfProtection\n\n$config['csrfProtection'] = true;\n\n/*============================== End of Configuration =================================*/\n\n/**\n * Config must be returned - do not change it.\n */\nreturn $config;\n"
},
{
"path": "src/routes.php",
"content": "name('ckfinder_connector');\n\nRoute::any('/ckfinder/browser', '\\CKSource\\CKFinderBridge\\Controller\\CKFinderController@browserAction')\n ->name('ckfinder_browser');\n\n//Route::any('/ckfinder/examples/{example?}', '\\CKSource\\CKFinderBridge\\Controller\\CKFinderController@examplesAction')\n// ->name('ckfinder_examples');\n"
},
{
"path": "views/browser.blade.php",
"content": "\n\n\n\n \n \n CKFinder 3 - File Browser\n\n\n\n@include('ckfinder::setup')\n\n\n\n\n\n\n"
},
{
"path": "views/samples/ckeditor.blade.php",
"content": "@extends('ckfinder::samples/layout')\n\n@section('content')\n
CKEditor Integration
\n\n
CKEditor 5
\n
To integrate CKFinder with CKEditor 5\n all you have to do is pass some additional configuration options to CKEditor:
\n
ClassicEditor\n\t.create( document.querySelector( '#editor2' ), {\n\t\tckfinder: {\n // Use named route for CKFinder connector entry point\n\t\t\tuploadUrl: '@{{ route('ckfinder_connector') }}?command=QuickUpload&type=Files'\n\t\t}\n\t} )\n\t.catch( error => {\n\t\tconsole.error( error );\n\t} );\n
\n
The sample below presents the result of the integration. Try pasting images from clipboard directly into the editing area as well as dropping images — the files will be saved on the fly by CKFinder.
CKEDITOR.replace( 'editor1', {\n\t// Use named CKFinder browser route\n\tfilebrowserBrowseUrl: '@{{ route('ckfinder_browser') }}',\n\t// Use named CKFinder connector route\n\tfilebrowserUploadUrl: '@{{ route('ckfinder_connector') }}?command=QuickUpload&type=Files'\n} );
\n
It is also possible to use CKFinder.setupCKEditor() as shown below, to automatically setup integration between CKEditor and CKFinder:
\n
var editor = CKEDITOR.replace( 'ckfinder' );\nCKFinder.setupCKEditor( editor );
\n
The sample below presents the result of the integration. You can manage and select files from your server when creating links or embedding images in CKEditor 4 content. In modern browsers you may also try pasting images from clipboard directly into the editing area as well as dropping images — the files will be saved on the fly by CKFinder.
The modal mode is similar to 'popups']) }}\">popup. The difference is that popups are opened using a separate browser window while in modal mode CKFinder is opened inside a modal container that is appended to current page document.
\n\n
\n \n
\n\t\t\t\n\t\t\t \n\t\t\t\n\t\t
\n
\n \n\n
Multiple Modals
\n\n
In some cases you may need more than one modal to handle multiple places that require selecting a file.\n Below you can find an example that fills each of the inputs with the URL of the selected file.
Read-only mode can be enabled in CKFinder with the readOnly\n\t\tconfiguration option. The user will be able to browse the files but will not be able to introduce any changes. Thanks to this setting you will be able to use\n\t\tCKFinder as an online gallery.
\n\t
Note: This will only disable certain UI elements. In order to successfully block file uploads and modifications, or to set read-only permissions for particular\n\t\tfolders, you will need to adjust ACL settings\n\t\taccordingly in the server-side configuration file.
With a little bit of imagination it is possible to turn CKFinder into a very simple gallery. Here CKFinder is configured to\n\t\topen a file on double click, run without a toolbar and without the folders panel.
The example below shows the StatusBarInfo plugin that displays basic information about the selected file in the application status bar.\n\t\tYou can find more plugin examples in the CKFinder sample plugins repository.\n\t\tPlease have a look at plugin documentation, too.
\n\t
CKFinder.widget( 'ckfinder-widget', {\n\twidth: '100%',\n\theight: 500,\n\tplugins: [\n\t\t// The path must be relative to the location of the ckfinder.js file.\n\t\t'../samples/plugins/StatusBarInfo/StatusBarInfo'\n\t]\n} );
The popup mode is most suitable for selecting files that are stored on a server. \n Click the button below to open the popup and choose any file. After that you will see basic information\n about the file that was selected, including the URL.
\n\n
\n \n
\n \n \n \n
\n
\n \n\n
Additionally, CKFinder supports a special file selection mode for images called Choose Resized. This feature\n allows you to resize the selected image to any size that is suitable for you. The CKFinder connector will automatically create\n a resized version of the image and return its URL.
\n\n
Multiple Popups
\n
In some cases you may need more than one popup to handle multiple places that require selecting a file.\n Below you can find an example that fills each of the inputs with the URL of the selected file.
It is possible to disable the folders panel and have folders displayed as icons in the main area of the application.\n\t\tIn the example below this mode is initialized inside a widget, but it also works in all standalone modes.
By default files are displayed in CKFinder as thumbnails. With list view enabled all files will be displayed as a list, one bellow the other. No image previews are available in this mode.
\n\t
The list view can be enabled regardless of the selected user interface (Default/Compact/Mobile).
Mobile user interface is enabled automatically when the width of the working area of the application gets below the value\n\t\tdefined in the uiModeThreshold\n\t\tconfiguration option.
\n\t
Note: This mode works best on mobile devices, as touch and swipe events are not enabled for desktop browsers.
![](\"https://user-images.githubusercontent.com/803299/42567830-6b6d3ad6-850b-11e8-9151-43021c92d8b7.png\")
![](\"https://user-images.githubusercontent.com/803299/42693315-18717aae-86af-11e8-863a-74070edb3912.png\")