ImageBrowser vs CKFinder

CKEditor Picture Web browser plugin
imagebrowser is a CKEditor plug-in that allows pictures on the hosting server to be searched and selected for addition into the editor's material.

This plug-in combines with the picture plug-in (part of CKEditor), by making it offer a Surf Server key in the Picture discussion screen (screenshot here).

The way you use it is very just like imageGetJson in Redactor - you only need to offer a record of pictures in a JSON structure, and the picture browser will manage the relax.

In reality, it uses the same information structure as Redactor, enabling for an simple conversion between the two publishers.

Installation

Copy the whole contents of this repository into a new plugins/imagebrowser directory in your CKEditor install.

Usage

Enable the plugin by adding it to extraPlugins and specify the imageBrowser_listUrl parameter:

CKEditor.replace('textareaId', {
        "extraPlugins": "imagebrowser",
        "imageBrowser_listUrl": "/path/to/images_list.json"
});

The imageBrowser_listUrl configuration parameter points to a URL that lists the server's images in a JSON format.

Example:

[
        {
                "thumb": "/image1_thumb.jpg",
                "image": "/image1_200x150.jpg",
                "folder": "Small"
        },
        {
                "thumb": "/image2_thumb.jpg",
                "image": "/image2_200x150.jpg",
                "folder": "Small"
        },

        {
                "thumb": "/image1_thumb.jpg",
                "image": "/image1_full.jpg",
                "folder": "Large"
        },
        {
                "thumb": "/image2_thumb.jpg",
                "image": "/image2_full.jpg",
                "folder": "Large"
        }
]

The above says that there are 2 image directories ("Small" and "Large") with 2 files in each of them.

The thumb field specifies the relative/absolute path to the image's thumbnail (for preview purposes).

The image field is the relative/absolute path being used when the image gets put into the editor's contents.

The folder field is optional. If omitted, the image list will not be split into categories.