{"title":"Γράφοντας το πρώτο σας Django app, μέρος 7","version":"3.0","locale":"el","docname":"intro/tutorial07","url":"/el/3.0/intro/tutorial07/","canonical":"https://djangodocs.dev/el/3.0/intro/tutorial07/","summary":"Καλώς ορίσατε στο τελευταίο μέρος του οδηγού (tutorial) του Django! Ο οδηγός αυτός ξεκινά εκεί που τελειώνει ο οδηγός 6 . Συνεχίζουμε με την εφαρμογή μας (Web-poll)…","html":"

Γράφοντας το πρώτο σας Django app, μέρος 7Link to this heading#

\n

Καλώς ορίσατε στο τελευταίο μέρος του οδηγού (tutorial) του Django! Ο οδηγός αυτός ξεκινά εκεί που τελειώνει ο οδηγός 6. Συνεχίζουμε με την εφαρμογή μας (Web-poll) και αυτή τη φορά θα επικεντρωθούμε στην παραμετροποίηση του διαχειριστικού site του Django το οποίο δημιουργείται αυτόματα για εσάς. Το Django admin το συναντήσαμε πρώτα στον Οδηγό 2.

\n\n
\n

Παραμετροποιώντας την admin formLink to this heading#

\n

Κάνοντας register το Question model με το Django admin (admin.site.register(Question)), το Django ήταν σε θέση να κατασκευάσει μια προεπιλεγμένη εμφάνιση της φόρμας του μοντέλου για επεξεργασία. Με άλλα λόγια σας δίνει τη δυνατότητα να δημιουργείτε, επεξεργάζεστε, ανανεώνετε και διαγράφετε entries στη βάση δεδομένων σας (υπενθυμίζουμε ότι κάθε instance του μοντέλου σας αναπαριστά και μια γραμμή -entry, row- στον αντίστοιχο πίνακα της database) χωρίς τη χρήση της κονσόλας (γραμμής εντολών). Πολύ συχνά θα θέλετε να επεξεργαστείτε την εμφάνιση της φόρμας αυτής καθώς και τον τρόπο που λειτουργεί. Για να το πετύχετε αυτό δεν έχετε παρά να πείτε στο Django τις επιλογές-ρυθμίσεις που θέλετε, για αυτό το μοντέλο, την ώρα που κάνετε register το μοντέλο σας με το Django admin.

\n

Ας δούμε πως δουλεύει αναδιοργανόνοντας τα πεδία (fields) στην φόρμα επεξεργασίας (edit form). Μέσα στο αρχείο polls/admin.py, αντικαταστήστε την γραμμή admin.site.register(Question) με αυτό το κομμάτι κώδικα:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ['pub_date', 'question_text']\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Θα ακολουθείτε αυτή τη διαδικασία (αρχικά θα δημιουργείτε μια model admin class και έπειτα θα περνάτε αυτή τη κλάση ως δεύτερο όρισμα στη μέθοδο admin.site.register()) κάθε φορά που θέλετε να αλλάξετε τυχόν επιλογές στο admin (admin options) για ένα μοντέλο.

\n

Αν θυμάστε, πριν την αλλαγή αυτή, στη φόρμα επεξεργασίας εμφανιζόταν πρώτα το πεδίο της ερώτησης και μετά το πεδίο της ημερομηνίας επειδή τα είχαμε δηλώσει με αυτή τη σειρά στο μοντέλο Question. Τώρα, παρακάμπτουμε αυτή τη σειρά και πλέον εμφανίζεται πρώτα το πεδίο της ημερομηνίας («Publication date») και κατόπιν το πεδίο της ερώτησης («Question»):

\n\"Fields\n

Αυτό δεν είναι και τόσο εντυπωσιακό με μόλις δύο πεδία, αλλά για φόρμες admin (admin forms) με δεκάδες πεδία, η επιλογή της σειράς εμφάνισης αποτελεί σημαντική λεπτομέρεια.

\n

Και μιλώντας για φόρμες με δεκάδες πεδία, ίσως να θέλετε να διαχωρίσετε τη φόρμα σε πεδία φορμών (fieldsets):

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None,               {'fields': ['question_text']}),\n        ('Date information', {'fields': ['pub_date']}),\n    ]\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Το πρώτο element από κάθε tuple μέσα στη λίστα fieldsets είναι ο τίτλος του fieldset. Δείτε πως θα εμφανίζεται τώρα η φόρμα:

\n\"Form\n
\n\n
\n

Παραμετροποιώντας την admin change listLink to this heading#

\n

Τώρα που η διαχειριστική σελίδα του μοντέλου Question δείχνει όμορφη, ας κάνουμε μερικές αλλαγές στην σελίδα «change list» – αυτή που εμφανίζει όλες τις ερωτήσεις μέσα στο σύστημα (σαν μια λίστα).

