{"title":"Skriva din första Django-app, del 7","version":"5.2","locale":"sv","docname":"intro/tutorial07","url":"/sv/5.2/intro/tutorial07/","canonical":"https://djangodocs.dev/sv/5.2/intro/tutorial07/","summary":"Denna handledning börjar där Tutorial 6 slutade. Vi fortsätter med web-poll applikationen och kommer att fokusera på att anpassa Djangos automatiskt…","html":"

Skriva din första Django-app, del 7Link to this heading#

\n

Denna handledning börjar där Tutorial 6 slutade. Vi fortsätter med web-poll applikationen och kommer att fokusera på att anpassa Djangos automatiskt genererade admin-webbplats som vi först utforskade i Tutorial 2.

\n\n
\n

Anpassa administratörsformuläretLink to this heading#

\n

Genom att registrera modellen Question med admin.site.register(Question) kunde Django konstruera en standardformulärrepresentation. Ofta vill du anpassa hur adminformuläret ser ut och fungerar. Du gör detta genom att berätta för Django de alternativ du vill ha när du registrerar objektet.

\n

Låt oss se hur detta fungerar genom att omorganisera fälten i redigeringsformuläret. Ersätt raden admin.site.register(Question) med:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ["pub_date", "question_text"]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Du följer det här mönstret - skapa en modelladministratörsklass och skicka den sedan som det andra argumentet till admin.site.register() - varje gång du behöver ändra administratörsalternativen för en modell.

\n

Den här ändringen gör att ”Publiceringsdatum” kommer före fältet ”Fråga”:

\n\"Fälten\n

Detta är inte imponerande med bara två fält, men för adminformulär med dussintals fält är det en viktig användbarhetsdetalj att välja en intuitiv ordning.

\n

Och på tal om formulär med dussintals fält kanske du vill dela upp formuläret i fältuppsättningar:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None, {"fields": ["question_text"]}),\n        ("Date information", {"fields": ["pub_date"]}),\n    ]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Det första elementet i varje tupel i fieldsets är titeln på fältuppsättningen. Så här ser vårt formulär ut nu:

\n\"Formuläret\n
\n\n
\n

Anpassa ändringslistan för administratörerLink to this heading#

\n

Nu när administratörssidan för frågor ser bra ut ska vi göra några justeringar på sidan ”ändringslista” - den sida som visar alla frågor i systemet.

\n

Så här ser det ut i nuläget:

\n\"Omröstningar\n

Som standard visar Django str() för varje objekt. Men ibland skulle det vara till större hjälp om vi kunde visa enskilda fält. För att göra det använder du adminalternativet list_display, som är en lista med fältnamn som ska visas, som kolumner, på sidan med ändringslistan för objektet:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date"]\n
\n

För säkerhets skull inkluderar vi även metoden was_published_recently() från Tutorial 2:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date", "was_published_recently"]\n
\n

Nu ser sidan med frågeändringslistan ut så här:

\n\"Omröstningar\n

Du kan klicka på kolumnrubrikerna för att sortera efter dessa värden - utom när det gäller rubriken was_published_recently, eftersom det inte finns stöd för sortering efter resultatet av en godtycklig metod. Observera också att kolumnrubriken för was_published_recently som standard är namnet på metoden (med understreck ersatta med mellanslag), och att varje rad innehåller strängrepresentationen av utdata.

\n

Du kan förbättra det genom att använda display()-dekoratorn på den metoden (utöka polls/models.py-filen som skapades i Tutorial 2), enligt följande:

\n
polls/modeller.py
\n
Python
from django.contrib import admin\n\n\nclass Question(models.Model):\n    # ...\n    @admin.display(\n        boolean=True,\n        ordering="pub_date",\n        description="Published recently?",\n    )\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n
\n

För mer information om de egenskaper som kan konfigureras via dekoratorn, se list_display.

\n

Redigera filen polls/admin.py igen och lägg till en förbättring av sidan med ändringslistan Question: filter med hjälp av list_filter. Lägg till följande rad i QuestionAdmin:

\n
Code
list_filter = ["pub_date"]\n
\n

Det lägger till en ”Filter”-sidofält som låter människor filtrera ändringslistan efter fältet pub_date:

\n\"Omröstningar\n

Vilken typ av filter som visas beror på vilken typ av fält du filtrerar på. Eftersom pub_date är en DateTimeField, vet Django att ge lämpliga filteralternativ: ”Vilket datum som helst”, ”Idag”, ”De senaste 7 dagarna”, ”Den här månaden”, ”Det här året”.

\n

Det här ser bra ut. Låt oss lägga till lite sökfunktionalitet:

\n
Code
search_fields = ["question_text"]\n
\n

Det lägger till en sökruta längst upp i ändringslistan. När någon skriver in söktermer kommer Django att söka i fältet question_text. Du kan använda så många fält som du vill - men eftersom det använder en LIKE-fråga bakom kulisserna, kommer det att göra det lättare för din databas att göra sökningen genom att begränsa antalet sökfält till ett rimligt antal.

\n

Nu är det också en bra tid att notera att ändringslistor ger dig gratis paginering. Standard är att visa 100 objekt per sida. Change list pagination, search boxes, filters, date-hierarchies, och column-header-ordering fungerar alla tillsammans som du tror att de ska.

\n
\n
\n

Anpassa administratörens utseende och känslaLink to this heading#

\n

Det är uppenbart att det är löjligt att ha ”Django administration” högst upp på varje adminsida. Det är bara platshållartext.

