Obyek ModelAdminLink to this heading#
\n- \n
- \nclass ModelAdminLink to this definition# \n
Kelas
\nModelAdminadalah perwakilan dari sebuah model di antarmuka admin. Biasanya, ini disimpan di berkas bernamaadmin.pydi aplikasi anda. Mari kita melihat consoh sangat sederhana dariModelAdmin:\n\nfrom django.contrib import admin\nfrom myproject.myapp.models import Author\n\nclass AuthorAdmin(admin.ModelAdmin):\n pass\nadmin.site.register(Author, AuthorAdmin)\n
Penghias registerLink to this heading#
\n- \n
- \nregister(*models, site=django.admin.sites.site)Link to this definition# \n
Ada juga sebuah penghias untuk mendaftarkan kelas-kelas
\nModelAdminanda:\nfrom django.contrib import admin\nfrom .models import Author\n\n@admin.register(Author)\nclass AuthorAdmin(admin.ModelAdmin):\n pass\nItu diberika satu atau lebih kelas-kelas model untuk mendaftar dengan
\nModelAdmindan sebuah argumen kata kunci pilihansitejika anda tidak menggunakan awalanAdminSite:\nfrom django.contrib import admin\nfrom .models import Author, Reader, Editor\nfrom myproject.admin_site import custom_admin_site\n\n@admin.register(Author, Reader, Editor, site=custom_admin_site)\nclass PersonAdmin(admin.ModelAdmin):\n pass\nAnda tidak dapat menggunakan penghias ini jika anda harus mengacukan kelas admin model anda di metode
\n__init__()nya, sebagai contohsuper(PersonAdmin, self).__init__(*args, **kwargs). Jika anda sedang menggunakan Python 3 dan tidak perlu khawatir tentang mendukung Python 2, anda dapat menggunakansuper().__init__(*args, **kwargs). Jika tidak, anda akan harus menggunakanadmin.site.register()daripada penghias ini.
Penemuan dari berkas adminLink to this heading#
\nKetika anda menaruh 'django.contrib.admin' di pengaturan INSTALLED_APPS anda, Django secara otomatis mencari modul admin di setiap aplikasi dan mengimpor itu.
- \n
- \nclass apps.AdminConfigLink to this definition# \n
Ini adalah awalan kelas
\nAppConfiguntuk admin. Itu memanggilautodiscover()ketika Django mulai.
- \n
- \nclass apps.SimpleAdminConfigLink to this definition# \n
Kelas ini bekerja seperti
\nAdminConfig, kecuali itu tidak memanggilautodiscover().
- \n
- \nautodiscover()Link to this definition# \n
Fungsi ini berusaha mengimpor sebuah modul
\nadmindi setiap aplikasi terpasang. Modul-modul itu diharapkan mendaftar model dengan admin.Secara khusus anda tidak butuh memanggil fungsi ini secara langsung sebagai
\nAdminConfigmemanggilnya ketika Django mulai.
Jika anda sedang menggunakan sebuah penyesuaian AdminSite, itu adalah umum mengimpor semua dari subkelas ModelAdmin kedalam kode anda dan mendaftarkan mereka ke penyesuaian AdminSite. Dalam hal itu, untuk meniadakan penemuan-otomatis, anda harus menaruh 'django.contrib.admin.apps.SimpleAdminConfig' sebagai gantinya 'django.contrib.admin' di pengaturan INSTALLED_APPS anda.
Pilihan ModelAdminLink to this heading#
\nModelAdmin sangat fleksibel. Itu mempunyai beberapa pilihan untuk berurusan dengan menyesuaikan antarmuka. Semua pilihan ditentukan pada subkelas ModelAdmin:
from django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n date_hierarchy = 'pub_date'\n- \n
- \nModelAdmin.actionsLink to this definition# \n
Sebuah daftar tindakan untuk membuat tersedia pada halaman daftar perubahan. Lihat Tindakan admin untuk rincian.
\n
- \n
- \nModelAdmin.actions_on_topLink to this definition# \n
- \n
- \nModelAdmin.actions_on_bottomLink to this definition# \n
Kendalikan dimana pada halaman batang tindakan muncul. Secara awalan daftar rubah admin memperlihatkan tindakan pada atas dari halaman (
\nactions_on_top = True; actions_on_bottom = False).
- \n
- \nModelAdmin.actions_selection_counterLink to this definition# \n
Kendalikan apakah sebuah penghitung pemilihan ditampilkan dekat tindakan dropdown. Secara awalan, daftar tubadh admin akan memperlihatkan itu (
\nactions_selection_counter = True).
- \n
- \nModelAdmin.date_hierarchyLink to this definition# \n
Setel
\ndate_hierarchypada nama dariDateFieldatauDateTimeFielddi model anda, dan halaman daftar rubah akan menyertakan navigasi penelusuran berdasarkan-tanggal oleh bidang itu.Contoh:
\n\ndate_hierarchy = 'pub_date'\nAnda dapat juga menentukan sebuah bidang pada model terkait menggunakan pencarian
\n__, sebagai contoh:\ndate_hierarchy = 'author__pub_date'\nIni akan secara cerdas mengumpulkan itu sendiri berdasarkan pada tanggal tersedia, sebagai contoh jika semua tanggal berada di satu bulan, itu akan menampilkan hanya penelesuran tingkat-hari.
\n\n\n
- \n
- \nModelAdmin.empty_value_displayLink to this definition# \n
Atribut ini menimpa nilai pertunjukan awalan untuk bidang rekaman yang kosong (
\nNone, string kosong, dll). Nilai awalan-(sebuah tanda garis). Sebagai contoh:\nfrom django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n empty_value_display = '-empty-'\nAnda dapat juga menimpa
\nempty_value_displayuntuk semua halaman admin denganAdminSite.empty_value_display, atau bidang-bidang tertentu seperti ini:\nfrom django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n fields = ('name', 'title', 'view_birth_date')\n\n def view_birth_date(self, obj):\n return obj.birth_date\n\n view_birth_date.empty_value_display = '???'\n
- \n
- \nModelAdmin.excludeLink to this definition# \n
Atribut ini, jika diberikan, harus berupa daftar dari nama-nama bidang untuk mengeluarkan dari formulir.
\nSebagai contoh, mari kita pertimbangkan model berikut:
\n\nfrom django.db import models\n\nclass Author(models.Model):\n name = models.CharField(max_length=100)\n title = models.CharField(max_length=3)\n birth_date = models.DateField(blank=True, null=True)\nJika anda ingin sebuah formulit untuk model
\nAuthoryang menyertakan hanya bidangnamedantitle, anda akan menentukanfieldsatauexcludeseperti ini:\nfrom django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n fields = ('name', 'title')\n\nclass AuthorAdmin(admin.ModelAdmin):\n exclude = ('birth_date',)\nSejak model Author hanya mempunyai tiga bidang,
\nname,title, danbirth_date, formulir dihasilkan dari pernyataan diatas akan mengandung bidang-bidang sama persis.
- \n
- \nModelAdmin.fieldsLink to this definition# \n
Gunakan pilihan
\nfieldsuntuk membuat perubahan tata letak sederhana di formulir pada halaman "add" dan "change" seperti menunjukkan hanya subhimpunan dari bidang-bidang tersedia, merubah urutan mereka, atau mengelompokkan mereka kedalam baris. Sebagai contoh, anda dapat menentukan versi sederhana dari formulir admin untuk modeldjango.contrib.flatpages.models.FlatPageseperi berikut:\nclass FlatPageAdmin(admin.ModelAdmin):\n fields = ('url', 'title', 'content')\nDi contoh diatas, hanya bidang-bidang
\nurl,titledancontentakan diperlihatkan, berurutan, di formulir.fieldsdapat mengandung nilai-nilai ditentukan diModelAdmin.readonly_fieldsuntuk diperlihatkan sebagai hanya-baca.Untuk kebutuhan tata letak lebih rumit, lihat pilihan
\nfieldsets.Pilihan
\nfields, tidak sepertilist_display, mungkin hanya mengandung nama-nama bidang pada model atau formulir ditentukan olehform. Itu mungkin mengandung hanya callable jika mereka berada didaftar direadonly_fields.Untuk memperlihatkan banyak bidang pada baris yang sama, bungkus bidang-bidang tersebut di tuple mereka sendiri. Di contoh ini, bidang
\nurldantitleakan diperlihatkan di baris sama dan bidangcontentakan diperlihatkan dibawah mereka pada baris nya sendiri:\n\nclass FlatPageAdmin(admin.ModelAdmin):\n fields = (('url', 'title'), 'content')\nJika tidak ada pilihan
\nfieldsmaupunfieldsetshadir, Django akan mengawalkan ke menampilkan setiap bidang yang bukan sebuahAutoFielddan mempunyaieditable=True, dalam fieldset tunggal, di urutan sama seperti bidang-bidang ditentukan di model
- \n
- \nModelAdmin.fieldsetsLink to this definition# \n
Setel
\nfieldsetsutuk mengendalikan tata letak dari halaman "add" dan "change" admin.
\nfieldsetsadalah daftar dari dua-tuple, yang setiap dua-tuple mewakili sebuah<fieldset>pada halaman formulir admin. (Sebuah<fieldset>adalah sebuah "section" dari formulir.)Dua-tuple dalam bentuk
\n(name, field_options), dimananameadalah sebuah string mewakili juful dari fieldset danfield_optionsadalah sebuah kamus dari informasi tentang fieldset, termasuk daftar dari bidang-bidang untuk ditampilkan di itu.Sebuah contoh penuh, diambil dari model
\ndjango.contrib.flatpages.models.FlatPage\nfrom django.contrib import admin\n\nclass FlatPageAdmin(admin.ModelAdmin):\n fieldsets = (\n (None, {\n 'fields': ('url', 'title', 'content', 'sites')\n }),\n ('Advanced options', {\n 'classes': ('collapse',),\n 'fields': ('registration_required', 'template_name'),\n }),\n )\nHasil dalam halaman admin yang kelihatan seperti:
\n![\"/id/1.11/_images/fieldsets.png\"](\"/id/1.11/_images/fieldsets.png\")
\nJika tidak ada pilihan
\nfieldsetsmaupunfieldshadir, Django akan mengawalkan ke menampilkan setiap bidang yang bukan sebuahAutoFielddan mempunyaieditable=True, dalam fieldset tunggal, di urutan sama seperti bidang-bidang ditentukan di modelKamus
\nfield_optionsdapat mempunyai kunci berikut:- \n
- \n
fieldsSebuah tuple dari nama-nama bidang untuk ditampilkan di fieldset ini. Kunci ini diwajibkan.
\nContoh:
\n\n{\n'fields': ('first_name', 'last_name', 'address', 'city', 'state'),\n}\nSeperti pilihan
\nfields, untuk memperlihatkan banyak bidang pada baris sama, membungkus bidang tersebut di tuple mereka sendiri. Dalam contoh ini, bidangfirst_namedanlast_namememperlihatkan pada baris sama:\n{\n'fields': (('first_name', 'last_name'), 'address', 'city', 'state'),\n}\n
\nfieldsdapat mengandung nilai-nilai ditentukan direadonly_fieldsuntuk ditampilkan sebagai hanya-baca.Jika anda menambah nama dari callable ke
\nfields, aturan sama berlaku seperti pilihanfields: callable harus sidaftar direadonly_fields. \n
\n- \n
classesSebuah daftar atau tuple mengandung kelas-kelas CSS tambahan untuk berlaku pada fieldset.
\nContoh:
\n\n{\n'classes': ('wide', 'extrapretty'),\n}\nDua kelas beguna ditentukan oleh awalan stylesheet situs admin adalah
\ncollapseandwide. Fieldset dengan gayacollapseakan diinisialisasi runtuh di admin dan diganti dengan sebuah tautan "klik untuk memperluas" kecil. Fieldset dengan gayawideakan diberikan ruang mendatar tambahan. \n
\n- \n
descriptionSebuah string dari teks tambahan pilihan untuk diperlihatkan pada atas dari setiap fieldset, dibawah kepala dari fieldset. String ini tidak dibangun untuk
\nTabularInlinedisebabkan oleh tata letaknya.Catat bahwa nilai ini bukan pelolosan-HTML ketika itu diperlihatkan dalam antarmuka admin. Ini membuat anda menyertakan HTML jika anda inginkan. Cara lain anda dapat menggunakan teks polos dan
\ndjango.utils.html.escape()untuk meloloskan karakter khusus HTML apapun. \n
\n
- \n
- \nModelAdmin.filter_horizontalLink to this definition# \n
Secara awalan, sebuah
\nManyToManyFielddiperlihatkan di situs admin dengan<select multiple>. Bagaimanapun, kotak pilihan-banyak dapat sulit digunakan ketika memilih banyak barang. Menambahkan sebuahManyToManyFieldke daftar ini malahan akan menggunakan antarmuka "filter" JavaScript tidak mengganggu yang mengizinkan pencarian dalam pilihan. Pilihan tidak terpilih atau terpilih muncul di dua kotak bersebelahan. Lihatfilter_verticaluntuk menggunakan antarmuka tegak lurus.
- \n
- \nModelAdmin.filter_verticalLink to this definition# \n
Sama seperti
\nfilter_horizontal, tetapi menggunakan tampilan tegak lurus dari antarmuka penyaring dengan kotak dari piliha tidak dipilih muncul diatas dari pilihan terpilih.
- \n
- \nModelAdmin.formLink to this definition# \n
Secara awalan sebuah
\nModelFormsecara dinamis dibuat untuk model anda. Itu digunakan untuk membuat formulir dihadirkan pada kedua halaman tambah/rubah. Anda dapat dengan mudah menyediakanModelFormanda sendiri untuk menimpa awalan perilaku formulir apapun pada halaman tambah/rubah. Kalau tidak, anda dapat menyesuaikan awalan formulir daripada menentukan keseluruhan satu yang baru menggunakan metodeModelAdmin.get_form().Untuk sebuah contoh lihat bagian Menambahkan pengesahan penyesuaian pada admin.
\n\n\n
- \n
- \nModelAdmin.formfield_overridesLink to this definition# \n
Ini menyediakan cara cepat-dan-kotor untuk menimpa beberapa pilihan
\nFielduntuk digunakan di admin.formfield_overridesadalah sebuah kamus memetakan sebuah kelas bidang pada kamus dari argumen untuk melewatkan ke bidang pada waktu pembangunan.Sejak itu sedikit abstrak, mari kita lihat contoh nyata. Penggunaan paling umum dari
\nformfield_overridesada;ah menambahkan sebuah widget penyesuaian untuk jenis tertentu dari bidang. Jadi, bayangkan kami telah menulis sebuahRichTextEditorWidgetyang ingin untuk digunakan untuk bidang teks besar daripada awalan<textarea>. Ini adalah bagaimana kami melakukannya:\nfrom django.db import models\nfrom django.contrib import admin\n\n# Import our custom widget and our model from where they're defined\nfrom myapp.widgets import RichTextEditorWidget\nfrom myapp.models import MyModel\n\nclass MyModelAdmin(admin.ModelAdmin):\n formfield_overrides = {\n models.TextField: {'widget': RichTextEditorWidget},\n }\nCatat bahwa kunci di kamus adalah kelas bidang sebenarnya, bukan sebuah string. Nilai adalah kamus lain; argumen ini akan dilewatkan ke metode
\n\n__init__()bidang formulir. Lihat The Forms API untuk rincian.
- \n
- \nModelAdmin.inlinesLink to this definition# \n
Lihat
\nInlineModelAdminobjects below as well asModelAdmin.get_formsets_with_inlines().
- \n
- \nModelAdmin.list_displayLink to this definition# \n
Set
\nlist_displayuntuk mengendalikan bidang-bidang mana yang ditampilkan pada halaman daftar rubah dari admin.Contoh:
\n\nlist_display = ('first_name', 'last_name')\nJika anda tidak menyetel
\nlist_display, situs admin akan menampilkan kolom tunggal yang menampilkan__str__()(__unicode__()on Python 2) perwakilan dari setiap obyek.Anda mempunyai empat nilai kemungkinan yang dapat digunakan dalam
\nlist_display:- \n
Sebuah bidang dari model. Sebagai contoh:
\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('first_name', 'last_name')\n\nSebuah callable yang menerima satu parameter untuk instance model. Sebagai contoh:
\n\ndef upper_case_name(obj):\n return ("%s %s" % (obj.first_name, obj.last_name)).upper()\nupper_case_name.short_description = 'Name'\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = (upper_case_name,)\n\nDeretan karakter mewakilkan sebuah atribut pada
\nModelAdmin. Ini berperilaku sama sebagai callable. Sebagai contoh:\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('upper_case_name',)\n\n def upper_case_name(self, obj):\n return ("%s %s" % (obj.first_name, obj.last_name)).upper()\n upper_case_name.short_description = 'Name'\n\nDeretan karakter mewakilkan sebuah atribut pada model. Ini berperilaku hampir sama sebagai callable, tetapi
\nselfdi konteks ini adalah instance model. Ini adalah contoh model penuh:\nfrom django.db import models\nfrom django.contrib import admin\n\nclass Person(models.Model):\n name = models.CharField(max_length=50)\n birthday = models.DateField()\n\n def decade_born_in(self):\n return self.birthday.strftime('%Y')[:3] + "0's"\n decade_born_in.short_description = 'Birth decade'\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('name', 'decade_born_in')\n\n
Sedikit kasus khusus untuk dicatat tentang
\nlist_display:- \n
Jika bidang adalah sebuah
ForeignKey, Django akan menampilkan__str__()(__unicode__()pada Pyhton 2) dari obyek terkait. \nBidang-bidang
ManyToManyFieldtidak didukung, karena akan memerlukan mengerjakan pernyataan SQL terpisah untuk setiap baris di tabel. Jika anda ingin melakukan ini meskipun begitu, berikan model anda sebuah metode penyesuaian, dan tambah nama metode kelist_display. (Lihat dibawah untuk lebih pada metode penyesuaian dilist_display.) \nJika bidang adalah sebuah
BooleanFieldatauNullBooleanField, Django akan menampilkan ikon "on" atau "off" cantik daripadaTrueatauFalse. \nJika deretan karakter yang diberikan adalah metode dari model,
\nModelAdminatau callable, Django akan meloloskan-HTML keluaran secara awalan. Untuk meloloskan masukan pengguna dan mengizinkan etiket tidak meloloskan anda sendiri, gunakanformat_html().Ini adalah sebuah contoh penuh model:
\n\n\nfrom django.db import models\nfrom django.contrib import admin\nfrom django.utils.html import format_html\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n last_name = models.CharField(max_length=50)\n color_code = models.CharField(max_length=6)\n\n def colored_name(self):\n return format_html(\n '<span style="color: #{};">{} {}</span>',\n self.color_code,\n self.first_name,\n self.last_name,\n )\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('first_name', 'last_name', 'colored_name')\n\nKetika beberapa contoh telah ditunjukkan, ketika menggunakan callable, metode model, atau metode
ModelAdmin, anda dapat menyesuaikan judul kolom dengan menambahkan sebuah atributshort_descriptionpada callable. \nJika nilai dari sebuah bidang adalah
\nNone, sebuah string kosong, atau sebuah perulangan tanpa unsur-unsur, Django akan menampilkan -` (tanda garis). Anda dapat menimpa ini denganAdminSite.empty_value_display:\nfrom django.contrib import admin\n\nadmin.site.empty_value_display = '(None)'\nAnda juga dapat menggunakan
\nModelAdmin.empty_value_display:\nclass PersonAdmin(admin.ModelAdmin):\n empty_value_display = 'unknown'\nAtau pada tingkat bidang:
\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('name', 'birth_date_view')\n\n def birth_date_view(self, obj):\n return obj.birth_date\n\n birth_date_view.empty_value_display = 'unknown'\n\nIf the string given is a method of the model,
\nModelAdminor a\ncallable that returns True or False Django will display a pretty\n"on" or "off" icon if you give the method abooleanattribute\nwhose value isTrue.Ini adalah sebuah contoh penuh model:
\n\nfrom django.db import models\nfrom django.contrib import admin\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n birthday = models.DateField()\n\n def born_in_fifties(self):\n return self.birthday.strftime('%Y')[:3] == '195'\n born_in_fifties.boolean = True\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('name', 'born_in_fifties')\n\nMetode __str__()` (
\n__unicode__()pada Python 2) hanya sah dilist_displayseperti metode model lain apapun, jadi itu adalah sempurna OKE melakukan ini:\nlist_display = ('__str__', 'some_other_field')\n\nBiasanya, unsur-unsur dari
\nlist_displayyang bukan bidang basisdata sebenarnya tidak dapat digunakan dalam mengurutkan (karena Django melakukan semua pengurutan pada tingkat basisdata).Bagaimanapun, jika sebuah unsur dari
\nlist_displaymewakili bidang basisdata tertentu, anda dapat menunjukkan fakta ini dengan mengatur atributadmin_order_fielddari barang.Sebagai contoh:
\n\nfrom django.db import models\nfrom django.contrib import admin\nfrom django.utils.html import format_html\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n color_code = models.CharField(max_length=6)\n\n def colored_first_name(self):\n return format_html(\n '<span style="color: #{};">{}</span>',\n self.color_code,\n self.first_name,\n )\n\n colored_first_name.admin_order_field = 'first_name'\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('first_name', 'colored_first_name')\nDiatas akan mengatakan Django untuk mengurutkan berdasarkan bidang
\nfirst_nameketika mencoba mengurutkan berdasarkancolored_first_namedi admin.Untuk menunjukkan urutan menurun dengan
\nadmin_order_fieldanda dapat menggunakan awalan tanda penghubung pada nama bidang. Menggunakan contoh diatas, ini akan kelihatan seperti:\ncolored_first_name.admin_order_field = '-first_name'\n
\nadmin_order_fieldmendukung permintaan pencarian untuk mengurutkan berdasarkan nilai pada hubungan terkait. Contoh ini termasuk sebuah kolom "author first name" di daftar tampilan dan mengizinkan mengurutkan itu dengan nama pertama:\nclass Blog(models.Model):\n title = models.CharField(max_length=255)\n author = models.ForeignKey(Person, on_delete=models.CASCADE)\n\nclass BlogAdmin(admin.ModelAdmin):\n list_display = ('title', 'author', 'author_first_name')\n\n def author_first_name(self, obj):\n return obj.author.first_name\n\n author_first_name.admin_order_field = 'author__first_name'\n\nUnsur-unsur dari
\nlist_displaydapat juga berupa sifat. Harap catat bagaimanapun, bahwa kerena cara sifat bekerja di Python, pengaturanshort_descriptionpada sebuah sifat hanya memungkinkan ketika menggunakan fungsiproperty()dan tidak dengan penghias@property.Sebagai contoh:
\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n last_name = models.CharField(max_length=50)\n\n def my_property(self):\n return self.first_name + ' ' + self.last_name\n my_property.short_description = "Full name of the person"\n\n full_name = property(my_property)\n\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('full_name',)\n\nNama-nama bidang di
list_displayakan juga muncul sebagai kelas-kelas CSS di keluaran HTML, di formulir daricolumn-<field_name>pada setiap unsur<th>. Ini dapat digunakan menyetel lebar kolom di sebuah berkas CSS sebagai contoh. \nDjango akan mencoba mentafsirkan setiap unsur dari
\nlist_displaydi urutan ini:- \n
Bidang dari model.
\nCallable
\nSebuah string mewakili sebuah atribut
ModelAdmin. \nSebuah string mewakili sebuah atribut model.
\n
Sebagai contoh jika anda mempunyai "first name" sebagai model bidang dan sebagai atribut
\nModelAdmin, bidang model akan digunakan. \n
- \n
- \nModelAdmin.list_display_linksLink to this definition# \n
Gunakan
\nlist_display_linksuntuk mengendalikan jika dan bidang-bidang mana dilist_displayharus di tautkan ke halaman "change" untuk sebuah obyek.Secara awalan, halaman daftar rubah akan mengkaitkan kolom pertama -- bidang pertama ditentukan di
\nlist_display-- ke halaman perubahan untuk setiap barang. Tetapilist_display_linksmembiarkan anda merubah ini:- \n
Sete itu menjadi
Noneuntuk tidak mendapatkan tautan sama sekali. \nSet itu menjadi daftar atau tuple dari bidang (di bentuk sama seperti
\nlist_display) yang kolomnya anda ingin rubah menjadi tautan.Anda dapat menentukan satu atau banyak bidang. Selama bidang-bidang muncul di
\nlist_display, Django tidak peduli seberapa banyak (seberapa sedikit) bidang-bidang ditautkan. Persyaratan satu-satunya adalah bahwa jika anda ingin menggunakanlist_display_linksdengan cara ini, anda harus menentukanlist_display. \n
Di contoh ini, bidang
\nfirst_namedanlast_nameakan dikaitkan pada halaman daftar rubah:\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('first_name', 'last_name', 'birthday')\n list_display_links = ('first_name', 'last_name')\nDi contoh ini, jaring halaman daftar rubah tidak akan mempunyai tautan:
\n\nclass AuditEntryAdmin(admin.ModelAdmin):\n list_display = ('timestamp', 'message')\n list_display_links = None\n
- \n
- \nModelAdmin.list_editableLink to this definition# \n
Setel
\n\nlist_editableke sebuah daftar nama-nama bidang pada model yang akan mengizinkan menyunting pada halaman daftar rubah. yaitu, bidang-bidang terdaftar dilist_editableakan diperlihatkan sebagai formulir widget pada halaman daftar rubah, mengizinkan pengguna menyunting dan menyimpan banyak baris sekaligus.
- \n
- \nModelAdmin.list_filterLink to this definition# \n
Setel
\nlist_filteruntuk mengaktifkan penyaring di batang sisi kanan dari halaman daftar rubah dari admin, seperti digambarkan di tangkapan layar berikut:![\"/id/1.11/_images/list_filter.png\"](\"/id/1.11/_images/list_filter.png\")
\n
\nlist_filterharus berupa sebuah daftar atau tuple dari unsur, dimana setiap unsur harus berupa satu dari jenis-jenis berikut:- \n
sebuah nama bidang, dimana bidang ditentukan harus berupa antara
\nBooleanField,CharField,DateField,DateTimeField,IntegerField,ForeignKeyatauManyToManyField, sebagai contoh:\nclass PersonAdmin(admin.ModelAdmin):\n list_filter = ('is_staff', 'company')\nNama-nama bidang di
\nlist_filterdapat juga menjangkau hubungan menggunakan pencarian__, sebagai contoh:\nclass PersonAdmin(admin.UserAdmin):\n list_filter = ('company__name',)\n\nsebuah kelas mewarisi dari
\ndjango.contrib.admin.SimpleListFilter, yang anda butuh menyediakan atributtitledanparameter_namedan menimpa metodelookupsdanqueryset, sebagai contoh:\n\nfrom datetime import date\n\nfrom django.contrib import admin\nfrom django.utils.translation import ugettext_lazy as _\n\nclass DecadeBornListFilter(admin.SimpleListFilter):\n # Human-readable title which will be displayed in the\n # right admin sidebar just above the filter options.\n title = _('decade born')\n\n # Parameter for the filter that will be used in the URL query.\n parameter_name = 'decade'\n\n def lookups(self, request, model_admin):\n """\n Returns a list of tuples. The first element in each\n tuple is the coded value for the option that will\n appear in the URL query. The second element is the\n human-readable name for the option that will appear\n in the right sidebar.\n """\n return (\n ('80s', _('in the eighties')),\n ('90s', _('in the nineties')),\n )\n\n def queryset(self, request, queryset):\n """\n Returns the filtered queryset based on the value\n provided in the query string and retrievable via\n `self.value()`.\n """\n # Compare the requested value (either '80s' or '90s')\n # to decide how to filter the queryset.\n if self.value() == '80s':\n return queryset.filter(birthday__gte=date(1980, 1, 1),\n birthday__lte=date(1989, 12, 31))\n if self.value() == '90s':\n return queryset.filter(birthday__gte=date(1990, 1, 1),\n birthday__lte=date(1999, 12, 31))\n\nclass PersonAdmin(admin.ModelAdmin):\n list_filter = (DecadeBornListFilter,)\n\nsebuah tuple, dimana unsur pertama adalah nama bidang dan unsur kedua adalah kelas diwarisi dari
\ndjango.contrib.admin.FieldListFilter, sebagai contoh:\nclass PersonAdmin(admin.ModelAdmin):\n list_filter = (\n ('is_staff', admin.BooleanFieldListFilter),\n )\nAnda dapat membatasi pilihan dari model terkait pada obyek-obyek terlibat di hubungan itu menggunakan
\nRelatedOnlyFieldListFilter:\nclass BookAdmin(admin.ModelAdmin):\n list_filter = (\n ('author', admin.RelatedOnlyFieldListFilter),\n )\nMengganggap
\n\nauthoradalahForeignKeypada modelUser, ini akan membatasi pilihanlist_filterpada pengguna yang telah menulis sebuah buku daripada mendaftarkan semua pengguna. \n
Daftar penyaring khususnya muncul hanya jika penyaring mempunyai lebih dari satu pilihan. Sebuah metode
\nhas_output()penyaring mengendalikan apakah atau tidak itu muncul.Itu memungkinkan menentukan penyesuaian cetakan untuk membangun daftar penyaring:
\n\nclass FilterWithCustomTemplate(admin.SimpleListFilter):\n template = "custom_template.html"\nLihat cetakan awalan disediakan oleh Django (
\nadmin/filter.html) untuk contoh nyata.
- \n
- \nModelAdmin.list_max_show_allLink to this definition# \n
Setel
\nlist_max_show_alluntuk mengendalikan seberapa banyak barang dapat muncul pada halaman daftar rubah admin "Show all". Admin akan memperlihatkan sebuah tautan "Show all" pada daftar rubah hanya jika jumlah hasil perhitungan kurang dari atau sama pada pengaturan ini. Secara awalan, ini disetel menjadi200.
- \n
- \nModelAdmin.list_per_pageLink to this definition# \n
Setel
\nlist_per_pageuntuk mengendalikan seberapa banyak barang akan muncul pada setiap penomoran halaman daftar rubah admin. Secara awalan, ini disetel menjadi100.
- \n\n
Setel
\nlist_select_relateduntuk memberitahu Django menggunakanselect_related()dalam mengambil daftar dari obyek-obyek pada halaman daftar rubah admin. Ini dapat menghemat anda sekelompok dari permintaan basisdata.Nilai harus antara sebuah boolean, sebuah daftar atau sebuah tuple. Awalan adalah
\nFalse.Ketika nilai adalah
\nTrue,select_related()akan selalu dipanggil. Ketika nilai disetel menjadiFalse, Django akan mencarilist_displaydan memanggilselect_related()jikaForeignKeyapapun hadir.Jika anda butuh lebih kendali berjaring-halus, gunakan sebuah tuple (atau daftar) sebagai nilai untuk
\nlist_select_related. Tuple kosong akan mencegah Django dari memanggilselect_relatedsama sekali. Tuple lain apapun akan dilewatkan secara langsung keselect_relatedsebagai parameter. Sebagai contoh:\nclass ArticleAdmin(admin.ModelAdmin):\n list_select_related = ('author', 'category')\nakan memanggil
\nselect_related('author', 'category').Jika anda butuh menentukan nilai dinamis berdasarkan pada permintaan, anda dapat menerapkan cara
\nget_list_select_related().
- \n
- \nModelAdmin.orderingLink to this definition# \n
Setel
\norderinguntuk menentukan bagaimana daftar dari obyek-obyek harus diurutkan di tampilan admin Django. Ini harus berupa sebuah daftar atau tuple di bentuk sama seperti parameterorderingmodel.Jika ini tidak disediakan, admin Django akan menggunakan pengurutan awalan model.
\nJika anda butuh menentukan urutan dinamis (sebagai contoh bergantung pada pengguna atau bahasa) anda dapat menerapkan sebuah metode
\nget_ordering().
- \n
- \nModelAdmin.paginatorLink to this definition# \n
Kelas penomoran digunakan untuk menomorkan halaman. Secara awalan,
\ndjango.core.paginator.Paginatordigunakan. Jika penyesuaian kelas penomoran tidak mempunyai antarmuka pembangun sama sepertidjango.core.paginator.Paginator, anda akan juga butuh menyediakan sebuah penerapan untukModelAdmin.get_paginator().
- \n
- \nModelAdmin.prepopulated_fieldsLink to this definition# \n
Setel
\nprepopulated_fieldspada nama-nama bidang pemetaan kamus ke bidang-bidang itu harus mengisi dimuka dari:\nclass ArticleAdmin(admin.ModelAdmin):\n prepopulated_fields = {"slug": ("title",)}\nKetika disetel, bidang-bdiang yang diberikan akan menggunakan sedikit JavaScript untuk mengumpulkan dari bidang-bdiang yang ditugaskan. Penggunaan utama untuk fungsionalitas ini adalah untuk secara otomatis membangkitkan nilai untuk bidang-bidang
\nSlugFielddari satu atau lebih bidang-bidang. Nilai yang dibangkitkan dihasilkan oleh penggabungan nilai-nilai dari bidang-bidang sumber, dan kemudian dengan merubah hasil itu menjadi sebuah keong sah (sebagai contoh mengganti tanda garis untuk ruang).
\nprepopulated_fieldstidak menerima bidang-bidangDateTimeField,ForeignKey,OneToOneField, danManyToManyField.
- \n
- \nModelAdmin.preserve_filtersLink to this definition# \n
Admin sekarang menjaga penyaring pada daftar tampilan setelah membuat, menyunting atau menghapus sebuah obyek. Anda dapat menyimpan kembali perilaku sebelumnya dari membersihkan penyaring dengan mengatur atribut ini menjadi
\nFalse.
- \n
- \nModelAdmin.radio_fieldsLink to this definition# \n
Secara awalan, admin Django menggunakan antarmuka kotak-pilih (<select>) untuk bidang-bidang adalah
\nForeignKeyatau mempunyaichoicesdisetel. Jika sebuah bidang hadir diradio_fields, Django akan menggunakan antarmuka tombl-radio sebagai gantinya. Menganggapgroupadalah sebuahForeignKeypada modelPerson:\nclass PersonAdmin(admin.ModelAdmin):\n radio_fields = {"group": admin.VERTICAL}\nAnda mempunyai pilihan dari menggunakan
\nHORIZONTALatauVERTICALdari moduldjango.contrib.admin.Jangan menyertakan sebuah bidang dalam
\nradio_fieldsmeskipun dia adalahForeignKeyatau mempunyai kumpulanchoices.
- \n
- \nModelAdmin.raw_id_fieldsLink to this definition# \n
Secara awalan, admin Django menggunakan antarmuka kotak-pilih (<select>) untuk bidang-bidang adalah
\nForeignKey. Terkadang anda tidak ingin mendatangkan atas dari memiliki untuk memilih semua instance terkait untuk memperlihatkan di drop-down.
\nraw_id_fieldsadalah sebuah daftar dari bidang anda ingin rubah menjadi widgetinputuntuk antara sebuahForeignKeyatauManyToManyField:\nclass ArticleAdmin(admin.ModelAdmin):\n raw_id_fields = ("newspaper",)\nWidget
\nInputraw_id_fieldsharus mengandung sebuah primary key jika bidang adalah sebuahForeignKeyatau sebuah dipisahkan koma daftar dari nilai-nilai jika bidng adalahManyToManyField. Widgetraw_id_fieldsmenunjukkan tombol kaca pembesar dekat pada bidang yang mengizinkan pengguna mencari dan memilih sebuah nilai:![\"/id/1.11/_images/raw_id_fields.png\"](\"/id/1.11/_images/raw_id_fields.png\")
\n
- \n
- \nModelAdmin.readonly_fieldsLink to this definition# \n
Secara awalan admin menunjukkan semua bidang sebagai dapat disunting. Bidang-bidang apapun di pilihan ini (yang harus berupa sebuah
\nlistatautuple) akan menampilkan data dengan-adanya dan bukan-dapat disunting; mereka juga dikeluarkan dariModelFormdigunakan untuk membuat dan menyunting. catat bahwa ketika menentukanModelAdmin.fieldsatauModelAdmin.fieldsetsbidang-bidang hanya-baca harus hadir untuk ditunjukkan (mereka diabaikan sebaliknya).Jika
\nreadonly_fieldsdigunakan tanpa menentukan urutan jelas melaluiModelAdmin.fieldsatauModelAdmin.fieldsetsmereka akan ditambahkan setelah semua bidang dapat disunting.Sebuah bidang hanya-baca tidak hanya dapat menampilkan data dari bidang model, itu juga dapat memperlihatkan keluaran dari metode model atau metode dari kelas
\nModelAdminitu sendiri. Ini sangat mirip pada cara perilakuModelAdmin.list_display. ini menyediakan sebuah cara mudah untuk menggunakan antarmuka admin untuk menyediakan umpan balik pada keadaan dari obyek-obyek sedang disunting, sebagai contoh:\nfrom django.contrib import admin\nfrom django.utils.html import format_html_join\nfrom django.utils.safestring import mark_safe\n\nclass PersonAdmin(admin.ModelAdmin):\n readonly_fields = ('address_report',)\n\n def address_report(self, instance):\n # assuming get_full_address() returns a list of strings\n # for each line of the address and you want to separate each\n # line by a linebreak\n return format_html_join(\n mark_safe('<br/>'),\n '{}',\n ((line,) for line in instance.get_full_address()),\n ) or mark_safe("<span class='errors'>I can't determine this address.</span>")\n\n # short_description functions like a model field's verbose_name\n address_report.short_description = "Address"\n
- \n
- \nModelAdmin.save_asLink to this definition# \n
Setel
\nsave_asuntuk mengadakan sebuah fitur "save as new" pada formulir rubah admin.Biasanya, obyek-obyek mempunyai tiga pilihan simpan: "Save", "Save and continue editing", dan "Save and add another". Jika
\nsave_asadalahTrue, "Save and add another" akan diganti oleh sebuah tombol "Save as new" yang membuat sebuah obyek baru (dengan sebuah ID baru) daripada memperbaharui obyek yang ada.Secara awal,
\nsave_asdisetel keFalse.
- \n
- \nModelAdmin.save_as_continueLink to this definition# \n
- \n
Ketika
\nsave_as=True, awalan pengalihan setelah menyimpan obyek baru adalah merubah tampilan untuk obyek itu. Jika anda menyetelsave_as_continue=False, pengalihan akan ke tampilan daftar rubah.Secara awal,
\nsave_as_continuedisetel menjadiFalse.
- \n
- \nModelAdmin.save_on_topLink to this definition# \n
Setel
\nsave_on_topuntuk menambah tombol simpan lintas atas dari formulir rubah admin anda.Biasanya, tombol simpan muncul hanya pada bawah dari formulir. Jika anda menyetel
\nsave_on_top, tombol-tombol akan muncul kedua pada atas dan bawah.Secara awal,
\nsave_on_topdisetel keFalse.
- \n
- \nModelAdmin.search_fieldsLink to this definition# \n
Setel
\nsearch_fieldsuntuk mengadakan sebah kotak pencarian pada halaman daftar rubah admin. Ini harus disetel ke sebuah daftar dari nama-nama bidang yang akan dicari kapanpun seseorang mengajukan permintaan pencarian di kotak teks itu.Bidang-bidang ini harus ada semacam bidang teks, seperti
\nCharFieldatauTextField. Anda dapat juga melakukan pencarian terkait pada sebuahForeignKeyatauManyToManyFieldcatatan "follow" dengan API pencarian:\nsearch_fields = ['foreign_key__related_fieldname']\nSebagai contoh, jika anda mempunyai sebuah masukan blog dengan sebuah penulis, pengertian berikut akan mengadakan pencarian masukan blog berdasarkan alamat surel dari penulis.
\n\nsearch_fields = ['user__email']\nKetika seseorang melakukan sebuah pencarian di kotak pencarian admin, Django membagi permintaan pencarian menjadi kata-kata dan mengembalikan semua obyek yang mengandung setiap kata-kata, huruf tidak sensitif, dimana setiap kata harus setidaknya satu dari
\nsearch_fields. Sebagai contoh, jikasearch_fieldsdisetel menjadi['first_name', 'last_name']dan pengguna mencarijohn lennon, Django akan melakukan setara dari kalusaWHERESQL ini:\nWHERE (first_name ILIKE '%john%' OR last_name ILIKE '%john%')\nAND (first_name ILIKE '%lennon%' OR last_name ILIKE '%lennon%')\nUntuk tercepat dan/atau pencarian lebih ketak, awalan nama bidang dengan sebuah penghubung:
\n- \n
^Gunakan penghubung '^' untuk mencocokkan permulaan pada awalan dari bidang. Sebagai contoh jika
\nsearch_fieldsdisetel menjadi['^first_name', '^last_name']dan pengguna mencari untukjohn lennon, Django akan melakukan setara dari klausaWHERESQL ini:\nWHERE (first_name ILIKE 'john%' OR last_name ILIKE 'john%')\nAND (first_name ILIKE 'lennon%' OR last_name ILIKE 'lennon%')\nPermintaan ini lebih efesien daripada permintaan
\n'%john%'biasa, karena basisdata hanya butuh memeriksa permulaan dari sebuah data kolom, daripada mencari melalui keseluruhan data kolom. Ditambah, jika kolom mempunyai sebuah indeks pada nya, beberapa basisdata mungkin dapat menggunakan indeks untuk permintaan ini, meskipun itu adalah sebuah permintaanLIKE. \n=Gunakan penghubung '=' untuk pencocokan tepat kasus-tidak sensitif. Sebagai contoh jika
\nsearch_fieldsdisetel menjadi`['=first_name', '=last_name']dan pengguna mencari untukjohn lennon, Django akan melakukan setara dari klausaWHERESQL ini:\nWHERE (first_name ILIKE 'john' OR last_name ILIKE 'john')\nAND (first_name ILIKE 'lennon' OR last_name ILIKE 'lennon')\nCatat bahwa masukan permintaan dipisah oleh ruang, jadi, ikuti contoh ini, itu saat ini tidak memungkinkan mencari semua rekaman yang
\nfirst_nameadalah persis'john winston'(mengandung sebuah ruang). \n@Menggunakan penghubung '@' untuk melakukan pencocokan teks penuh. Ini seperti metode pencarian awalan tetapi menggunakan sebuah indeks. Saat ini ini hanya tersedia untuk MySQL.
\n \n
Jika anda butuh menyesuaikan pencarian anda dapat menggunakan
\nModelAdmin.get_search_results()untuk menyediakan tambahan atau pengganti perilaku pencarian.
- \n
- \nModelAdmin.show_full_result_countLink to this definition# \n
Setel
\nshow_full_result_countuntuk mengendalikan apakah perhitungan penuh dari obyek harus ditampilkan pada halaman admin disaring (sebagai contoh99 hasil (jumlah 103)). Jika pilihan ini disetel menjadiFalse, sebuah teks seperti99 hasil (Tampilkan semua)ditampilkan sebagai gantinya.Awalan dari
\nshow_full_result_count=Truemembangkitkan sebuah permintaan untuk melakukan perhitungan penuh pada tabel yang dapat mahal jika isi tabel mengandung sejumlah nomor dari baris.
- \n
- \nModelAdmin.view_on_siteLink to this definition# \n
Setel
\nview_on_siteuntuk mengendalikan apakah atau tidak ditampilkan tautan "View on site". Tautan ini harus membawa anda ke URL dimana anda dapat menampilkan obyek tersimpan.Nilai ini dapat berupa baik bendera boolean atau callable. Jika
\nTrue(awalan), metode obyekget_absolute_url()akan digunakan untuk membangkitkan url.Jika model anda mempunyai metode
\nget_absolute_url()tetapi anda tidak ingin tombol "View on site" muncul, anda hanya butuh mensetelview_on_sitemenjadiFalse:\nfrom django.contrib import admin\n\nclass PersonAdmin(admin.ModelAdmin):\n view_on_site = False\nDi kasus itu adalah callable, itu menerima instance model sebagai parameter. Sebagi contoh:
\n\nfrom django.contrib import admin\nfrom django.urls import reverse\n\nclass PersonAdmin(admin.ModelAdmin):\n def view_on_site(self, obj):\n url = reverse('person-detail', kwargs={'slug': obj.slug})\n return 'https://example.com' + url\n
Penyesuaian pilihan cetakanLink to this heading#
\nBagian Menimpa cetakan admin menggambarkan bagaimana menimpa atau memperpanjang awalan cetakan admin. Gunakan pilihan berikut untuk mengesampingkan cetakan awalan digunakan oleh tampilan ModelAdmin:
- \n
- \nModelAdmin.add_form_templateLink to this definition# \n
Jalur pada cetakan penyesuaian, digunakan oleh
\nadd_view().
- \n
- \nModelAdmin.change_form_templateLink to this definition# \n
Jalur untuk cetakan penyesuaian, digunakan oleh
\nchange_view().
- \n
- \nModelAdmin.change_list_templateLink to this definition# \n
Jalur pada cetakan penyesuaian, digunakan oleh
\nchangelist_view().
- \n
- \nModelAdmin.delete_confirmation_templateLink to this definition# \n
Jalur pada cetakan penyesuaian, digunakan oleh
\ndelete_view()untuk menampilkan halaman penegasan ketika menghapus satu atau lebih obyek.
- \n
- \nModelAdmin.delete_selected_confirmation_templateLink to this definition# \n
Jalur pada cetakan penyesuaian, digunakan oleh tindakan
\ndelete_selecteduntuk memperlihatkan halaman penegasan ketika menghapus satu atau lebih obyek. Lihat actions documentation.
- \n
- \nModelAdmin.object_history_templateLink to this definition# \n
Jalur pada cetakan penyesuaian, digunakan oleh
\nhistory_view().
- \n
- \nModelAdmin.popup_response_templateLink to this definition# \n
- \n
Jalur pada cetakan penyesuaian, digunakan oleh
\nresponse_add(),response_change(), danresponse_delete().
Cara ModelAdminLink to this heading#
\n\n- \n
- \nModelAdmin.save_model(request, obj, form, change)Link to this definition# \n
Metode
\nsave_modelmemberikanHttpRequest, sebuah instance model, sebuah instanceModelForm, dan sebuah nilai boolean berdasarkan pada apakah itu sedang menambahkan atau merubah obyek. Menimpa metode ini mengizinkan melakukan tindakan pra- atau menempatkan-simpan. Memanggilsuper().save_model()untuk menyimpan obyek menggunakanModel.save().Sebagai contoh untuk melampirkan
\nrequest.userpada obyek sebelum menyimpannya:\nfrom django.contrib import admin\n\nclass ArticleAdmin(admin.ModelAdmin):\n def save_model(self, request, obj, form, change):\n obj.user = request.user\n super(ArticleAdmin, self).save_model(request, obj, form, change)\n
- \n
- \nModelAdmin.delete_model(request, obj)Link to this definition# \n
Metode
\ndelete_modeldiberikanHttpRequestdan sebuah instance model. Mengesampingkan metode ini mengizinkan melakukan tindakan menghapus pra- atau pasca-. Panggilsuper().delete_model()untuk menghapus obyek menggunakanModel.delete().
- \n
- \nModelAdmin.save_formset(request, form, formset, change)Link to this definition# \n
Metode
\nsave_formsetmemberikanHttpRequest, instanceModelForminduk dan nilai boolean berdasarkan pada apakah itu sedang menambahkan atau merubah obyek induk.Sebagai contoh, untuk melampirkan
\nrequest.userpada setiap instance model formset dirubah:\nclass ArticleAdmin(admin.ModelAdmin):\n def save_formset(self, request, form, formset, change):\n instances = formset.save(commit=False)\n for obj in formset.deleted_objects:\n obj.delete()\n for instance in instances:\n instance.user = request.user\n instance.save()\n formset.save_m2m()\nLihat juga Saving objects in the formset.
\n
- \n
- \nModelAdmin.get_ordering(request)Link to this definition# \n
Metode
\nget_orderingmengambilrequestsebagai parameter dan diharapkan mengembalikan sebuahlistatautupleuntuk mengurutkan mirip pada atributordering. Sebagai contoh:\nclass PersonAdmin(admin.ModelAdmin):\n\n def get_ordering(self, request):\n if request.user.is_superuser:\n return ['name', 'rank']\n else:\n return ['name']\n
- \n
- \nModelAdmin.get_search_results(request, queryset, search_term)Link to this definition# \n
Metode
\nget_search_resultsmerubah daftar dari obyek-obyek diperlihatkan kedalam itu yang cocok istilah pencarian disediakan. Itu menerima permintaan, sebuah queryset yang memberlakukan penyaring saat ini, dan istilah pencarian disediakan-pengguna. Itu mengembalikan sebuah tuple mengandung sebuah queryset dirubah untuk menerapkan pencarian, dan sebuah boolean mengindikasikan jika hasil mungkin mengandung ganda.Pencarian penerapan awalan bidang-bidang bernama di
\nModelAdmin.search_fields.Metode ini mungkin dikesampingkan dengan metode pencarian penyesuaian anda sendiri. Sebagai contoh, anda mungkin berharap mencari sebuah bidang integer, atau gunakan alat tambahan seperti Solr atau Haystack. Anda harus membangun jika perubahan queryset diterapkan dengan metode pencarian anda mungkin memperkenalkan ganda kedalam hasil, dan mengembalikan
\nTruedi unsur kedua dari nilai kembalian.Sebagai contoh, untuk mencari
\nnamedanage, anda dapat menggunakan:\nclass PersonAdmin(admin.ModelAdmin):\n list_display = ('name', 'age')\n search_fields = ('name',)\n\n def get_search_results(self, request, queryset, search_term):\n queryset, use_distinct = super(PersonAdmin, self).get_search_results(request, queryset, search_term)\n try:\n search_term_as_int = int(search_term)\n except ValueError:\n pass\n else:\n queryset |= self.model.objects.filter(age=search_term_as_int)\n return queryset, use_distinct\nPenerapan ini lebih efesien dari
\nsearch_fields = ('name', '=age')yang menghasilkan dalam sebuah perbandingan string untuk bidang numerik, sebagai contoh... OR UPPER("polls_choice"."votes"::text) = UPPER('4')pada PostgreSQL.
- \n\n
Metode
\nsave_relatedmemberikanHttpRequest, sebuah instanceModelForminduk, daftar dari formset berderet dan sebuah nilai boolean berdasarkan pada apakah induk sedang ditambahkan atau dirubah. Disini anda dapat melakukan tindakan pra- atau pasca- untuk obyek-obyek terkait ke induk. Catat bahwa pada titik ini obyek induk dan formulirnya telah disimpan.
- \n
- \nModelAdmin.get_readonly_fields(request, obj=None)Link to this definition# \n
Metode
\nget_readonly_fieldsmemberikanHttpRequestdanobjsedang disunting atauNonepada sebuah formulir tambah) dan diharapkan mengembalikan sebuahlist(atautupledari nama-nama bidang yang akan diperlihatkan sebagai hanya-baca, seperti digambarkan diatas di bagianModelAdmin.readonly_fields.
- \n
- \nModelAdmin.get_prepopulated_fields(request, obj=None)Link to this definition# \n
Metode
\nget_prepopulated_fieldsmemberikanHttpRequestdanobjsedang disunting (atauNonepada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuahdictionary, seperti digambarkan diatas di bagianModelAdmin.prepopulated_fields.
- \n
- \nModelAdmin.get_list_display(request)Link to this definition# \n
Metode
\nget_list_displaymemberikanHttpRequestdan diharapkan mengembalikan sebuahlistatautupledari nama-nama bidang yang akan diperlihatkan pada tampilan daftar rubah seperti digambarkan diatas di bagianModelAdmin.list_display.
- \n
- \nModelAdmin.get_list_display_links(request, list_display)Link to this definition# \n
Metode
\nget_list_display_linksmemberikanHttpRequestdanlistatautupledikembalikan olehModelAdmin.get_list_display(). Itu diharapkan mengembalikan antaraNoneatau sebuahlistatautupledari nama-nama bidang pada daftar rubah yang akan ditautkan ke tampilan rubah, seperti digambarkan di bagianModelAdmin.list_display_links.
- \n
- \nModelAdmin.get_exclude(request, obj=None)Link to this definition# \n
- \n
Metode
\nget_excludememberikanHttpRequestdanobjsedang disunting (atauNonepada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuah daftar dari bidang-bidang, seperti digambarkan diatas di bagianModelAdmin.exclude.
- \n
- \nModelAdmin.get_fields(request, obj=None)Link to this definition# \n
Metode
\nget_fieldsmemberikanHttpRequestdanobjsedang disunting (atauNonepada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuah daftar dari bidang-bidang, seperti digambarkan diatas di bagianModelAdmin.fields.
- \n
- \nModelAdmin.get_fieldsets(request, obj=None)Link to this definition# \n
Metode
\nget_fieldsetsmemberikanHttpRequestdanobjsedang disunting atauNonepada sebuah formulir tambah) dan diharapkan mengembalikan sebuah daftar dari dua-tuple, dimana setiap dua-tuple mewakili sebuah<fieldset>pada halaman formulir admin, seperti digambarkan diatas di bagianModelAdmin.fieldsets.
- \n
- \nModelAdmin.get_list_filter(request)Link to this definition# \n
Metode
\nget_list_filtermemberikanHttpRequestdan diharapkan mengembalikan jenis yang sama dari urutan jenis seperti untuk atributlist_filter.
- \n\n
Metode
\nget_list_select_relatedmemberikanHttpRequestdan harus mengembalikan sebuah boolean atau daftar sepertiModelAdmin.list_select_relatedlakukan.
- \n
- \nModelAdmin.get_search_fields(request)Link to this definition# \n
Metode
\nget_search_fieldsmemberikanHttpRequestdan diharapkan mengembalikan jenis yang sama dari urutan jenis seperti untuk atributsearch_fields.
- \n
- \nModelAdmin.get_inline_instances(request, obj=None)Link to this definition# \n
Metode
\nget_inline_instancesmemberikanHttpRequestdanobjsedang disunting (atauNonepada sebuah formulir tambah) dan diharapkan mengembalikan sebuahlistatautupledari obyekInlineModelAdmin, seperti digambarkan dibawah di bagianInlineModelAdmin. Sebagai contoh, berikut akan mengembalikan berderet tanpa awalan penyaringan berdasarkan pada perizinan tambah, rubah, dan hapus:\nclass MyModelAdmin(admin.ModelAdmin):\n inlines = (MyInline,)\n\n def get_inline_instances(self, request, obj=None):\n return [inline(self.model, self.admin_site) for inline in self.inlines]\nJika anda mengutamakan metode ini, pastikan bahwa berderet dikembalikan adalah instance dari kelas-kelas ditentukan di
\ninlinesatau anda mungkin menghadapi kesalahan "Bad Request" ketika menambahkan obyek-obyek terkait.
- \n
- \nModelAdmin.get_urls()Link to this definition# \n
Metode
\nget_urlspada sebuahModelAdminmengembalikan URL untuk digunakan untuk ModelAdmin itu di cara yang sama seperti sebuah URLconf. Karena itu anda dapat memperpanjang mereka seperti didokumentasikan di Pengirim URL:\nclass MyModelAdmin(admin.ModelAdmin):\n def get_urls(self):\n urls = super(MyModelAdmin, self).get_urls()\n my_urls = [\n url(r'^my_view/$', self.my_view),\n ]\n return my_urls + urls\n\n def my_view(self, request):\n # ...\n context = dict(\n # Include common variables for rendering the admin template.\n self.admin_site.each_context(request),\n # Anything else you want in the context...\n key=value,\n )\n return TemplateResponse(request, "sometemplate.html", context)\nJika anda ingin menggunakan tata letak admin, perpanjang dari
\nadmin/base_site.html:\n\n{% extends "admin/base_site.html" %}\n{% block content %}\n...\n{% endblock %}\nBagaimanapun, fungsi
\nself.my_viewterdaftar diatas menderita dari dua masalah:- \n
Itu tidak akan melakukan pemeriksaan perizinan apapun, jadi itu akan dapat diakses unutk masyarakat umum.
\nItu tidak akan menyediakan rincian kepala apapun untuk mencegah penyimpanan sementara. Ini berarti jika halaman mengambil data dari basisdata, dan middleware penyimpanan sementara aktid, halaman dapat menampilkan informasi usang.
\n
Sejak ini biasanya bukan apa anda inginkan, Django menyediakan pembungkus kenyamanan untuk memeriksa perizinan dan menandai tampilan sebagai bukan-cacheable. pembungkus ini adalah
\nAdminSite.admin_view()(i.e.self.admin_site.admin_viewdidalam sebuah instanceModelAdmin); gunakan itu seperti begitu:\nclass MyModelAdmin(admin.ModelAdmin):\n def get_urls(self):\n urls = super(MyModelAdmin, self).get_urls()\n my_urls = [\n url(r'^my_view/$', self.admin_site.admin_view(self.my_view))\n ]\n return my_urls + urls\nPerhatikan tampilan dibungkus di baris kelima diatas:
\n\nurl(r'^my_view/$', self.admin_site.admin_view(self.my_view))\nPembungkus ini akan melindungi
\nself.my_viewdari akses tidak terotorisasi dan akan memberlakukan penghiasdjango.views.decorators.cache.never_cache()untuk memastikan itu tidak disimpan sementara jika middleware cache aktif.Jika halaman adalah cacheable, tetapi anda masih ingin pemeriksaan perizinan dilakukan, anda dapat melewatkan sebuah argumen
\ncacheable=TruepadaAdminSite.admin_view():\nurl(r'^my_view/$', self.admin_site.admin_view(self.my_view, cacheable=True))\nTampilan
\nModelAdminmempunyai atributmodel_admin. Selain tampilanAdminSitemempunyai atributadmin_site.
- \n
- \nModelAdmin.get_form(request, obj=None, **kwargs)Link to this definition# \n
Mengembalikan sebuah kelas
\nModelFormuntuk digunakan di tampilan tambah dan rubah admin, lihatadd_view()danchange_view().Penerapan dasar menggunakan
\nmodelform_factory()pada subkelasform, dirubah oleh atribut sepertifieldsdanexclude. Jadi, sebagai contoh, jika anda ingin menawarkan tambahan bidang-bidang le superuser, anda dapat menukar formulir dasar berbeda seperi begitu:\nclass MyModelAdmin(admin.ModelAdmin):\n def get_form(self, request, obj=None, **kwargs):\n if request.user.is_superuser:\n kwargs['form'] = MySuperuserForm\n return super(MyModelAdmin, self).get_form(request, obj, **kwargs)\nAnda mungkin juga hanya mengembalikan kelas
\nModelFormpenyesuaian langsung.
- \n
- \nModelAdmin.get_formsets_with_inlines(request, obj=None)Link to this definition# \n
Menghasilkan (
\nFormSet,InlineModelAdmin) pasangan untuk digunakan di tampilan tambah dan rubah admin.Sebagai contoh jika anda ingin memperlihatkan hanya berderet tertentu di tampilan rubah, anda dapat menimpa
\nget_formsets_with_inlinessebagai berikut:\nclass MyModelAdmin(admin.ModelAdmin):\n inlines = [MyInline, SomeOtherInline]\n\n def get_formsets_with_inlines(self, request, obj=None):\n for inline in self.get_inline_instances(request, obj):\n # hide MyInline in the add view\n if isinstance(inline, MyInline) and obj is None:\n continue\n yield inline.get_formset(request, obj), inline\n
- \n
- \nModelAdmin.formfield_for_foreignkey(db_field, request, **kwargs)Link to this definition# \n
Metode
\nformfield_for_foreignkeypada sebuahModelAdminmengizinkan anda menimpa formfield awalan untuk bidang foreign key. Sebagai contoh, untuk mengembalikan bagian dari obyek-obyek untuk bidang foreign key ini berdasarkan pada pengguna:\nclass MyModelAdmin(admin.ModelAdmin):\n def formfield_for_foreignkey(self, db_field, request, **kwargs):\n if db_field.name == "car":\n kwargs["queryset"] = Car.objects.filter(owner=request.user)\n return super(MyModelAdmin, self).formfield_for_foreignkey(db_field, request, **kwargs)\nPenggunaan ini instance
\nHttpRequestuntuk menyaring bidang foreign keyCarke hanya meperlihatkan mobil dimiliki oleh instanceUser.
- \n
- \nModelAdmin.formfield_for_manytomany(db_field, request, **kwargs)Link to this definition# \n
Seperti metode
\nformfield_for_foreignkey, metodeformfield_for_manytomanydapat dikesampingkan untuk merubah formfield awalan untuk bidang many to many. Sebagai contoh, jika seorang pemilik dapat memiliki banyak mobil dan mobil dapat dimiliki banyak pemilik -- hubungan many to many -- anda dapat penyaring bidang foreign keyCarpada hanya memperlihatkan pemilik mobil berdasarkanUser:\nclass MyModelAdmin(admin.ModelAdmin):\n def formfield_for_manytomany(self, db_field, request, **kwargs):\n if db_field.name == "cars":\n kwargs["queryset"] = Car.objects.filter(owner=request.user)\n return super(MyModelAdmin, self).formfield_for_manytomany(db_field, request, **kwargs)\n
- \n
- \nModelAdmin.formfield_for_choice_field(db_field, request, **kwargs)Link to this definition# \n
Seperti metode
\nformfield_for_foreignkeydanformfield_for_manytomany, metodeformfield_for_choice_fielddapat ditimpa untuk merubah formfield awalan untuk sebuah bidang yang telah menyatakan pilihan. Sebagai contoh, jika pilihan tersedia pada superuser harus berbeda dari tersebut tersedia pada staf biasa, anda dapat meneruskan sebagai berikut:\n\nclass MyModelAdmin(admin.ModelAdmin):\n def formfield_for_choice_field(self, db_field, request, **kwargs):\n if db_field.name == "status":\n kwargs['choices'] = (\n ('accepted', 'Accepted'),\n ('denied', 'Denied'),\n )\n if request.user.is_superuser:\n kwargs['choices'] += (('ready', 'Ready for deployment'),)\n return super(MyModelAdmin, self).formfield_for_choice_field(db_field, request, **kwargs)\n
- \n
- \nModelAdmin.get_changelist(request, **kwargs)Link to this definition# \n
Mengembalikan kelas
\nChangelistuntuk digunakan untuk pendaftaran. Secara awalan,django.contrib.admin.views.main.ChangeListdigunakan. Dengan mewarisi kelas ini anda dapat merubah perilaku dari pendaftaran.
- \n
- \nModelAdmin.get_changelist_form(request, **kwargs)Link to this definition# \n
Mengembalikan sebuah kelas
\nModelFormuntuk digunakan diFormsetpada halaman daftar rubah. Untuk menggunakan formulir penyesuaian, sebagai contoh:\n\nfrom django import forms\n\nclass MyForm(forms.ModelForm):\n pass\n\nclass MyModelAdmin(admin.ModelAdmin):\n def get_changelist_form(self, request, **kwargs):\n return MyForm\n
- \n
- \nModelAdmin.get_changelist_formset(request, **kwargs)Link to this definition# \n
Mengembalikan sebuah kelas ModelFormSet untuk digunakan pada halaman daftar rubah jika
\nlist_editabledigunakan. Untuk menggunakan formset penyesuaian, sebagai contoh:\nfrom django.forms import BaseModelFormSet\n\nclass MyAdminFormSet(BaseModelFormSet):\n pass\n\nclass MyModelAdmin(admin.ModelAdmin):\n def get_changelist_formset(self, request, **kwargs):\n kwargs['formset'] = MyAdminFormSet\n return super(MyModelAdmin, self).get_changelist_formset(request, **kwargs)\n
- \n
- \nModelAdmin.lookup_allowed(lookup, value)Link to this definition# \n
The objects in the changelist page can be filtered with lookups from the\nURL's query string. This is how
\nlist_filterworks, for example. The\nlookups are similar to what's used inQuerySet.filter()(e.g.\nuser__email=user@example.com). Since the lookups in the query string\ncan be manipulated by the user, they must be sanitized to prevent\nunauthorized data exposure.The
\nlookup_allowed()method is given a lookup path from the query string\n(e.g.'user__email') and the corresponding value\n(e.g.'user@example.com'), and returns a boolean indicating whether\nfiltering the changelist'sQuerySetusing the parameters is permitted.\nIflookup_allowed()returnsFalse,DisallowedModelAdminLookup\n(subclass ofSuspiciousOperation) is raised.By default,
\nlookup_allowed()allows access to a model's local fields,\nfield paths used inlist_filter(but not paths from\nget_list_filter()), and lookups required for\nlimit_choices_toto function\ncorrectly inraw_id_fields.Menimpa metode ini utnuk menyesuaikan pencarian diizinkan untuk subkelas
\nModelAdminanda.
- \n
- \nModelAdmin.has_add_permission(request)Link to this definition# \n
Harus mengembalikan
\nTruejika menambahkan sebuah obyek diizinkan,Falsesebaliknya.
- \n
- \nModelAdmin.has_change_permission(request, obj=None)Link to this definition# \n
Harus mengembalikan
\nTruejika menyunting obyek diizinkan,Falsesebaliknya. Jika obyek adalahNone, harus mengembalikanTrueatauFalseuntuk menandakan apakah menyunting obyek dari jenis ini diizinkan secara umum (sebagai contoh,Falseakan ditafsirkan sebagai arti bahwa pengguna tidak diizinkan menyunting obyek apapun dari jenis ini).
- \n
- \nModelAdmin.has_delete_permission(request, obj=None)Link to this definition# \n
Harus mengembalikan
\nTruejika menghapus obyek diizinkan,Falsesebaliknya. Jika obyek adalahNone, harus mengembalikanTrueatauFalseuntuk menandakan apakah menghapus obyek dari jenis ini diizinkan secara umum (sebagai contoh,Falseakan ditafsirkan sebagai arti bahwa pengguna saat ini tidak diizinkan menghapus obyek apapun dari jenis ini).
- \n
- \nModelAdmin.has_module_permission(request)Link to this definition# \n
Harus mengembalikan
\nTruejika memperlihatkan modul pada halaman indeks admin dan mengakses halaman indeks admin diizinkan,Falsesebaliknya. GunakanUser.has_module_perms()secara awalan. Mengutamakan itu tidak membatasi akses untuk menambah, merubah atau menghapus tampilan,has_add_permission(),has_change_permission(), danhas_delete_permission()harus digunakan untuk itu.
- \n
- \nModelAdmin.get_queryset(request)Link to this definition# \n
Metode
\nget_querysetpada sebuahModelAdminmengembalikan sebuahQuerySetdari semua instance model yang dapat disunting oleh situs admin. Satu kasus penggunaan dari mengutamakan metode ini adalah menunjukkan obyek-obyek dimiliki oleh pengguna masuk:\nclass MyModelAdmin(admin.ModelAdmin):\n def get_queryset(self, request):\n qs = super(MyModelAdmin, self).get_queryset(request)\n if request.user.is_superuser:\n return qs\n return qs.filter(author=request.user)\n
- \n
- \nModelAdmin.message_user(request, message, level=messages.INFO, extra_tags='', fail_silently=False)Link to this definition# \n
Mengirim sebuah pesan ke pengguna menggunakan backend
\ndjango.contrib.messages. Lihat custom ModelAdmin example.Argumen kata kunci mengizinkan anda merubah tingkatan pesan, menambah tambahan etiket CSS, atau gagal secara diam jika kerangka kerja
\ncontrib.messagestidak dipasang. Argumen kata kunci ini cocok dengan untukdjango.contrib.messages.add_message(), lihat dokumentasi fungsi itu untuk lebih rinci. Satu perbedaan adalah bahwa tingkatan mungkin dilewatkan sebagai label string sebagai tambahan pada integer/ketetapan.
- \n
- \nModelAdmin.get_paginator(request, queryset, per_page, orphans=0, allow_empty_first_page=True)Link to this definition# \n
Mengembalikan sebuah instance dari penomor digunakan untuk tampilan ini. Secara awalan, instasiasi sebuah instance dari
\npaginator.
- \n
- \nModelAdmin.response_add(request, obj, post_url_continue=None)Link to this definition# \n
Menentukan tahap the
\nHttpResponsefor theadd_view().
\nresponse_adddipanggil setelah formulir admin diajukan dan hanya setelah obyek dan semua instances terkait telah dibuat dan disimpan. Anda dapat menimpanya untuk merubah perilaku awalan setelah obyek telah dibuat.
- \n
- \nModelAdmin.response_change(request, obj)Link to this definition# \n
Menentukan tahap
\nHttpResponsefor thechange_view().
\nresponse_changedipanggil setelah formulir admin diajukan dan hanya setelah obyek dan semua instances terkait telah disimpan. Anda dapat menimpanya untuk merubah perilaku awalan setelah obyek telah dirubah.
- \n
- \nModelAdmin.response_delete(request, obj_display, obj_id)Link to this definition# \n
Menentukan
\nHttpResponseuntuk tahapdelete_view().
\nresponse_deletedipanggil setelah obyek telah dihapus. Anda dapat menimpa ini untuk merubah kebiasaan awal setelah obyek telah dihapus.
\nobj_displayadalah sebuah string dengan nama dari obyek terhapus.
\nobj_idadalah penciri serial digunakan untuk mengambil obyek untuk dihapus.
- \n
- \nModelAdmin.get_changeform_initial_data(request)Link to this definition# \n
Sebuah kaitan untuk data inisial pada formulir rubah admin. Secara awalan, bidang-bidang diberikan nilai-nilai inisial dari parameter
\nGET. Sebagai contoh,?name=initial_valueakan menyetel nilai inisial bidangnamemenjadiinitial_value.Metode ini harus mengembalikan sebuah kamus di formulir
\n{'fieldname': 'fieldval'}:\ndef get_changeform_initial_data(self, request):\n return {'name': 'custom_initial_value'}\n
Cara lainLink to this heading#
\n- \n
- \nModelAdmin.add_view(request, form_url='', extra_context=None)Link to this definition# \n
Tampilan Django untuk halaman tambahan instance model. Lihat catatan dibawah.
\n
- \n
- \nModelAdmin.change_view(request, object_id, form_url='', extra_context=None)Link to this definition# \n
Tampilan Django untuk halaman suntingan instance model. Lihat catatan dibawah.
\n
- \n
- \nModelAdmin.changelist_view(request, extra_context=None)Link to this definition# \n
Tampilan Django untuk halaman daftar rubah/tindakan instance model. Lihat catatan dibawah.
\n
- \n
- \nModelAdmin.delete_view(request, object_id, extra_context=None)Link to this definition# \n
Tampilan Django untuk halaman penegasan penghapusn instance model. Lihat catatan dibawah.
\n
- \n
- \nModelAdmin.history_view(request, object_id, extra_context=None)Link to this definition# \n
Tampilan Django untuk halaman yang menampilan riwayat perubahan untuk instance model diberikan.
\n
Tidak seperti jenis-kait metode ModelAdmin dirinci di bagian sebelumnya, lima metode ini yang pada kenyataannya dirancang untuk dipanggil sebagai tampilan Django dari URL aplikasi admin mengirim penangan untuk membangun halaman-halaman yang berhubungan dengan tindakan CRUD instance-instance model. Sebagai sebuah hasil, slengkapnya mengutamakan metode ini akan secara signifikan merubah perilaku admin aplikasi admin.
Satu alasan umum untuk mengutamakan metode ini adalah menambah data konteks yang disediakan ke cetakan yang membangun tampilan. Di contoh berikut, tamppilan rubah ditimpa sehingga cetakan dibangun menyediakan beberapa data pemetaan tambahan yang tidak akan sebaliknya menjadi tersedia:
\nclass MyModelAdmin(admin.ModelAdmin):\n\n # A template for a very customized change view:\n change_form_template = 'admin/myapp/extras/openstreetmap_change_form.html'\n\n def get_osm_info(self):\n # ...\n pass\n\n def change_view(self, request, object_id, form_url='', extra_context=None):\n extra_context = extra_context or {}\n extra_context['osm_data'] = self.get_osm_info()\n return super(MyModelAdmin, self).change_view(\n request, object_id, form_url, extra_context=extra_context,\n )\nTampilan ini mengembalikan instance TemplateResponse yang mengizinkan anda dengan mudah menyesuaikan data tanggapan sebelum membangun. Untuk rincian lebih, lihat TemplateResponse documentation.
Pengertian aset ModelAdminLink to this heading#
\nAda waktu dimana anda akan menambahkan sedikit CSS dan/atay JavaScript pada tampilan tambah/rubah. Ini dapat dicapai dengan menggunakan kelas Media sebelah dalam pada ModelAdmin anda:
class ArticleAdmin(admin.ModelAdmin):\n class Media:\n css = {\n "all": ("my_styles.css",)\n }\n js = ("my_code.js",)\nstaticfiles app menambahkan STATIC_URL (atau MEDIA_URL jika STATIC_URL adalah None) pada jalur aset apapun. Peraturan sama berlaku seperti regular asset definitions on forms.
jQueryLink to this heading#
\nJavaScript admin Django memanfaatkan pustaka jQuery
\nUntuk menghindari pertentangan dengan tulisan dipasok-pengguna atau pustaka, jQuery (versi 2.2.3) Django adalah namespace sebagai django.jQuery. Jika anda ingin menggunakan jQuery di JavaScript admin anda sendiri tanpa menyertakan salinan kedua, anda dapat menggunakan obyek django.jQuery pada daftar rubah dan tampilan tambah/rubah.
Kelas ModelAdmin membutuhkan jQuery secara awalan, jadi tidak butuh menambahkan jQuery ke daftar ModelAdmin anda dari sumber daya media meskipun anda mempunyai kebutuhan khusus. Sebagai contoh, jika anda membutuhkan pustaka jQuery menjadi di namespace global (sebagai contoh ketika menggunakan plugin jQuery pihak-ketiga) atau jika anda butuh versi terbaru dari jQuery, anda akan harus menyertakan salinan anda sendiri.
Django menyediakan kedua versi tidak dipadatkan dan 'dikecilkan' dari jQuery, sebagai masing-masing jquery.js dan jquery.min.js.
ModelAdmin dan InlineModelAdmin mempunyai sebuah sifat media yang mengembalikan sebuah daftar dari obyek Media yang menyimpan jalur pada berkas-berkas JavaScript untuk formulir dan/atau formset. Jika DEBUG adalah True itu akan mengembalikan versi tidak terpampat dari beragam berkas-berkas JavaScript, termasuk jquery.js; jika tidak, itu akan mengembalikan versi 'minified'.
Menambahkan pengesahan penyesuaian pada adminLink to this heading#
\nMenambahkan penyesuaian pengesahan dari data di admin adalah sangat mudah. Antarmuka admin otomatis menggunakan kembali django.forms, dan kelas ModelAdmin memberikan anda kemampuan menentukan formulir anda sendiri:
class ArticleAdmin(admin.ModelAdmin):\n form = MyArticleAdminForm\nMyArticleAdminForm dapat ditentukan dimanapun selama anda mengimpor ketika diperlukan. Sekarang dalam formulir anda anda dapat menambah penyesuaian pengesahan milik anda sendiri untuk bidang apapun:
class MyArticleAdminForm(forms.ModelForm):\n def clean_name(self):\n # do something that validates your data\n return self.cleaned_data["name"]\nItu adalah penting anda menggunakan sebuah ModelForm disini sebaliknya hal-hal dapat rusak. Lihat dokuementasi forms pada custom validation dan, lebih khusus, model form validation notes untuk informasi lebih.