polls/models.py

class Question(models.Model):
    class Meta:
        verbose_name = 'Question'
        verbose_name_plural = 'Forme multiple de question'

    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    def __str__(self):
        return self.question_text

Assurez-vous que "Questions" et "Questions" sont remplacés par "questions" et "questions plurielles".

Personnalisez la commande

Par défaut, l'ordre d'enregistrement est décroissant (les plus récents apparaissent), mais modifions cela pour qu'il soit arrangé à partir du plus récent à la date de publication (pub_date).

Les changements sont définis dans la propriété ʻorderingde la classe Meta du modèle. La valeur du paramètre est le nom du champ, et si vous souhaitez l'utiliser dans l'ordre décroissant, ajoutez-` au début.

class Question(models.Model):
    class Meta:
        verbose_name = 'Question'
        verbose_name_plural = 'Forme multiple de question'
        ordering = ['-pub_date']

    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    def __str__(self):
        return self.question_text

Commencez par organiser dans l'ordre du contenu des questions, et si elles sont identiques, si vous souhaitez organiser dans l'ordre décroissant de la date de publication ordering = ['question_text', '-pubdate'] Écrivez comme suit. Veuillez vérifier qu'ils sont réellement réorganisés.

--

Il est également possible de personnaliser le formulaire lui-même lors de l'ajout. (J'expliquerai dans la section suivante ci-dessous) Dans le didacticiel d'origine, lors de l'ajout d'un objet Question après cela J'explique comment changer la conception du formulaire, mais je vais omettre l'explication cette fois. Si vous êtes intéressé, veuillez consulter le tutoriel du chef de famille. https://docs.djangoproject.com/en/1.8/intro/tutorial02/#customize-the-admin-form

Objets avec relation

Documents → https://docs.djangoproject.com/en/1.8/intro/tutorial02/#adding-related-objects (Expliqué depuis le milieu avec ʻAjout d'un élément en ligne``) Source → 35ec2c6 → 84f1086

Nous ajouterons un autre modèle, Choice, dont dispose l'application de sondage. Ce modèle a une clé étrangère (relation avec le modèle Question), à quoi ressemblera-t-il?

Tout d'abord, éditez polls / admin.py et ajoutez Choice pour l'afficher dans admin.

polls/admin.py

from django.contrib import admin

from .models import Question
from .models import Choice  #Ajouter ici


admin.site.register(Question)
admin.site.register(Choice)  #Ajouter ici

Il semble qu'il a été ajouté en toute sécurité. Le modèle Choice n'a pas de paramètres Meta, il sort donc tel quel. Ensuite, nous examinerons l'écran supplémentaire.

Dans le cas du champ ForeignKey, il est affiché sous forme de liste de sélection dans le formulaire comme celui-ci. Vous pouvez également créer un nouvel objet Question en appuyant sur le bouton vert plus sur le côté droit.

Le contenu est comme ça, et l'objet du modèle Question créé précédemment est inclus. Si vous n'avez pas défini __str__, les trois seront affichés comme Objet Question et vous serez triste. Bien sûr, vous pouvez personnaliser librement ce que vous souhaitez offrir à cette option. L'ordre est trié par «ordre» défini dans la classe Meta du modèle.

Personnalisation du modèle pour le site d'administration

De cette façon, simplement enregistrer le modèle avec la fonction ʻadmin.site.register` fera diverses choses automatiquement, mais Avec une petite modification, vous pouvez personnaliser le contenu du formulaire, afficher la liste, ajouter des éléments de recherche, etc.

Lors de la personnalisation, passez la classe qui décrit le comportement sur le site Admin au deuxième argument de la fonction ʻadmin.site.reigster. Cette classe hérite de la classe ʻadmin.ModelAdmin et ne remplace que les parties nécessaires par vous-même. Comme il est difficile de comprendre s'il ne s'agit que de phrases, nous montrerons en fait des exemples de chaque personnalisation.

Ajouter un élément en ligne

Documents → https://docs.djangoproject.com/en/1.8/intro/tutorial02/#adding-related-objects Source → 84f1086 → ʻe4bacf7`

Dans les exemples jusqu'à présent, si vous souhaitez ajouter des questions et des choix, créez d'abord la question d'origine, puis J'ai dû le sélectionner sur la page supplémentaire de Choix. Il est difficile de sélectionner les questions une par une dans Choice, et il y a une possibilité de faire une erreur dans la sélection.

