Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django integration for aloha HTML5 editor

Project Description


What is djaloha good for?

Djaloha (django + aloha) is a backend for using the Aloha Editor into a Django site. It enables inline editing for your HTML content. It includes a django Form and a Widget helper. Djaloha is using aloha.0.23.26

Quick start

In, add ‘djaloha’ to the INSTALLED_APPS In add (r'^djaloha/', include('djaloha.urls')) to your urlpatterns

Then create a form. For example something like

import floppyforms
from models import Note
from djaloha.widgets import AlohaInput

class NoteForm(floppyforms.ModelForm):
    class Meta:
        model = Note
        fields = ('text',)
        widgets = {
            'text': AlohaInput(),

Let’s assume that you’ve a form variable pointing on an instance of a NoteForm. In the template file, call the form and don’t forget to put {{}} in the headers.


Djaloha has a “provider” that allows you to add local links to your models (articles, contacts, whatever) easily, through an autocomplete field that will search for objects based on rules you defined for each model :

  • search this kind of models using get_absolute_url()
  • search this kind of models using another method
  • search this kind of models using a specified model field

You can set the DJALOHA_LINK_MODELS setting in your to tell which django models will be available in the auto-complete field of the “add link” widget like this

DJALOHA_LINK_MODELS = ('coop_local.Article','calendar.Event')

djaloha requires jquery and is provided by default with jquery.1.7.2. You can change the jquery version if needed

DJALOHA_JQUERY = 'js/jquery.1.7.2.js'

Aloha has a nice plugin architecture. djaloha includes by default the main Aloha plugins. You may want to have a different set of plugins. Please refer to the Aloha docs for more information on plugins


Please note that the DJALOHA_PLUGINS setting is a global setting. If you need to change the set of plugins for a specific form field, you can pass a similar tuple in the aloha_plugins attribute of your AlohaInput widget. The extra_aloha_plugins attribute will add additional plugins to the default set.

DJALOHA_INIT_URL setting make possible to overloaf the aloha init file of djaloha. aloha_init_url attribute of AlohaInput can also be used to overload it for a specific form field.


apidev-djaloha is a fork from credis/djaloha (see

Djaloha uses the BSD license. see license.txt

Djaloha development was funded by CREDIS, FSE (European Social Fund) and Conseil Regional d’Auvergne.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
apidev-djaloha-1.1.5.tar.gz (17.3 MB) Copy SHA256 Checksum SHA256 Source Sep 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting