froala/django-froala-editor is one of the open-source repositories TopGit tracks, currently at 1 stars, written primarily in CSS. Package to integrate Froala WYSIWYG HTML rich text editor with Django.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
from django.db import models
from froala_editor.fields import FroalaField
class Page(models.Model):
content = FroalaField()
FroalaField uses froala_editor.widgets.FroalaEditor as its widget. You may directly use this widget with any of your forms.py:
from django import forms
from froala_editor.widgets import FroalaEditor
class PageForm(forms.ModelForm):
content = forms.CharField(widget=FroalaEditor)
Usage outside admin
When used outside the Django admin, the media files are to be manually included in the template. Inside the <head> section or before the form is rendered, include:
{{ form.media }}
Usage with virtual environment
To use Froala Editor in virtual environment, see https://tutorial.djangogirls.org/en/django_installation/ for how to setup virtual environment & to start your application in virtual environment.
Options
Froala Editor provides several options for customizing the editor. See https://froala.com/wysiwyg-editor/docs for all available options.
You can provide a dictionary of these options as FROALA_EDITOR_OPTIONS setting in settings.py. These options would then be used for all instances of the WYSIWYG editor in the project.
Options for individual field can also be provided via FroalaField or FroalaEditor class. This overrides any options set via FROALA_EDITOR_OPTIONS:
from django.db import models
from froala_editor.fields import FroalaField
class Page(models.Model):
content = FroalaField(options={
'toolbarInline': True,
})
from django import forms
from froala_editor.widgets import FroalaEditor
class PageForm(forms.ModelForm):
content = forms.TextField(widget=FroalaEditor(options={
'toolbarInline': True,
}))
Theme
You may provide the name of the theme to be used as theme argument to FroalaField or FroalaEditor.
from django.db import models
from froala_editor.fields import FroalaField
class Page(models.Model):
content = FroalaField(theme='dark')
FROALA_EDITOR_THEME can be set in settings.py making all instances of the editor to use a theme. However, theme argument in FroalaField and FroalaEditor overrides FROALA_EDITOR_THEME. Using a theme named 'dark' would require the existence of the file froala_editor/static/froala_editor/css/themes/dark.min.css. Available themes are: 'dark', 'gray' and 'red'.
Plugins
Froala Editor comes with the plugins: block style, text & background colors, font size, font family, insert video, insert table, media manager, lists and file upload. By default, all plugins are enabled by default in this package. See https://froala.com/wysiwyg-editor/docs/plugins for all available plugins.
FROALA_EDITOR_PLUGINS can be set in settings.py to tell which plugins should all instances of Froala Editor be using. By default, it is
The usage of plugins argument with FroalaEditor or FroalaField overrides this for that particular instance.
from django.db import models
from froala_editor.fields import FroalaField
class Page(models.Model):
content = FroalaField(plugins=('font_size', 'font_family'))
Third party integrations
FROALA_EDITOR_THIRD_PARTY setting can be used to configure third party integrations. Aviary Image Editor and SCAYT Web SpellChecker are available for now.
To enable, in settings.py:
Similar to plugin configuration, this can also be overridden on ForalaEditor and FroalaField.
Use your key for SCAYT Web SpellChecker with SCAYT_CUSTOMER_ID in your project setings.
Image upload
FroalaEditor and FroalaField optionally take in a boolean value for image_upload argument to enable or disable image uploads. Image uploads are enabled by default if the urls of this package are included in your urls.py.
You can use FROALA_UPLOAD_PATH setting in settings.py to change the path where uploaded files are stored within the MEDIA_ROOT. By default, uploads/froala_editor/images is used for storing uploaded images.
Other Settings
USE_FROALA_EDITOR - default True
If set to Falsein your Django settings disables Froala editor and uses a TextArea instead.
FROALA_STORAGE_BACKEND
This allows for the storage used for uploaded images and files to be changed through settings. If nothing is provided it uses default_storage, otherwise it uses this backend. Using this you can specify a different storage backend like S3 only for Froala.
FROALA_JS_COOKIE - default False.
If set to True, it assumes js-cookie is installed and included to get the CSRF token using js-cookie.
Release
To publish to PyPi, the following command should be run:
python setup.py sdist upload -r pypi
License
This package is available under BSD License. However, in order to use Froala WYSIWYG HTML Editor plugin you should purchase a license for it.
See https://froala.com/wysiwyg-editor/pricing for licensing the Froala Editor.
If you bought a license and got your key, the easiest way to implement it is to put it into the FROALA_EDITOR_OPTIONS setting in settings.py:
TopGit's last sync did not record any GitHub topics for froala/django-froala-editor. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on froala/django-froala-editor?
The most recent commit recorded on froala/django-froala-editor was 1 month ago, based on the GitHub push timestamp. The repository has 0 forks — one of the better signals of community interest.
Is froala/django-froala-editor open source?
TopGit's metadata for froala/django-froala-editor does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
Where can I see froala/django-froala-editor in action?
The project maintains a homepage at https://froala.com/wysiwyg-editor. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about froala/django-froala-editor?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/froala/django-froala-editor is the definitive source.
Read full README in the tab above.
Is django-froala-editor worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of django-froala-editor.
/django-froala-editor