\n

Δείτε πως φαίνεται σε αυτό το σημείο:

\n\"Polls\n

Από προεπιλογή, το Django εμφανίζει τη μέθοδο str() για κάθε object. Αλλά μερικές φορές θα ήταν πιο βολικό να εμφανίζουμε μεμονομένα πεδία. Για να το κάνουμε αυτό θα χρησιμοποιήσουμε την επιλογή-ρύθμιση list_display, η οποία είναι ένα tuple από ονόματα πεδίων (του μοντέλου σας), τα οποία θα εμφανιστούν ως στήλες σε αυτή τη σελίδα:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ('question_text', 'pub_date')\n
\n

For good measure, let’s also include the was_published_recently() method\nfrom Tutorial 2:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ('question_text', 'pub_date', 'was_published_recently')\n
\n

Τώρα η σελίδα change list του Question δείχνει κάπως έτσι:

\n\"Polls\n

Μπορείτε να κλικάρετε στους headers κάθε στήλης για να ταξινομήσετε την αντίστοιχη στήλη κατά τις τιμές της. Μοναδική εξαίρεση στη δυνατότητα της ταξινόμηση μιας στήλης αποτελεί η περίπτωση του header was_published_recently, επειδή η ταξινόμηση με βάση την έξοδο μιας μεθόδου (ενός μοντέλου) δεν υποστηρίζεται. Επίσης, σημειώστε ότι ο header της στήλης was_published_recently είναι, από προεπιλογή, το όνομα της μεθόδου (με τα κενά να αντικαθιστούν τις κάτω παύλες) και κάθε κελί της στήλης αυτής περιέχει την έξοδο της συγκεκριμένης μεθόδου (True ή False).

\n

Μπορούμε να βελτιώσουμε την όλη αυτή εμφάνιση παρέχοντας μερικά attributes στην μέθοδο αυτή (μέσα στο αρχείο polls/models.py) ως ακολούθως:

\n
polls/models.py
\n
Python
class Question(models.Model):\n    # ...\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n    was_published_recently.admin_order_field = 'pub_date'\n    was_published_recently.boolean = True\n    was_published_recently.short_description = 'Published recently?'\n
\n

Για περισσότερες πληροφορίες σχετικά με τα properties των μεθόδων, δείτε στο list_display.

\n

Επεξεργαστείτε το αρχείο polls/admin.py για ακόμη μια φορά και προσθέστε ένα φίλτρο στη σελίδα change list του μοντέλου Question χρησιμοποιώντας το list_filter. Προσθέστε την ακόλουθη γραμμή κώδικα στην κλάση QuestionAdmin:

\n
Code
list_filter = ['pub_date']\n
\n

Αυτό προσθέτει μια πλευρική στήλη (sidebar) «Filter» η οποία επιτρέπει το φιλτράρισμα των αποτελεσμάτων στην σελίδα change list κατά το πεδίο pub_date:

\n\"Polls\n

Ο τύπος του φίλτρου που εμφανίζεται εξαρτάται από τον τύπο του πεδίου που προσπαθείτε να φιλτράρετε. Επειδή το πεδίο pub_date είναι τύπου DateTimeField, το Django ξέρει ότι πρέπει να του δώσει τις ανάλογες επιλογές για φιλτράρισμα, όπως: «Οποιαδήποτε ημερομηνία», «Σήμερα», «Τελευταίες 7 μέρες», «Αυτόν το μήνα», «Αυτόν το χρόνο».

\n

Αρχίζει και παίρνει σχήμα η όλη σελίδα μας. Ας προσθέσουμε τη δυνατότητα του searching:

\n
Code
search_fields = ['question_text']\n
\n

Αυτό προσθέτει ένα search box κοντά στην κορυφή της σελίδας change list. Όταν κάποιος πληκτρολογήσει κάποια λέξη κλειδί για εύρεση, το Django θα ψάξει μέσα στο πεδίο question_text. Μπορείτε να χρησιμοποιήσετε όσα πεδία θέλετε – όμως επειδή η μέθοδος αυτή κάνει χρήση του LIKE query στο παρασκήνιο, αν περιορίσετε τον αριθμό των search fields μέσα στο πεδίο search_fields, τότε θα κάνει τη δουλειά της database σας πιο εύκολη στην εύρεση της λέξης κλειδί που δώσατε.

\n

Τώρα είναι μια καλή στιγμή να σημειώσουμε ότι η σελίδες change lists σας δίνουν δωρεάν τη δυνατότητα του pagination. Από προεπιλογή, το Djoango εμφανίζει 100 γραμμές ανά σελίδα. Τα attributes Change list pagination, search boxes, filters, date-hierarchies και\ncolumn-header-ordering συνεργάζονται μεταξύ τους όπως ακριβώς νομίζετε.

