commentaire

[semainetech_django.git] / project / support / admin.py

# -*- encoding: utf-8 -*-

from django.contrib import admin
from django.conf import settings
from models import FAQ

#TODO : écrire une admin pour le modèle de 'Ressources'.

class FAQAdmin(admin.ModelAdmin):
    """
    Cette classe permet de spécifier comment fonctionne les interfaces d'administrations du modèle FAQ :
    * liste 
    * édition

    Celà se fait, en spécifiant certaines propriétés de la classe, ou encore en surchargeant des méthodes
    particulières.
    
    Les interfaces d'administrations, font parties intégrantes du framework Django,
    et les options disponibles sont présentées ici :
    https://docs.djangoproject.com/en/1.2/ref/contrib/admin
    """

    # Cette option définie les champs qui seront présentées dans la vue en liste.
    # Si on se référence au modèle FAQ, _todo n'est pas un champs du modèle, mais
    # il fait référence à une méthode définie ci-dessous.
    list_display = ("question", "_todo", "public", )

    def _todo(self, obj):
        """
        Cette méthode est exploitée par la liste list_display. Elle prends en paramètre 'obj',
        qui est un objet FAQ.
        (Cette méthode est appelée pour représentrer la valeur de la colonne '_todo' pour chaque ligne.)
        """
        if obj.reponse != "":
            return """<img alt="True" src="%simg/admin/icon-yes.gif">""" % settings.ADMIN_MEDIA_PREFIX
        else:
            return """<img alt="False" src="%simg/admin/icon-no.gif">""" % settings.ADMIN_MEDIA_PREFIX
    # Cette option permet de renommer la colonne
    _todo.short_description = u"Traité"
    # Cette option autorise l'utilisation du HTML dans le résultat de la méthode
    _todo.allow_tags = True


# Il ne faut pas oublier d'enregistrer le modèle avec son admin!!!
admin.site.register(FAQ, FAQAdmin)