https://github.com/touppercase78/django-polls-complete-app
The completed web polls application with Python Django from tutorials
https://github.com/touppercase78/django-polls-complete-app
django django-application python python3 web web-application
Last synced: about 2 months ago
JSON representation
The completed web polls application with Python Django from tutorials
- Host: GitHub
- URL: https://github.com/touppercase78/django-polls-complete-app
- Owner: toUpperCase78
- Created: 2025-03-24T15:07:35.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-24T15:41:43.000Z (over 1 year ago)
- Last Synced: 2025-03-24T16:27:33.030Z (over 1 year ago)
- Topics: django, django-application, python, python3, web, web-application
- Language: Python
- Homepage:
- Size: 227 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Django Polls - Complete App
**The completed web polls application with Python Django from tutorials**
## Overview
**Django** is one of the well-known and high-level Python web framework for rapid development and clean, pragmatic design. It takes care many steps of the web development, enabling to focus on writing applications without requiring to reinvent something. Moreover, Django is popular by being free and open-source.
This repository contains the files which correspond to the web polls application and all parts of the tutorial, which are available in Django's [official documentation](https://docs.djangoproject.com/en/5.1/), were followed to get the application working as intended and make it fully functional. Notice that there is a main project called ``mysite`` and inside, the ``polls`` application is available.
After the completion of this tutorial, I've implemented a few more things to present a much better design; such as different font in all pages, a static logo image that appears at the top, green buttons, table structure in poll results...
_The polls application was developed with Django version 5.1._
## Usage
Go to the directory where ``manage.py`` is available, and in the command prompt or terminal screen, type ``python manage.py runserver``.
When the server is up, then go to ``http://localhost:8000/polls/`` which is the main page and the starting point of web polls application. You should see several poll questions created already...
Try clicking one of the questions, select an option and click the Vote button. There should be the poll results page for how many votes have been given so far for the question. After that, you may vote again or move to another question.
### Administration Panel
To access the administration panel, go to ``http://localhost:8000/admin/`` and enter these credentials:
```
Username: doganyigityenigun
Password: django123456
```
There, you should see the ``Questions`` model and when you click on it, all the created questions will appear. Here, you can add a new question, define the corresponding choices. In the meantime, you can alter the existing questions and their choices and vote counts as you wish.
Keep in mind that the application only shows up to 5 questions in the main page, ordered by the publication date. Additionally, the questions from the future date will not appear in the poll list until it has been reached with the real date.
## Screenshots
The screenshots below could give an idea of which pages will be encountered throughout the web polls application.
.png)
.png)
.png)
## Details
There are many files and directories to properly operate the project and the web polls application itself.
**The root directory**
* ``manage.py``: The command-line utility for interacting with the Django project in various ways.
* ``db.sqlite3``: The database file to store the questions, choices and their related vote counts. Note that this app is using the default SQLite database system.
**``mysite`` directory**
* ``__pycache__``: This directory stores the compiled bytecode of imported modules within ``mysite``.
* ``__init__.py``: An empty file to tell Python that this directory should be considered as a Python package.
* ``asgi.py``: An entry point for ASGI-compatible web servres to serve the project.
* ``settings.py``: Settings and configurations for this Django project.
* ``urls.py``: The URL declarations for this Django project; think of it as a table of contents of this Django-powered site.
* ``wsgi.py``: An entry point for WSGI-compatible web servers to serve the project.
**``polls`` directory**
* ``__pycache__``: This directory stores the compiled bytecode of imported modules within ``polls``.
* ``migrations\0001_initial.py``: The details about the changes of the defined models are presented here; created after executing ''makemigrations``.
* ``static\polls``: This directory holds the static files (e.g. CSS, JavaScript methods, images).
* ``template\polls``: This directory contains the HTML page templates (with some Python code blocks) that correspond to the views for rendering (total of 3 pages).
* ``__init__.py``: An empty file to tell Python that this directory should be considered as a Python package.
* ``admin.py``: The customizations of polls administration page are contained here (items to display, filters, search fields, inlines).
* ``apps.py``: The application file for ``polls`` to be registered as installed app for the project.
* ``models.py``: The models and their attributes (fields) inside are implemented here; can contain additional self methods and foreign keys.
* ``tests.py``: Several test methods for ``Question`` model and ``Index`` view to make sure the application is working as expected by simulating user behaviors.
* ``urls.py``: The URL declarations for the web polls app, bound to their views. Currently, the generic views are being used for rendering pages.
* ``views.py``: The structures of all views are written here. Currently, the generic views are adopted for the purpose of less coding. In addition, there is also ``views_old1.py`` file that represents the traditional version of these views.
**``templates\admin`` directory**
This directory contains two files ``base_site.html`` and ``index.html`` in order to alter the structure of the admin pages. These were taken from the Django's source files. Only the title was changed to ``Polls Administration``.
## Commands for Managing the Project
These commands were used to manage the Django project and the web polls application together. You must be in the directory where ``manage.py`` resides before execution.
* **``django-admin startproject mysite djangotutorial``**: Create a project called ``mysite`` inside ``djangotutorial`` directory. This will generate a few files as the starting point.
* **``python manage.py runserver``**: Start the web server (development). Use ``Ctrl+C`` to stop.
* **``python manage.py startapp polls``**: Create a directory called ``polls`` and together with that, generate several files for initial operation.
* **``python manage.py makemigrations polls``**: Tell Django that some changes have been made to the models and want those changes to be stored as a migration.
* **``python manage.py migrate``**: Look for the ``INSTALLED_APPS`` setting, create any necessary database tables according to the database settings.
* **``python manage.py sqlmigrate polls 0001``**: Take the migration number for the app and return the SQL command for understanding what migration would run.
* **``python manage.py check``**: Check for any problems in the project without making migrations or altering the database.
* **``python manage.py shell``**: Start the interactive Python shell and play around with the free API given by Django.
* **``python manage.py createsuperuser``**: Create a user who can login to the admin site. Specify the username, e-mail address and password.
* **``python manage.py test polls``**: Run the written tests for ``polls`` application.