\n
\n
\n

Παραμετροποιώντας την εμφάνιση του admin siteLink to this heading#

\n

Βασικά, η λέξη «Διαχείριση Django» στην κορυφή κάθε σελίδας του admin είναι γελοία. Στην πραγματικότητα είναι ένα κείμενο placeholder.

\n

You can change it, though, using Django’s template system. The Django admin is\npowered by Django itself, and its interfaces use Django’s own template system.

\n
\n

Παραμετροποιώντας τα templates του project σαςLink to this heading#

\n

Δημιουργήστε έναν φάκελο templates μέσα στο root φάκελο του project σας (αυτόν που περιέχει το αρχείο manage.py). Τα templates μπορούν να υπάρχουν οπουδήποτε μέσα στο filesystem σας αρκεί το Django να έχει πρόσβαση σε αυτά. (Το Django τρέχει υπό τον χρήστη που τρέχει και τον server σας.) Ωστόσο, το να κρατάτε τα templates σας μέσα στο project σας είναι μια, γενικά, καλή πρακτική.

\n

Ανοίξτε το αρχείο ρυθμίσεων-επιλογών του project σας (settings file, mysite/settings.py) και προσθέστε την επιλογή DIRS μέσα στην επιλογή TEMPLATES:

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [os.path.join(BASE_DIR, 'templates')],\n        'APP_DIRS': True,\n        'OPTIONS': {\n            'context_processors': [\n                'django.template.context_processors.debug',\n                'django.template.context_processors.request',\n                'django.contrib.auth.context_processors.auth',\n                'django.contrib.messages.context_processors.messages',\n            ],\n        },\n    },\n]\n
\n

Η επιλογή DIRS είναι μια λίστα με strings. Κάθε string είναι η διαδρομή (path) η οποία καταλήγει σε κάποιο φάκελο που περιέχει τα templates σας. Όταν το Django φορτώνει τα templates θα ψάξει και σε αυτά τα paths για να βρει τα templates σας. Με άλλα λόγια αποτελεί ένα μονοπάτι ευρέσεως των templates.

\n\n

Δημιουργήστε, τώρα, ένα φάκελο με όνομα admin μέσα στο φάκελο templates και κάντε αντιγραφή-επικόλληση το αρχείο template admin/base_site.html το οποίο θα βρείτε μέσα στον πηγαίο κώδικα του Django (django/contrib/admin/templates).

\n\n

Then, edit the file and replace\n{{ site_header|default:_('Django administration') }} (including the curly\nbraces) with your own site’s name as you see fit. You should end up with\na section of code like:

\n
Django template
{% block branding %}\n<h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></h1>\n{% endblock %}\n
\n

Χρησιμοποιούμε αυτή τη διαδικασία για να σας δείξουμε πως μπορείτε να κάνετε override τα templates. Σε ένα πραγματικό project, το πιο πιθανόν είναι να χρησιμοποιήσετε το attibute django.contrib.admin.AdminSite.site_header κάνοντας την παραπάνω διαδικασία ακόμα πιο εύκολη.

\n

