{"title":"Menulis aplikasi Django kedua anda, bagian 7","version":"6.1","locale":"id","docname":"intro/tutorial07","url":"/id/6.1/intro/tutorial07/","canonical":"https://djangodocs.dev/id/6.1/intro/tutorial07/","summary":"Tutorial ini memulai dimana Tutorial 6 ditinggalkan. Kami sedang melanjutkan aplikasi poling-jaringan dan akan fokus pada menyesuaikan pembangkitan otomatis…","html":"

Menulis aplikasi Django kedua anda, bagian 7Link to this heading#

\n

Tutorial ini memulai dimana Tutorial 6 ditinggalkan. Kami sedang melanjutkan aplikasi poling-jaringan dan akan fokus pada menyesuaikan pembangkitan otomatis situs admin Django yang pertama kami jelajahi dalam in Tutorial 2.

\n\n
\n

Sesuaikan bentuk adminLink to this heading#

\n

Dengan mendaftarkan model Question dengan admin.site.register(Question), Django dapat membangun bentuk perwakilan awal. Sering, anda akan menginginkan menyesuaikan bagaimana bentuk admin kelihatan dan bekerja. Anda akan melakukan ini dengan memberitahu Django pilihan anda ingin ketika anda mendaftar obyek.

\n

Mari kita lihat bagaimana ini bekerja dengan mengurutkan kembali bidang di formulir sunting. Ganti baris admin.site.register(Question) dengan:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ["pub_date", "question_text"]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Anda akan mengikuti corak ini -- buat sebuah kelas admin model, kemudian lewati dia sebagai argumen kedua ke admin.site.register() -- setiap saat anda butuh merubah pilihan admin untuk sebuah model.

\n

Perubahan khusus ini diatas membuat "Tanggal penerbitan" datang sebelum bidang "Pertanyaan" :

\n\"Bidang-bidang\n

Ini tidak hebat dengan hanya dua bidang, tetapi untuk bentuk admin dengan lusinan bidang, memilih urutan intuitif adalah rincian kegunaan penting.

\n

Dan berbicara formulir dengan lusinan bidang, anda mungkin ingin memisahkan formulir menjadi kumpulan bidang:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None, {"fields": ["question_text"]}),\n        ("Date information", {"fields": ["pub_date"]}),\n    ]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Unsur pertama dari setiap tuple di fieldsets adalah judul dari fieldset. Ini adalah apa formulir kami kelihatan seperti sekarang:

\n\"Formulir\n
\n\n
\n

Sesuaiakan daftar perubahan adminLink to this heading#

\n

Sekarang bahwa halaman admin Question kelihatan bagus, mari kita membuat beberapa perubahan untuk "daftar rubah" halaman -- satu yang menampilkan semua pertanyaan di sistem.

\n

Inilah yang terlihat seperti pada saat ini:

\n\"Halaman\n

By default, Django displays the str() of each object. But sometimes it'd be\nmore helpful if we could display individual fields. To do that, use the\nlist_display admin option, which is a\nlist of field names to display, as columns, on the change list page for the\nobject:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date"]\n
\n

Untuk ukuran terbaik, mari juta juga sertakan metode was_published_recently() dari Tutorial 2:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date", "was_published_recently"]\n
\n

Sekarang pertanyaan halaman daftar perubahan kelihatan seperti ini:

\n\"Halaman\n

Anda dapat meng klik di kepala kolom untuk mengurutkan nilai tersebut -- kecuali di kasus kepala was_published_recently, karena mengurutkan berdasarkan keluaran dari cara sewenang-wenang tidak didukung. Juga catat bahwa kepala kolom untuk was_published_recently adalah, secara awal, nama dari cara (dengan garis bawah ditandai dengan spasi), dan setiap baris mengandung string mewakili dari keluaran.

\n

You can improve that by using the display()\ndecorator on that method (extending the polls/models.py file that was\ncreated in Tutorial 2), as follows:

\n
polls/models.py
\n
Python
from django.contrib import admin\n\n\nclass Question(models.Model):\n    # ...\n    @admin.display(\n        boolean=True,\n        ordering="pub_date",\n        description="Published recently?",\n    )\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n
\n

Untuk informasi lebih pada properti yang dapat dikonfigurasikan melalui penghias lihat list_display.

\n

Sunting berkas polls/admin.py anda kembali dan tambah perbaikan ke halaman daftar perubahan Question : saringan menggunakan list_filter. Tambah baris berikut ke QuestionAdmin:

\n
Code
list_filter = ["pub_date"]\n
\n

Itu menambahkan batang sisi "Saringan" yang membiarkan orang menyaring daftar perubahan dengan bidang pub_date:

\n\"Halaman\n

Jenis dari saringan ditampilkan tergantung pada jenis dari bidang anda saringkan. karena pub_date adalah sebuah DateTimeField, Django mengetahui untuk memberikan pilihan saringan sesuai: "Tanggal kapanpun", "7 hari terakhir"," Bulan ini", "Tahun ini".

\n

Ini adalah pembentukan baik. Mari kita menambahkan beberapa kemampuan pencarian

\n
Code
search_fields = ["question_text"]\n
\n

Itu menambah kotak pencarian di bagian atas dari daftar rubah. Ketika seseorang memasukkan istilah pencarian, Django akan mencari bidang question_text. Anda dapat menggunakan sebanyak bidang anda suka -- meskipun karena itu menggunakan query LIKE dibelakang layar, membatasi angka bidan gpencarian untuk angka yang beralasan akan membuatnya mudah bagi basisdata anda melakukan pencarian.

\n

Now's also a good time to note that change lists give you free pagination. The\ndefault is to display 100 items per page.

\n\n
\n
\n

Sesuaikan admin lihat dan rasakanLink to this heading#

\n

Jelas, mempunyai "Administrasi Django" pada atas dari setiap halaman admin adalah menggelikan. Itu adalah hanya teks placeholder.

\n

Anda dapat merubahnya, meskipun, menggunakan sistem cetakan Django. Admin Django ditenagai oleh Django itu sendiri, dan antarmukanya menggunakan sistem cetakan Django sendiri.

\n
\n

Menyesuaikan cetakan proyek andaLink to this heading#

\n

Create a templates directory in your djangotutorial directory.\nTemplates can live anywhere on your filesystem that Django can access. (Django\nruns as whatever user your server runs.) However, keeping your templates within\nthe project is a good convention to follow.

\n

Buka berkas pengaturan anda (mysite/settings.py, ingat) dan tambah pilihan DIRS di pengaturan TEMPLATES :

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        "OPTIONS": {\n            "context_processors": [\n                "django.template.context_processors.request",\n                "django.contrib.auth.context_processors.auth",\n                "django.contrib.messages.context_processors.messages",\n            ],\n        },\n    },\n]\n
\n

DIRS adalah daftar dari direktori sistem berkas untuk memeriksa ketika memuat cetakan Django; dia adalah jalur pencarian.

\n\n

Now create a directory called admin inside templates, and copy the\ntemplate admin/base_site.html from within the default Django admin\ntemplate directory in the source code of Django itself\n(django/contrib/admin/templates) into that directory.

\n\n

Kemudian, sunting berkas dan ganti {{ site_header|default:_('Django administration') }} (termasuk tanda buka kurung bergelombang) dengan nama situs anda sendiri untuk melihatnya cocok. Anda akan berakhir dengan bagian seperti kode:

\n
Django template
{% block branding %}\n<div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>\n{% if user.is_anonymous %}\n  {% include "admin/color_theme_toggle.html" %}\n{% endif %}\n{% endblock %}\n
\n

Kami menggunakan pendekatan ini untuk mengajarkan anda bagaimana menimpa cetakan. Di proyek sesungguhnya, anda mungkin menggunakan atribut django.contrib.admin.AdminSite.site_header untuk lebih mudah membuat penyesuaian tertentu.

