Personalizzare il modulo di amministrazione¶

Registrando il modello Question con admin.site.register(Question), Django è stato in grado di costruire un form di default. Spesso, vorrai personalizzare il modo in cui il form di amministrazione appare e funziona. Lo farai dicendo a Django quali opzioni vuoi quando registrerai l’oggetto.

Vediamo come funziona riordinando i campi nel modulo di modifica. Sostituisci la riga admin.site.register(Question) con:

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fields = ["pub_date", "question_text"]


admin.site.register(Question, QuestionAdmin)

Seguirai questo pattern – crea una classe del modello di amministrazione, poi passala come secondo argomento a admin.site.register() – ogni volta che vuoi cambiare le opzioni nel panello di amministrazione del modello.

Questa particolare modifica qui sopra fa sì che la «Data di pubblicazione» venga prima del campo «Domanda»:

Questo non è impressionante con solo due campi, ma per i moduli di amministrazione con dozzine di campi, la scelta di un ordine intuitivo è un dettaglio importante per l’usabilità.

E parlando di moduli con dozzine di campi, potresti voler dividere il modulo in gruppi di campi:

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None, {"fields": ["question_text"]}),
        ("Date information", {"fields": ["pub_date"]}),
    ]


admin.site.register(Question, QuestionAdmin)

Il primo elemento di ogni tupla in fieldsets è il titolo del fieldset. Ecco come il nostro form appare adesso:

Aggiunta di oggetti correlati¶

OK, abbiamo la nostra pagina di amministrazione del modello Question, ma una Question ha più Choice, e il pannello di amministrazione non mostra le scelte.

Ancora.

Esistono due modi per risolvere questo problema. Il primo è registrare Scelta nell’amministrazione proprio come abbiamo fatto con Domanda:

from django.contrib import admin

from .models import Choice, Question

# ...
admin.site.register(Choice)

Ora «Scelte» è un’opzione disponibile nell’amministrazione di Django. Il modulo «Aggiungi scelta» ha questo aspetto:

In quel form, il campo «Question» è un menu a tendina contenente tutte le domande nel database. Django sa che una ForeignKey dovrebbe essere rappresentata nell’admin come una <select>. Nel nostro caso, esiste solo una domanda a questo punto.

Nota anche il link «Aggiungi un’altra domanda» vicino a «Domanda.» Ogni oggetto con una relazione di ForeignKey lo ottiene gratis. Quando farai click su «Aggiungi un’altra domanda», vedrai una finestra di popup con il form «Aggiungi domanda». Se aggiungi una domanda in quella finestra e fai click su «Salva», Django salverà la richiesta sul database e la aggiungerà come scelta selezionata nel form «Aggiungi scelta» che stai guardando.

Ma, onestamente, questo è un modo inefficiente di aggiungere oggetti Choice al sistema. Sarebbe meglio se potessi aggiungere un gruppo di Choices direttamente quando crei l’oggetto Question. Facciamolo.

Rimuovere la chiamata register() per il modello Scelta. Quindi, modifica il codice di registrazione Domanda per leggere:

from django.contrib import admin

from .models import Choice, Question


class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None, {"fields": ["question_text"]}),
        ("Date information", {"fields": ["pub_date"], "classes": ["collapse"]}),
    ]
    inlines = [ChoiceInline]


admin.site.register(Question, QuestionAdmin)

Questo dice a Django: gli oggetti «Choice sono modificati nella pagina di amministrazione del modello Question. Di default, fornisce abbastanza campi per 3 scelte.

Carica la pagina «Aggiungi domanda» per vedere come appare:

Funziona in questo modo: Ci sono tre slot per le relative Choices – come specificato dall” extra – e ogni volta torni alla pagina «Change» per un oggetto che è stato già creato, tu vedi altri ricevi slot.

Alla fine dei tre slot, troverai un link «Aggiungi un’altra Choice». Se ci clicchi, un nuovo slot viene aggiunto. Se vuoi rimuovere uno slot aggiunto, puoi cliccare sulla X in alto a destra dello slot aggiunto. Questa immagine mostra lo slot aggiunto:

Un piccolo problema. Occupa molto spazio dello schermo mostrare tutti i campi per inserire i relativi oggetti Choice. Per questo motivo, Django offre un modo tabellare per mostrare i relativi oggetti inline. Per usarlo, cambia la dichiarazione ChoiceInline per leggere:

class ChoiceInline(admin.TabularInline): ...

Con questa TabularInline (invece di StackedInline), gli oggetti relativi vengono mostrati in un modo più compatto, in un formato tabellare:

Nota che è presente una ulteriore colonna «Cancellare?» che permette di rimuovere le righe aggiunte con il pulsante «Aggiungi un’altra scelta» e le righe che sono già state salvate.

Personalizzazione della lista per la modifica dell’interfaccia di amministrazione¶

Ora che la pagina di amministrazione del modello Question sembra buona, facciamo qualche modifica alla pagina di «change list» – quella che mostra tutte le domande nel sistema.

Ecco come appare a questo punto:

By default, Django displays the str() of each object. But sometimes it’d be more helpful if we could display individual fields. To do that, use the list_display admin option, which is a list of field names to display, as columns, on the change list page for the object:

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date"]

Di buona norma, aggiungiamo il metodo was_published_recently() da Tutorial 2:

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date", "was_published_recently"]

Ora la pagina di elenco delle domande ha questo aspetto:

Puoi fare click sull’intestazione delle colonne per ordinare quei valori – eccetto nel caso di was_published_recently perchè l’ordinamento dell’output di un metodo non è supportato. Nota anche che l’intestazione di colonna per was_published_recently è, di default, il nome del metodo (con gli underscore a rimpiazzare gli spazi), e che ogni linea contiene la rappresentazione in stringa dell’oggetto.

You can improve that by using the display() decorator on that method (extending the polls/models.py file that was created in Tutorial 2), as follows:

from django.contrib import admin


class Question(models.Model):
    # ...
    @admin.display(
        boolean=True,
        ordering="pub_date",
        description="Published recently?",
    )
    def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <= now

Per più informazioni sulle proprietà configurabili attraverso il decoratore, vedi list_display.

Modifica nuovamente il tuo file polls/admin.py e aggiungi un miglioramento alla pagina dell’elenco di modifiche Domanda: i filtri usando list_filter. Aggiungi la seguente riga in QuestionAdmin:

list_filter = ["pub_date"]

Questo aggiunge una sidebar «Filtra» che permette all’utente di filtrare la lista per il campo pub_date:

Il tipo di filtro visualizzato dipende dal tipo di campo su cui stai filtrando. Poiché pub_date è un DateTimeField, Django sa fornire le opzioni di filtro appropriate: «Qualsiasi data», «Oggi», «Ultimi 7 giorni», «Questo mese», «Quest’anno».

Sta venendo su bene. Aggiungiamo alcune funzionalità di ricerca:

search_fields = ["question_text"]

Ciò aggiunge una casella di ricerca all’inizio dell’elenco delle modifiche. Quando qualcuno inserisce i termini di ricerca, Django cercherà nel campo question_text. Puoi utilizzare tutti i campi che desideri – anche se poiché utilizza una query LIKE dietro le quinte, limitare il numero di campi di ricerca a un numero ragionevole renderà più facile per il tuo database fare la ricerca.

Adesso è anche un buon momento per notare che le liste dei cambiamenti ti danno la paginazione gratis. Di default, mostra 100 elementi per pagina. Change list pagination, search boxes, filters, date-hierarchies, e column-header-ordering lavorano tutti assieme come pensi che dovrebbero.

Personalizza l’aspetto dell’amministrazione¶

Chiaramente, avere «Django administration» nella parte superiore di ogni pagina di amministrazione è ridicolo. È solo testo segnaposto.

Puoi comunque cambiarlo, usando il sistema di template di Django. L’admin di Django è costruita su Django stesso, e dunque le sue interfacce usano il sistema di template di Django.

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [BASE_DIR / "templates"],
        "APP_DIRS": True,
        "OPTIONS": {
            "context_processors": [
                "django.template.context_processors.debug",
                "django.template.context_processors.request",
                "django.contrib.auth.context_processors.auth",
                "django.contrib.messages.context_processors.messages",
            ],
        },
    },
]

$ python -c "import django; print(django.__path__)"

...\> py -c "import django; print(django.__path__)"

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

Personalizza l’indice dell’amministrazione¶

In modo simile, potresti voler personalizzare l’aspetto della pagina dell’indice di amministrazione di Django.

Di default, mostra tutte le app in INSTALLED_APPS che sono state registrate con l’applicazione di admin, in ordine alfabetico. Potresti voler apportare modifiche significative al layout. Dopotutto, l’indice è probabilmente la pagina più importante dell’amministratore e dovrebbe essere facile da usare.

Il modello da personalizzare è admin/index.html. (Fai lo stesso di admin/base_site.html nella sezione precedente – copialo dalla directory predefinita alla directory del tuo modello personalizzato). Modifica il file e vedrai che utilizza una variabile di modello chiamata app_list. Quella variabile contiene tutte le app Django installate. Invece di usarlo, puoi codificare link a pagine di amministrazione specifiche degli oggetti nel modo che ritieni migliore.

When you’re comfortable with the admin, read part 8 of this tutorial to learn how to use third-party packages.