\n

Du kan dock ändra det med hjälp av Djangos mallsystem. Django-admin drivs av Django själv och dess gränssnitt använder Djangos eget mallsystem.

\n
\n

Anpassa mallarna för ditt projektLink to this heading#

\n

Skapa en templates katalog i din djangotutorial katalog. Mallar kan finnas var som helst på ditt filsystem som Django kan komma åt. (Django körs som vilken användare som helst som din server kör.) Att hålla dina mallar inom projektet är dock en bra konvention att följa.

\n

Öppna din inställningsfil (mysite/settings.py, kom ihåg) och lägg till ett DIRS alternativ i TEMPLATES inställningen:

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        "OPTIONS": {\n            "context_processors": [\n                "django.template.context_processors.request",\n                "django.contrib.auth.context_processors.auth",\n                "django.contrib.messages.context_processors.messages",\n            ],\n        },\n    },\n]\n
\n

DIRS är en lista över filsystemkataloger som ska kontrolleras när Django-mallar laddas; det är en sökväg.

\n\n

Skapa nu en katalog som heter admin inuti templates, och kopiera mallen admin/base_site.html från standardkatalogen för Djangos adminmallar i källkoden för Django själv (django/contrib/admin/templates) till den katalogen.

\n\n

Redigera sedan filen och ersätt {{ site_header|default:_('Django administration') }} (inklusive hakparenteserna) med namnet på din egen webbplats som du tycker passar. Du bör sluta med ett avsnitt av kod som:

\n
Django template
{% block branding %}\n<div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>\n{% if user.is_anonymous %}\n  {% include "admin/color_theme_toggle.html" %}\n{% endif %}\n{% endblock %}\n
\n

Vi använder detta tillvägagångssätt för att lära dig hur du kan åsidosätta mallar. I ett verkligt projekt skulle du förmodligen använda attributet django.contrib.admin.AdminSite.site_header för att lättare göra just den här anpassningen.

\n

Den här mallfilen innehåller mycket text som {% block branding %} och {{ title }}. Taggarna {% och {{ är en del av Djangos mallspråk. När Django renderar admin/base_site.html, kommer detta mallspråk att utvärderas för att producera den slutliga HTML-sidan, precis som vi såg i Tutorial 3.

\n

Observera att alla Djangos standardmallar för administratörer kan åsidosättas. För att åsidosätta en mall gör du samma sak som du gjorde med base_site.html - kopiera den från standardkatalogen till din anpassade katalog och gör ändringar.

\n
\n
\n

Anpassa mallarna för din applikationLink to this heading#

\n

Smarta läsare kommer att fråga: Men om DIRS var tom som standard, hur hittade Django standardmallarna för admin? Svaret är att, eftersom APP_DIRS är inställd på True, letar Django automatiskt efter en templates/ underkatalog inom varje applikationspaket, för användning som en fallback (glöm inte att django.contrib.admin är en applikation).

\n

Vår poll-applikation är inte särskilt komplex och behöver inte anpassade admin-mallar. Men om det blir mer sofistikerat och kräver modifiering av Djangos standardadministratörsmallar för vissa av dess funktioner, skulle det vara mer förnuftigt att modifiera applikationens mallar, snarare än de i projektet. På så sätt kan du inkludera pollsapplikationen i alla nya projekt och vara säker på att den hittar de anpassade mallar den behöver.

\n

Se dokumentation för laddning av mallar för mer information om hur Django hittar sina mallar.

\n
\n
\n
\n

Anpassa indexsidan för administratörerLink to this heading#

\n

På ett liknande sätt kanske du vill anpassa utseendet på Django-administratörens indexsida.

\n

Som standard visas alla appar i INSTALLED_APPS som har registrerats i adminprogrammet i alfabetisk ordning. Du kanske vill göra betydande ändringar i layouten. När allt kommer omkring är indexet förmodligen den viktigaste sidan i admin, och den bör vara lätt att använda.

\n

Den mall som ska anpassas är admin/index.html. (Gör samma sak som med admin/base_site.html i föregående avsnitt - kopiera den från standardkatalogen till din anpassade mallkatalog). Redigera filen och du kommer att se att den använder en mallvariabel som heter app_list. Den variabeln innehåller alla installerade Django-appar. Istället för att använda den kan du hårdkoda länkar till objektspecifika adminsidor på det sätt som du tycker är bäst.

\n

När du känner dig bekväm med administratören kan du läsa del 8 av denna handledning för att lära dig hur du använder tredjepartspaket.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Anpassa administratörsformuläret","anchor":"customize-the-admin-form","children":[]},{"title":"Lägga till relaterade objekt","anchor":"adding-related-objects","children":[]},{"title":"Anpassa ändringslistan för administratörer","anchor":"customize-the-admin-change-list","children":[]},{"title":"Anpassa administratörens utseende och känsla","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Anpassa mallarna för ditt projekt","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Anpassa mallarna för din applikation","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Anpassa indexsidan för administratörer","anchor":"customize-the-admin-index-page","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Kom igång","url":"/sv/5.2/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Skriva din första Django-app, del 6","url":"/sv/5.2/intro/tutorial06/"},"next":{"docname":"intro/tutorial08","title":"Skriva din första Django-app, del 8","url":"/sv/5.2/intro/tutorial08/"},"formats":{"html":"/sv/5.2/intro/tutorial07/","markdown":"/sv/5.2/intro/tutorial07.md","json":"/sv/5.2/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/sv/5.2/intro/tutorial07/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}