Αυτό το αρχείο template περιέχει αρκετό κείμενο όπως {% block branding %} και {{ title }}. Τα tags {% και {{ είναι μέρος της γλώσσας template του Django. Όταν το Django κάνει render το αρχείο admin/base_site.html, αυτή η γλώσσα θα τρέξει και θα γεμίσει αυτά τα tags με διάφορες τιμές για να παραχθεί στο τέλος η HTML σελίδα που θα επιστρέψει πίσω στον χρήστη (ως response), όπως είδαμε στον Οδηγό 3.

\n

Note that any of Django’s default admin templates can be overridden. To\noverride a template, do the same thing you did with base_site.html – copy\nit from the default directory into your custom directory, and make changes.

\n
\n
\n

Παραμετροποιώντας τα templates της εφαρμογής σαςLink to this heading#

\n

Οι προσεκτικοί αναγνώστες θα αναρρωτηθούν: Αφού η ρύθμιση (λίστα) DIRS είναι κενή αρχικά, πως ξέρει το Django που να βρει τα προεπιλεγμένα admin templates; Η απάντηση έχει ως εξής: εφόσον η ρύθμιση (boolean) APP_DIRS έχει την τιμή True, το Django αυτόματα κοιτάζει στο φάκελο templates/ κάθε εφαρμογής (που συμπεριλαμβάνεται στη ρύθμιση-λίστα INSTALLED_APPS), για τη χρήση τους ως fallback (μην ξεχνάτε ότι το django.contrib.admin είναι και αυτό μια εφαρμογή).

\n

Η εφαρμογή ψηφοφορίας μας δεν είναι πολύ περίπλοκη και δεν χρειάζεται κάποια μεγάλη παραμετροποίηση των admin templates. Αλλά αν αναπτυχθεί και μεγαλώσει σε τέτοιο βαθμό που να χρειάζεται απαραιτήτως διάφορες λειτουργικές επεμβάσεις στα default templates του Django, τότε θα ήταν πιο λογικό να γίνει σε επίπεδο application (μέσα στο φάκελο templates της εφαρμογής σας) παρά σε επίπεδο project (μέσα στο φάκελο templates του project σας). Με αυτό τον τρόπο, θα μπορέσετε να συμπεριλάβετε την εφαρμογή ψηφοφορίας σας σε κάποιο μελλοντικό project και θα είστε σίγουροι ότι τα templates αυτής της εφαρμογής θα εφαρμοστούν αμέσως στο νέο project.

\n

Δείτε στο εγχειρίδιο (documentation) φόρτωσης των templates για περισσότερες πληροφορίες σχετικά με το πως το Django βρίσκει-αναζητά τα templates.

\n
\n
\n
\n

Παραμετροποιώντας την αρχική σελίδα του Django adminLink to this heading#

\n

Ομοίως, ίσως να θέλετε να παραμετροποιήσετε (να φέρετε στα μέτρα σας) την εμφάνιση της αρχικής σελίδας του Django admin.

\n

Από προεπιλογή, εμφανίζονται όλες οι εφαρμογές (κατά αλφαβητική σειρά) που συμπεριλαμβάνονται στη ρύθμιση (λίστα) INSTALLED_APPS και έχουν γίνει register με το admin. Αν θέλετε να κάνετε σημαντικές αλλαγές στην εμφάνιση της αρχικής σελίδας δεν έχετε παρά να βάλετε τη φαντασία σας να δουλέψει. Είναι γνωστό ότι η εμφάνιση της αρχικής σελίδας του admin είναι η πιο σημαντική και θα πρέπει να είναι εύκολο να την παραμετροποιήσετε.

\n

To template προς παραμετροποίηση είναι το admin/index.html (κάντε το ίδιο όπως κάνατε για το αρχείο admin/base_site.html πριν – αντιγράψτε το από τον πηγαίο κώδικα του Django στον τοπικό φάκελο templates της εφαρμογής σας). Κατά τη διάρκεια επεξεργασίας του αρχείου θα δείτε ότι χρησιμοποιείται μια template variable με το όνομα app_list. Αυτή η μεταβλητή περιέχει κάθε εγκατεστημένη εφαρμογή στο Django (είναι μέσα στο INSTALLED_APPS και register στο admin). Αντί αυτού, μπορείτε να γράψετε hard-code συνδέσμους σε object-specific admin σελίδες με όποιον τρόπο πιστεύετε ότι είναι καλύτερος.

\n
\n
\n

Επόμενα βήματαLink to this heading#

\n

Ο οδηγός για αρχάριους τελειώνει κάπου εδώ. Στο μεταξύ μπορείτε να δείτε προτεινόμενες κατευθύνσεις για το τι να κάνετε έπειτα, στο άρθρο τι να κάνω μετά από εδώ.

\n

Αν είστε εξοικειωμένοι με το Python packaging και ενδιαφέρεστε να μάθετε πως να μετατρέψετε την εφαρμογή ψηφοφορίας σε «επαναχρησιμοποιήσιμη εφαρμογή», δείτε το άρθρο Οδηγός για προχωρημένους: Πως να γράψετε επαναχρησιμοποιήσιμα apps.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Παραμετροποιώντας την admin form","anchor":"customize-the-admin-form","children":[]},{"title":"Προσθήκη συσχετισμένων objects","anchor":"adding-related-objects","children":[]},{"title":"Παραμετροποιώντας την admin change list","anchor":"customize-the-admin-change-list","children":[]},{"title":"Παραμετροποιώντας την εμφάνιση του admin site","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Παραμετροποιώντας τα templates του project σας","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Παραμετροποιώντας τα templates της εφαρμογής σας","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Παραμετροποιώντας την αρχική σελίδα του Django admin","anchor":"customize-the-admin-index-page","children":[]},{"title":"Επόμενα βήματα","anchor":"what-s-next","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Ξεκινώντας","url":"/el/3.0/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Γράφοντας το πρώτο σας Django app, μέρος 6","url":"/el/3.0/intro/tutorial06/"},"next":{"docname":"intro/reusable-apps","title":"Οδηγός για προχωρημένους: Πως να γράψετε επαναχρησιμοποιήσιμα apps","url":"/el/3.0/intro/reusable-apps/"},"formats":{"html":"/el/3.0/intro/tutorial07/","markdown":"/el/3.0/intro/tutorial07.md","json":"/el/3.0/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/3.0.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/el/3.0/intro/tutorial07/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}