Le formulaire en ligne est pratique là-bas. Si vous l'utilisez, ce sera l'objet de la relation (question dans ce cas) Vous pouvez créer l'objet cible (Choice dans ce cas) en même temps.

Dans le cas du site d'administration, une classe pour l'affichage d'Inline appelée InlineAdmin est préparée. Cette fois, nous utiliserons la classe StackedInline.

Le code source modifié est le suivant.

polls/admin.py

from django.contrib import admin

from .models import Question
from .models import Choice


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


class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]

admin.site.register(Question, QuestionAdmin)
admin.site.register(Choice)

Ajoutez les définitions de «ChoiceInline» et «QuestionAdmin» au deuxième argument lors de l'enregistrement d'une question. Il est modifié pour passer «QuestionAdmin».

ʻAdmin.StackedInline` est une classe de base pour créer des Inlines au format Stacked. Définissez le modèle cible (Choix dans ce cas) et le nombre d'écrans (extra = 3). Vous pouvez également définir le nombre maximum et déterminer s'il peut ou non être supprimé.

ʻAdmin.ModelAdmin` est une classe permettant de personnaliser le comportement du modèle sur le site de gestion. Cette fois, les inserts sont définis et le comportement lors de l'ajout et de la modification d'objets est modifié.

Si vous changez jusqu'à présent et accédez à nouveau à la page supplémentaire (ou à la page d'édition) de Question sur le site de gestion Vous pouvez voir que vous pouvez modifier les choix en même temps.

Personnaliser l'affichage des objets

Document → https://docs.djangoproject.com/en/1.8/intro/tutorial02/#customize-the-admin-change-list Source → ʻe4bacf7→7f5128a`

Maintenant que l'enregistrement et l'édition s'améliorent, personnalisons l'affichage de la liste. Pour changer l'affichage, définissez list_display dans la classe (QuestionAdmin) créée en héritant de ʻadmin.ModelAdmin`.

polls/admin.py

...
class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]
    list_display = ('question_text', 'pub_date')
...

La liste, qui était un paysage meurtrier, est devenue un peu plus vivante. Pour tous les modèles, django ajoutera automatiquement une clé primaire. En passant, ajoutons cela également.

polls/admin.py

...
class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]
    list_display = ('pk', 'question_text', 'pub_date')
...

C'est un sentiment agréable.

Plus de personnalisation

Faisons quelque chose d'un peu spécial, en suivant le tutoriel original. En plus des champs, list_display peut être défini sur une méthode sans argument.

Ajoutez une méthode was_published_recently au modèle Question pour voir si la question a été publiée dans la journée.

polls/models.py

import datetime

from django.db import models
from django.utils import timezone


class Question(models.Model):
...

    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
...

Ensuite, ajoutez cette méthode à list_display.

polls/admin.py

...
class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]
    list_display = ('pk', 'question_text', 'pub_date', 'was_published_recently')
...

Vous pouvez le voir correctement. Il peut être intéressant de créer une méthode qui renvoie le nombre de choix associés à la question.

Personnalisation supplémentaire

Si la cible de list_display est une méthode, vous pouvez modifier l'affichage et définir les conditions d'ordre en ajoutant des attributs à la méthode. Définissons ʻadmin_order_field, boolean, short_description` en suivant le tutoriel original.

polls/models.py

...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
    was_published_recently.admin_order_field = 'pub_date'
    was_published_recently.boolean = True
    was_published_recently.short_description = 'Published recently?'
...

Ça fait du bien. ʻAdmin_order_fielddéfinit le champ à regarder lors du tri. Dans cet exemple, ils sont triés par le champpub_date`. En définissant cet attribut, vous pouvez cliquer sur l'en-tête du tableau et le trier.

Filtrer, ajouter une recherche

Enfin, ajoutons un filtre et une recherche. Définissez simplement les propriétés dans QuestionAdmin comme dans l'exemple.

polls/admin.py

...
class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]
    list_display = ('pk', 'question_text', 'pub_date', 'was_published_recently')
    list_filter = ['pub_date']
    search_fields = ['question_text']
...

Vous pouvez facilement ajouter des filtres et des recherches comme celui-ci.

-- Vers le prochain tutoriel

→ Résumé du didacticiel