Skip to main content

A django app which provides and infrastructure you can use to include custom contents of other apps directly inside ckeditor.

Project description

# django-resckeditor

This is a django app which provides and infrastructure you can use to include custom contents of other apps directly inside ckeditor.

It requires [django-ckeditor](https://github.com/django-ckeditor/django-ckeditor)

It defines a custom CKEDITOR plugin which implements two dialog tabs: the first to select the resource, and the second to dynamically set options.

**Full documentation**: [https://django-resckeditor.readthedocs.io/en/latest/](https://django-resckeditor.readthedocs.io/en/latest/)

![Screenshot](docs/images/list.png)
![Screenshot](docs/images/options.png)

## Getting Started

Install django-resckeditor:

$ pip install django-resckeditor

Add resckeditor to your installed apps:

INSTALLED_APPS = (
# ...
'ckeditor',
'ckeditor_uploader',
'resckeditor',
# ...
)

add the urls in your core application:

urlpatterns = [
# ...
url(r'^resckeditor/', include('resckeditor.urls', namespace='resckeditor')),
]

**N.B.** do not change the **resckeditor** path, since it is hardcoded in the js code.

Add the resource and ajax plugins to your ckeditor instance:

CKEDITOR_CONFIGS = {
'default': {
'skin': 'moono',
'toolbar_Full': [
// ..
['Res'/*, ...*/],
// ..
],
'toolbar': 'Full',
// ...
'extraPlugins': 'ajax,resource',
}
}

Define functions export resources for ckeditor, so for example in your settings:

RESCKEDITOR_CONFIG = {
'RESOURCES': [
{
'list': 'path.to.module.func.defining.resources',
'output': 'path.to.module.func.returning.html',
'label': 'My group of widgets'
},
]
}


The `list` function is invoked without arguments and should return a dictionary defining all the available resources
(i.e. all the news we want to export) and the available options:

def my_list_function():
res = []
for n in News.objects.published():
res.append({
'label': n.title,
'id': n.id
})
return {
'resources': res,
'options': [
{
'type': 'text',
'name': 'news-dialog-options-section-title',
'label': 'Last News',
'default': ''
},
{
'type': 'checkbox',
'name': 'news-dialog-options-show-title',
'label': 'Show title',
'default': True
},
{
'type': 'number',
'name': 'news-dialog-options-num-chars',
'label': 'Number of chars',
'default': 50
},
{
'type': 'select',
'name': 'news-dialog-options-layout',
'label': 'Layout',
'data': [
{'label': 'one row', 'value': 'row'},
{'label': 'two columns', 'value': 'col-2'},
{'label': 'three columns', 'value': 'col-3'},
{'label': 'four columns', 'value': 'col-4'},
]
}
]

}

The `output` function will receive the id of the resource selected and a dictionary containing the provided options.
It should return the html output of the resource.

def my_output_function(id, options):
n = News.objects.get(pk=id)
return '<h1>%s</h1>' % n.title

## Supported options

Currently only 4 types of options are supported: checkbox, text, number and select, but should be sufficient for almost all use cases.
The syntax and required properties are the one you may se in the example above (text has the same props as number).


Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-resckeditor, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size django_resckeditor-1.0.0-py3-none-any.whl (17.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size django-resckeditor-1.0.0.tar.gz (15.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page