Der Django-Admin-Bereich im Überblick

Der Django-Admin-Bereich imÜberblick

Andi Albrecht

PyCon DE 2012

31. Oktober 2012

. . .Grundlegende Konfiguration

. . . . . .Views Methoden des ModelAdmin Weiterführende Themen Vorteile & Nachteile

Django-Admin-Bereich / Andi Albrecht / PyCon DE 2012

Andi Albrecht – @andialbrecht

Erster Python-Kontakt vor etwa 10 Jahren alsStudentische Hilfskraft bei der DFGAktuell: Anwendungsentwickler für Webapplikationen beiProUnix in BonnEntwicklung und Pflege mittlerer und großer SystemeOpenSource: Rietveld Code Review Tool,python-sqlparse, CrunchyFrog, hgsvn, ...




Übersicht

Grundlegende Konfiguration

Views

Methoden des ModelAdmin

Weiterführende Themen

Vorteile & Nachteile




Umwas geht es?




Grundlegende KonfigurationAutodiscover & Sites

settings.pyINSTALLED_APPS = (…’django.contrib.admin’,…

)

urls.pyfrom django.contrib import adminadmin.autodiscover()

urlpatterns = patterns(”,…url(r’^admin/’, include(admin.site.urls)),…

)





settings.pyINSTALLED_APPS = (…’django.contrib.admin’, Ñ Admin ist eine App…

)

urls.pyfrom django.contrib import adminadmin.autodiscover()


)






)

urls.pyfrom django.contrib import adminadmin.autodiscover() Ñ sucht nach admin.py in Apps


)






)

urls.pyfrom django.contrib import adminadmin.autodiscover() Ñ sucht nach admin.py in Apps

urlpatterns = patterns(”,… Ñ URLs der Default-Admin-Siteurl(r’^admin/’, include(admin.site.urls)),…

)




Grundlegende KonfigurationAdmin-Models für Models

myapp|– __init__.py|– views.py|– models.py|– admin.py




Grundlegende KonfigurationAdmin-Models für Models

myapp|– __init__.py|– views.py|– models.py|– admin.py

from django.contrib import adminfrom library import models

class BookAdmin(admin.ModelAdmin):pass

admin.site.register(models.Book, BookAdmin)admin.site.register(models.Author, admin.ModelAdmin)admin.site.register(models.Publisher, admin.ModelAdmin)




Grundlegende KonfigurationBerechtigungen

Admin-Bereich baut auf Apps Ñ Models Ñ

Berechtigungen aufZugang zum Admin nur für aktive User mit is_staff-Flag(Redakteur)Superuser darf immer alles (war ja klar...)Sichtbarkeit von Models / Apps richtet sich dann nachModel-Berechtigungen:

MyModel.can_addMyModel.can_changeMyModel.can_deleteAchtung: Keine Berechtigung MyModel.can_view!




ViewsÜbersicht

App-Dashboard Alle Apps mit Zugriff auf mind. 1 Modelë Model-Liste Alle Models einer App auf die ein Nutzer Zugriff hat

ë Objektliste Alle(!) Objekte zu einem Modelë Detailansicht Formular zum Bearbeiten eines Objekts




ViewsObjektliste




ViewsObjektliste, Konfiguration

class AuthorAdmin(admin.ModelAdmin):list_display = (’id’, ’__unicode__’, ’num_books’)list_display_links = (’id’, ’__unicode__’)search_fields = (’first_name’, ’last_name’, ’book__title’)list_filter = (’book__publisher__name’,)

def num_books(self, obj):return obj.book_set.count()

num_books.short_description = _(u’Number of books’)

admin.site.register(models.Author, AuthorAdmin)





class AuthorAdmin(admin.ModelAdmin):list_display = (’id’, ’__unicode__’, ’num_books’)list_display_links = (’id’, ’__unicode__’)search_fields = (’first_name’, ’last_name’, ’book__title’)list_filter = (’book__publisher__name’,)

def num_books(self, obj):return obj.book_set.count() # DB-Abfrage je Objekt!

num_books.short_description = _(u’Number of books’)

admin.site.register(models.Author, AuthorAdmin)





class Author(models.Model):first_name = models.CharField(max_length=100, verbose_name=_(u’First name’))last_name = models.CharField(max_length=100, verbose_name=_(u’Last name’))

def __unicode__(self):return u’%s %s’ % (self.first_name, self.last_name)

class Meta:verbose_name = _(u’Author’)verbose_name_plural = _(u’Authors’)




ViewsDetailansicht




ViewsDetailansicht, Konfiguration

class BookInline(admin.TabularInline):model = models.Book

class AuthorAdmin(admin.ModelAdmin):[...]inlines = [BookInline,][...]




Methoden des ModelAdminObjekte, Objektlisten

save|delete_model(self, request, obj[,form, change])get_ordering(self, request)queryset(self, request)




Methoden des ModelAdminViews, Forms

get_form(self, request, obj=None, **kwargs)get_readonly_fields(self, request)get_urls(self)add|change|changelist|delete_view (self,request[, object_id, ...])




Weiterführende Themen

Anpassung von TemplatesAnpassung des gesamten LookFeels (django-admin-tools,Grappelli)Hinzufügen eigener Views (Stichwort:ModelAdmin.get_urls())Hinzufügen eigener Aktionen auf ObjektenHinzufügen eigener Filter




Weiterführende ThemenRT(F)D

https://docs.djangoproject.com/en/1.4/ref/contrib/admin/




Weiterführende ThemenRead the Source!




Vorteile & NachteileAdmin-Bereich Out-of-the-box, nur wenig KonfigurationnötigAdministration von Daten, Aufbau von Test-DatenNebenbei Geenprüfung der Datenstrukturen für EntwicklerEinfach konfigurierbar, in vielen Details konfigurierbar"dicke" Apps nutzen den Admin-Bereich (CMS, Shop)

Admin-Bereich bildet eine technische Sicht (Datenbank)ab, aber keine fachlicheNutzer brauchen Staff-FlagVersuch, den Admin-Bereich Endnutzer-freundlich zugestalten scheitertAdmin-Bereich ist für versierte Benutzer




Danke!

E-Mail [email protected]@gmail.com

Twitter @andialbrecht

Homepage http://andialbrecht.de

http://www.prounix.de/unternehmen/jobs/python/

prounix.de




Der Django-Admin-Bereich im Überblick

Technology

Transcript of Der Django-Admin-Bereich im Überblick