Reporting Issues

Contents

If you feel you found an issue in CKFinder, we will be grateful for letting us know.

Report bugs.
Submit feature requests.
Suggest improvements in the documentation.

Before you create a bug report, please read our guidelines on how to do it properly and most efficiently.

Reproduce on Demo Page

To eliminate the chance that the issue might be caused by some third-party software or your customizations, try to reproduce the issue on the CKFinder demo page first.

The demo site is always running the latest version of CKFinder. If the problem can be reproduced on the demo page, report an issue.

Are You Using the Latest Version?

If the problem cannot be reproduced on the demo page and you are not using the latest version of CKFinder, try upgrading your CKFinder installation first.

Make sure to clear the browser cache after upgrading. Verify whether the issue exists.

Please note that if the problem was fixed in one of the releases that succeeded the version you are using, you will need to upgrade your CKFinder installation as we do not backport fixes.

Provide Detailed Information

The more information you provide the better as the chances that we will be able to confirm and fix the issue will increase.

On what browser (name, exact version) and operating system (name, exact version) did you find the bug?
Are you able to reproduce it in other browsers?
Which version of CKFinder are you using?
Which server-side distribution of CKFinder are you using (e.g. PHP)?
What are the operating system and server configuration where CKFinder is installed?
Can the error be reproduced on any of the default samples provided with CKFinder or does it only occur when CKFinder is integrated with your application?
What are the exact steps to perform in order to reproduce the issue?
If CKFinder shows any error message, please provide it.
Do you see any errors in the JavaScript console when the issue occurs? If yes, paste all details and/or provide a screenshot of the error console.
If CKFinder does not load, does the Network tab in your browser show any HTTP errors like 403/404?
In case of issues with file uploads, does the issue happen only when large files or files of certain type are uploaded?
If you think that screenshots may help in understanding the issue, please add some. Hint: In most browsers you can paste them directly from clipboard.
Does the error happen only with some particular setup? If yes, please explain.

Careful with Posting Sensitive Data!

If your configuration file is needed to reproduce the issue, please use the dedicated support channel (or the contact form) instead so that your private data like server-side paths or license key did not leak on the public issue tracker.

Sample Bug Report

A sample bug report could look like this:

On what browser (name, exact version) and operating system (name, exact version) did you find the bug?

Google Chrome 41.0.2272.118, Fedora 21.

Are you able to reproduce it in other browsers?

Yes, IE11 on Windows 7.

Which version of CKFinder are you using?

CKFinder 3.1.2

Which server-side distribution of CKFinder are you using (e.g. PHP)?

PHP

What are the operating system and server configuration where CKFinder is installed?

Fedora 21, Apache/2.4.10 (Fedora) PHP/5.6.7

Can the error be reproduced on any of the default samples provided with CKFinder or does it only occur when CKFinder is integrated with your application?

Can be reproduced on the default widget sample.

What are the exact steps to perform in order to reproduce the issue?

Open the widget sample.
Click the first file to select it.
Press the Delete key on your keyboard to delete it.
Result: Nothing happens.
Expected result: The file is deleted.

If CKFinder shows any error message, please provide it.

No error message is shown.

Do you see any errors in the JavaScript console when the issue occurs? If yes, paste all details and/or provide a screenshot of the error console.

Yes: Uncaught TypeError: Cannot read property 'stopPropagation' of undefined

If CKFinder does not load, does the Network tab in your browser show any HTTP errors like 403/404?

No.

In case of issues with file uploads, does the issue happen only when large files or files of certain type are uploaded?

If you think that screenshots may help in understanding the issue, please add some. Hint: In most browsers you can paste them directly from clipboard.

Does the error happen only with some particular setup? If yes, please explain.

No.

Feedback Appreciated!

We are grateful for any comments and ideas that can help us make CKFinder a better application. Thank you for your feedback!