Django levereras med en valfri ”flatpages”-applikation. Den låter dig lagra ”platt” HTML-innehåll i en databas och hanterar hanteringen åt dig via Djangos admin-gränssnitt och ett Python API.
\nEn flatpage är ett objekt med en URL, en titel och ett innehåll. Använd den för enstaka sidor i specialfall, t.ex. sidor med ”Om” eller ”Sekretesspolicy”, som du vill lagra i en databas men som du inte vill utveckla en anpassad Django-applikation för.
\nEn flatpage kan använda en anpassad mall eller en standardmall för flatpage som gäller för hela systemet. Den kan vara kopplad till en eller flera webbplatser.
\nInnehållsfältet kan eventuellt lämnas tomt om du föredrar att lägga ditt innehåll i en anpassad mall.
\nFölj dessa steg för att installera Flatpages-appen:
\nInstallera sites-ramverket genom att lägga till 'django.contrib.sites' i din INSTALLED_APPS-inställning, om det inte redan finns där.
Kontrollera också att du har ställt in SITE_ID till ID:t för den webbplats som inställningsfilen representerar. Detta är vanligtvis 1 (dvs. SITE_ID = 1), men om du använder sites-ramverket för att hantera flera webbplatser kan det vara ID:t för en annan webbplats.
Lägg till 'django.contrib.flatpages' till din INSTALLED_APPS inställning.
Då antingen..:
\nLägg till en post i din URLconf. Till exempel:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\neller:
\nLägg till 'django.contrib.flatpages.middleware.FlatpageFallbackMiddleware' till din MIDDLEWARE inställning.
Kör kommandot manage.py migrate.
manage.py migrate skapar två tabeller i din databas: django_flatpage och django_flatpage_sites. django_flatpage är en uppslagstabell som mappar en URL till en titel och en massa textinnehåll. django_flatpage_sites associerar en flatpage med en webbplats.
Det finns flera sätt att inkludera de platta sidorna i din URLconf. Du kan ägna en särskild sökväg åt platta sidor:
\nurlpatterns = [\n path("pages/", include("django.contrib.flatpages.urls")),\n]\nDu kan också använda det som ett ”catchall”-mönster. I det här fallet är det viktigt att placera mönstret i slutet av de andra urlmönstren:
\nfrom django.contrib.flatpages import views\n\n# Your other patterns here\nurlpatterns += [\n re_path(r"^(?P<url>.*/)$", views.flatpage),\n]\nEn annan vanlig inställning är att använda platta sidor för en begränsad uppsättning kända sidor och att hårdkoda deras webbadresser i 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]\nArgumentet kwargs anger det url-värde som används för modelluppslagningen FlatPage i flatpage-vyn.
Argumentet name gör att URL:en kan vändas i mallar, t.ex. med hjälp av malltaggen url.
Klassen:~django.contrib.flatpages.middleware.FlatpageFallbackMiddleware kan göra allt arbete.
\nVarje gång en Django-applikation ger upphov till ett 404-fel kontrollerar detta middleware flatpages-databasen för den begärda webbadressen som en sista utväg. Specifikt kontrolleras om det finns en flatpage med den angivna URL:en med ett webbplats-ID som motsvarar inställningen SITE_ID.
Om den hittar en matchning följer den den här algoritmen:
\nOm sidan har en egen mall laddas den mallen. Annars laddas mallen flatpages/default.html.
Den skickar den mallen en enda kontextvariabel, flatpage, som är flatpage-objektet. Den använder RequestContext vid rendering av mallen.
Mellanvaran lägger bara till ett efterföljande snedstreck och omdirigerar (genom att titta på inställningen APPEND_SLASH) om den resulterande URL:en hänvisar till en giltig flatpage. Omdirigeringar är permanenta (301 statuskod).
Om den inte hittar någon matchning fortsätter begäran att behandlas som vanligt.
\nMiddleware aktiveras endast för 404:or - inte för 500:or eller svar med någon annan statuskod.
\nObservera att ordningen på MIDDLEWARE spelar roll. I allmänhet kan du sätta FlatpageFallbackMiddleware i slutet av listan. Detta innebär att det kommer att köras först när svaret bearbetas och säkerställer att alla andra svarsbearbetande mellanprogram ser det riktiga flatpage-svaret snarare än 404.
Mer information om middleware finns i middleware docs.
\n\nOm du har aktiverat det automatiska Django-administratörsgränssnittet bör du se ett ”Flatpages”-avsnitt på adminindexsidan. Redigera flatpages som du redigerar alla andra objekt i systemet.
\nModellen FlatPage har ett fält enable_comments som inte används av contrib.flatpages, men som kan vara användbart för ditt projekt eller tredjepartsappar. Det visas inte i admin-gränssnittet, men du kan lägga till det genom att registrera en anpassad ModelAdmin för 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 representeras av en standard Django model, FlatPage. Du kan komma åt flatpage-objekt via Django database API.
FlatPage modellLink to this heading#FlatPage-objekt har följande fält:
Krävs. 100 tecken eller färre. Indexerad för snabbare sökningar.
\nKrävs. 200 tecken eller färre.
\nValfritt (blank=True). TextField som vanligtvis innehåller HTML-innehållet på sidan.
Boolesk. Detta fält används inte av flatpages som standard och visas inte i admin-gränssnittet. Se flatpages admin interface section för en detaljerad förklaring.
Valfritt (blank=True). 70 tecken eller färre. Anger den mall som används för att rendera sidan. Standardvärdet är flatpages/default.html om den inte anges.
Många-till-många-relation till Site, som bestämmer sites som den platta sidan är tillgänglig på.
Returnerar den relativa URL-sökvägen för sidan baserat på attributet url.
Som standard återges flatpages via mallen flatpages/default.html, men du kan åsidosätta detta för en viss flatpage: i admin finns ett kollapsat fält med titeln ”Advanced options” (klicka på det för att expandera det) som innehåller ett fält för att ange ett mallnamn. Om du skapar en platt sida via Python API kan du ange mallnamnet som fältet template_name på objektet FlatPage.
Det är ditt ansvar att skapa mallen flatpages/default.html; i din mallkatalog skapar du en katalog flatpages som innehåller filen default.html.
Flatpage-mallar får en enda kontextvariabel, flatpage, som är flatpage-objektet.
Här är ett exempel på en flatpages/default.html mall:
<!DOCTYPE html>\n<html lang="en">\n<head>\n<title>{{ flatpage.title }}</title>\n</head>\n<body>\n{{ flatpage.content }}\n</body>\n</html>\nEftersom du redan skriver in rå HTML på adminsidan för en flatpage, markeras både flatpage.title och flatpage.content som inte krävande automatisk HTML-escaping i mallen.
FlatPage-objekt i dina mallarLink to this heading#Appen Flatpages tillhandahåller en malltagg som gör att du kan iterera över alla tillgängliga flatpages på aktuell webbplats.
\nSom alla anpassade malltaggar måste du ladda dess anpassade taggbibliotek innan du kan använda den. När du har laddat biblioteket kan du hämta alla aktuella flatpages via taggen 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_required flatpagesLink to this heading#Som standard visar malltaggen get_flatpages endast flatpages som är markerade med registration_required = False. Om du vill visa registreringsskyddade flatpages måste du ange en autentiserad användare med hjälp av en for-klausul.
Till exempel:
\n{% get_flatpages for someuser as about_pages %}\nOm du anger en anonym användare kommer get_flatpages att bete sig på samma sätt som om du inte hade angett någon användare - dvs. den kommer bara att visa dig offentliga flatpages.
Ett valfritt argument, starts_with, kan användas för att begränsa de returnerade sidorna till dem som börjar med en viss bas-URL. Detta argument kan skickas som en sträng eller som en variabel som ska lösas upp från kontexten.
Till exempel:
\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#Klassen sitemaps.FlatPageSitemap tittar på alla offentligt synliga flatpages som definieras för den aktuella SITE_ID (se sites-dokumentationen) och skapar en post i webbplatskartan. Dessa poster inkluderar endast attributet location – inte lastmod, changefreq eller priority.
Här är ett exempel på en URLconf som använder 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