An aip flatpagesLink to this heading#

Ag baint úsáide as an URLConfLink to this heading#

There are several ways to include the flatpages in your URLconf. You can dedicate a particular path to flatpages:

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

Is féidir leat é a chur ar bun mar phatrún “catchall” freisin. Sa chás seo, tá sé tábhachtach an patrún a chur ag deireadh na urlpattern eile:

from django.contrib.flatpages import views

# Your other patterns here
urlpatterns += [
    re_path(r"^(?P<url>.*/)$", views.flatpage),
]

Another common setup is to use flatpages for a limited set of known pages and to hardcode their URLs in the URLconf:

from django.contrib.flatpages import views

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

The kwargs argument sets the url value used for the FlatPage model lookup in the flatpage view.

The name argument allows the URL to be reversed in templates, for example using the url template tag.

Ag baint úsáide as an middlewareLink to this heading#

Is féidir leis an:class: ~django.contrib.flatpages.middleware.flatpageFallbackmiddleware an obair go léir a dhéanamh.

class FlatpageFallbackMiddlewareLink to this definition#

Gach uair a ardaíonn aon fheidhmchlár Django earráid 404, seiceálann an middleware seo bunachar sonraí na flatpages don URL iarrtha mar rogha dheiridh. Go sonrach, seiceálann sé leathanach comhréidh leis an URL tugtha le ID láithreáin a fhreagraíonn don socrú: setting: SITE_ID.

Má aimsíonn sé meaitseáil, leanann sé an algartam seo:

• Má tá teimpléad saincheaptha ag an flatpage, luchtaíonn sé an teimpléad sin. Seachas sin, luchtaíonn sé an teimpléad:file: flatpages/default.html.

• Cuireann sé athróg comhthéacs aonair ar an teimpléad sin, flatpage`, arb é an réad leathanaigh réidh. Úsáideann sé: aicme: ~django.template.requestContext chun an teimpléad a rindreáil.

Ní chuirfidh an middleware slasc agus atreorú (trí fhéachaint ar an socrú: “APPEND_SLASH`”) má thagraíonn an URL mar thoradh air do leathanach comhréidh bailí. Tá athreoruithe buan (cód stádais 301).

Mura bhfaigheann sé meaitseáil, leanann an t-iarratas á phróiseáil mar is gnách.

Ní ghníomhaítear an middleware ach ar feadh 404s - ní le haghaidh 500s nó freagraí ar aon chód stádais eile.

Tabhair faoi deara go bhfuil tábhacht ag ordú:setting: MIDDLEWARE. Go ginearálta, is féidir leat: class: ~django.contrib.flatpages.middleware.flatpageFallBackMiddleware a chur ag deireadh an liosta. Ciallaíonn sé seo go rithfidh sé ar dtús agus an freagra á bpróiseáil, agus cinntíonn sé go bhfeiceann aon mheánearraí próiseála freagartha eile an fíor-fhreagairt leathanaigh réidh seachas an 404.

Le haghaidh tuilleadh eolais faoi middleware, léigh an:doc: middle</topics/http/middleware> ware docs.

Tríd an gcomhéadan riaracháinLink to this heading#

Má tá an comhéadan riaracháin Django uathoibríoch curtha i ngníomh agat, ba chóir duit rannán “Flatpages” a fheiceáil ar an leathanach innéacs riaracháin. Cuir leathanaigh cothrom in eagar agus tú in eagar aon rud eile sa chóras.

Tá réimse enable_comments sa tsamhail flatpage nach n-úsáideann contrib.flatpages`, ach d'fhéadfadh sé sin a bheith úsáideach do do thionscadal nó d'aipeanna tríú páirtí. Níl sé le feiceáil sa chomhéadan riaracháin, ach is féidir leat é a chur leis trí “ModelAdmin” saincheaptha a chlárú le haghaidh 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)

Trí API PythonLink to this heading#

Flatpages are represented by a standard Django model, FlatPage. You can access flatpage objects via the Django database API.

RéimsíLink to this heading#

FlatPage objects have the following fields:

class models.FlatPage

urlLink to this definition#

Required. 100 characters or fewer. Indexed for faster lookups.

titleLink to this definition#

Required. 200 characters or fewer.

contentLink to this definition#

Optional (blank=True). TextField that typically, contains the HTML content of the page.

enable_commentsLink to this definition#

Boolean. This field is not used by flatpages by default and does not appear in the admin interface. Please see flatpages admin interface section for a detailed explanation.

template_nameLink to this definition#

Optional (blank=True). 70 characters or fewer. Specifies the template used to render the page. Defaults to flatpages/default.html if not provided.

sitesLink to this definition#

Many-to-many relationship to Site, which determines the sites the flatpage is available on.

ModhannaLink to this heading#

class models.FlatPage

get_absolute_url()Link to this definition#

Returns the relative URL path of the page based on the url attribute.

Ag taispeáint leathanaigh árasán clárúcháin_riachtanaLink to this heading#

De réir réamhshocraithe, ní thaispeánfaidh an clib teimpléad:ttag: get_flatpages ach leathanaigh chomhpháirteanna atá marcáilte registration_required = False. Más mian leat leathanaigh árasaithe atá cosanta ó chlárú a thaispeáint, ní mór duit úsáideoir fíordheimhnithe a shonrú ag baint úsáide as clásal for`.

Mar shampla:

{% get_flatpages for someuser as about_pages %}

Má sholáthraíonn tú úsáideoir gan ainm, iompróidh :ttag: get_flatpages mar an gcéanna is dá mbeadh úsáideoir curtha ar fáil agat - ie, ní thaispeánfaidh sé ach leathanaigh árasán poiblí duit.

Leathanaigh réidh a theorannú de réir URL bonnLink to this heading#

Is féidir argóint roghnach, starts_with, a chur i bhfeidhm chun na leathanaigh a chuirtear ar ais a theorannú dóibh siúd a thosaíonn le URL bonn áirithe. Féadfar an argóint seo a rith mar shreang, nó mar athróg le réiteach ón gcomhthéacs.

Mar shampla:

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

SamplaLink to this heading#

Seo sampla de URLConf ag baint úsáid:class: 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",
    ),
]