Tagann Django le feidhmchlár roghnach “flatpages”. Ligeann sé duit ábhar HTML “comhréidh” a stóráil i mbunachar sonraí agus láimhseálann sé an bhainistíocht duit trí chomhéadan riaracháin Django agus API Python.
\nIs réad é leathanach cothrom le URL, teideal agus ábhar. Úsáid é le haghaidh leathanaigh aonuaire, cásanna speisialta, mar shampla leathanaigh “Maidir” nó “Beartas Príobháideachta”, ar mhaith leat a stóráil i mbunachar sonraí ach nach dteastaíonn uait feidhmchlár saincheaptha Django a fhorbairt dóibh.
\nIs féidir le leathanach cothrom teimpléad saincheaptha nó teimpléad réamhshocraithe ar fud an chórais a úsáid. Is féidir leis a bheith bainteach le suíomh amháin, nó iolracha.
\nFéadfar an réimse ábhair a fhágáil bán go roghnach más fearr leat d'ábhar a chur i dteimpléad saincheaptha.
\nChun an aip flatpages a shuiteáil, lean na céimeanna seo:
\nSuiteáil an creat:mod: sites `trí ``<django.contrib.sites>django.contrib.sites' a chur le do shuíomh: INSTALLED_APPS, mura bhfuil sé ann cheana féin.
\nAlso 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.
Cuir ``django.contrib.flatpages'` le do shocrú: INSTALLED_APPS.
Ansin ceachtar:
\nCuir iontráil isteach i do URLConf. Mar shampla:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\nnó:
\n\nCruthaíonn manage.py migrate dhá thábla i do bhunachar sonraí: django_flatpage agus django_flatpage_sites. Is tábla cuardaigh é django_flatpage a mhéapálann URL chuig teideal agus dornán ábhar téacs. Comhcheanglaíonn django_flatpage_sites leathanach cothrom le suíomh.
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]\nIs 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:
\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.
Is féidir leis an:class: ~django.contrib.flatpages.middleware.flatpageFallbackmiddleware an obair go léir a dhéanamh.
\nGach 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.
\nMá aimsíonn sé meaitseáil, leanann sé an algartam seo:
\nMá 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).
\nMura bhfaigheann sé meaitseáil, leanann an t-iarratas á phróiseáil mar is gnách.
\nNí ghníomhaítear an middleware ach ar feadh 404s - ní le haghaidh 500s nó freagraí ar aon chód stádais eile.
\nTabhair 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.
\nLe haghaidh tuilleadh eolais faoi middleware, léigh an:doc: middle</topics/http/middleware> ware docs.
\n\nMá 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.
\nTá 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\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.
Tá freagracht ort an teimpléad:file: flatpages/default.html a chruthú; i d'eolaire teimpléad, cruthaigh eolaire a:file: flatpages ina bhfuil comhad:file: default.html.
\nCuirtear athróg comhthéacs amháin ar theimpléid flatpage, flatpage`, arb é an réad flatpage.
\nSeo sampla: comhad: teimpléad flatpages/default.html:
\n<!DOCTYPE html>\n<html lang="en">\n<head>\n<title>{{ flatpage.title }}</title>\n</head>\n<body>\n{{ flatpage.content }}\n</body>\n</html>\n<automatic-html-escaping>Ós rud é go bhfuil HTML amh á iontráil agat cheana féin sa leathanach riaracháin le haghaidh leathanach cothrom, marcáiltear flatpage.title agus flatpage.content` araon mar not ag iarraidh:ref: `uathoibríoch HTML éalú `sa teimpléad.
<hooking-into-current-site-from-views>Soláthraíonn an aip flatpages clib teimpléad a ligeann duit athrá a dhéanamh thar na leathanaigh cothroma go léir atá ar fáil ar:ref: `láithreán reatha `.
\nCosúil le gach clib teimpléad saincheaptha, beidh ort: ref: a leabharlann clibeanna saincheaptha a luchtú sula bhfé <loading-custom-template-libraries>adfaidh tú é a úsáid. Tar éis duit an leabharlann a luchtú, is féidir leat gach leathanach cothrom reatha a aisghabháil tríd an gclibe:ttag: `get_flatpages:
\n{% 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>\nclá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:
\n{% get_flatpages for someuser as about_pages %}\nMá 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.
\nIs 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.
\nMar shampla:
\n{% get_flatpages '/about/' as about_pages %}\n{% get_flatpages about_prefix as about_pages %}\n{% get_flatpages '/about/' for someuser as about_pages %}\n<django.contrib.sites>Breathnaíonn an rang:class: SiteMaps.flatPageSitemap <django.contrib.flatpages.sitemaps.FlatPageSitemap>`ar gach ceann atá le feiceáil go poibl:mod: `~django.contrib.flatpages atá sainmhínithe don reath:setting: SITE_ID (féach an doiciméadú: mod: sites) agus cruthaíonn sé iontráil sa léarscáil. Ní áirítear ar na hiontrálacha seo ach an tréith: attr: ~django.contrib.sitemaps.sitemap.location -- not:attr: ~django.contrib.sitemaps.sitemap.lastmod, :attr: ~django.contrib.sitemaps.sitemap.changeFreq nó:attr: ~django.contrib.sitemaps.sitemap.changeFreq .contrib.sitemaps.sitemap.priority`.
\nSeo sampla de URLConf ag baint úsáid:class: FlatPageSitemap:
\nfrom 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