Django comes with an optional "flatpages" application. It lets you store "flat"\nHTML content in a database and handles the management for you via Django's\nadmin interface and a Python API.
\nA flatpage is an object with a URL, title and content. Use it for one-off,\nspecial-case pages, such as "About" or "Privacy Policy" pages, that you want to\nstore in a database but for which you don't want to develop a custom Django\napplication.
\nSebuah flatpage dapat menggunakan cetakan penyesuaian atau awalan, cetakan flatpage sistem luas. Itu dapat dikaitkan dengan satu, atau banyak, situs.
\nBidang isi mungkin pilihan ditinggalkan kosong jika anda memilih menaruh isi anda di penyesuaian cetakan.
\nUntuk memasang aplikasi flatpages, ikuti langkah ini:
\nPasang sites framework dengan menambahkan 'django.contrib.sites' pada pengaturan INSTALLED_APPS anda, jika itu sudah tidak disana.
Also make sure you've correctly set SITE_ID to the ID of the\nsite the settings file represents. This will usually be 1 (i.e.\nSITE_ID = 1), but if you're using the sites framework to manage\nmultiple sites, it could be the ID of a different site.
Tambah 'django.contrib.flatpages' ke pengaturan INSTALLED_APPS anda.
Maka salah satu:
\nTambah sebuah masukan dalam URLconf anda. Sebagai contoh:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\natau:
\nTambah 'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware' ke pengaturan MIDDLEWARE anda.
Jalankan perintah manage.py migrate.
manage.py migrate creates two tables in your database: django_flatpage\nand django_flatpage_sites. django_flatpage is a lookup table that maps\na URL to a title and bunch of text content. django_flatpage_sites\nassociates a flatpage with a site.
There are several ways to include the flatpages in your URLconf. You can\ndedicate a particular path to flatpages:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\nAnda dapat juga menyetel itu sebagai sebuah pola "catchall". Dalam kasus ini, itu adalah penting menempatkan pola pada akhir dari urlpattern lain:
\nfrom django.contrib.flatpages import views\n\n# Your other patterns here\nurlpatterns += [\n re_path(r"^(?P<url>.*/)$", views.flatpage),\n]\nAnother common setup is to use flatpages for a limited set of known pages and\nto hardcode their URLs in the URLconf:
\nfrom django.contrib.flatpages import views\n\nurlpatterns += [\n path("about-us/", views.flatpage, kwargs={"url": "/about-us/"}, name="about"),\n path("license/", views.flatpage, kwargs={"url": "/license/"}, name="license"),\n]\nThe kwargs argument sets the url value used for the FlatPage model\nlookup in the flatpage view.
The name argument allows the URL to be reversed in templates, for example\nusing the url template tag.
FlatpageFallbackMiddleware dapat melakukan semua dari pekerjaan.
Setiap kali aplikasi Django apapun memunculkan kesalahan 404, middleware ini memeriksa bahwa basisdata flatpage untuk URL diminta sebagai usaha terakhir. Khususnya, itu memeriksa untuk flatpage dengan URL diberikan dengan ID situs yang berhubungan pada pengaturan SITE_ID.
Jika dia menemukan yang cocok, dia mengikuti algoritma ini:
\nJika halaman datar mempunyai cetakan penyesuaian, itu memuat cetakan tersebut. Sebaliknya, itu memuat cetakan flatpages/default.html.
Itu melewatkan cetakan tersebut sebuah variabel konteks tunggal, flatpage, yaitu obyek halaman datar. Itu menggunakan RequestContext dalam membangun cetakan.
Middleware hanya akan menambah garis miring dan mengalihkan (dengan mencari pada pengaturan APPEND_SLASH) jika URL yang dihasilkan mengacu ke halaman datar yang sah. Pengalihan adalah tetap (kode keadaan 301).
Jika itu tidak menemukan kecocokan, permintaan berlanjut untuk diolah seperti biasa.
\nMiddleware hanya dapat diaktifasikan untuk 404 -- bukan untuk 500 atau tanggapan kode keadaan apapun lainnya.
\nCatat bahwa urutan dari MIDDLEWARE penting. Umumnya, anda dapat menaruh FlatpageFallbackMiddleware pada akhir dari daftar. Ini berarti itu akan berjalan pertama ketika mengolah tanggapan, dan memastikan bahwa middleware pengolahan-tanggapan lain apapn melihat tanggapan flatpage daripada 404.
Untuk lebih pada middleware, baca dokumentasi middleware.
\n\nJika anda telah diaktivasi antarmuka admin Django, anda harus melihat bagisn "Flatpages" pada halaman indeks admin. Sunting flatpage ketika anda menyunting obyek apapun lainnya dalam sistem.
\nModel FlatPage mempunyai bidang enable_comments yang tidak digunakan oleh contrib.flatpages, tetapi itu mungkin berguna untuk peoyek anda atau aplikasi pihak-ketiga. Itu tidak muncul dalam antarmuka admin, tetapi anda dapat menambahkan itu dengan mendaftarkan penyesuaian ModelAdmin untuk FlatPage:
from django.contrib import admin\nfrom django.contrib.flatpages.admin import FlatPageAdmin\nfrom django.contrib.flatpages.models import FlatPage\nfrom django.utils.translation import gettext_lazy as _\n\n\n# Define a new FlatPageAdmin\nclass FlatPageAdmin(FlatPageAdmin):\n fieldsets = [\n (None, {"fields": ["url", "title", "content", "sites"]}),\n (\n _("Advanced options"),\n {\n "classes": ["collapse"],\n "fields": [\n "enable_comments",\n "registration_required",\n "template_name",\n ],\n },\n ),\n ]\n\n\n# Re-register FlatPageAdmin\nadmin.site.unregister(FlatPage)\nadmin.site.register(FlatPage, FlatPageAdmin)\nFlatpages are represented by a standard\nDjango model, FlatPage. You can access\nflatpage objects via the Django database API.
FlatPage modelLink to this heading#FlatPage objects have the following\nfields:
Required. 100 characters or fewer. Indexed for faster lookups.
\nRequired. 200 characters or fewer.
\nOptional (blank=True).\nTextField that typically, contains the HTML\ncontent of the page.
Boolean. This field is not used by flatpages by\ndefault and does not appear in the admin interface. Please see\nflatpages admin interface section for a\ndetailed explanation.
Optional (blank=True). 70\ncharacters or fewer. Specifies the template used to render the page.\nDefaults to flatpages/default.html if not provided.
Many-to-many relationship to\nSite, which determines the\nsites the flatpage is available on.
Returns the relative URL path of the page based on the\nurl attribute.
By default, flatpages are rendered via the template\nflatpages/default.html, but you can override that for a particular\nflatpage: in the admin, a collapsed fieldset titled "Advanced options"\n(clicking will expand it) contains a field for specifying a template name. If\nyou're creating a flatpage via the Python API you can set the template name as\nthe field template_name on the FlatPage object.
Creating the flatpages/default.html template is your responsibility;\nin your template directory, create a flatpages directory containing a\nfile default.html.
Cetakan flatpage melewatkan variabel konteks tunggal, flatpage, yaitu obyek flatpage.
Ini adalah sebuah contoh cetakan flatpages/default.html:
<!DOCTYPE html>\n<html lang="en">\n<head>\n<title>{{ flatpage.title }}</title>\n</head>\n<body>\n{{ flatpage.content }}\n</body>\n</html>\nSejak anda sudah memasukkan HTML mentah kedalam halaman admin untuk sebuah flatpage, kedua flatpage.title dan flatpage.content ditandai sebagai bukan membutuhkan automatic HTML escaping 1 dalam cetakan.
FlatPage dalam cetakan andaLink to this heading#Aplikasi flatpage menyediakan sebuah etiket cetakan yang mengizinkan anda mengulangi semua flatpage yang tersedia pada current site 1.
\nSeperti semua etiket cetakan penyesuaian, anda akan butuh untuk load its custom tag library 1 sebelum anda dapat menggunakan itu. Setelah memuat pustaka, anda dapat mengambil semua flatpage melalui etiket get_flatpages.
{% load flatpages %}\n{% get_flatpages as flatpages %}\n<ul>\n {% for page in flatpages %}\n <li><a href="{{ page.url }}">{{ page.title }}</a></li>\n {% endfor %}\n</ul>\nregistration_requiredLink to this heading#Secara awalan, etiket cetakan get_flatpages akan hanya menunjukkan halaman datar yang ditandai registration_required = False. Jika anda ingin menampilkan halaman datar terlindungi-pendaftaran, anda butuh menentukan seorang pengguna terautentifikasi menggunakan klausa for.
Sebagai contoh:
\n{% get_flatpages for someuser as about_pages %}\nJika anda menyediakan pengguna anonim, get_flatpages akan berperilaku sama seperti jika anda belum menyediakan pengguna -- yaitu, itu akan hanya menampilkan flatpage umum anda.
Sebuah argumen pilihan, starts_with, dapat diberlakukan pada batasan halaman dikembalikan ke yang dimulai dengan URL dasar tertentu. Argumen ini mungkin dilewatkan sebagai sebuah string, atau sebagai sebuah variabel untuk dipecahkan dari konteks.
Sebagai contoh:
\n{% get_flatpages '/about/' as about_pages %}\n{% get_flatpages about_prefix as about_pages %}\n{% get_flatpages '/about/' for someuser as about_pages %}\ndjango.contrib.sitemapsLink to this heading#Kelas sitemaps.FlatPageSitemap mencari semua flatpages yang nampak di depan umum ditentukan untuk SITE_ID saat ini (lihat sites documentation) dan buat sebuah masukan dalam peta situs. Masukan ini termasuk hanya atribut location -- bukan lastmod, changefreq atau priority.
Ini adalah sebuah contoh dari URLconf menggunakan FlatPageSitemap:
from django.contrib.flatpages.sitemaps import FlatPageSitemap\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\n\nurlpatterns = [\n # ...\n # the sitemap\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": {"flatpages": FlatPageSitemap}},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\n