django-bleach

Django-pemutih adalah aplikasi Django untuk pemutih dan membersihkan pengguna HTML.
pemutih adalah modul Python yang mengambil input HTML, dan mengembalikan valid, dibersihkan HTML yang berisi hanya bagian diperbolehkan tag HTML, atribut dan gaya. Django-pemutih adalah aplikasi Django yang membuat menggunakan pemutih sangat mudah.
Pengaturan
1. Instal Django-pemutih via pip:
& Nbsp; pip menginstal Django-pemutih
2. Tambahkan Django-pemutih untuk INSTALLED_APPS Anda:
& Nbsp; INSTALLED_APPS = [
& Nbsp; # ...
& Nbsp; 'django_bleach',
& Nbsp; # ...
& Nbsp;]
3. Pilih beberapa default masuk akal untuk tag diperbolehkan, atribut dan gaya; dan perilaku ketika tag tidak diketahui ditemui. Masing-masing adalah opsional, dan langsung menggunakan default pemutih. Lihat dokumentasi pemutih:
& Nbsp; # Yang tag HTML diperbolehkan
& Nbsp; BLEACH_ALLOWED_TAGS = ['p', 'b', 'i', 'u', 'em', 'kuat', 'a']
& Nbsp; # Yang atribut HTML diperbolehkan
& Nbsp; BLEACH_ALLOWED_ATTRIBUTES = ['href', 'title', 'gaya']
& Nbsp; # Yang properti CSS yang diperbolehkan dalam 'gaya' atribut (dengan asumsi
& Nbsp; # gaya adalah atribut diperbolehkan)
& Nbsp; BLEACH_ALLOWED_STYLES = [
& Nbsp; "font-family ',' font-weight ',' text-decoration ',' font-variant ']
& Nbsp; # Jalur tag diketahui apakah Benar, ganti dengan HTML lolos karakter jika
& Nbsp; # False
& Nbsp; BLEACH_STRIP_TAGS = True
& Nbsp; komentar # Strip, atau meninggalkan mereka dalam.
& Nbsp; BLEACH_STRIP_COMMENTS = False
4. Pilih widget default untuk bidang pemutih. Ini default untuk django.forms.Textarea, tetapi Anda mungkin ingin menggantinya dengan editor WYSIWYG, atau sesuatu yang mirip:
& Nbsp; # Gunakan CKEditorWidget untuk bidang HTML dikelantang
& Nbsp; BLEACH_DEFAULT_WIDGET = 'wysiwyg.widgets.WysiwygWidget'
Saya menggunakan Django-ckeditor dalam proyek-proyek saya, tapi apa yang Anda gunakan adalah terserah Anda.
Penggunaan
Dalam model Anda
Django-pemutih menyediakan tiga cara untuk menciptakan output yang diputihkan. Cara termudah termasuk konten HTML pengguna diedit yang secara otomatis dibersihkan adalah dengan menggunakan medan Model Bleachfield:
# Di app / models.py
dari model Django impor
dari django_bleach.models impor Bleachfield
kelas Post (models.Model):
& Nbsp; title = models.CharField ()
& Nbsp; content = Bleachfield ()
& Nbsp; # ...
Bleachfield mengambil argumen berikut, untuk menyesuaikan output pemutih. Lihat dokumentasi pemutih untuk mereka gunakan:
- Allowed_tags
- Allowed_attributes
- Allowed_styles
- Strip_tags
- Strip_comments
Selain argumen tertentu-pemutih, bidang Model Bleachfield menerima semua atribut lapangan normal. Di belakang layar, itu adalah TextField, dan menerima semua argumen yang sama sebagai default textfield lakukan.
Bidang Model Bleachfield memanfaatkan bidang bentuk Bleachfield untuk melakukan semua pekerjaan. Ini tidak memberikan fasilitas sanitisation sendiri. Hal ini dianggap bug, tapi solusi yang bersih belum dilaksanakan. Setiap permintaan tarik memperbaiki ini akan syukur diterapkan. Selama bidang Model Bleachfield hanya digunakan dengan kolom formulir Bleachfield, tidak akan ada masalah. Jika hal ini tidak terjadi, dibersihkan HTML tidak dapat dijamin.
Dalam formulir Anda
Bidang bentuk Bleachfield disediakan. Bidang ini mampu membersihkan masukan HTML dari user, dan menyajikan aman, bersih HTML ke aplikasi Django Anda. Ini adalah tempat sebagian besar pekerjaan dilakukan.
Dalam template Anda
Jika Anda memiliki suatu bagian dari konten dari suatu tempat yang perlu dicetak dalam sebuah template, Anda dapat menggunakan filter pemutih:
{% Beban bleach_tags%}
{{Some_unsafe_content | pemutih}}
Filter tidak membutuhkan argumen. . Ia menggunakan pengaturan default didefinisikan dalam pengaturan aplikasi Anda

Persyaratan :

• Python
• Django