{"title":"Situs admin Django","version":"4.0","locale":"id","docname":"ref/contrib/admin/index","url":"/id/4.0/ref/contrib/admin/","canonical":"https://djangodocs.dev/id/4.0/ref/contrib/admin/","summary":"Satu dari bagian yang paling berkuasa dari Django adalah antarmuka admin otomatis.","html":"

Situs admin DjangoLink to this heading#

\n

Satu dari bagian yang paling berkuasa dari Django adalah antarmuka admin otomatis. Itu membaca metadata dari model anda untuk menyediakan cepat, antarmuka terpusat-model dimana pengguna dipercaya dapat mengelola isi pada situs anda. Dianjurkan admin menggunakan batasannya ke sebuah alat pengelola internal organisasi. Itu tidak dimaksudkan untuk membangun keseluruhan front end disekeliling.

\n

Admin mempunyai banyak kaitan untuk penyesuaian, tetapi hati-hati dari mencoba menggunakan kaitan tersebut secara khusus. Jika anda butuh menyediakan antarmuka pengolahan-terpusat yang memisahkan rincian penerapan dari tabel-tabel dan bidang-bidang basisdata, kemudian itu mungkin waktu utuk menulis tampilan anda sendiri.

\n

Di dokumen ini kami mengobrol bagaimana mengaktifkan pengguna, menggunakan, dan menyesuaikan antarmuka admin Django.

\n
\n

IkhtisarLink to this heading#

\n

Admin diadakan di cetakan proyek awalan digunakan oleh startproject.

\n

Jika anda tidak menggunakan cetakan proyek awalan, ini adalah syarat-syaratnya:

\n
    \n

  1. Tambah 'django.contrib.admin' dan ketergantungannya - django.contrib.auth, django.contrib.contenttypes, django.contrib.messages, dan django.contrib.sessions - ke pengaturan INSTALLED_APPS.

    2. \n

  2. Configure a DjangoTemplates\nbackend in your TEMPLATES setting with\ndjango.template.context_processors.request,\ndjango.contrib.auth.context_processors.auth, and\ndjango.contrib.messages.context_processors.messages in\nthe 'context_processors' option of OPTIONS.

    3. \n

  3. Jika anda telah menyesuaikan pengaturan MIDDLEWARE, django.contrib.auth.middleware.AuthenticationMiddleware dan django.contrib.messages.middleware.MessageMiddleware harus disertakan.

    4. \n

  4. Hook the admin's URLs into your URLconf.

    5. \n
\n

Setelah anda mengambil langkah-langkah ini, anda mungkin akan dapat menggunakan situs admin dengan mengunjungi URL anda kaitkan kedalam (/admin/, secara awalan).

\n

If you need to create a user to login with, use the createsuperuser\ncommand. By default, logging in to the admin requires that the user has the\nis_staff attribute set to True.

\n

Akhirnya, tentukan mana model aplikasi anda harus disunting dalam antarmuka admin. Untuk setiap dari model tersebut, daftarkan mereka dengan admin seperti digambarkan dalam ModelAdmin.

\n
\n

Topik lainnyaLink to this heading#

\n
\n\n
\n\n
\n
\n
\n

Obyek ModelAdminLink to this heading#

\n
\n
\nclass ModelAdminLink to this definition#
\n

The ModelAdmin class is the representation of a model in the admin\ninterface. Usually, these are stored in a file named admin.py in your\napplication. Let's take a look at an example of the ModelAdmin:

\n
Code
from django.contrib import admin\nfrom myapp.models import Author\n\nclass AuthorAdmin(admin.ModelAdmin):\n    pass\nadmin.site.register(Author, AuthorAdmin)\n
\n\n
\n\n
\n

Penghias registerLink to this heading#

\n
\n
\nregister(*models, site=django.contrib.admin.sites.site)Link to this definition#
\n

Ada juga sebuah penghias untuk mendaftarkan kelas-kelas ModelAdmin anda:

\n
Code
from django.contrib import admin\nfrom .models import Author\n\n@admin.register(Author)\nclass AuthorAdmin(admin.ModelAdmin):\n    pass\n
\n

Itu diberikan satu atau lebih kelas-kelas model untuk didaftarkan dengan ModelAdmin. Jika anda sedang menggunakan penyesuaian AdminSite, lewatkan itu menggunakan argumen katakunci site:

\n
Code
from django.contrib import admin\nfrom .models import Author, Editor, Reader\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\n
\n

Anda tidak dapat menggunakan decorator ini jika anda harus mengacu kelas admin anda dalam metode __init__() nya, misalnya. super(PersonAdmin, self).__init__(*args, **kwargs). Anda dapat menggunakan super().__init__(*args, **kwargs).

\n
\n\n
\n
\n

Penemuan dari berkas adminLink to this heading#

\n

Ketika anda menaruh 'django.contrib.admin' di pengaturan INSTALLED_APPS anda, Django secara otomatis mencari modul admin di setiap aplikasi dan mengimpor itu.

\n
\n
\nclass apps.AdminConfigLink to this definition#
\n

Ini adalah awalan kelas AppConfig untuk admin. Itu memanggil autodiscover() ketika Django mulai.

\n
\n\n
\n
\nclass apps.SimpleAdminConfigLink to this definition#
\n

Kelas ini bekerja seperti AdminConfig, kecuali itu tidak memanggil autodiscover().

\n
\n
\ndefault_siteLink to this definition#
\n

Jalur impor bertitik pada kelas situs admin awalan atau pada callable yang mengembalikan yang mengembalikan sebuah instance situs. Awalan pada 'django.contrib.admin.sites.AdminSite'. Lihat Menimpa situs admin awalan untuk penggunaan.

\n
\n\n
\n\n
\n
\nautodiscover()Link to this definition#
\n

Fungsi ini berusaha mengimpor sebuah modul admin di setiap aplikasi terpasang. Modul-modul itu diharapkan mendaftar model dengan admin.

\n

Secara khusus anda tidak butuh memanggil fungsi ini secara langsung sebagai AdminConfig memanggilnya ketika Django mulai.

\n
\n\n

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.

\n
\n
\n

Pilihan ModelAdminLink to this heading#

\n

ModelAdmin sangat fleksibel. Itu mempunyai beberapa pilihan untuk berurusan dengan menyesuaikan antarmuka. Semua pilihan ditentukan pada subkelas ModelAdmin:

\n
Code
from django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n    date_hierarchy = 'pub_date'\n
\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\n
\n
\nModelAdmin.actions_on_topLink to this definition#
\n
\n\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 (actions_on_top = True; actions_on_bottom = False).

\n
\n\n
\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 (actions_selection_counter = True).

\n
\n\n
\n
\nModelAdmin.date_hierarchyLink to this definition#
\n

Setel date_hierarchy pada nama dari DateField atau DateTimeField di model anda, dan halaman daftar rubah akan menyertakan navigasi penelusuran berdasarkan-tanggal oleh bidang itu.

\n

Contoh:

\n
Code
date_hierarchy = 'pub_date'\n
\n

Anda dapat juga menentukan sebuah bidang pada model terkait menggunakan pencarian __, sebagai contoh:

\n
Code
date_hierarchy = 'author__pub_date'\n
\n

Ini akan secara cerdas mengumpulkan itu sendiri berdasarkan pada data tersedia, misalnya jika semua tanggal berada di satu bulan, itu akan menampilkan hanya penelesuran tingkat-hari.

\n\n
\n\n
\n
\nModelAdmin.empty_value_displayLink to this definition#
\n

Atribut ini menimpa nilai pertunjukan awalan untuk bidang rekaman yang kosong (None, string kosong, dll). Nilai awalan - (sebuah tanda garis). Sebagai contoh:

\n
Code
from django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n    empty_value_display = '-empty-'\n
\n

Anda dapat juga menimpa empty_value_display untuk semua halaman admin dengan AdminSite.empty_value_display, atau bidang-bidang tertentu seperti ini:

\n
Code
from django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n    list_display = ('name', 'title', 'view_birth_date')\n\n    @admin.display(empty_value='???')\n    def view_birth_date(self, obj):\n        return obj.birth_date\n
\n\n
\n\n
\n
\nModelAdmin.excludeLink to this definition#
\n

Atribut ini, jika diberikan, harus berupa daftar dari nama-nama bidang untuk mengeluarkan dari formulir.

\n

Sebagai contoh, mari kita pertimbangkan model berikut:

\n
Code
from 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)\n
\n

Jika anda ingin sebuah formulit untuk model Author yang menyertakan hanya bidang name dan title, anda akan menentukan fields atau exclude seperti ini:

\n
Code
from django.contrib import admin\n\nclass AuthorAdmin(admin.ModelAdmin):\n    fields = ('name', 'title')\n\nclass AuthorAdmin(admin.ModelAdmin):\n    exclude = ('birth_date',)\n
\n

Sejak model Author hanya mempunyai tiga bidang, name, title, dan birth_date, formulir dihasilkan dari pernyataan diatas akan mengandung bidang-bidang sama persis.

\n
\n\n
\n
\nModelAdmin.fieldsLink to this definition#
\n

Gunakan pilihan fields untuk 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 model django.contrib.flatpages.models.FlatPage seperi berikut:

\n
Code
class FlatPageAdmin(admin.ModelAdmin):\n    fields = ('url', 'title', 'content')\n
\n

Di contoh diatas, hanya bidang-bidang url, title dan content akan diperlihatkan, berurutan, di formulir. fields dapat mengandung nilai-nilai ditentukan di ModelAdmin.readonly_fields untuk diperlihatkan sebagai hanya-baca.

\n

Untuk kebutuhan tata letak lebih rumit, lihat pilihan fieldsets.

\n

Pilihan fields menerima jenis-jenis sama dari nilai sebagai list_display, kecuali yang callable tidak diterima. Nama-nama dari model dan metode admin model akan hanya digunakan jika mereka terdaftar dalam readonly_fields.

\n

Untuk memperlihatkan banyak bidang pada baris yang sama, bungkus bidang-bidang tersebut di tuple mereka sendiri. Di contoh ini, bidang url dan title akan diperlihatkan di baris sama dan bidang content akan diperlihatkan dibawah mereka pada baris nya sendiri:

\n
Code
class FlatPageAdmin(admin.ModelAdmin):\n    fields = (('url', 'title'), 'content')\n
\n\n

Jika tidak ada pilihan fields maupun fieldsets hadir, Django akan mengawalkan ke menampilkan setiap bidang yang bukan sebuah AutoField dan mempunyai editable=True, dalam fieldset tunggal, di urutan sama seperti bidang-bidang ditentukan di model

\n
\n\n
\n
\nModelAdmin.fieldsetsLink to this definition#
\n

Setel fieldsets utuk mengendalikan tata letak dari halaman "add" dan "change" admin.

\n

fieldsets adalah daftar dari dua-tuple, yang setiap dua-tuple mewakili sebuah <fieldset> pada halaman formulir admin. (Sebuah <fieldset> adalah sebuah "section" dari formulir.)

\n

Dua-tuple dalam bentuk (name, field_options), dimana name adalah sebuah string mewakili juful dari fieldset dan field_options adalah sebuah kamus dari informasi tentang fieldset, termasuk daftar dari bidang-bidang untuk ditampilkan di itu.

\n

Sebuah contoh penuh, diambil dari model django.contrib.flatpages.models.FlatPage

\n
Code
from 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    )\n
\n

Hasil dalam halaman admin yang kelihatan seperti:

\n\"/id/4.0/_images/fieldsets.png\"\n

Jika tidak ada pilihan fieldsets maupun fields hadir, Django akan mengawalkan ke menampilkan setiap bidang yang bukan sebuah AutoField dan mempunyai editable=True, dalam fieldset tunggal, di urutan sama seperti bidang-bidang ditentukan di model

\n

Kamus field_options dapat mempunyai kunci berikut:

\n
    \n
  • \n
    fields

    Sebuah tuple dari nama-nama bidang untuk ditampilkan di fieldset ini. Kunci ini diwajibkan.

    \n

    Contoh:

    \n
    Code
    {\n'fields': ('first_name', 'last_name', 'address', 'city', 'state'),\n}\n
    \n

    Seperti pilihan fields, untuk memperlihatkan banyak bidang pada baris sama, membungkus bidang tersebut di tuple mereka sendiri. Dalam contoh ini, bidang first_name dan last_name memperlihatkan pada baris sama:

    \n
    Code
    {\n'fields': (('first_name', 'last_name'), 'address', 'city', 'state'),\n}\n
    \n

    fields dapat mengandung nilai-nilai ditentukan di readonly_fields untuk ditampilkan sebagai hanya-baca.

    \n

    Jika anda menambah nama dari callable ke fields, aturan sama berlaku seperti pilihan fields: callable harus sidaftar di readonly_fields.

    \n
    \n
    \n
    • \n
  • \n
    classes

    Sebuah daftar atau tuple mengandung kelas-kelas CSS tambahan untuk berlaku pada fieldset.

    \n

    Contoh:

    \n
    Code
    {\n'classes': ('wide', 'extrapretty'),\n}\n
    \n

    Dua kelas beguna ditentukan oleh awalan stylesheet situs admin adalah collapse and wide. Fieldset dengan gaya collapse akan diinisialisasi runtuh di admin dan diganti dengan sebuah tautan "klik untuk memperluas" kecil. Fieldset dengan gaya wide akan diberikan ruang mendatar tambahan.

    \n
    \n
    \n
    • \n
  • \n
    description

    Sebuah string dari teks tambahan pilihan untuk diperlihatkan pada atas dari setiap fieldset, dibawah kepala dari fieldset. String ini tidak dibangun untuk TabularInline disebabkan oleh tata letaknya.

    \n

    Catat bahwa nilai ini bukan pelolosan-HTML ketika itu ditampilkan dalam antarmuka admin. Ini membuat anda menyertakan HTML jika anda inginkan. Cara lain anda dapat menggunakan teks polos dan django.utils.html.escape() untuk meloloskan karakter khusus HTML apapun.

    \n
    \n
    \n
    • \n
\n
\n\n
\n
\nModelAdmin.filter_horizontalLink to this definition#
\n

Secara awalan, sebuah ManyToManyField diperlihatkan di situs admin dengan <select multiple>. Bagaimanapun, kotak pilihan-banyak dapat sulit digunakan ketika memilih banyak barang. Menambahkan sebuah ManyToManyField ke 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. Lihat filter_vertical untuk menggunakan antarmuka tegak lurus.

\n
\n\n
\n
\nModelAdmin.filter_verticalLink to this definition#
\n

Sama seperti filter_horizontal, tetapi menggunakan tampilan tegak lurus dari antarmuka penyaring dengan kotak dari piliha tidak dipilih muncul diatas dari pilihan terpilih.