\n

Berkas cetakan ini mengandung banyak teks seperti {% block branding %} dan {{ title }}. Etiket {% dan {{ adalah bagian dari bahasa cetakan Django. Ketika Django membangun admin/base_site.html, bahasa cetakan akan menilai untuk menghasilkan halaman HTML akhir, sama seeprti kami lihat di Tutorial 3.

\n

Catat bahwa cetakan admin awalan Django dapat ditimpa. Untuk menimpa cetakan, lakukan hal sama anda lakukan dengan base_site.html -- salin itu dari direktori awalan kedalam direktori penyesuaian anda, dan buat perubahan.

\n
\n
\n

Menyesuaikan cetakan aplikasi andaLink to this heading#

\n

Pembaca cerdik akan bertanya: Tetapi jika DIRS kosong secara awal, bagaimana Django menemukan cetakan admin awal? Jawabannya adalah, sejak APP_DIRS disetel ke True, Django otomatis mencari subdirektori templates/ dalam setiap paket aplikasi, untuk digunakan sebagai kembali (jangan lupa bahwa django.contrib.admin adalah sebuah aplikasi).

\n

Aplikasi jejak pendapat kami tidak sangat rumit dan tidak butuh penyesuaian cetakan admin. Tetapi jika itu tumbuh lebih mutkahir dan membutuhkan perubahan dari cetakan admin standar Django untuk beberapa fungsinya, itu akan lebih bijaksana untuk merubah cetakan aplikasi, daripada itu di proyek. Lewat situ, anda dapat menyertakan aplikasi jejak pendapat di proyek baru apapun dan terjamin bahwa dia akan menemukan cetakan penyesuaian dia butuhkan.

\n

Lihat dokumentasi memuat cetakan untuk informasi lebih tentang bagaimana Django menemukan cetakannya.

\n
\n
\n
\n

Sesuaikan halaman index adminLink to this heading#

\n

Pada catatan sama, anda mungkin ingin menyesuaikan penampilan dan rasa dari halaman index admin Django.

\n

Secara awal, dia menampilkan semua aplikasi di INSTALLED_APPS yang telah didaftarkan dengan aplikasi admin, dalam urutan alfabet. Anda mungkin ingin membuat perubahan signifikan pada tata letak. Lagi pula, index mungkin halaman paling penting dari admin, dan dia harus mudah digunakan.

\n

The template to customize is admin/index.html. (Do the same as with\nadmin/base_site.html in the previous section -- copy it from the default\ndirectory to your custom template directory). Edit the file, and you'll see it\nuses a template variable called app_list. That variable contains every\ninstalled Django app. Instead of using that, you can hardcode links to\nobject-specific admin pages in whatever way you think is best.

\n

When you're comfortable with the admin, read part 8 of this\ntutorial to learn how to use third-party packages.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Sesuaikan bentuk admin","anchor":"customize-the-admin-form","children":[]},{"title":"Menambahkan obyek terhubung","anchor":"adding-related-objects","children":[]},{"title":"Sesuaiakan daftar perubahan admin","anchor":"customize-the-admin-change-list","children":[]},{"title":"Sesuaikan admin lihat dan rasakan","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Menyesuaikan cetakan proyek anda","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Menyesuaikan cetakan aplikasi anda","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Sesuaikan halaman index admin","anchor":"customize-the-admin-index-page","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Mulai","url":"/id/6.1/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Menulis aplikasi Django pertama anda, bagian 6","url":"/id/6.1/intro/tutorial06/"},"next":{"docname":"intro/tutorial08","title":"Writing your first Django app, part 8","url":"/id/6.1/intro/tutorial08/"},"formats":{"html":"/id/6.1/intro/tutorial07/","markdown":"/id/6.1/intro/tutorial07.md","json":"/id/6.1/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/id/6.1/intro/tutorial07/","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","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}