django-bleach

django-albire este o aplicatie Django pentru a decolora și dezinfecteze utilizator HTML.
albire este un modul Python care ia orice intrare HTML, și se întoarce HTML valid, dezinfectate care conține doar o subset permis de tag-uri HTML, atribute și stiluri. django-albire este o aplicatie Django care face folosind inalbitor extrem de ușor.
Configurare
1. Instalați django-înălbitor prin PIP:
& Nbsp; pip instala django-albire
2. Adăugați django-inalbitor la INSTALLED_APPS dumneavoastră:
& Nbsp; INSTALLED_APPS = [
& Nbsp; # ...
& Nbsp; "django_bleach",
& Nbsp; # ...
& Nbsp;]
3. Selectați unele implicite sensibile pentru tag-uri permise, atribute și stiluri; și comportamentul când Tag-uri necunoscute sunt întâlnite. Fiecare dintre acestea sunt opționale, și implicit la utilizarea valorile implicite de albire. Consultați documentația înălbitor:
& Nbsp; # pe care tag-uri HTML sunt permise
& Nbsp; BLEACH_ALLOWED_TAGS = ['p', 'b', "i", "u",-le "," puternic "," o "]
& Nbsp; # pe care atribute HTML sunt permise
& Nbsp; BLEACH_ALLOWED_ATTRIBUTES = ['href', 'title', "stil"]
& Nbsp; # pe care proprietățile CSS sunt permise în "stil" atributele (presupunând
& Nbsp; # stil este un atribut permis)
& Nbsp; BLEACH_ALLOWED_STYLES = [
& Nbsp; "font-family", "font-weight", "text-decor", "font-variantă"]
& Nbsp; # Strip necunoscut tag-uri Dacă este adevărat, înlocuiți cu HTML scăpat de caractere dacă
& Nbsp; # Fals
& Nbsp; BLEACH_STRIP_TAGS = True
& Nbsp; comentarii # Strip, sau lăsați-le în.
& Nbsp; BLEACH_STRIP_COMMENTS = False
4. Selectați widget-ul implicit pentru câmpurile de albire. Acest implicit la django.forms.Textarea, dar, probabil, va dori să-l înlocuiască cu un editor WYSIWYG, sau ceva similar:
& Nbsp; # Folosiți CKEditorWidget pentru câmpurile HTML albite
& Nbsp; BLEACH_DEFAULT_WIDGET = 'wysiwyg.widgets.WysiwygWidget'
Eu folosesc django-ckeditor în proiectele mele, dar ceea ce utilizați este de până la tine.
Utilizare
În modelul
django-albire oferă trei moduri de a crea ieșire albit. Cel mai simplu mod de a include conținut HTML editabil-utilizator care este igienizat automat este de a folosi câmpul de model BleachField:
# În app / models.py
de la modele de import Django
de la django_bleach.models import BleachField
Clasa de post (models.Model):
& Nbsp; title = models.CharField ()
& Nbsp; conținut = BleachField ()
& Nbsp; # ...
BleachField ia următoarele argumente, pentru a personaliza ieșirea de albire. Consultați documentația albire pentru utilizarea lor:
- allowed_tags
- allowed_attributes
- allowed_styles
- strip_tags
- strip_comments
Pe lângă argumentele-albire specific, domeniul modelul BleachField acceptă toate atributele de câmp perpendiculare. În spatele scenei, aceasta este o TextField, și acceptă toate aceleași argumente ca implicit casetele de text face.
Câmpul Modelul BleachField face uz de câmp de formular BleachField să facă toate lucrările. Acesta oferă în sine nu facilități igienizare. Aceasta este considerată un bug, dar o soluție curat nu a fost încă pusă în aplicare. Orice solicitări de tragere de fixare acest lucru va fi aplicată cu recunoștință. Atâta timp cât câmpul modelul BleachField este utilizat numai cu câmpuri de formulare BleachField, nu va fi nici o problemă. Dacă acest lucru nu se întâmplă, HTML igienizat nu pot fi garantate.
În formularele
Este oferit un câmp de formular BleachField. Acest câmp igienizează intrare HTML de utilizator, și prezintă în condiții de siguranță HTML, curat la cererea dumneavoastră Django. Acest lucru este în cazul în care cea mai mare a muncii se face.
În șabloanele
Dacă aveți o bucata de conținut de undeva că trebuie să fie tipărit într-un șablon, puteți utiliza filtrul înălbitor:
{% Sarcină bleach_tags%}
{{Some_unsafe_content | înălbitor}}
Filtrul are argumente. . Acesta utilizează setările implicite definite în setările aplicației

Cerințe :

• Python
• Django