django-bleach

Django-отбеливатель является приложение Django, чтобы отбелить и дезинфицировать пользователя HTML.
отбеливатель модуль Python, который принимает любые HTML ввод и возвращает действительное, облагороженная HTML, который содержит только разрешенный подмножество HTML-теги, атрибуты и стилей. Django-отбеливатель является приложение Django, что делает использование очень легко отбеливатель.
Настройка
1. Установите Django-отбеливатель с помощью PIP:
& NBSP; пункт установить Django-отбеливатель
2. Добавить Django-отбеливатель для ваших INSTALLED_APPS:
& NBSP; INSTALLED_APPS = [
& NBSP; # ...
& NBSP; 'django_bleach ",
& NBSP; # ...
& NBSP;]
3. Выберите некоторые разумные значения по умолчанию для разрешенных тегов, атрибутов и стилей; и поведение, когда неизвестные теги встречаются. Каждый из них не являются обязательными, и по умолчанию использовать отбеливающие умолчанию. Смотрите документацию отбеливателя:
& NBSP; # Какой HTML теги разрешены
& NBSP; BLEACH_ALLOWED_TAGS = ['р', 'б', 'я', 'U', 'Em', 'сильный', 'а']
& NBSP; # Какой атрибуты HTML разрешено
& NBSP; BLEACH_ALLOWED_ATTRIBUTES = ['HREF', 'Название', 'стиль']
& NBSP; # Какие свойства CSS разрешено в "стиле" атрибуты (при условии,
& NBSP; # стиль является разрешенным атрибутом)
& NBSP; BLEACH_ALLOWED_STYLES = [
& NBSP; 'семейство шрифтов', 'начертание шрифта »,« текст-отделка »,« шрифт-вариант']
& NBSP; # Газа неизвестные теги, если, правда, заменить HTML бежал символы, если
& NBSP; # Ложные
& NBSP; BLEACH_STRIP_TAGS = True
& NBSP; # Strip комментарии, либо оставить их в.
& NBSP; BLEACH_STRIP_COMMENTS = False
4. Выберите виджет по умолчанию для отбеливания полей. По умолчанию это django.forms.Textarea, но вы, вероятно, хотите, чтобы заменить его с помощью редактора WYSIWYG, или что-то подобное:
& NBSP; # Используйте CKEditorWidget для обесцвеченных областях HTML
& NBSP; BLEACH_DEFAULT_WIDGET = 'wysiwyg.widgets.WysiwygWidget "
Я использую Django-CKEditor в своих проектах, но то, что вы используете до вас.
Использование
В вашей модели
Django-отбеливатель предусматривает три способа создания беленой выход. Простейший способ включения пользователя для редактирования содержимого HTML, который автоматически продезинфицировать является использование модели поле BleachField:
# В приложение / models.py
от моделей импортных Django
от django_bleach.models импортировать BleachField
Класс сообщение (models.Model):
& NBSP; название = models.CharField ()
& NBSP; содержание = BleachField ()
& NBSP; # ...
BleachField принимает следующие аргументы, чтобы настроить вывод отбеливателя. Смотрите документацию отбеливатель для их использования:
- Allowed_tags
- Allowed_attributes
- Allowed_styles
- Strip_tags
- Strip_comments
В дополнение к аргументам отбеливающих конкретного модель поля BleachField принимает все обычные атрибуты поля. За кулисами, это TextField, и принимает все те же аргументы, по умолчанию текстовые поля сделать.
Модель поле BleachField использует поля формы BleachField сделать всю работу. Это не дает санитарной обработки объектов самостоятельно. Это считается ошибкой, но чистое решение еще не были реализованы. Любые запросы тянуть фиксирующие это будет с благодарностью применяется. Пока модель поля BleachField используется только с полями форм BleachField, не будет никаких проблем. Если это не так, продезинфицировать HTML не может быть гарантирована.
В ваших форм
Поле формы BleachField предоставляется. Это поле sanitises вход HTML от пользователя, и представляет безопасную, чистую HTML в приложение Django. Это где большая часть работы сделана.
В шаблонах
Если у вас есть peice контента из где-то, что должно быть напечатано в шаблоне, вы можете использовать отбеливатель фильтр:
{% Нагрузки bleach_tags%}
{{Some_unsafe_content | отбеливателя}}
Фильтр не принимает аргументов. . Он использует настройки по умолчанию, определенные в настройках приложения

Требования

• Python
• Джанго