CRUD

1. Personnaliser la vue liste

Pour visualiser le code relatif à ce chapitre : git diff v1.2.2..v1.3.0.

L’objectif ici est de se poser des questions sur ce que l’on veut. Et c’est ce que l’on va faire, progressivement.

    list_display = ( 
        "name", 
        "status", 
        "duration", 
        "level", 
    )  

    list_display = ( 
        "user_username", 
        "user_first_name", 
        "user_last_name", 
        "avatar", 
        "profile_activated", 
        "subscription_date", 
        "score", 
    )  

1. Modifier des données d’une relation many to one

Au sein du formulaire d’un jeu, nous souhaitons pouvoir saisir les questions. Nous souhaitons voir un tableau de ces questions et que ce tableau soit modifiable. C’est ce que permettent les inlines.

class QuestionInline(admin.TabularInline): 
    model = Question 
    fields = ("text", "points", "order") 
    min_num = 2 
    max_num = 5 
    extra = 1  

Le nom des champs est assez explicite. Il faut renseigner a minima le nom du modèle concerné par l’inline et les champs que nous souhaitons voir.

Les deux champs suivants permettent de préciser le nombre minimum de lignes dans le tableau ainsi que le nombre maximal.

Le dernier champ permet de préciser le nombre de champs à laisser en plus lorsque l’on ouvre le formulaire en modification. Ainsi, s’il y a trois questions, il y aura une quatrième ligne vide, prête à saisir. S’il y a déjà cinq questions, le nombre maximal, cette ligne supplémentaire ne sera pas visible, car inutile. Cela permet d’améliorer légèrement l’expérience utilisateur....

1. Retirer un modèle du menu

Nous souhaitons gérer les jeux et uniquement les jeux, car ce sont les entités tangibles fonctionnelles.

Les questions ne sont rien d’autre qu’une partie du jeu, et les réponses une partie des questions.

Donc, nous ne voulons pas voir apparaître les questions ou les réponses dans le menu, juste les jeux. Nous ne souhaitons pas non plus accéder à la liste des questions ou des réponses.

Pour cela, nous allons les désactiver :

@admin.register(Question) 
class QuestionAdmin(admin.ModelAdmin): 
    def has_module_permission(self, request): 
        return False 
 
 
@admin.register(Answer) 
class AnswerAdmin(admin.ModelAdmin): 
    def has_module_permission(self, request): 
        return False  

Les modèles en question doivent tout de même être déclarés et enregistrés, ils sont utilisés sous une autre forme, à partir de l’interface des jeux, via les inlines. 

Mais, la surcharge de cette méthode permet de ne plus les voir dans le menu.

2. Gérer la visibilité des interfaces

Attention ! Avec les modifications vues juste à l’instant, il est toujours possible de voir les données...

1. Créer une action

Une action est une tâche que l’on peut réaliser sur plusieurs objets en même temps.

Si nous allons dans la liste des jeux, nous pouvons sélectionner plusieurs jeux, puis utiliser la liste déroulante située à gauche, juste au-dessus du tableau, pour choisir une action à exécuter.

Pour l’instant, la seule action possible est de supprimer ces objets.

Si nous sommes attentifs, nous voyons qu’en cochant et décochant des lignes, le nombre d’éléments sélectionnés à droite de cette liste de sélection se met à jour.

Nous allons créer une nouvelle action pour remettre à zéro les scores de tous les joueurs sélectionnés.

Voici l’action :

    @admin.action(description=gettext("Reset scores")) 
    def reset_scores(self, request, queryset): 
        queryset.update(score=0)  

Comme nous pouvons le voir, nous avons toujours l’objet request comme paramètre, mais nous avons surtout l’objet queryset, qui représente la requête pour tous les objets sélectionnés. Nous utilisons donc simplement la méthode update pour mettre à jour...