Ο μόνος τρόπος να μάθετε να γράφετε Django apps (εφαρμογές) και γενικά να δουλεύετε με το Django είναι μέσα από παραδείγματα.
\nΜέσα από αυτόν τον οδηγό, θα φτιάξουμε παρέα μία απλή εφαρμογή (application) ψηφοφορίας (poll app). Κάθε ερώτηση θα απαρτίζεται από ένα σετ απαντήσεων, από τις οποίες ο χρήστης θα μπορεί να επιλέξει μία κάθε φορά.
\nΗ εφαρμογή θα αποτελείται από δύο μέρη:
\nΈνα κοινό-δημόσιο site που θα επιτρέπει στους χρήστες να βλέπουν τις διαθέσιμες ψηφοφορίες (γκάλοπ, αν προτιμάτε) και να ψηφίζουν.
Ένα διαχειριστικό (admin) site το οποίο θα επιτρέπει σε εσάς (που θα είστε ο διαχειριστής) να προσθέτετε νέες, να αλλάζετε ήδη υπάρχουσες αλλά και να διαγράφετε ψηφοφορίες.
Υποθέτουμε ότι έχετε ήδη εγκαταστήσει το Django στον υπολογιστή σας. Μπορείτε να δείτε αν το Django έχει εγκατασταθεί (και αν ναι, ποια έκδοση διαθέτετε) πληκτρολογώντας στην κονσόλα (γραμμή εντολών):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nΑν το Django είναι εγκατεστημένο, θα δείτε την έκδοση του. Αν δεν είναι, θα δείτε ένα σφάλμα λέγοντας σας ότι “δεν υπάρχει κάποιο module με το όνομα django” (no module named django).
\nThis tutorial is written for Django 4.0, which supports Python 3.8 and\nlater. If the Django version doesn’t match, you can refer to the tutorial for\nyour version of Django by using the version switcher at the bottom right corner\nof this page, or update Django to the newest version. If you’re using an older\nversion of Python, check Ποια έκδοση της Python να χρησιμοποιήσω με το Django; to find a compatible\nversion of Django.
\nΔείτε See πως να εγκαταστήσετε το Django για συμβουλές απεγκατάστασης τυχόν παλιών εκδόσεων και εγκατάστασης της καινούργιας.
\n\nΑν αυτή είναι η πρώτη φορά που χρησιμοποιείτε το Django, θα χρειαστεί να ρυθμίσετε κάποια πράγματα στην αρχή. Θυμηθείτε ότι οι σωστές βάσεις δημιουργούν σταθερά σπίτια. Πιο συγκεκριμένα, θα χρειαστεί να τρέξετε μια Django εντολή η οποία θα δημιουργήσει αυτόματα ένα Django project – το οποίο δεν είναι τίποτε άλλο παρά ένας φάκελος (μια συλλογή από ρυθμίσεις, αν θέλετε) που περιέχει διάφορα αρχεία, όπως ρυθμίσεις της βάσης δεδομένων, διάφορες επιλογές του Django και ρυθμίσεις που αφορούν το application σας. Αν μπερδευτήκατε, μην ανησυχείτε, θα διαλευκανθούν όλα καθώς προχωράμε στον οδηγό.
\nΑπό κονσόλα τρέξτε την εντολή, cd και τον φάκελο που θα θέλατε να αποθηκευτεί το Django project σας. Μετά τρέξτε την ακόλουθη εντολή:
Linux / macOS
$ django-admin startproject mysite\nWindows
...\\> django-admin startproject mysite\nΣυγχαρητήρια! Μόλις δημιουργήσατε το πρώτο σας Django project. Αυτή η εντολή θα δημιουργήσει αυτόματα (μέσα στον φάκελο που κάνατε cd) ένα φάκελο με το όνομα mysite. Αν δεν δούλεψε, δείτε στα προβλήματα τρέχοντας το django-admin.
Ας δούμε τώρα τι δημιούργησε η εντολή startproject:
mysite/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nΑυτά τα αρχεία είναι:
\nThe outer mysite/ root directory is a container for your project. Its\nname doesn’t matter to Django; you can rename it to anything you like.
manage.py: Αυτό το αρχείο αποτελεί εντολή (κονσόλας) την οποία μπορείτε να χρησιμοποιήσετε (και θα το κάνετε) για να αλληλεπιδράτε με το project σας για διάφορους λόγους (π.χ δημιουργία πινάκων στη database, εκκίνηση του προ-εγκατεστημένου server κλπ). Μπορείτε να διαβάσετε όλες τις λεπτομέρειες σχετικά με το αρχείο manage.py στο django-admin and manage.py.
Ο εσωτερικός φάκελος mysite/ είναι ένα τυπικό Python package για το project σας. Το όνομα του (έχει σημασία) θα το χρησιμοποιήσετε για να κάνετε import οτιδήποτε σε άλλα Python packages (π.χ import mysite.urls).
mysite/__init__.py: Ένα κενό αρχείο που λέει στην Python ότι αυτός ο φάκελος θα πρέπει να θεωρηθεί ως Python package. Αν είστε καινούργιος στην Python, διαβάστε περισσότερα σχετικά με τα packages στην επίσημη ιστοσελίδα της Python.
mysite/settings.py: Ένα αρχείο που κρατά όλες τις ρυθμίσεις/παραμέτρους για αυτό το Django project (είναι η καρδιά ενός project). Το άρθρο Django settings θα σας εξηγήσει όλα όσα χρειάζεστε σχετικά με το πως δουλεύουν οι ρυθμίσεις αυτές.
mysite/urls.py: Το αρχείο αυτό κρατά τους ορισμούς των URLs για αυτό το project. Με άλλα λόγια είναι ένας «πίνακας περιεχομένων» του Django site σας. Μπορείτε να διαβάστε περισσότερα για τα URLs στο άρθρο URL dispatcher.
mysite/asgi.py: An entry-point for ASGI-compatible web servers to\nserve your project. See How to deploy with ASGI for more details.
mysite/wsgi.py: Αυτό το αρχείο αποτελεί ένα σημείο εισόδου για τους Web servers οι οποίοι είναι συμβατοί με το WSGI specification. Δείτε περισσότερα στο άρθρο πως να δουλέψω με το WSGI για περισσότερες λεπτομέρειες.
Τώρα που δημιουργήσαμε ένα Django project, θα πρέπει να σιγουρευτούμε ότι λειτουργεί. Από κονσόλα (γραμμή εντολών) μεταβείτε στο root φάκελο του project σας (mysite) και τρέξτε την ακόλουθη εντολή:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nΘα δείτε την ακόλουθη έξοδο, στη κονσόλα:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n09 Αυγούστου 2026 - 15:50:53\nDjango version 4.0, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
You’ve started the Django development server, a lightweight web server written\npurely in Python. We’ve included this with Django so you can develop things\nrapidly, without having to deal with configuring a production server – such as\nApache – until you’re ready for production.
\nNow’s a good time to note: don’t use this server in anything resembling a\nproduction environment. It’s intended only for use while developing. (We’re in\nthe business of making web frameworks, not web servers.)
\nNow that the server’s running, visit http://127.0.0.1:8000/ with your web\nbrowser. You’ll see a «Congratulations!» page, with a rocket taking off.\nIt worked!
\n\n\nΤώρα που το περιβάλλον εργασίας σας – το «project» – είναι έτοιμο, μπορείτε να ξεκινήσετε να δημιουργείτε.
\nΚάθε application που γράφετε στο Django αποτελείται από ένα Python package (ένας φάκελος που περιέχει το αρχείο __init__.py) το οποίο πρέπει να ακολουθεί ορισμένους κανόνες. Για άλλη μια φορά, το Django σας παρέχει την ανάλογη εντολή για να δημιουργήσετε αυτόματα τη δομή αυτού του φακέλου (Python package) ούτως ώστε να επικεντρωθείτε στο να γράψετε κώδικα παρά στο να δημιουργείτε φακέλους και υποφακέλους.
Your apps can live anywhere on your Python path. In\nthis tutorial, we’ll create our poll app in the same directory as your\nmanage.py file so that it can be imported as its own top-level module,\nrather than a submodule of mysite.
Για να δημιουργήσετε το app, σιγουρευτείτε ότι βρίσκεστε στο ίδιο επίπεδο με το αρχείο manage.py και πληκτρολογήστε την εντολή:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nΣυγχαρητήρια και πάλι! Μόλις φτιάξατε την πρώτη σας εφαρμογή στο Django. Βέβαια δεν κάνει τίποτα ακόμα αλλά θα φτάσουμε και εκεί. Η εντολή θα δημιουργήσει ένα φάκελο polls, ο οποίος αναπτύσσεται ως εξής:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nΑυτή η δομή θα εσωκλείει ολόκληρη την εφαρμογή μας.
\nΑς γράψουμε το πρώτο μας view. Ανοίξτε το αρχείο polls/views.py και γράψτε τον ακόλουθο Python κώδικα:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nΑυτή είναι η πιο απλή μορφή view στο Django. Για να καλέσετε το view, θα πρέπει να το συσχετίσουμε με ένα URL - και γι” αυτό θα χρειαστούμε ένα URLconf.
\nΓια τη δημιουργία του URLconf στον φάκελο polls, δημιουργήστε ένα αρχείο με το όνομα urls.py. Ο φάκελος της εφαρμογής σας θα πρέπει να δείχνει έτσι:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nΜέσα στο αρχείο polls/urls.py συμπεριλάβετε τον παρακάτω κώδικα:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path('', views.index, name='index'),\n]\nThe next step is to point the root URLconf at the polls.urls module. In\nmysite/urls.py, add an import for django.urls.include and insert an\ninclude() in the urlpatterns list, so you have:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path('polls/', include('polls.urls')),\n path('admin/', admin.site.urls),\n]\nThe include() function allows referencing other URLconfs.\nWhenever Django encounters include(), it chops off whatever\npart of the URL matched up to that point and sends the remaining string to the\nincluded URLconf for further processing.
The idea behind include() is to make it easy to\nplug-and-play URLs. Since polls are in their own URLconf\n(polls/urls.py), they can be placed under «/polls/», or under\n«/fun_polls/», or under «/content/polls/», or any other path root, and the\napp will still work.
You have now wired an index view into the URLconf. Verify it’s working with\nthe following command:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nΕπισκεφτείτε την σελίδα http://localhost:8000/polls/ με τον browser σας και θα πρέπει να δείτε το κείμενο «Hello, world. You’re at the polls index.», το οποίο γράψαμε στην index view.
The path() function is passed four arguments, two required:\nroute and view, and two optional: kwargs, and name.\nAt this point, it’s worth reviewing what these arguments are for.
path() argument: routeLink to this heading#route is a string that contains a URL pattern. When processing a request,\nDjango starts at the first pattern in urlpatterns and makes its way down\nthe list, comparing the requested URL against each pattern until it finds one\nthat matches.
Patterns don’t search GET and POST parameters, or the domain name. For example,\nin a request to https://www.example.com/myapp/, the URLconf will look for\nmyapp/. In a request to https://www.example.com/myapp/?page=3, the\nURLconf will also look for myapp/.
path() argument: viewLink to this heading#When Django finds a matching pattern, it calls the specified view function with\nan HttpRequest object as the first argument and any\n«captured» values from the route as keyword arguments. We’ll give an example\nof this in a bit.
path() argument: kwargsLink to this heading#Επίσης, στο Django view μπορούν να περαστούν, προαιρετικά και αυθαίρετα keyword arguments. Σε αυτό τον οδηγό δεν θα χρησιμοποιήσουμε αυτή τη δυνατότητα.
\npath() argument: nameLink to this heading#Υπάρχει επίσης το πολύ δυνατό χαρακτηριστικό του Django, με το οποίο μπορείτε να ονομάσετε τα URL σας και να αναφέρεστε σε αυτά μόνο με το όνομα τους παρά με την διεύθυνση τους. Αυτό, θα το χρησιμοποιείτε συνέχεια στα templates σας (π.χ μέσα σε ένα <a href> HTML tag). Με αυτό τον τρόπο μπορείτε να αλλάζετε τις διευθύνσεις των URL πειράζοντας μόνο ένα αρχείο (urls.py) παρά να ψάχνετε σε άλλα μέρη (π.χ στα template σας) για να ανανεώσετε το URL (αφού, αλλιώς θα είχατε γράψει ολόκληρη τη διεύθυνση URL).
Όταν αισθανθείτε άνετα με αυτό τον οδηγό και με τη λειτουργία της Web request-Web response διαδικασίας μπορείτε να συνεχίσετε στο δεύτερο μέρος αυτού του οδηγού για να εργαστείτε με τη βάση δεδομένων.
\n