Aplikasi flatpageLink to this heading#

Menggunakan URLconfLink to this heading#

Ada beberapa cara untuk menyertakan halaman-halaman datar dalam URLconf anda. Anda dapat mengamanatkan jalur tertentu pada halaman-halaman datar:

urlpatterns = [
    path('pages/', include('django.contrib.flatpages.urls')),
]

Anda dapat juga menyetel itu sebagai sebuah pola "catchall". Dalam kasus ini, itu adalah penting menempatkan pola pada akhir dari urlpattern lain:

from django.contrib.flatpages import views

# Your other patterns here
urlpatterns += [
    path('<path:url>', views.flatpage),
]

Pengaturan lain umum adalah menggunakan halaman-halaman datar untuk kumpulan terbatas dari halaman-halaman yang dikenal dan kode keras url, jadi anda dapat mengacu mereka dengan etiket cetakan url:

from django.contrib.flatpages import views

urlpatterns += [
    path('about-us/', views.flatpage, {'url': '/about-us/'}, name='about'),
    path('license/', views.flatpage, {'url': '/license/'}, name='license'),
]

Menggunakan middlewareLink to this heading#

FlatpageFallbackMiddleware dapat melakukan semua dari pekerjaan.

class FlatpageFallbackMiddlewareLink to this definition#

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:

• Jika 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.

Middleware hanya dapat diaktifasikan untuk 404 -- bukan untuk 500 atau tanggapan kode keadaan apapun lainnya.

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

Melalui antarmuka adminLink to this heading#

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

Model 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
from django.contrib.flatpages.admin import FlatPageAdmin
from django.contrib.flatpages.models import FlatPage
from django.utils.translation import gettext_lazy as _

# Define a new FlatPageAdmin
class FlatPageAdmin(FlatPageAdmin):
    fieldsets = (
        (None, {'fields': ('url', 'title', 'content', 'sites')}),
        (_('Advanced options'), {
            'classes': ('collapse',),
            'fields': (
                'enable_comments',
                'registration_required',
                'template_name',
            ),
        }),
    )

# Re-register FlatPageAdmin
admin.site.unregister(FlatPage)
admin.site.register(FlatPage, FlatPageAdmin)

Melalui API PythonLink to this heading#

class FlatPageLink to this definition#

Flatpage diwakilkan oleh sebuah standar Django model, yang berada dalam django/contrib/flatpages/models.py. Anda dapat mengakses obyek flatpage melalui Django database API.

Menampilkan flatpage registration_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:

{% get_flatpages for someuser as about_pages %}

Jika anda menyediakan pengguna anonim, get_flatpages akan berperilaku sama seperti jika anda belum menyediakan pengguna -- yaitu, itu akan hanya menampilkan flatpage umum anda.

Membatasi flatpage dengan URL dasarLink to this heading#

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:

{% get_flatpages '/about/' as about_pages %}
{% get_flatpages about_prefix as about_pages %}
{% get_flatpages '/about/' for someuser as about_pages %}

ContohLink to this heading#

Ini adalah sebuah contoh dari URLconf menggunakan FlatPageSitemap:

from django.contrib.flatpages.sitemaps import FlatPageSitemap
from django.contrib.sitemaps.views import sitemap
from django.urls import path

urlpatterns = [
    # ...

    # the sitemap
    path('sitemap.xml', sitemap,
        {'sitemaps': {'flatpages': FlatPageSitemap}},
        name='django.contrib.sitemaps.views.sitemap'),
]