\n
\n\n
\n
\nModelAdmin.formLink to this definition#
\n

Secara awalan sebuah ModelForm secara dinamis dibuat untuk model anda. Itu digunakan untuk membuat formulir dihadirkan pada kedua halaman tambah/rubah. Anda dapat dengan mudah menyediakan ModelForm anda 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 metode ModelAdmin.get_form().

\n

Untuk sebuah contoh lihat bagian Menambahkan pengesahan penyesuaian pada admin.

\n\n\n
\n\n
\n
\nModelAdmin.formfield_overridesLink to this definition#
\n

Ini menyediakan cara cepat-dan-kotor untuk menimpa beberapa pilihan Field untuk digunakan di admin. formfield_overrides adalah sebuah kamus memetakan sebuah kelas bidang pada kamus dari argumen untuk melewatkan ke bidang pada waktu pembangunan.

\n

Sejak itu sedikit abstrak, mari kita lihat contoh nyata. Penggunaan paling umum dari formfield_overrides ada;ah menambahkan sebuah widget penyesuaian untuk jenis tertentu dari bidang. Jadi, bayangkan kami telah menulis sebuah RichTextEditorWidget yang ingin untuk digunakan untuk bidang teks besar daripada awalan <textarea>. Ini adalah bagaimana kami melakukannya:

\n
Code
from django.contrib import admin\nfrom django.db import models\n\n# Import our custom widget and our model from where they're defined\nfrom myapp.models import MyModel\nfrom myapp.widgets import RichTextEditorWidget\n\nclass MyModelAdmin(admin.ModelAdmin):\n    formfield_overrides = {\n        models.TextField: {'widget': RichTextEditorWidget},\n    }\n
\n

Catat bahwa kunci di kamus adalah kelas bidang sebenarnya, bukan sebuah string. Nilai adalah kamus lain; argumen ini akan dilewatkan ke metode __init__() bidang formulir. Lihat API Formulir untuk rincian.

\n\n
\n\n
\n
\nModelAdmin.inlinesLink to this definition#
\n

Lihat InlineModelAdmin objects below as well as ModelAdmin.get_formsets_with_inlines().

\n
\n\n
\n
\nModelAdmin.list_displayLink to this definition#
\n

Set list_display untuk mengendalikan bidang-bidang mana yang ditampilkan pada halaman daftar rubah dari admin.

\n

Contoh:

\n
Code
list_display = ('first_name', 'last_name')\n
\n

Jika anda tidak menyetel list_display, situs admin akan menampilkan kolom tunggal yang menampilkan perwakilan __str__() untuk setiap obyek.

\n

There are four types of values that can be used in list_display. All\nbut the simplest may use the display()\ndecorator, which is used to customize how the field is presented:

\n
    \n

  • Nama dari bidang model. Sebagai contoh:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ('first_name', 'last_name')\n
    \n
    • \n

  • Sebuah callable yang menerima satu argumen, instance model. Sebagai contoh:

    \n
    Code
    @admin.display(description='Name')\ndef upper_case_name(obj):\n    return ("%s %s" % (obj.first_name, obj.last_name)).upper()\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = (upper_case_name,)\n
    \n
    • \n

  • Sebuah string mewakili sebuah metode ModelAdmin yang menerima satu argumen. instance model. Sebagai contoh:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ('upper_case_name',)\n\n    @admin.display(description='Name')\n    def upper_case_name(self, obj):\n        return ("%s %s" % (obj.first_name, obj.last_name)).upper()\n
    \n
    • \n

  • Sebuah string mewakilkan sebuah atribut model atau metode (tanpa argumen dibutuhkan apapun). Sebagai contoh:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\n\nclass Person(models.Model):\n    name = models.CharField(max_length=50)\n    birthday = models.DateField()\n\n    @admin.display(description='Birth decade')\n    def decade_born_in(self):\n        return '%d’s' % (self.birthday.year // 10 * 10)\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ('name', 'decade_born_in')\n
    \n
    • \n
\n

Sedikit kasus khusus untuk dicatat tentang list_display:

\n
    \n

  • Jika bidang adalah sebuah ForeignKey, Django akan menampilkan __str__() dari obyek terkait.

    • \n

  • Bidang-bidang ManyToManyField tidak 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 ke list_display. (Lihat dibawah untuk lebih pada metode penyesuaian di list_display.)

    • \n

  • If the field is a BooleanField, Django will display a pretty "yes",\n"no", or "unknown" icon instead of True, False, or None.

    • \n

  • Jika deretan karakter yang diberikan adalah metode dari model, ModelAdmin atau callable, Django akan meloloskan-HTML keluaran secara awalan. Untuk meloloskan masukan pengguna dan mengizinkan etiket tidak meloloskan anda sendiri, gunakan format_html().

    \n

    Ini adalah sebuah contoh penuh model:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\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    @admin.display\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
    \n
    • \n

  • As some examples have already demonstrated, when using a callable, a\nmodel method, or a ModelAdmin method, you can customize the column's\ntitle by wrapping the callable with the\ndisplay() decorator and passing the\ndescription argument.

    \n\n
    • \n

  • Jika nilai dari sebuah bidang adalah None, sebuah string kosong, atau sebuah perulangan tanpa unsur-unsur, Django akan menampilkan -` (tanda garis). Anda dapat menimpa ini dengan AdminSite.empty_value_display:

    \n
    Code
    from django.contrib import admin\n\nadmin.site.empty_value_display = '(None)'\n
    \n

    Anda juga dapat menggunakan ModelAdmin.empty_value_display:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    empty_value_display = 'unknown'\n
    \n

    Atau pada tingkat bidang:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_display = ('name', 'birth_date_view')\n\n    @admin.display(empty_value='unknown')\n    def birth_date_view(self, obj):\n         return obj.birth_date\n
    \n\n
    • \n

  • If the string given is a method of the model, ModelAdmin or a\ncallable that returns True, False, or None, Django will\ndisplay a pretty "yes", "no", or "unknown" icon if you wrap the method\nwith the display() decorator passing the\nboolean argument with the value set to True:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    birthday = models.DateField()\n\n    @admin.display(boolean=True)\n    def born_in_fifties(self):\n        return 1950 <= self.birthday.year < 1960\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ('name', 'born_in_fifties')\n
    \n\n
    • \n

  • Metode __str__() adalah hanya sah dalam list_display seperti metode model lain apapun, jadi itu sangat OK untuk melakukan ini:

    \n
    Code
    list_display = ('__str__', 'some_other_field')\n
    \n
    • \n

  • Biasanya, unsur-unsur dari list_display yang bukan bidang basisdata sebenarnya tidak dapat digunakan dalam mengurutkan (karena Django melakukan semua pengurutan pada tingkat basisdata).

    \n

    However, if an element of list_display represents a certain database\nfield, you can indicate this fact by using the\ndisplay() decorator on the method, passing\nthe ordering argument:

    \n
    Code
    from django.contrib import admin\nfrom django.db import models\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    @admin.display(ordering='first_name')\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\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ('first_name', 'colored_first_name')\n
    \n

    Diatas akan mengatakan Django untuk mengurutkan berdasarkan bidang first_name ketika mencoba mengurutkan berdasarkan colored_first_name di admin.

    \n

    To indicate descending order with the ordering argument you can use a\nhyphen prefix on the field name. Using the above example, this would look\nlike:

    \n
    Code
    @admin.display(ordering='-first_name')\n
    \n

    The ordering argument supports query lookups to sort by values on\nrelated models. This example includes an "author first name" column in\nthe list display and allows sorting it by first name:

    \n
    Code
    class 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    @admin.display(ordering='author__first_name')\n    def author_first_name(self, obj):\n        return obj.author.first_name\n
    \n

    Query expressions may be used with the\nordering argument:

    \n
    Code
    from django.db.models import Value\nfrom django.db.models.functions import Concat\n\nclass Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    last_name = models.CharField(max_length=50)\n\n    @admin.display(ordering=Concat('first_name', Value(' '), 'last_name'))\n    def full_name(self):\n        return self.first_name + ' ' + self.last_name\n
    \n\n
    • \n

  • Elements of list_display can also be properties:

    \n
    Code
    class Person(models.Model):\n    first_name = models.CharField(max_length=50)\n    last_name = models.CharField(max_length=50)\n\n    @property\n    @admin.display(\n        ordering='last_name',\n        description='Full name of the person',\n    )\n    def full_name(self):\n        return self.first_name + ' ' + self.last_name\n\nclass PersonAdmin(admin.ModelAdmin):\n    list_display = ('full_name',)\n
    \n

    Note that @property must be above @display. If you're using the\nold way -- setting the display-related attributes directly rather than\nusing the display() decorator -- be aware\nthat the property() function and not the @property decorator\nmust be used:

    \n
    Code
    def my_property(self):\n    return self.first_name + ' ' + self.last_name\nmy_property.short_description = "Full name of the person"\nmy_property.admin_order_field = 'last_name'\n\nfull_name = property(my_property)\n
    \n
    • \n

  • Nama-nama bidang di list_display akan juga muncul sebagai kelas-kelas CSS di keluaran HTML, di formulir dari column-<field_name> pada setiap unsur <th>. Ini dapat digunakan menyetel lebar kolom di sebuah berkas CSS sebagai contoh.

    • \n

  • Django akan mencoba mentafsirkan setiap unsur dari list_display di urutan ini:

    \n
      \n

    • Bidang dari model.

      • \n

    • Callable

      • \n

    • Sebuah string mewakili sebuah atribut ModelAdmin.

      • \n

    • Sebuah string mewakili sebuah atribut model.

      • \n
    \n

    Sebagai contoh jika anda mempunyai "first name" sebagai model bidang dan sebagai atribut ModelAdmin, bidang model akan digunakan.

    \n
    • \n
\n
\n\n
\n
\nModelAdmin.list_display_linksLink to this definition#
\n

Gunakan list_display_links untuk mengendalikan jika dan bidang-bidang mana di list_display harus di tautkan ke halaman "change" untuk sebuah obyek.

\n

Secara awalan, halaman daftar rubah akan mengkaitkan kolom pertama -- bidang pertama ditentukan di list_display -- ke halaman perubahan untuk setiap barang. Tetapi list_display_links membiarkan anda merubah ini:

\n
    \n

  • Sete itu menjadi None untuk tidak mendapatkan tautan sama sekali.

    • \n

  • Set itu menjadi daftar atau tuple dari bidang (di bentuk sama seperti list_display) yang kolomnya anda ingin rubah menjadi tautan.

    \n

    Anda dapat menentukan satu atau banyak bidang. Selama bidang-bidang muncul di list_display, Django tidak peduli seberapa banyak (seberapa sedikit) bidang-bidang ditautkan. Persyaratan satu-satunya adalah bahwa jika anda ingin menggunakan list_display_links dengan cara ini, anda harus menentukan list_display.

    \n
    • \n
\n

Di contoh ini, bidang first_name dan last_name akan dikaitkan pada halaman daftar rubah:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    list_display = ('first_name', 'last_name', 'birthday')\n    list_display_links = ('first_name', 'last_name')\n
\n

Di contoh ini, jaring halaman daftar rubah tidak akan mempunyai tautan:

\n
Code
class AuditEntryAdmin(admin.ModelAdmin):\n    list_display = ('timestamp', 'message')\n    list_display_links = None\n
\n
\n\n
\n
\nModelAdmin.list_editableLink to this definition#
\n

Setel list_editable ke sebuah daftar nama-nama bidang pada model yang akan mengizinkan menyunting pada halaman daftar rubah. yaitu, bidang-bidang terdaftar di list_editable akan diperlihatkan sebagai formulir widget pada halaman daftar rubah, mengizinkan pengguna menyunting dan menyimpan banyak baris sekaligus.

\n\n
\n\n
\n
\nModelAdmin.list_filterLink to this definition#
\n

Setel list_filter untuk mengaktifkan penyaring di batang sisi kanan dari halaman daftar rubah dari admin, seperti digambarkan di tangkapan layar berikut:

\n\"/id/4.0/_images/list_filter.png\"\n

list_filter harus berupa sebuah daftar atau tuple dari unsur, dimana setiap unsur harus berupa satu dari jenis-jenis berikut:

\n
    \n

  • sebuah nama bidang, dimana bidang ditentukan harus berupa antara BooleanField, CharField, DateField, DateTimeField, IntegerField, ForeignKey atau ManyToManyField, sebagai contoh:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_filter = ('is_staff', 'company')\n
    \n

    Nama-nama bidang di list_filter dapat juga menjangkau hubungan menggunakan pencarian __, sebagai contoh:

    \n
    Code
    class PersonAdmin(admin.UserAdmin):\n    list_filter = ('company__name',)\n
    \n
    • \n

  • sebuah kelas mewarisi dari django.contrib.admin.SimpleListFilter, yang anda butuh menyediakan atribut title dan parameter_name dan menimpa metode lookups dan queryset, misalnya:

    \n
    Code
    from datetime import date\n\nfrom django.contrib import admin\nfrom django.utils.translation import gettext_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
    \n\n
    • \n

  • sebuah tuple, dimana unsur pertama adalah nama bidang dan unsur kedua adalah kelas diwarisi dari django.contrib.admin.FieldListFilter, sebagai contoh:

    \n
    Code
    class PersonAdmin(admin.ModelAdmin):\n    list_filter = (\n        ('is_staff', admin.BooleanFieldListFilter),\n    )\n
    \n

    Anda dapat membatasi pilihan dari model terkait pada obyek-obyek terlibat di hubungan itu menggunakan RelatedOnlyFieldListFilter:

    \n
    Code
    class BookAdmin(admin.ModelAdmin):\n    list_filter = (\n        ('author', admin.RelatedOnlyFieldListFilter),\n    )\n
    \n

    Mengganggap author adalah ForeignKey pada model User, ini akan membatasi pilihan list_filter pada pengguna yang telah menulis sebuah buku daripada mendaftarkan semua pengguna.

    \n

    You can filter empty values using EmptyFieldListFilter, which can\nfilter on both empty strings and nulls, depending on what the field\nallows to store:

    \n
    Code
    class BookAdmin(admin.ModelAdmin):\n    list_filter = (\n        ('title', admin.EmptyFieldListFilter),\n    )\n
    \n\n\n
    • \n
\n

Daftar penyaring khususnya muncul hanya jika penyaring mempunyai lebih dari satu pilihan. Sebuah metode has_output() penyaring mengendalikan apakah atau tidak itu muncul.

\n

Itu memungkinkan menentukan penyesuaian cetakan untuk membangun daftar penyaring:

\n
Code
class FilterWithCustomTemplate(admin.SimpleListFilter):\n    template = "custom_template.html"\n
\n

Lihat cetakan awalan disediakan oleh Django (admin/filter.html) untuk contoh nyata.

\n
\n\n
\n
\nModelAdmin.list_max_show_allLink to this definition#
\n

Setel list_max_show_all untuk 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 menjadi 200.

\n
\n\n
\n
\nModelAdmin.list_per_pageLink to this definition#
\n

Setel list_per_page untuk mengendalikan seberapa banyak barang akan muncul pada setiap penomoran halaman daftar rubah admin. Secara awalan, ini disetel menjadi 100.

\n
\n\n
\n
\nModelAdmin.list_select_relatedLink to this definition#
\n

Setel list_select_related untuk memberitahu Django menggunakan select_related() dalam mengambil daftar dari obyek-obyek pada halaman daftar rubah admin. Ini dapat menghemat anda sekelompok dari permintaan basisdata.

\n

Nilai harus antara sebuah boolean, sebuah daftar atau sebuah tuple. Awalan adalah False.

\n

Ketika nilai adalah True, select_related() akan selalu dipanggil. Ketika nilai disetel menjadi False, Django akan mencari list_display dan memanggil select_related() jika ForeignKey apapun hadir.

\n

Jika anda butuh lebih kendali berjaring-halus, gunakan sebuah tuple (atau daftar) sebagai nilai untuk list_select_related. Tuple kosong akan mencegah Django dari memanggil select_related sama sekali. Tuple lain apapun akan dilewatkan secara langsung ke select_related sebagai parameter. Sebagai contoh:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    list_select_related = ('author', 'category')\n
\n

akan memanggil select_related('author', 'category').

\n

Jika anda butuh menentukan nilai dinamis berdasarkan pada permintaan, anda dapat menerapkan cara get_list_select_related().

\n\n
\n\n
\n
\nModelAdmin.orderingLink to this definition#
\n

Setel ordering untuk menentukan bagaimana daftar dari obyek-obyek harus diurutkan di tampilan admin Django. Ini harus berupa sebuah daftar atau tuple di bentuk sama seperti parameter ordering model.

\n

Jika ini tidak disediakan, admin Django akan menggunakan pengurutan awalan model.

\n

Jika anda butuh menentukan urutan dinamis (sebagai contoh bergantung pada pengguna atau bahasa) anda dapat menerapkan sebuah metode get_ordering().

\n\n
\n\n
\n
\nModelAdmin.paginatorLink to this definition#
\n

Kelas penomoran digunakan untuk menomorkan halaman. Secara awalan, django.core.paginator.Paginator digunakan. Jika penyesuaian kelas penomoran tidak mempunyai antarmuka pembangun sama seperti django.core.paginator.Paginator, anda akan juga butuh menyediakan sebuah penerapan untuk ModelAdmin.get_paginator().

\n
\n\n
\n
\nModelAdmin.prepopulated_fieldsLink to this definition#
\n

Setel prepopulated_fields pada nama-nama bidang pemetaan kamus ke bidang-bidang itu harus mengisi dimuka dari:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    prepopulated_fields = {"slug": ("title",)}\n
\n

When set, the given fields will use a bit of JavaScript to populate from\nthe fields assigned. The main use for this functionality is to\nautomatically generate the value for SlugField fields from one or more\nother fields. The generated value is produced by concatenating the values\nof the source fields, and then by transforming that result into a valid\nslug (e.g. substituting dashes for spaces and lowercasing ASCII letters).

\n

Bidang-bidang diisi tidak dirubah oleh JavaScript setelah sebuah nilai telah disimpan. Itu biasanya tidak diinginkan bahwa tanda siput berubah (yang akan menyebabkan sebuah URL obyek berubah jika tanda siput digunakan dalam itu).

\n

prepopulated_fields tidak menerima bidang-bidang DateTimeField, ForeignKey, OneToOneField, dan ManyToManyField.

\n\n
\n\n
\n
\nModelAdmin.preserve_filtersLink to this definition#
\n

By default, applied filters are preserved on the list view after creating,\nediting, or deleting an object. You can have filters cleared by setting\nthis attribute to False.

\n
\n\n
\n
\nModelAdmin.radio_fieldsLink to this definition#
\n

Secara awalan, admin Django menggunakan antarmuka kotak-pilih (<select>) untuk bidang-bidang adalah ForeignKey atau mempunyai choices disetel. Jika sebuah bidang hadir di radio_fields, Django akan menggunakan antarmuka tombl-radio sebagai gantinya. Menganggap group adalah sebuah ForeignKey pada model Person:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    radio_fields = {"group": admin.VERTICAL}\n
\n

Anda mempunyai pilihan dari menggunakan HORIZONTAL atau VERTICAL dari modul django.contrib.admin.

\n

Jangan menyertakan sebuah bidang dalam radio_fields meskipun dia adalah ForeignKey atau mempunyai kumpulan choices.

\n
\n\n
\n
\nModelAdmin.autocomplete_fieldsLink to this definition#
\n

autocomplete_fields adalah sebuah daftar dari ForeignKey dan/atau bidang ManyToManyField anda ingin rubah menjadi masukan pelengkap otomatis Select2 .

\n

Secara awalan, admin menggunakan antarmuka pilih-kotak (````) untuk bidang-bidang tersebut. Terkadang anda tidak ingin terjadi tambahan dari memilih semua instance terkait untuk ditampilkan dalam dropdown.

\n

Masukan Select2 terlihat mirip pada masukan awalan tetapi datang dengan fitur pencarian yang memuat pilihan secara asinkron. Ini lebih cepat dan lebih ramah-pengguna jika model terkait mempunyai banyak instance.

\n

Anda harus menentukan search_fields di obyek ModelAdmin terkait karena pencarian lengkap otomatis menggunakan itu.

\n

Untuk menghindari penyingkapan data tidak berhak, pengguna harus memiliki perizinan view atau change pada obyek terkait untuk menggunakan pelengkapan otomatis.

\n

Pengurutan dan penomoran dari hasil dikendalikan oleh metode terkait get_ordering() dan get_paginator() ModelAdmin.

\n

Dalam contoh berikut, ChoiceAdmin mempunyai sebuah bidang pelengkapan otomatis untuk ForeignKey pada Question. Hasilnya disaring oleh bidang question_text diurutkan oleh bidang date_created:

\n
Code
class QuestionAdmin(admin.ModelAdmin):\n    ordering = ['date_created']\n    search_fields = ['question_text']\n\nclass ChoiceAdmin(admin.ModelAdmin):\n    autocomplete_fields = ['question']\n
\n\n
\n\n
\n
\nModelAdmin.raw_id_fieldsLink to this definition#
\n

Secara awalan, admin Django menggunakan antarmuka kotak-pilih (<select>) untuk bidang-bidang adalah ForeignKey. Terkadang anda tidak ingin mendatangkan atas dari memiliki untuk memilih semua instance terkait untuk memperlihatkan di drop-down.

\n

raw_id_fields adalah sebuah daftar dari bidang anda ingin rubah menjadi widget input untuk antara sebuah ForeignKey atau ManyToManyField:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    raw_id_fields = ("newspaper",)\n
\n

Widget Input raw_id_fields harus mengandung sebuah primary key jika bidang adalah sebuah ForeignKey atau sebuah dipisahkan koma daftar dari nilai-nilai jika bidng adalah ManyToManyField. Widget raw_id_fields menunjukkan tombol kaca pembesar dekat pada bidang yang mengizinkan pengguna mencari dan memilih sebuah nilai:

\n\"/id/4.0/_images/raw_id_fields.png\"\n
\n\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 list atau tuple) akan menampilkan data dengan-adanya dan bukan-dapat disunting; mereka juga dikeluarkan dari ModelForm digunakan untuk membuat dan menyunting. catat bahwa ketika menentukan ModelAdmin.fields atau ModelAdmin.fieldsets bidang-bidang hanya-baca harus hadir untuk ditunjukkan (mereka diabaikan sebaliknya).

\n

Jika readonly_fields digunakan tanpa menentukan urutan jelas melalui ModelAdmin.fields atau ModelAdmin.fieldsets mereka akan ditambahkan setelah semua bidang dapat disunting.

\n

A read-only field can not only display data from a model's field, it can\nalso display the output of a model's method or a method of the\nModelAdmin class itself. This is very similar to the way\nModelAdmin.list_display behaves. This provides a way to use the\nadmin interface to provide feedback on the status of the objects being\nedited, for example:

\n
Code
from 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    # description functions like a model field's verbose_name\n    @admin.display(description='Address')\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
\n\n
\n
\nModelAdmin.save_asLink to this definition#
\n

Setel save_as untuk mengadakan sebuah fitur "save as new" pada formulir rubah admin.

\n

Biasanya, obyek-obyek mempunyai tiga pilihan simpan: "Save", "Save and continue editing", dan "Save and add another". Jika save_as adalah True, "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.

\n

Secara awal, save_as disetel ke False.

\n
\n\n
\n
\nModelAdmin.save_as_continueLink to this definition#
\n

Ketika save_as=True, awalan pengalihan setelah menyimpan obyek baru adalah merubah tampilan untuk obyek itu. Jika anda menyetel save_as_continue=False, pengalihan akan ke tampilan daftar rubah.

\n

Secara awal, save_as_continue disetel menjadi False.

\n
\n\n
\n
\nModelAdmin.save_on_topLink to this definition#
\n

Setel save_on_top untuk menambah tombol simpan lintas atas dari formulir rubah admin anda.

\n

Biasanya, tombol simpan muncul hanya pada bawah dari formulir. Jika anda menyetel save_on_top, tombol-tombol akan muncul kedua pada atas dan bawah.

\n

Secara awal, save_on_top disetel ke False.

\n
\n\n
\n
\nModelAdmin.search_fieldsLink to this definition#
\n

Setel search_fields untuk 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.

\n

Bidang-bidang ini harus ada semacam bidang teks, seperti CharField atau TextField. Anda dapat juga melakukan pencarian terkait pada sebuah ForeignKey atau ManyToManyField catatan "follow" dengan API pencarian:

\n
Code
search_fields = ['foreign_key__related_fieldname']\n
\n

Sebagai contoh, jika anda mempunyai sebuah masukan blog dengan sebuah penulis, pengertian berikut akan mengadakan pencarian masukan blog berdasarkan alamat surel dari penulis.

\n
Code
search_fields = ['user__email']\n
\n

When somebody does a search in the admin search box, Django splits the\nsearch query into words and returns all objects that contain each of the\nwords, case-insensitive (using the icontains lookup), where each\nword must be in at least one of search_fields. For example, if\nsearch_fields is set to ['first_name', 'last_name'] and a user\nsearches for john lennon, Django will do the equivalent of this SQL\nWHERE clause:

\n
SQL
WHERE (first_name ILIKE '%john%' OR last_name ILIKE '%john%')\nAND (first_name ILIKE '%lennon%' OR last_name ILIKE '%lennon%')\n
\n

The search query can contain quoted phrases with spaces. For example, if a\nuser searches for "john winston" or 'john winston', Django will do\nthe equivalent of this SQL WHERE clause:

\n
SQL
WHERE (first_name ILIKE '%john winston%' OR last_name ILIKE '%john winston%')\n
\n

Jika anda tidak ingin menggunakan icontains sebagai pencarian, anda dapat menggunakan pencarian apapun dengan menambahkan itu ke bidang. Sebagai contoh, anda dapat menggunakan exact dengan menyetel search_field menjadi ['first_name__exact'].

\n

Beberapa jalan pintas (paling lama) untuk menentukan pencarian bidang juga tersedia. Anda dapat menambahkan sebuah bidang dalam search_fields dengan karakter berikut dan itu setara pada menambahkan __ ke bidang:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Awalan

Cari

^

startswith

=

iexact

@

search

None

icontains

\n
\n

Jika anda butuh menyesuaikan pencarian anda dapat menggunakan ModelAdmin.get_search_results() untuk menyediakan tambahan atau pengganti perilaku pencarian.

\n\n
\n\n
\n
\nModelAdmin.search_help_textLink to this definition#
\n
\n

Set search_help_text to specify a descriptive text for the search box\nwhich will be displayed below it.

\n
\n\n
\n
\nModelAdmin.show_full_result_countLink to this definition#
\n

Setel show_full_result_count untuk mengendalikan apakah perhitungan penuh dari obyek harus ditampilkan pada halaman admin disaring (misalnya 99 hasil (jumlah 103)). Jika pilihan ini disetel menjadi False, sebuah teks seperti 99 hasil (Tampilkan semua) ditampilkan sebagai gantinya.

\n

Awalan dari show_full_result_count=True membangkitkan sebuah permintaan untuk melakukan perhitungan penuh pada tabel yang dapat mahal jika isi tabel mengandung sejumlah nomor dari baris.

\n
\n\n
\n
\nModelAdmin.sortable_byLink to this definition#
\n

By default, the change list page allows sorting by all model fields (and\ncallables that use the ordering argument to the\ndisplay() decorator or have the\nadmin_order_field attribute) specified in list_display.

\n

Jika anda ingin meniadakan pemilihan untuk beberapa kolom, setel sortable_by pada sebuah kumpulan (misalnya list, tuple, atau set) dari himpunan bagian list_display yang anda ingin menjadi dapat dipilih. Sebuah kumpulan kosong meniadakan pemilihan untuk semua kolom.

\n

Jika anda butuh menentukan daftar ini secara dinamis, terapkan metode get_sortable_by() sebagai gantinya.

\n
\n\n
\n
\nModelAdmin.view_on_siteLink to this definition#
\n

Setel view_on_site untuk mengendalikan apakah atau tidak ditampilkan tautan "View on site". Tautan ini harus membawa anda ke URL dimana anda dapat menampilkan obyek tersimpan.

\n

Nilai ini dapat berupa baik bendera boolean atau callable. Jika True (awalan), metode obyek get_absolute_url() akan digunakan untuk membangkitkan url.

\n

Jika model anda mempunyai metode get_absolute_url() tetapi anda tidak ingin tombol "View on site" muncul, anda hanya butuh mensetel view_on_site menjadi False:

\n
Code
from django.contrib import admin\n\nclass PersonAdmin(admin.ModelAdmin):\n    view_on_site = False\n
\n

Di kasus itu adalah callable, itu menerima instance model sebagai parameter. Sebagi contoh:

\n
Code
from 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
\n
\n\n
\n

Penyesuaian pilihan cetakanLink to this heading#

\n

Bagian Menimpa cetakan admin menggambarkan bagaimana menimpa atau memperpanjang awalan cetakan admin. Gunakan pilihan berikut untuk mengesampingkan cetakan awalan digunakan oleh tampilan ModelAdmin:

\n
\n
\nModelAdmin.add_form_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh add_view().

\n
\n\n
\n
\nModelAdmin.change_form_templateLink to this definition#
\n

Jalur untuk cetakan penyesuaian, digunakan oleh change_view().

\n
\n\n
\n
\nModelAdmin.change_list_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh changelist_view().

\n
\n\n
\n
\nModelAdmin.delete_confirmation_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh delete_view() untuk menampilkan halaman penegasan ketika menghapus satu atau lebih obyek.

\n
\n\n
\n
\nModelAdmin.delete_selected_confirmation_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh tindakan delete_selected untuk memperlihatkan halaman penegasan ketika menghapus satu atau lebih obyek. Lihat actions documentation.

\n
\n\n
\n
\nModelAdmin.object_history_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh history_view().

\n
\n\n
\n
\nModelAdmin.popup_response_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian, digunakan oleh response_add(), response_change(), dan response_delete().

\n
\n\n
\n
\n
\n

Cara ModelAdminLink to this heading#

\n\n
\n
\nModelAdmin.save_model(request, obj, form, change)Link to this definition#
\n

Metode save_model memberikan HttpRequest, sebuah instance model, sebuah instance ModelForm, dan sebuah nilai boolean berdasarkan pada apakah itu sedang menambahkan atau merubah obyek. Menimpa metode ini mengizinkan melakukan tindakan pra- atau menempatkan-simpan. Memanggil super().save_model() untuk menyimpan obyek menggunakan Model.save().

\n

Sebagai contoh untuk melampirkan request.user pada obyek sebelum menyimpannya:

\n
Code
from 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().save_model(request, obj, form, change)\n
\n
\n\n
\n
\nModelAdmin.delete_model(request, obj)Link to this definition#
\n

Metode delete_model diberikan HttpRequest dan sebuah instance model. Mengesampingkan metode ini mengizinkan melakukan tindakan menghapus pra- atau pasca-. Panggil super().delete_model() untuk menghapus obyek menggunakan Model.delete().

\n
\n\n
\n
\nModelAdmin.delete_queryset(request, queryset)Link to this definition#
\n

Metode delete_queryset() memberikan HttpRequest dan QuerySet dari obyek untuk dihapus. Timpa metode ini untuk menyesuaikan pengolahan penghapusan untuk "delete selected objects" action.

\n
\n\n
\n
\nModelAdmin.save_formset(request, form, formset, change)Link to this definition#
\n

Metode save_formset memberikan HttpRequest, instance ModelForm induk dan nilai boolean berdasarkan pada apakah itu sedang menambahkan atau merubah obyek induk.

\n

Sebagai contoh, untuk melampirkan request.user pada setiap instance model formset dirubah:

\n
Code
class 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()\n
\n

Lihat juga Saving objects in the formset.

\n
\n\n
\n
\nModelAdmin.get_ordering(request)Link to this definition#
\n

Metode get_ordering mengambil request sebagai parameter dan diharapkan mengembalikan sebuah list atau tuple untuk mengurutkan mirip pada atribut ordering. Sebagai contoh:

\n
Code
class 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
\n\n
\n
\nModelAdmin.get_search_results(request, queryset, search_term)Link to this definition#
\n

Metode get_search_results merubah 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.

\n

Pencarian penerapan awalan bidang-bidang bernama di ModelAdmin.search_fields.

\n

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 True di unsur kedua dari nilai kembalian.

\n

Sebagai contoh, untuk mencari name dan age, anda dapat menggunakan:

\n
Code
class 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, may_have_duplicates = super().get_search_results(\n            request, queryset, search_term,\n        )\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, may_have_duplicates\n
\n

Penerapan ini lebih efesien dari search_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\n
\n
\nModelAdmin.save_related(request, form, formsets, change)Link to this definition#
\n

Metode save_related memberikan HttpRequest, sebuah instance ModelForm induk, 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
\n\n
\n
\nModelAdmin.get_autocomplete_fields(request)Link to this definition#
\n

Metode get_autocomplete_fields() memberikan HttpRequest dan diharapkan mengembalikan sebuah list atau tuple dari nama bidang yang akan ditampilkan dengan sebuah widget pelengkapan otomatis seperti digambarkan diatas dalam bagian ModelAdmin.autocomplete_fields.

\n
\n\n
\n
\nModelAdmin.get_readonly_fields(request, obj=None)Link to this definition#
\n

Metode get_readonly_fields memberikan HttpRequest dan obj sedang disunting atau None pada sebuah formulir tambah) dan diharapkan mengembalikan sebuah list (atau tuple dari nama-nama bidang yang akan diperlihatkan sebagai hanya-baca, seperti digambarkan diatas di bagian ModelAdmin.readonly_fields.

\n
\n\n
\n
\nModelAdmin.get_prepopulated_fields(request, obj=None)Link to this definition#
\n

Metode get_prepopulated_fields memberikan HttpRequest dan obj sedang disunting (atau None pada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuah dictionary, seperti digambarkan diatas di bagian ModelAdmin.prepopulated_fields.

\n
\n\n
\n
\nModelAdmin.get_list_display(request)Link to this definition#
\n

Metode get_list_display memberikan HttpRequest dan diharapkan mengembalikan sebuah list atau tuple dari nama-nama bidang yang akan diperlihatkan pada tampilan daftar rubah seperti digambarkan diatas di bagian ModelAdmin.list_display.

\n
\n\n
\n
\nModelAdmin.get_list_display_links(request, list_display)Link to this definition#
\n

Metode get_list_display_links memberikan HttpRequest dan list atau tuple dikembalikan oleh ModelAdmin.get_list_display(). Itu diharapkan mengembalikan antara None atau sebuah list atau tuple dari nama-nama bidang pada daftar rubah yang akan ditautkan ke tampilan rubah, seperti digambarkan di bagian ModelAdmin.list_display_links.

\n
\n\n
\n
\nModelAdmin.get_exclude(request, obj=None)Link to this definition#
\n

Metode get_exclude memberikan HttpRequest dan obj sedang disunting (atau None pada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuah daftar dari bidang-bidang, seperti digambarkan diatas di bagian ModelAdmin.exclude.

\n
\n\n
\n
\nModelAdmin.get_fields(request, obj=None)Link to this definition#
\n

Metode get_fields memberikan HttpRequest dan obj sedang disunting (atau None pada sebuah formulir tambah) dan diharapkan untuk mengembalikan sebuah daftar dari bidang-bidang, seperti digambarkan diatas di bagian ModelAdmin.fields.

\n
\n\n
\n
\nModelAdmin.get_fieldsets(request, obj=None)Link to this definition#
\n

Metode get_fieldsets memberikan HttpRequest dan obj sedang disunting atau None pada 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 bagian ModelAdmin.fieldsets.

\n
\n\n
\n
\nModelAdmin.get_list_filter(request)Link to this definition#
\n

Metode get_list_filter memberikan HttpRequest dan diharapkan mengembalikan jenis yang sama dari urutan jenis seperti untuk atribut list_filter.

\n
\n\n
\n
\nModelAdmin.get_list_select_related(request)Link to this definition#
\n

Metode get_list_select_related memberikan HttpRequest dan harus mengembalikan sebuah boolean atau daftar seperti ModelAdmin.list_select_related lakukan.

\n
\n\n
\n
\nModelAdmin.get_search_fields(request)Link to this definition#
\n

Metode get_search_fields memberikan HttpRequest dan diharapkan mengembalikan jenis yang sama dari urutan jenis seperti untuk atribut search_fields.

\n
\n\n
\n
\nModelAdmin.get_sortable_by(request)Link to this definition#
\n

Metode get_sortable_by() melewatkan HttpRequest dan dan diharapapkan mengembalikan kumpulan (misalnya list, tuple, atau set) dari nama-nama bidang yang akan diurutkan dalam halaman daftar rubah.

\n

Penerapan awalnya mengambalikan sortable_by jika disetel, sebaliknya itu menunda ke get_list_display().

\n

Sebagai contoh, untuk mencegah satu atau lebih kolom dari menjadi dapat diurutkan:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n\n    def get_sortable_by(self, request):\n        return {*self.get_list_display(request)} - {'rank'}\n
\n
\n\n
\n
\nModelAdmin.get_inline_instances(request, obj=None)Link to this definition#
\n

Metode get_inline_instances memberikan HttpRequest dan obj sedang dirubah (atau None pada formulir tambah) dan diharapkan mengembalikan sebuah list atau tuple dari obyek InlineModelAdmin, seperti digambarkan dibawah dalam bagian InlineModelAdmin. Sebagai contoh, berikut akan mengembalikan dibarisan tanpa penyaringan awalan berdasarkan pada perizinan tambah, rubah, hapus, dan menampilkan:

\n
Code
class 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]\n
\n

Jika anda mengutamakan metode ini, pastikan bahwa berderet dikembalikan adalah instance dari kelas-kelas ditentukan di inlines atau anda mungkin menghadapi kesalahan "Bad Request" ketika menambahkan obyek-obyek terkait.

\n
\n\n
\n
\nModelAdmin.get_inlines(request, obj)Link to this definition#
\n

The get_inlines method is given the HttpRequest and the\nobj being edited (or None on an add form) and is expected to return\nan iterable of inlines. You can override this method to dynamically add\ninlines based on the request or model instance instead of specifying them\nin ModelAdmin.inlines.

\n
\n\n
\n
\nModelAdmin.get_urls()Link to this definition#
\n

Metode get_urls pada sebuah ModelAdmin mengembalikan URL untuk digunakan untuk ModelAdmin itu di cara yang sama seperti sebuah URLconf. Karena itu anda dapat memperpanjang mereka seperti didokumentasikan di Pengirim URL:

\n
Code
from django.contrib import admin\nfrom django.template.response import TemplateResponse\nfrom django.urls import path\n\nclass MyModelAdmin(admin.ModelAdmin):\n    def get_urls(self):\n        urls = super().get_urls()\n        my_urls = [\n            path('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)\n
\n

Jika anda ingin menggunakan tata letak admin, perpanjang dari admin/base_site.html:

\n
Django template
{% extends "admin/base_site.html" %}\n{% block content %}\n...\n{% endblock %}\n
\n\n

Bagaimanapun, fungsi self.my_view terdaftar diatas menderita dari dua masalah:

\n
    \n

  • Itu tidak akan melakukan pemeriksaan perizinan apapun, jadi itu akan dapat diakses unutk masyarakat umum.

    • \n

  • Itu 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
\n

Sejak ini biasanya bukan apa anda inginkan, Django menyediakan pembungkus kenyamanan untuk memeriksa perizinan dan menandai tampilan sebagai bukan-cacheable. pembungkus ini adalah AdminSite.admin_view() (i.e. self.admin_site.admin_view didalam sebuah instance ModelAdmin); gunakan itu seperti begitu:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_urls(self):\n        urls = super().get_urls()\n        my_urls = [\n            path('my_view/', self.admin_site.admin_view(self.my_view))\n        ]\n        return my_urls + urls\n
\n

Perhatikan tampilan dibungkus di baris kelima diatas:

\n
Code
path('my_view/', self.admin_site.admin_view(self.my_view))\n
\n

Pembungkus ini akan melindungi self.my_view dari akses tidak terotorisasi dan akan memberlakukan penghias django.views.decorators.cache.never_cache() untuk memastikan itu tidak disimpan sementara jika middleware cache aktif.

\n

Jika halaman adalah cacheable, tetapi anda masih ingin pemeriksaan perizinan dilakukan, anda dapat melewatkan sebuah argumen cacheable=True pada AdminSite.admin_view():

\n
Code
path('my_view/', self.admin_site.admin_view(self.my_view, cacheable=True))\n
\n

Tampilan ModelAdmin mempunyai atribut model_admin. Selain tampilan AdminSite mempunyai atribut admin_site.

\n
\n\n
\n
\nModelAdmin.get_form(request, obj=None, **kwargs)Link to this definition#
\n

Mengembalikan sebuah kelas ModelForm untuk digunakan di tampilan tambah dan rubah admin, lihat add_view() dan change_view().

\n

Penerapan dasar menggunakan modelform_factory() pada subkelas form, dirubah oleh atribut seperti fields dan exclude. Jadi, sebagai contoh, jika anda ingin menawarkan tambahan bidang-bidang le superuser, anda dapat menukar formulir dasar berbeda seperi begitu:

\n
Code
class 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().get_form(request, obj, **kwargs)\n
\n

Anda mungkin juga mengembalikan kelas ModelForm penyesuaian langsung.

\n
\n\n
\n
\nModelAdmin.get_formsets_with_inlines(request, obj=None)Link to this definition#
\n

Menghasilkan (FormSet, InlineModelAdmin) pasangan untuk digunakan di tampilan tambah dan rubah admin.

\n

Sebagai contoh jika anda ingin memperlihatkan hanya berderet tertentu di tampilan rubah, anda dapat menimpa get_formsets_with_inlines sebagai berikut:

\n
Code
class 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 not isinstance(inline, MyInline) or obj is not None:\n                yield inline.get_formset(request, obj), inline\n
\n
\n\n
\n
\nModelAdmin.formfield_for_foreignkey(db_field, request, **kwargs)Link to this definition#
\n

Metode formfield_for_foreignkey pada sebuah ModelAdmin mengizinkan anda menimpa formfield awalan untuk bidang foreign key. Sebagai contoh, untuk mengembalikan bagian dari obyek-obyek untuk bidang foreign key ini berdasarkan pada pengguna:

\n
Code
class 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().formfield_for_foreignkey(db_field, request, **kwargs)\n
\n

Penggunaan ini instance HttpRequest untuk menyaring bidang foreign key Car ke hanya meperlihatkan mobil dimiliki oleh instance User.

\n

For more complex filters, you can use ModelForm.__init__() method to\nfilter based on an instance of your model (see\nBidang-bidang yang menangani hubungan). For example:

\n
Code
class CountryAdminForm(forms.ModelForm):\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.fields['capital'].queryset = self.instance.cities.all()\n\nclass CountryAdmin(admin.ModelAdmin):\n    form = CountryAdminForm\n
\n
\n\n
\n
\nModelAdmin.formfield_for_manytomany(db_field, request, **kwargs)Link to this definition#
\n

Seperti metode formfield_for_foreignkey, metode formfield_for_manytomany dapat 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 key Car pada hanya memperlihatkan pemilik mobil berdasarkan User:

\n
Code
class 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().formfield_for_manytomany(db_field, request, **kwargs)\n
\n
\n\n
\n
\nModelAdmin.formfield_for_choice_field(db_field, request, **kwargs)Link to this definition#
\n

Seperti metode formfield_for_foreignkey dan formfield_for_manytomany, metode formfield_for_choice_field dapat 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
Code
class 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().formfield_for_choice_field(db_field, request, **kwargs)\n
\n\n
\n\n
\n
\nModelAdmin.get_changelist(request, **kwargs)Link to this definition#
\n

Mengembalikan kelas Changelist untuk digunakan untuk pendaftaran. Secara awalan, django.contrib.admin.views.main.ChangeList digunakan. Dengan mewarisi kelas ini anda dapat merubah perilaku dari pendaftaran.

\n
\n\n
\n
\nModelAdmin.get_changelist_form(request, **kwargs)Link to this definition#
\n

Mengembalikan sebuah kelas ModelForm untuk digunakan di Formset pada halaman daftar rubah. Untuk menggunakan formulir penyesuaian, sebagai contoh:

\n
Code
from 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\n
\n\n
\n
\nModelAdmin.get_changelist_formset(request, **kwargs)Link to this definition#
\n

Mengembalikan sebuah kelas ModelFormSet untuk digunakan pada halaman daftar rubah jika list_editable digunakan. Untuk menggunakan formset penyesuaian, sebagai contoh:

\n
Code
from 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().get_changelist_formset(request, **kwargs)\n
\n
\n\n
\n
\nModelAdmin.lookup_allowed(lookup, value)Link to this definition#
\n

Obyek-obyek dalam halaman daftar rubah dapat disaring dengan pencarian dari string permintaan URL. Ini adalah bagaimana list_filter bekerja, sebagai contoh. Pencarian mirip pada apa yang digunakan dalam QuerySet.filter() (misalnya user__email=user@example.com). Sejak pencarian dalam string permintaan dapat diubah oleh pengguna, mereka harus dibersihkan untuk mencegah pembukaan data tidak berhak.

\n

Metode lookup_allowed() memberikan jalur pencarian dari string permintaan (misalnya 'user__email') dan nilai terkait (misalnya 'user@example.com'), dan mengembalikan boolean menunjukkan apakah penyaringan QuerySet daftar rubah menggunakan parameter diizinkan. Jika lookup_allowed() mengembalikan False, DisallowedModelAdminLookup (subkelas dari SuspiciousOperation) dimunculkan.

\n

Secara awalan, lookup_allowed() mengizinkan akses pada bidang lokal model, jalur-jalur bidang digunakan dalam list_filter (tetapi bukan jalur dari get_list_filter()), dan pencarian dibutuhkan untuk limit_choices_to pada fungsi dengan benar dalam raw_id_fields.

\n

Menimpa metode ini untuk menyesuaikan pencarian diizinkan untuk subkelas ModelAdmin anda.

\n
\n\n
\n
\nModelAdmin.has_view_permission(request, obj=None)Link to this definition#
\n

Harus mengembalikan True jika menampilkan obj diizinkan, False sebaliknya. Jika obj adalah None, harus mengembalikan True atau False untuk menunjukkan apakah menampilkan obyek dari jenis ini diizinkan secara umum (misalnya, False akan diterjemahkan sebagai artian bahwa pengguna saat ini tidak diizinkan menampilkan obyek apapun dai jenis ini).

\n

Penerapan awalan mengembalikan True jika pengguna mempunyai baik perizinan "change" atau "view".

\n
\n\n
\n
\nModelAdmin.has_add_permission(request)Link to this definition#
\n

Harus mengembalikan True jika menambahkan sebuah obyek diizinkan, False sebaliknya.

\n
\n\n
\n
\nModelAdmin.has_change_permission(request, obj=None)Link to this definition#
\n

Harus mengembalikan True jika penyuntingan obj diizinkan, False sebaliknya. Jika obj adalah None, harus mengembalikan True atau False untuk menunjukkan apakah penyuntingan dari obyek jenis ini diizinkan secara umum (misalnya, False akan diterjemahkan sesuai artian bahwa pengguna saat ini tidak diizinkan untuk menyunting obyek apapun dari jenis ini).

\n
\n\n
\n
\nModelAdmin.has_delete_permission(request, obj=None)Link to this definition#
\n

Harus mengembalikan True jika penghapusan obj diizinkan, False sebaliknya. Jika obj adalah None, harus mengembalikan True atau False untuk menunjukkan apakah penghapusan obyek jenis ini diizinkan secara umum (misalnya, False jika diterjemahkan sesuai artian bahwa pengguna saat ini tidak diizinkan menghapus obyek apapun dari jenis ini).

\n
\n\n
\n
\nModelAdmin.has_module_permission(request)Link to this definition#
\n

Harus mengembalikan True jika menampilkan modul pada halaman index admin dan mengakses halaman index admin diizinkan, False sebaliknya. Menggunakan User.has_module_perms() secara awalan. menimpa itu tidak membatasi akses pada tampilan melihat, tambah, rubah, atau hapus, has_view_permission(), has_add_permission(), has_change_permission(), dan has_delete_permission() harus digunakan untuk itu.

\n
\n\n
\n
\nModelAdmin.get_queryset(request)Link to this definition#
\n

Metode get_queryset pada sebuah ModelAdmin mengembalikan sebuah QuerySet dari semua instance model yang dapat disunting oleh situs admin. Satu kasus penggunaan dari mengutamakan metode ini adalah menunjukkan obyek-obyek dimiliki oleh pengguna masuk:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_queryset(self, request):\n        qs = super().get_queryset(request)\n        if request.user.is_superuser:\n            return qs\n        return qs.filter(author=request.user)\n
\n
\n\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 django.contrib.messages. Lihat custom ModelAdmin example.

\n

Argumen kata kunci mengizinkan anda merubah tingkatan pesan, menambah tambahan etiket CSS, atau gagal secara diam jika kerangka kerja contrib.messages tidak dipasang. Argumen kata kunci ini cocok dengan untuk django.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
\n\n
\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 paginator.

\n
\n\n
\n
\nModelAdmin.response_add(request, obj, post_url_continue=None)Link to this definition#
\n

Menentukan tahap the HttpResponse for the add_view().

\n

response_add dipanggil 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
\n\n
\n
\nModelAdmin.response_change(request, obj)Link to this definition#
\n

Menentukan tahap HttpResponse for the change_view().

\n

response_change dipanggil 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
\n\n
\n
\nModelAdmin.response_delete(request, obj_display, obj_id)Link to this definition#
\n

Menentukan HttpResponse untuk tahap delete_view().

\n

response_delete dipanggil setelah obyek telah dihapus. Anda dapat menimpa ini untuk merubah kebiasaan awal setelah obyek telah dihapus.

\n

obj_display adalah sebuah string dengan nama dari obyek terhapus.

\n

obj_id adalah penciri serial digunakan untuk mengambil obyek untuk dihapus.

\n
\n\n
\n
\nModelAdmin.get_formset_kwargs(request, obj, inline, prefix)Link to this definition#
\n
\n

A hook for customizing the keyword arguments passed to the constructor of a\nformset. For example, to pass request to formset forms:

\n
Code
class MyModelAdmin(admin.ModelAdmin):\n    def get_formset_kwargs(self, request, obj, inline, prefix):\n        return {\n            **super().get_formset_kwargs(request, obj, inline, prefix),\n            'form_kwargs': {'request': request},\n        }\n
\n

You can also use it to set initial for formset forms.

\n
\n\n
\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 GET. Sebagai contoh, ?name=initial_value akan menyetel nilai inisial bidang name menjadi initial_value.

\n

Metode ini harus mengembalikan sebuah kamus di formulir {'fieldname': 'fieldval'}:

\n
Code
def get_changeform_initial_data(self, request):\n    return {'name': 'custom_initial_value'}\n
\n
\n\n
\n
\nModelAdmin.get_deleted_objects(objs, request)Link to this definition#
\n

Sebuah kaitan untuk menyesuaikan pengeolahan penghapusan dari delete_view() dan "delete selected" action.

\n

Argumen objs adalah perulangan sama dari obyek (QuerySet atau list dari instance model) untuk dihapus, dan request adalah HttpRequest.

\n

Metode ini harus mengembalikan 4-tuple dari (deleted_objects, model_count, perms_needed, protected).

\n

deleted_objects list dari strings mewakili semua obyek yang akan dihapus. Jika ada obyek terkait untuk dihapus, list adalah bersarang dan menyertakan obyek terkait tersebut. List dibentuk dalam cetakan menggunakan penyaring unordered_list.

\n

model_count adalah sebuah pemetaan dictionary setiap verbose_name_plural model ke sejumalh obyek yang akan dihapus.

\n

perms_needed adalah kumpulan dari verbose_name dari model yang pengguna tidak mempunyai perizinan untuk hapus.

\n

protected adalah daftar dari string mewakili semua obyek-obyek terkait terlindungi yang tidak dapat dihapus. Daftar ditampilkan dalam cetakan.

\n
\n\n
\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\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\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\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\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
\n\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.

\n

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:

\n
Code
class 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().change_view(\n            request, object_id, form_url, extra_context=extra_context,\n        )\n
\n

Tampilan ini mengembalikan instance TemplateResponse yang mengizinkan anda dengan mudah menyesuaikan data tanggapan sebelum membangun. Untuk rincian lebih, lihat TemplateResponse documentation.

\n
\n
\n
\n

Pengertian aset ModelAdminLink to this heading#

\n

Ada 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:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    class Media:\n        css = {\n            "all": ("my_styles.css",)\n        }\n        js = ("my_code.js",)\n
\n

staticfiles 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.

\n
\n

jQueryLink to this heading#

\n

JavaScript admin Django memanfaatkan pustaka jQuery

\n

To avoid conflicts with user-supplied scripts or libraries, Django's jQuery\n(version 3.6.0) is namespaced as django.jQuery. If you want to use jQuery\nin your own admin JavaScript without including a second copy, you can use the\ndjango.jQuery object on changelist and add/edit views. Also, your own admin\nforms or widgets depending on django.jQuery must specify\njs=['admin/js/jquery.init.js', …] when declaring form media assets.

\n\n

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.

\n

Django menyediakan kedua versi tidak dipadatkan dan 'dikecilkan' dari jQuery, sebagai masing-masing jquery.js dan jquery.min.js.

\n

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'.

\n
\n
\n
\n

Menambahkan pengesahan penyesuaian pada adminLink to this heading#

\n

You can also add custom validation of data in the admin. The automatic admin\ninterface reuses django.forms, and the ModelAdmin class gives you\nthe ability to define your own form:

\n
Code
class ArticleAdmin(admin.ModelAdmin):\n    form = MyArticleAdminForm\n
\n

MyArticleAdminForm dapat ditentukan dimanapun selama anda mengimpor ketika diperlukan. Sekarang dalam formulir anda anda dapat menambah penyesuaian pengesahan milik anda sendiri untuk bidang apapun:

\n
Code
class MyArticleAdminForm(forms.ModelForm):\n    def clean_name(self):\n        # do something that validates your data\n        return self.cleaned_data["name"]\n
\n

Itu 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.

\n
\n
\n
\n

Obyek InlineModelAdminLink to this heading#

\n
\n
\nclass InlineModelAdminLink to this definition#
\n
\n\n
\n
\nclass TabularInlineLink to this definition#
\n
\n\n
\n
\nclass StackedInlineLink to this definition#
\n

Antarmuka admin mempunyai kemampuan menyunting model-model pada halaman sama sebagai model induk. Ini adalah dipanggil berderet. Andaikan anda mempunyai kedua model ini:

\n
Code
from django.db import models\n\nclass Author(models.Model):\n   name = models.CharField(max_length=100)\n\nclass Book(models.Model):\n   author = models.ForeignKey(Author, on_delete=models.CASCADE)\n   title = models.CharField(max_length=100)\n
\n

Anda dapat menyunting buku-buku ditulis oleh seorang penulis pada halaman penulis. Anda tambah berderet pada sebuah model dengan menentukan mereka di sebuah ModelAdmin.inlines:

\n
Code
from django.contrib import admin\n\nclass BookInline(admin.TabularInline):\n    model = Book\n\nclass AuthorAdmin(admin.ModelAdmin):\n    inlines = [\n        BookInline,\n    ]\n
\n

Django menyediakan dua subkelas dari InlineModelAdmin dan mereka adalah:

\n\n

Perbedaan diantara kedua ini adalah hanya cetakan digunakan untuk membangun mereka.

\n
\n\n
\n

Pilihan InlineModelAdminLink to this heading#

\n

InlineModelAdmin berbagi banyak dari fitur-fitur sama seperti ModelAdmin, dan menambahkan beberapa dari miliknya (fitur-fitur dibagi sebenarnya ditentukan di superkelas BaseModelAdmin). Fitur-fitur dibagi adalah:

\n\n

Kelas InlineModelAdmin menambah atau menyesuaikan:

\n
\n
\nInlineModelAdmin.modelLink to this definition#
\n

Model yang di berderet sedang menggunakan. Ini adalah diwajibkan.

\n
\n\n
\n
\nInlineModelAdmin.fk_nameLink to this definition#
\n

Nama dari foreign key pada model. Di kebanyakan kasus ini akan ditangani dengan otomatis, tetapi fk_name harus ditentukan secara jelas jika ada lebih dari satu foreign key pada model induk yang sama.

\n
\n\n
\n
\nInlineModelAdmin.formsetLink to this definition#
\n

Ini awalan pada BaseInlineFormSet. Menggunakan formset anda sendiri dapat memberikan anda banyak kemungkinan dari penyesuaian. Berderet adalah dibangun sekitar model formsets.

\n
\n\n
\n
\nInlineModelAdmin.formLink to this definition#
\n

NIlai untuk awalan form pada ModelForm. Ini adalah apa yang dilewatkan melalui inlineformset_factory() ketika membuat formset untuk berderet ini.

\n
\n\n\n
\n
\nInlineModelAdmin.classesLink to this definition#
\n

Sebuah daftar atau tuple mengandung kelas-kelas CSS tambahan pada fieldset yang dibangun untuk berderet. Awalan pada None. Ketika dengan kelas-kelas dikonfigurasikan di fieldsets, berderet dengan sebuah kelas collapse akan diinisialisasikan diruntuhkan dan kepala mereka akan mempunyai tautan "show" kecil.

\n
\n\n
\n
\nInlineModelAdmin.extraLink to this definition#
\n

This controls the number of extra forms the formset will display in\naddition to the initial forms. Defaults to 3. See the\nformsets documentation for more\ninformation.

\n

Untuk pengguna dengan peramban diadakan-JavaScript, sebuah tautan "Add another" disediakan untuk mengadakan nomor apapun dari berderet tambahan untuk ditambahkan ke itu yang disediakan sebagai sebuah hasil dari argumen extra.

\n

Tautan dinamis tidak akan muncul jika sejumlah dari formulir diperlihatkan saat ini melebihi max_num, atau jika pengguna tidak mempunyai JavaScript diadakan.

\n

InlineModelAdmin.get_extra() juga mengizinkan anda menyesuaikan sejumlah formulir tambahan.

\n
\n\n
\n
\nInlineModelAdmin.max_numLink to this definition#
\n

Ini mengendalikan jumlah minimal dari formulir untuk menunjukkan di berderet. Ini tidak secara langsung menghubungankan ke sejumlah dari obyek, tetapi dapat jika nilai cukup kecil. Lihat Membatasi angka dari obyek dapat di sunting untuk informasi lebih.

\n

InlineModelAdmin.get_max_num() juga mengizinkan anda menyesuaikan nomor maksimal dari formulir tambahan.

\n
\n\n
\n
\nInlineModelAdmin.min_numLink to this definition#
\n

Ini mengendalikan jumlah minimal dari formulir untuk menunjukkan dalam deretan. Lihat modelformset_factory() untuk informasi lebih.

\n

InlineModelAdmin.get_min_num() juga mengizinkan anda menyesuaikan nomor minimal dari formulir ditampilkan.

\n
\n\n
\n
\nInlineModelAdmin.raw_id_fieldsLink to this definition#
\n

Secara awalan, admin Django menggunakan antarmuka kotak-pilih (<select>) untuk bidang-bidang adalah ForeignKey. Terkadang anda tidak ingin mendatangkan atas dari memiliki untuk memilih semua instance terkait untuk memperlihatkan di drop-down.

\n

raw_id_fields adalah sebuah daftar dari bidang anda ingin rubah menjadi widget input untuk antara sebuah ForeignKey atau ManyToManyField:

\n
Code
class BookInline(admin.TabularInline):\n    model = Book\n    raw_id_fields = ("pages",)\n
\n
\n\n
\n
\nInlineModelAdmin.templateLink to this definition#
\n

Cetakan digunakan untuk membangun berderet pada halaman.

\n
\n\n
\n
\nInlineModelAdmin.verbose_nameLink to this definition#
\n

An override to the verbose_name from the\nmodel's inner Meta class.

\n
\n\n
\n
\nInlineModelAdmin.verbose_name_pluralLink to this definition#
\n

An override to the verbose_name_plural\nfrom the model's inner Meta class. If this isn't given and the\nInlineModelAdmin.verbose_name is defined, Django will use\nInlineModelAdmin.verbose_name + 's'.

\n\n
\n\n
\n
\nInlineModelAdmin.can_deleteLink to this definition#
\n

Menentukan apakah atau tidak obyek berderet dapat dihapus di berderet. Awalan menjadi True.

\n
\n\n
\n
\nInlineModelAdmin.show_change_linkLink to this definition#
\n

Menentukan apakah atau tidak obyek berderet dapat dirubah di admin mempunyai sebuah tautan ke formulir rubah. Awalan menjadi False.

\n
\n\n
\n
\nInlineModelAdmin.get_formset(request, obj=None, **kwargs)Link to this definition#
\n

Returns a BaseInlineFormSet class for use in\nadmin add/change views. obj is the parent object being edited or\nNone when adding a new parent. See the example for\nModelAdmin.get_formsets_with_inlines.

\n
\n\n
\n
\nInlineModelAdmin.get_extra(request, obj=None, **kwargs)Link to this definition#
\n

Mengembalikan sejumlah formulir berderet tambahan untuk digunakan. Secara awalan, mengembalikan atribut InlineModelAdmin.extra

\n

Timpa metode ini untuk secara program menentukan jumlah dari formulir berderet tambahan. Sebagai contoh, ini mungkin berdasarkan pada instance model (dilewatkan sebagai argumen kata kunci obj):

\n
Code
class BinaryTreeAdmin(admin.TabularInline):\n    model = BinaryTree\n\n    def get_extra(self, request, obj=None, **kwargs):\n        extra = 2\n        if obj:\n            return extra - obj.binarytree_set.count()\n        return extra\n
\n
\n\n
\n
\nInlineModelAdmin.get_max_num(request, obj=None, **kwargs)Link to this definition#
\n

Mengembalikan jumlah maksimal dari formulir berderet tambahan untuk digunakan. Secara awalan, mengembalikan atribut InlineModelAdmin.max_num.

\n

Timpa metode ini untuk secara program menentukan jumlah maksimal dari formulir berderet tambahan. Sebagai contoh, ini mungkin berdasarkan pada instance model (dilewatkan sebagai argumen kata kunci obj):

\n
Code
class BinaryTreeAdmin(admin.TabularInline):\n    model = BinaryTree\n\n    def get_max_num(self, request, obj=None, **kwargs):\n        max_num = 10\n        if obj and obj.parent:\n            return max_num - 5\n        return max_num\n
\n
\n\n
\n
\nInlineModelAdmin.get_min_num(request, obj=None, **kwargs)Link to this definition#
\n

Mengembalikan jumlah minimal dari formulir berderet untuk digunakan. Secara awalan, mengembalikan atribut InlineModelAdmin.min_num.

\n

Timpa metode ini untuk secara program menentukan jumlah minimal dari formulir berderet tambahan. Sebagai contoh, ini mungkin berdasarkan pada instance model (dilewatkan sebagai argumen kata kunci obj):

\n
\n\n
\n
\nInlineModelAdmin.has_add_permission(request, obj)Link to this definition#
\n

Harus mengembalikan True jika menambahkan obyek dalam barisan diizinkan, False sebaliknya. obj adalah obyek induk sedang disunting atau None ketika menambahkan induk baru.

\n
\n\n
\n
\nInlineModelAdmin.has_change_permission(request, obj=None)Link to this definition#
\n

Harus mengembalikan True jika menyunting obyek dalam barisan diizinkan, False sebaliknya. obj adalah obyek induk sedang disunting.

\n
\n\n
\n
\nInlineModelAdmin.has_delete_permission(request, obj=None)Link to this definition#
\n

Harus mengembalikan True jika menghapus obyek dalam barisan diizinkan, False sebaliknya. obj adalah obyek induk sedang disunting.

\n
\n\n\n
\n
\n

Bekerja dengan sebuah model dengan dua atau lebih foreign key pada model induk yang sama.Link to this heading#

\n

Itu terkadang memungkinkan memiliki lebih dari satu foreign key pada model yang sama. Ambil model ini sebagai contoh:

\n
Code
from django.db import models\n\nclass Friendship(models.Model):\n    to_person = models.ForeignKey(Person, on_delete=models.CASCADE, related_name="friends")\n    from_person = models.ForeignKey(Person, on_delete=models.CASCADE, related_name="from_friends")\n
\n

Jika anda ingin memperlihatkan sebuah berderet pada halaman tambah/rubah admin Person anda butuh secara jelas menentukan foreign key sejak itu tidak dapat melakukannya otomatis:

\n
Code
from django.contrib import admin\nfrom myapp.models import Friendship\n\nclass FriendshipInline(admin.TabularInline):\n    model = Friendship\n    fk_name = "to_person"\n\nclass PersonAdmin(admin.ModelAdmin):\n    inlines = [\n        FriendshipInline,\n    ]\n
\n
\n
\n

Bekerja dengan model banyak-ke-banyakLink to this heading#

\n

By default, admin widgets for many-to-many relations will be displayed\non whichever model contains the actual reference to the\nManyToManyField. Depending on your ModelAdmin\ndefinition, each many-to-many field in your model will be represented by a\nstandard HTML <select multiple>, a horizontal or vertical filter, or a\nraw_id_fields widget. However, it is also possible to replace these\nwidgets with inlines.

\n

Misalkan kita memiliki model berikut:

\n
Code
from django.db import models\n\nclass Person(models.Model):\n    name = models.CharField(max_length=128)\n\nclass Group(models.Model):\n    name = models.CharField(max_length=128)\n    members = models.ManyToManyField(Person, related_name='groups')\n
\n

Jika anda ingin memperlihatkan hubungan many-yo-many menggunakan sebuah berderet, anda dapat melakukan juga dengan menentukan sebuah obyek InlineModelAdmin untuk hubungan:

\n
Code
from django.contrib import admin\n\nclass MembershipInline(admin.TabularInline):\n    model = Group.members.through\n\nclass PersonAdmin(admin.ModelAdmin):\n    inlines = [\n        MembershipInline,\n    ]\n\nclass GroupAdmin(admin.ModelAdmin):\n    inlines = [\n        MembershipInline,\n    ]\n    exclude = ('members',)\n
\n

Ada dua fitur perlu dicatat di contoh ini.

\n

Pertama-tama - kelas MembershipInline mengacu Group.members.through. Atribut through adalah sebuah acuan pada model yang mengelola hubungan many-to-many. Model ini secara otomatis dibuat oleh Django ketika anda menentukan bidang many-to-many.

\n

Kedua, GroupAdmin harus secara manual mengeluarkan bidang members. Django menampilkan sebuah widget admin untuk bidang many-to-many pada model yang menentukan hubungan (di kasus ini, Group). Jika anda ingin menggunakan sebuah model berderet untuk mewakili hubungan many-to-many, anda harus memberitahu admin Django tidak memperlihatkan widget ini - sebaliknya anda akan berakhir dengan dua widget pada halaman admin anda untuk mengelola hubungan.

\n

Catat bahwa ketika menggunakan teknik ini sinyal m2m_changed tidak dipicu. Ini adalah karena sejauh admin yang bersangkutan, through hanya sebuah model dengan dua bidang foreign key daripada hubungan many-to-many.

\n

Dalam semua hal lainnya, InlineModelAdmin persisnya sama seperti lainnya. Anda dapat menyesuaikan penampilan menggunakan apapun dari sifat-sifat ModelAdmin biasa.

\n
\n
\n

Bekerja dengan model perantara many-to-manyLink to this heading#

\n

Ketika anda menentukan sebuah model perantara menggunakan argumen through pada sebuah ManyToManyField, admin tidak akan menampilkan sebuah widget secara awalan. Ini karena setiap instance dari model perantara membutuhkan lebih informasi dari dapat diperlihatkan dalam sebuah widget tunggal, dan tata letak dibutuhkan untuk widget banyak akan beragam bergantung pada model perantara.

\n

However, we still want to be able to edit that information inline. Fortunately,\nwe can do this with inline admin models. Suppose we have the following models:

\n
Code
from django.db import models\n\nclass Person(models.Model):\n    name = models.CharField(max_length=128)\n\nclass Group(models.Model):\n    name = models.CharField(max_length=128)\n    members = models.ManyToManyField(Person, through='Membership')\n\nclass Membership(models.Model):\n    person = models.ForeignKey(Person, on_delete=models.CASCADE)\n    group = models.ForeignKey(Group, on_delete=models.CASCADE)\n    date_joined = models.DateField()\n    invite_reason = models.CharField(max_length=64)\n
\n

Langkah pertama dalam memperlihatkan model perantara ini di admin adalah menentukan sebuah kelas berderet untuk model Membership:

\n
Code
class MembershipInline(admin.TabularInline):\n    model = Membership\n    extra = 1\n
\n

This example uses the default InlineModelAdmin values for the\nMembership model, and limits the extra add forms to one. This could be\ncustomized using any of the options available to InlineModelAdmin classes.

\n

Sekarang membuat tampilan admin untuk model Person dan Group:

\n
Code
class PersonAdmin(admin.ModelAdmin):\n    inlines = (MembershipInline,)\n\nclass GroupAdmin(admin.ModelAdmin):\n    inlines = (MembershipInline,)\n
\n

Akhirnya, daftar model Person dan Group dengan situs admin:

\n
Code
admin.site.register(Person, PersonAdmin)\nadmin.site.register(Group, GroupAdmin)\n
\n

Sekarang situs admin anda dipersiapkan untuk menyunting obyek-obyek Membership berderet dari antara Person atau Group di halaman rincian.

\n
\n
\n

Menggunakan hubungan umum sebagai sebuah berderetLink to this heading#

\n

Itu memungkinkan menggunakan sebuah berderet dengan umum obyek terkait. Mari kita katakan anda memiliki model-model berikut:

\n
Code
from django.contrib.contenttypes.fields import GenericForeignKey\nfrom django.db import models\n\nclass Image(models.Model):\n    image = models.ImageField(upload_to="images")\n    content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE)\n    object_id = models.PositiveIntegerField()\n    content_object = GenericForeignKey("content_type", "object_id")\n\nclass Product(models.Model):\n    name = models.CharField(max_length=100)\n
\n

Jika anda ingin menyunting dan membuat sebuah instance Image pada Product, tampilan tambah/rubah anda dapat menggunakan GenericTabularInline atau GenericStackedInline (kedua subkelas-subkelas dari GenericInlineModelAdmin) disediakan oleh admin. Mereka menerapkan tata letak penampakan datar dan bertumpuk untuk formulir mewakili obyek berderet, masing-masing, seperti pasangan bukan-umum mereka. Mereka berperilaku seperti berderet lainnya. Di admin.py anda untuk contoh aplikasi ini:

\n
Code
from django.contrib import admin\nfrom django.contrib.contenttypes.admin import GenericTabularInline\n\nfrom myapp.models import Image, Product\n\nclass ImageInline(GenericTabularInline):\n    model = Image\n\nclass ProductAdmin(admin.ModelAdmin):\n    inlines = [\n        ImageInline,\n    ]\n\nadmin.site.register(Product, ProductAdmin)\n
\n

Lihat contenttypes documentation untuk informasi lebih spesifik.

\n
\n
\n
\n

Menimpa cetakan adminLink to this heading#

\n

You can override many of the templates which the admin module uses to generate\nthe various pages of an admin site. You can even override a few of these\ntemplates for a specific app, or a specific model.

\n
\n

Setel direktori cetakan admin proyekLink to this heading#

\n

Berkas-berkas cetakan admin ditempatkan di direktori contrib/admin/templates/admin.

\n

Untuk menimpa satu atau lebih mereka, pertama buat sebuah direktori admin dalam direktori templates proyek anda. Ini dapat berupa apapun dari direktori anda tentukan dalam pilihan DIRS dari backend DjangoTemplates dalam pengaturan TEMPLATES. Jika anda telah menyesuaikan pilihan 'loaders', pastikan 'django.template.loaders.filesystem.Loader' muncul sebelum 'django.template.loaders.app_directories.Loader' sehingga cetakan penyesuaian anda akan ditemukan oleh sistem pemuat cetakan sebelum mereka yang disertakan dengan django.contrib.admin.

\n

Dalam direktori admin ini, buat sub-direktori diberi nama setelah aplikasi anda. Dalam subdirektori aplikasi ini buat sub-direktori dinamai setelah model anda. Catat, bahwa aplikasi admin akan menghuruf kecilkan nama model ketika mencari direktori, jadi pastikan anda memberi nama direktori dalam semua huruf kecil jika anda akan menjalankan aplikasi anda pada sistem berkas kasus-sensitif.

\n

Untuk menimpa sebuah cetakan admin untuk aplikasi tertentu, salin dan sunting cetakan dari direktori django/contrib/admin/templates/admin, dan simpan itu ke satu dari direktori anda baru buat.

\n

Sebagai contoh, jika kami ingin menambah sebuah alat pada tampilan daftar rubah untuk semua model-model dalam sebuah aplikasi bernama my_app, kami akan menyalin contrib/admin/templates/admin/change_list.html ke direktori templates/admin/my_app/ dari proyek kami, dan membuat apapun perubahan dibutuhkan.

\n

Jika kami ingin menambah sebuah alat pada tampilan daftar rubah untuk hanya model tertentu bernama 'Page', kami akan menyalin berkas sama itu ke direktori templates/admin/my_app/page dari proyek kami.

\n
\n
\n

Menimpa lawan mengganti cetakan adminLink to this heading#

\n

Karena rancangan modular dari cetakan-cetakan admin, itu biasanya tidak perlu dan tidak dianjurkan untuk mengganti keseluruhan cetakan. Itu adalah hampir selalu lebih baik menimpa hanya bagian dari cetakan yang anda butuh dirubah.

\n

Untuk melanjutkan contoh diatas, kami ingin menambah sebuah tautan baru dekat pada alat History untuk model Page. Setelah mencari di change_form.html kami menentukan bahwa kami hanya butuh menimpa blok object-tools-items, Oleh karena itu disini adalah change_form.html baru kami :

\n
Django template
{% extends "admin/change_form.html" %}\n{% load i18n admin_urls %}\n{% block object-tools-items %}\n    <li>\n        <a href="{% url opts|admin_urlname:'history' original.pk|admin_urlquote %}" class="historylink">{% translate "History" %}</a>\n    </li>\n    <li>\n        <a href="mylink/" class="historylink">My Link</a>\n    </li>\n    {% if has_absolute_url %}\n        <li>\n            <a href="{% url 'admin:view_on_site' content_type_id original.pk %}" class="viewsitelink">{% translate "View on site" %}</a>\n        </li>\n    {% endif %}\n{% endblock %}\n
\n

Dan itu dia! Jika kami menempatkan berkas ini di direktori templates/admin/my_app, tautan kami akan muncul pada formulir rubah untuk semua model dalam my_app.

\n
\n
\n

Cetakan-cetakan yang mungkin menimpa per aplikasi atau modelLink to this heading#

\n

Tidak setiap cetakan di contrib/admin/templates/admin mungkin ditimpa per aplikasi atau per model. Berikut dapat:

\n\n

For those templates that cannot be overridden in this way, you may still\noverride them for your entire project by placing the new version in your\ntemplates/admin directory. This is particularly useful to create custom 404\nand 500 pages.

\n\n
\n
\n

Cetakan akar dan masukLink to this heading#

\n

Jika anda berharap merubah cetakan indeks, masuk atau keluar, anda lebih baik membuat instance AdminSite anda sendiri (lihat dibawah), dan merubah sifat-sifat AdminSite.index_template , AdminSite.login_template atau AdminSite.logout_template.

\n
\n
\n
\n

Theming supportLink to this heading#

\n\n

The admin uses CSS variables to define colors. This allows changing colors\nwithout having to override many individual CSS rules. For example, if you\npreferred purple instead of blue you could add a admin/base.html template\noverride to your project:

\n
Django template
{% extends 'admin/base.html' %}\n\n{% block extrastyle %}{{ block.super }}\n<style>\n:root {\n  --primary: #9774d5;\n  --secondary: #785cab;\n  --link-fg: #7c449b;\n  --link-selected-fg: #8f5bb2;\n}\n</style>\n{% endblock %}\n
\n

A dark theme is defined, and applied respecting the prefers-color-scheme\nmedia query.

\n

The list of CSS variables are defined at\ndjango/contrib/admin/static/admin/css/base.css.

\n
\n
\n

Obyek AdminSiteLink to this heading#

\n
\n
\nclass AdminSite(name='admin')Link to this definition#
\n

Sebuah situs administratif Django diwakili oleh sebuah instance dari django.contrib.admin.sites.AdminSite; secara awalan, sebuah instance dari kelas ini dibuat sebagai django.contrib.admin.site dan anda dapat mendaftar model-model anda dan instance-instance ModelAdmin dengan itu.

\n

Jika anda ingin menyesuaikan situs admin awalan, anda dapat :ref:`override it `.

\n

Ketika mendirikan sebuah instance dari sebuah AdminSite, anda dapat menyediakan sebuah nama instance unik menggunakan argumen name pada pembangun. Nama instance ini digunakan untuk mencirikan instance, khususnya ketika reversing admin URLs. Jika tidak ada nama instance disediakan, sebuah nama instace awalan dari admin akan digunakan. Lihat Menyesuaikan kelas AdminSite. untuk sebuah contoh dari menyesuaikan kelas AdminSite.

\n
\n\n
\n

Atribut AdminSiteLink to this heading#

\n

Cetakan dapat dikesampingkan atau diperpanjang berdasarkan cetakan admin seperti digambarkan di Menimpa cetakan admin.

\n
\n
\nAdminSite.site_headerLink to this definition#
\n

Teks untuk ditaruh di atas dari setiap halaman index admin, sebagai sebuah <h1> (sebuah string). Secara awalan, ini adalah "Administrasi Django".

\n
\n\n
\n
\nAdminSite.site_titleLink to this definition#
\n

Teks untuk ditaruh pada akhir dari setiap <title> halaman admin (sebuah string). Secara awalan, ini adalah "Situs admin Django".

\n
\n\n
\n
\nAdminSite.site_urlLink to this definition#
\n

URL untuk tautan "View site" pada atas dari setiap halaman admin. Secara awalan, site_url adalah /. Setel itu menjadi None untuk memindahkan tautan

\n

Untuk situs-situs berjalan pada subjalur, metode each_context() memeriksa jika permintaan saat ini mempunyai kumpulan request.META['SCRIPT_NAME'] dan menggunakan nilai itu jika site_url``tidak menyetel ke sesuatu selain dari ``/.

\n
\n\n
\n
\nAdminSite.index_titleLink to this definition#
\n

Teks untuk ditaruh di atas dari halaman index admin (deretan karakter). Secara awalan, ini adalah "Administrasi Situs".

\n
\n\n
\n
\nAdminSite.index_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan indeks utama situs admin.

\n
\n\n
\n
\nAdminSite.app_index_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan indeks aplikasi situs admin.

\n
\n\n
\n
\nAdminSite.empty_value_displayLink to this definition#
\n

Deretan karakter yang digunakan untuk menampilkan nilai kosong di daftar perubahan situs admin. Awalan pada sebuah garis. Nilai dapat juga ditimpa pada dasar per ModelAdmin dan pada bidang penyesuaian dalam ModelAdmin dengan mengatur sebuah atribut empty_value_display pada bidang. Lihat ModelAdmin.empty_value_display sebagai contoh.

\n
\n\n
\n
\nAdminSite.enable_nav_sidebarLink to this definition#
\n

A boolean value that determines whether to show the navigation sidebar\non larger screens. By default, it is set to True.

\n
\n\n
\n
\nAdminSite.final_catch_all_viewLink to this definition#
\n
\n

A boolean value that determines whether to add a final catch-all view to\nthe admin that redirects unauthenticated users to the login page. By\ndefault, it is set to True.

\n\n
\n\n
\n
\nAdminSite.login_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan masuk situs admin.

\n
\n\n
\n
\nAdminSite.login_formLink to this definition#
\n

Subkelas dari AuthenticationForm yang akan digunakan oleh tampilan masuk situs admin.

\n
\n\n
\n
\nAdminSite.logout_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan keluar situs admin.

\n
\n\n
\n
\nAdminSite.password_change_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan merubah sandi situs admin.

\n
\n\n
\n
\nAdminSite.password_change_done_templateLink to this definition#
\n

Jalur pada cetakan penyesuaian yang akan digunakan oleh tampilan selesai merubah sandi situs admin.

\n
\n\n
\n
\n

Cara AdminSiteLink to this heading#

\n
\n
\nAdminSite.each_context(request)Link to this definition#
\n

Dikembalikan sebuah kamus dari variabel-variabel untuk menaruh di konteks cetakan untuk setiap halaman di situs admin.

\n

Menyertakan variabel-variabel berikut dan nilai-nilai secara awalan:

\n
    \n

  • site_header: AdminSite.site_header

    • \n

  • site_title: AdminSite.site_title

    • \n

  • site_url: AdminSite.site_url

    • \n

  • has_permission: AdminSite.has_permission()

    • \n

  • available_apps: sebuah daftar aplikasi dari application registry tersedia untuk pengguna saat ini. Setiap masukan dalam daftar adalah sebuah kamus mewakili sebuah aplikasi dengan kunci berikut:

    \n
      \n

    • app_label: label aplikasi

      • \n

    • app_url: URL dari indeks aplikasi di admin

      • \n

    • has_module_perms: sebuah boolean mengindikasikan jika menampilkan dan mengakses dari halaman indeks modul diizinkan untuk pengguna saat ini

      • \n

    • models: sebuah daftar dari model tersedia di aplikasi

      • \n
    \n

    Setiap model adalah kamus dengan kunci-kunci berikut:

    \n
      \n

    • model: the model class

      • \n

    • object_name: nama kelas dari model

      • \n

    • name: nama jamak dari model

      • \n

    • perms: dict melacak perizinan add, change, delete, dan view

      • \n

    • admin_url: URL daftar rubah admin untuk model

      • \n

    • add_url: URL admin untuk menambah instance model baru

      • \n
    \n
    • \n
\n\n
\n\n
\n
\nAdminSite.has_permission(request)Link to this definition#
\n

Mengembalikan True jika pengguna untuk HttpRequest yang diberikan mempunyai perizinan untuk melihat setidaknya satu halaman dalam situs admin. Awalan mewajibkan kedua User.is_active dan User.is_staff menjadi True.

\n
\n\n
\n
\nAdminSite.register(model_or_iterable, admin_class=None, **options)Link to this definition#
\n

Mendaftarkan kelas model yang diberikan (atau kelas-kelas berulang) dengan admin_class yang diberikan. Awalan admin_class pada ModelAdmin (pilihan admin awalan). Jika argumen kata kunci diberikan -- misalnya list_display -- mereka akan diberlakukan sebagai pilihan pada kelas admin.

\n

Memunculkan ImproperlyConfigured jika sebuah model adalah abstrak, dan django.contrib.admin.sites.AlreadyRegistered jika sebuah model sudah terdaftar.

\n
\n\n
\n
\nAdminSite.unregister(model_or_iterable)Link to this definition#
\n

Unregisters the given model class (or iterable of classes).

\n

Raises django.contrib.admin.sites.NotRegistered if a model isn't\nalready registered.

\n
\n\n
\n
\n

Mengkaitkan instance AdminSite kedalam URLconf andaLink to this heading#

\n

Langkah terakhir untuk mengatur admin Django adalah mengkaitkan instance AdminSite anda kedalam URLconf anda. Lakukan ini dengan menunjuk sebuah URL yang diberikan pada metode AdminSite.urls. Itu tidak diperlukan, menggunakan include().

\n

Di contoh ini, kami mendaftarkan instance AdminSite awalan django.contrib.admin.site pada URL /admin/

\n
Code
# urls.py\nfrom django.contrib import admin\nfrom django.urls import path\n\nurlpatterns = [\n    path('admin/', admin.site.urls),\n]\n
\n
\n
\n

Menyesuaikan kelas AdminSite.Link to this heading#

\n

If you'd like to set up your own admin site with custom behavior, you're free\nto subclass AdminSite and override or add anything you like. Then, create\nan instance of your AdminSite subclass (the same way you'd instantiate any\nother Python class) and register your models and ModelAdmin subclasses with\nit instead of with the default site. Finally, update myproject/urls.py\nto reference your AdminSite subclass.

\n
myapp/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import MyModel\n\nclass MyAdminSite(admin.AdminSite):\n    site_header = 'Monty Python administration'\n\nadmin_site = MyAdminSite(name='myadmin')\nadmin_site.register(MyModel)\n
\n
myproject/urls.py
\n
Python
from django.urls import path\n\nfrom myapp.admin import admin_site\n\nurlpatterns = [\n    path('myadmin/', admin_site.urls),\n]\n
\n

Catat bahwa anda tidak mungkin ingin penemuan otomatis dari modul-modul admin ketika menggunakan instance AdminSite anda sendiri sejak anda akan mengimpor semua per-aplikasi modul-modul admin dalam modul myproject.admin anda. Ini berarti anda butuh menaruh 'django.contrib.admin.apps.SimpleAdminConfig' daripada 'django.contrib.admin' dalam pengaturan INSTALLED_APPS anda.

\n
\n
\n

Menimpa situs admin awalanLink to this heading#

\n

Anda dapat menimpa django.contrib.admin.site awalan dengan mengatur atribut default_site AppConfig penyesuaian pada jalur impor bertitik dari salah satu subkelas AdminSite atau callable yang mengembalikan sebuah instance situs.

\n
myproject/admin.py
\n
Python
from django.contrib import admin\n\nclass MyAdminSite(admin.AdminSite):\n    ...\n
\n
myproject/apps.py
\n
Python
from django.contrib.admin.apps import AdminConfig\n\nclass MyAdminConfig(AdminConfig):\n    default_site = 'myproject.admin.MyAdminSite'\n
\n
myproject/settings.py
\n
Python
INSTALLED_APPS = [\n    ...\n    'myproject.apps.MyAdminConfig',  # replaces 'django.contrib.admin'\n    ...\n]\n
\n
\n
\n

Banyak situs admin di URLconf yang samaLink to this heading#

\n

You can create multiple instances of the admin site on the same Django-powered\nwebsite. Create multiple instances of AdminSite and place each one at a\ndifferent URL.

\n

Dalam contoh ini, URL fitur /basic-admin/ and /advanced-admin/ versi terpisah dari situs admin -- menggunakan instance-instance AdminSite myproject.admin.basic_site dan myproject.admin.advanced_site, masing-masing:

\n
Code
# urls.py\nfrom django.urls import path\nfrom myproject.admin import advanced_site, basic_site\n\nurlpatterns = [\n    path('basic-admin/', basic_site.urls),\n    path('advanced-admin/', advanced_site.urls),\n]\n
\n

Instance AdminSite mengambil argumen tunggal pada pembangun mereka, nama mereka, yang dapat apapun anda suka. Argumen ini menjadi awalan pada nama-nama URL untuk tujuan dari reversing them. Ini hanya dibutuhkan jika anda sedang menggunakan lebih dari satu AdminSite.

\n
\n
\n

Menambahkan tampilan ke situs adminLink to this heading#

\n

Seperti ModelAdmin, AdminSite menyediakan sebuah metode get_urls() yang dapat ditimpa untuk menentukan tambahan tampilan untuk situs. Untuk menambah sebuah tampilan baru ke situs admin anda, perpanjang metode get_urls() dasar untuk menyertakan sebuah pola untuk tampilan baru anda.

\n\n
\n
\n

Menambahkan fitur penyetelan kembali sandiLink to this heading#

\n

Anda dapat menambah sebuah fitur penyetelan kembali sandi pada situs admin dengan menambahkan beberapa baris pada URLconf anda. Khususnya, tambah tambahkan empat pola ini:

\n
Code
from django.contrib.auth import views as auth_views\n\npath(\n    'admin/password_reset/',\n    auth_views.PasswordResetView.as_view(),\n    name='admin_password_reset',\n),\npath(\n    'admin/password_reset/done/',\n    auth_views.PasswordResetDoneView.as_view(),\n    name='password_reset_done',\n),\npath(\n    'reset/<uidb64>/<token>/',\n    auth_views.PasswordResetConfirmView.as_view(),\n    name='password_reset_confirm',\n),\npath(\n    'reset/done/',\n    auth_views.PasswordResetCompleteView.as_view(),\n    name='password_reset_complete',\n),\n
\n

(Ini menganggap anda telah menambahkan admin pada admin/ dan diwajibkan bahwa anda menaruh URL dimulai dengan ^admin/ sebelum baris yang menyertakan aplikasi admin itu sendiri).

\n

Kehadiran dari URL bernama admin_password_reset akan menyebabkan sebuah tautan "forgotten your password?" muncul pada halaman masuk admin awalan dibawah kotak sandi.

\n
\n
\n
\n

Obyek LogEntryLink to this heading#

\n
\n
\nclass models.LogEntryLink to this definition#
\n

Kelas LogEntry melacak penambahan, perubahan, penghapusan dari obyek melalui antarmuka admin.

\n
\n\n
\n

Atribut LogEntryLink to this heading#

\n
\n
\nLogEntry.action_timeLink to this definition#
\n

Tanggal dan waktu dari tindakan.

\n
\n\n
\n
\nLogEntry.userLink to this definition#
\n

Pengguna (sebuah instance AUTH_USER_MODEL) yang melakukan tindakan.

\n
\n\n
\n
\nLogEntry.content_typeLink to this definition#
\n

ContentType dari obyek dirubah.

\n
\n\n
\n
\nLogEntry.object_idLink to this definition#
\n

Perwakilan tekstual dari primary key obyek yang telah dirubah.

\n
\n\n
\n
\nLogEntry.object_reprLink to this definition#
\n

repr() obyek setelah perubahan.

\n
\n\n
\n
\nLogEntry.action_flagLink to this definition#
\n

Jenis dari tindakan dicatat: ADDITION, CHANGE, DELETION.

\n

Sebagai contoh, untuk mendapatkan daftar dari semua tambahan selesai melalui admin:

\n
Code
from django.contrib.admin.models import ADDITION, LogEntry\n\nLogEntry.objects.filter(action_flag=ADDITION)\n
\n
\n\n
\n
\nLogEntry.change_messageLink to this definition#
\n

Gambaran rincian dari perubahan. Dalam kasus sebuah penyuntingan, sebagai contoh, pesan mengandung daftar dari bidang-bidang terseunting. Situs admin Django membentuk isi ini sebagai struktur JSON, sehingga get_change_message() mengubah komposisi sebuah pesan diterjemahkan dalam bahasa pengguna saat ini. Penyesuaian kode mungkin menyetel ini sebagai string polos. Anda disarankan menggunakan metode get_change_message() untuk mengambil nilai ini daripada mengakses itu langsung.

\n
\n\n
\n
\n

Cara LogEntryLink to this heading#

\n
\n
\nLogEntry.get_edited_object()Link to this definition#
\n

Sebuah jalan pintas yang mengembalikan obyek diacukan.

\n
\n\n
\n
\nLogEntry.get_change_message()Link to this definition#
\n

Bentuk dan terjemahkan change_message kedalam bahasa pengguna saat ini. Pesan-pesan dibuat sebelum Django 1.10 akan selalu diperlihatkan dalam bahasa yang mereka telah masuk.

\n
\n\n
\n
\n
\n

Membalikkan URL adminLink to this heading#

\n

Ketika AdminSite disebarkan, tampilan disediakan oleh situs itu dapat diakses menggunakan URL reversing system Django.

\n

AdminSite menyediakan corak URL bernama berikut:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Halaman

Nama URL

Parameter

Indeks

indeks

Masuk

login

Keluar

keluar

Ubah sandi

password_change

Merubah sandi selesai

password_change_done

i18n JavaScript

jsi18n

Halaman indeks aplikasi

app_list

app_label

Pengalihan ke halaman obyek

view_on_site

content_type_id, object_id

\n
\n

Setiap instance ModelAdmin menyediakan sebuah tambahan sekumpulan dari URL bernama:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Halaman

Nama URL

Parameter

Daftar rubah

{{ app_label }}_{{ model_name }}_changelist

Tambah

{{ app_label }}_{{ model_name }}_add

Riwayat

{{ app_label }}_{{ model_name }}_history

object_id

Hapus

{{ app_label }}_{{ model_name }}_delete

object_id

Ubah

{{ app_label }}_{{ model_name }}_change

object_id

\n
\n

UserAdmin menyediakan sebuah URL bernama:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n

Halaman

Nama URL

Parameter

Ubah sandi

auth_user_password_change

user_id

\n
\n

URL bernama ini didaftarkan dengan namespace aplikasi admin, dan dengan sebuah namespace instance berhubungan pada nama dari instance Site.

\n

Jadi - jika anda ingin mendapatkan acuan pada tampilan Change untuk obyek Choice tertentu (dari aplikasi jejak pendapat) dalam admin awalan, anda akan memanggil:

\n
Code
>>> from django.urls import reverse\n>>> c = Choice.objects.get(...)\n>>> change_url = reverse('admin:polls_choice_change', args=(c.id,))\n
\n

Ini akan menemukan instance terdaftar pertama dari aplikasi admin (apapun nama instance), dan memutuskan untuk tampilan untuk merubah instance poll.Choice dalam instance itu.

\n

Jika anda inginmenemukan sebuah URL dalam instance admin tertentu, sediakan nama dari instance itu sebagai sebuah petunjuk current_app untuk membalikkan panggilan. Sebagai contoh, jika anda khususnya ingin tampilan admin dari instance admin bernama custom, anda akan butuh memanggil:

\n
Code
>>> change_url = reverse('admin:polls_choice_change', args=(c.id,), current_app='custom')\n
\n

Untuk rincian lebih, lihat dokumentasi pada reversing namespaced URLs.

\n

Untuk mengizinkan membalikan paling mudah dari url-url admin dalam cetakan, Django menyediakan penyaring admin_urlname yang mengambil sebuah tindakan sebagai argumen:

\n
Django template
{% load admin_urls %}\n<a href="{% url opts|admin_urlname:'add' %}">Add user</a>\n<a href="{% url opts|admin_urlname:'delete' user.pk %}">Delete this user</a>\n
\n

Tindakan dalam contoh-contoh diatas mencocokan bagian terakhir dari nama-nama URL untuk instance-instance ModelAdmin digambarkan diatas. Variabel 11opts`` dapat berupa obyek-obyek apapun yang mempunyai sebuah atribut app_label dan model_name dan biasanya dipasok oleh tampilan-tampilan admin untuk model saat ini.

\n
\n
\n

The display decoratorLink to this heading#

\n
\n
\ndisplay(*, boolean=None, ordering=None, description=None, empty_value=None)Link to this definition#
\n
\n

This decorator can be used for setting specific attributes on custom\ndisplay functions that can be used with\nlist_display or\nreadonly_fields:

\n
Code
@admin.display(\n    boolean=True,\n    ordering='-publish_date',\n    description='Is Published?',\n)\ndef is_published(self, obj):\n    return obj.publish_date is not None\n
\n

This is equivalent to setting some attributes (with the original, longer\nnames) on the function directly:

\n
Code
def is_published(self, obj):\n    return obj.publish_date is not None\nis_published.boolean = True\nis_published.admin_order_field = '-publish_date'\nis_published.short_description = 'Is Published?'\n
\n

Also note that the empty_value decorator parameter maps to the\nempty_value_display attribute assigned directly to the function. It\ncannot be used in conjunction with boolean -- they are mutually\nexclusive.

\n

Use of this decorator is not compulsory to make a display function, but it\ncan be useful to use it without arguments as a marker in your source to\nidentify the purpose of the function:

\n
Code
@admin.display\ndef published_year(self, obj):\n    return obj.publish_date.year\n
\n

In this case it will add no attributes to the function.

\n
\n\n
\n
\n

Penghias staff_member_requiredLink to this heading#

\n
\n
\nstaff_member_required(redirect_field_name='next', login_url='admin:login')Link to this definition#
\n

This decorator is used on the admin views that require authorization. A\nview decorated with this function will have the following behavior:

\n
    \n

  • Jika pengguna masuk, adalah anggota staf (User.is_staff=True), dan aktif (User.is_active=True), kerjakan tampilan secara biasa.

    • \n

  • Sebaliknya, permintaan akan dialihkan ke URL ditentukan oleh parameter login_url, dengan jalur aslinya diminta dalam sebuah variabel string permintaan ditentukan oleh redirect_field_name. Sebagai contoh: /admin/login/?next=/admin/polls/question/3/.

    • \n
\n

Contoh penggunaan:

\n
Code
from django.contrib.admin.views.decorators import staff_member_required\n\n@staff_member_required\ndef my_view(request):\n    ...\n
\n
\n\n
","rootId":"module-django.contrib.admin","toc":[{"title":"Ikhtisar","anchor":"overview","children":[{"title":"Topik lainnya","anchor":"other-topics","children":[]}]},{"title":"Obyek ModelAdmin","anchor":"modeladmin-objects","children":[{"title":"Penghias register","anchor":"the-register-decorator","children":[]},{"title":"Penemuan dari berkas admin","anchor":"discovery-of-admin-files","children":[]},{"title":"Pilihan ModelAdmin","anchor":"modeladmin-options","children":[{"title":"Penyesuaian pilihan cetakan","anchor":"custom-template-options","children":[]}]},{"title":"Cara ModelAdmin","anchor":"modeladmin-methods","children":[{"title":"Cara lain","anchor":"other-methods","children":[]}]},{"title":"Pengertian aset ModelAdmin","anchor":"modeladmin-asset-definitions","children":[{"title":"jQuery","anchor":"jquery","children":[]}]},{"title":"Menambahkan pengesahan penyesuaian pada admin","anchor":"adding-custom-validation-to-the-admin","children":[]}]},{"title":"Obyek InlineModelAdmin","anchor":"inlinemodeladmin-objects","children":[{"title":"Pilihan InlineModelAdmin","anchor":"inlinemodeladmin-options","children":[]},{"title":"Bekerja dengan sebuah model dengan dua atau lebih foreign key pada model induk yang sama.","anchor":"working-with-a-model-with-two-or-more-foreign-keys-to-the-same-parent-model","children":[]},{"title":"Bekerja dengan model banyak-ke-banyak","anchor":"working-with-many-to-many-models","children":[]},{"title":"Bekerja dengan model perantara many-to-many","anchor":"working-with-many-to-many-intermediary-models","children":[]},{"title":"Menggunakan hubungan umum sebagai sebuah berderet","anchor":"using-generic-relations-as-an-inline","children":[]}]},{"title":"Menimpa cetakan admin","anchor":"overriding-admin-templates","children":[{"title":"Setel direktori cetakan admin proyek","anchor":"set-up-your-projects-admin-template-directories","children":[]},{"title":"Menimpa lawan mengganti cetakan admin","anchor":"overriding-vs-replacing-an-admin-template","children":[]},{"title":"Cetakan-cetakan yang mungkin menimpa per aplikasi atau model","anchor":"templates-which-may-be-overridden-per-app-or-model","children":[]},{"title":"Cetakan akar dan masuk","anchor":"root-and-login-templates","children":[]}]},{"title":"Theming support","anchor":"theming-support","children":[]},{"title":"Obyek AdminSite","anchor":"adminsite-objects","children":[{"title":"Atribut AdminSite","anchor":"adminsite-attributes","children":[]},{"title":"Cara AdminSite","anchor":"adminsite-methods","children":[]},{"title":"Mengkaitkan instance AdminSite kedalam URLconf anda","anchor":"hooking-adminsite-instances-into-your-urlconf","children":[]},{"title":"Menyesuaikan kelas AdminSite.","anchor":"customizing-the-adminsite-class","children":[]},{"title":"Menimpa situs admin awalan","anchor":"overriding-the-default-admin-site","children":[]},{"title":"Banyak situs admin di URLconf yang sama","anchor":"multiple-admin-sites-in-the-same-urlconf","children":[]},{"title":"Menambahkan tampilan ke situs admin","anchor":"adding-views-to-admin-sites","children":[]},{"title":"Menambahkan fitur penyetelan kembali sandi","anchor":"adding-a-password-reset-feature","children":[]}]},{"title":"Obyek LogEntry","anchor":"logentry-objects","children":[{"title":"Atribut LogEntry","anchor":"logentry-attributes","children":[]},{"title":"Cara LogEntry","anchor":"logentry-methods","children":[]}]},{"title":"Membalikkan URL admin","anchor":"reversing-admin-urls","children":[]},{"title":"The display decorator","anchor":"the-display-decorator","children":[]},{"title":"Penghias staff_member_required","anchor":"the-staff-member-required-decorator","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Acuan API","url":"/id/4.0/ref/"},{"docname":"ref/contrib/index","title":"Paket contrib","url":"/id/4.0/ref/contrib/"}],"prev":{"docname":"ref/contrib/index","title":"Paket contrib","url":"/id/4.0/ref/contrib/"},"next":{"docname":"ref/contrib/admin/actions","title":"Tindakan admin","url":"/id/4.0/ref/contrib/admin/actions/"},"formats":{"html":"/id/4.0/ref/contrib/admin/","markdown":"/id/4.0/ref/contrib/admin.md","json":"/id/4.0/ref/contrib/admin.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/ref/contrib/admin/index.txt","official":"https://docs.djangoproject.com/id/4.0/ref/contrib/admin/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}