understanding-django/dear_diary/README.md

Dear Diary Project

This is notes from course.

Create Project And App

1. Under undestanding-django directory, create project dear_diary

   $ pipenv install
   $ pipenv shell
   $ django-admin startproject dear_diary 
   

2. Go to dear_diary directory and create app entries

   $ cd dear_diary
   $ python manage.py startapp entries
   

App Files

• migrations - For database versioning.
• admin.py - Register models appearing at admin dashboard.
• models.py - Control whats save in your database.
• tests.py - Tests for this app
• views.py - (Render views/Response) for url

Admin Dashboard

1. Initialize database (Default generate db.sqlite3)

   $ python manage.py migrate
   
   Operations to perform:
       Apply all migrations: admin, auth, contenttypes, sessions
       Running migrations:
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
       Applying admin.0002_logentry_remove_auto_add... OK
       Applying admin.0003_logentry_add_action_flag_choices... OK
       Applying contenttypes.0002_remove_content_type_name... OK
       Applying auth.0002_alter_permission_name_max_length... OK
       Applying auth.0003_alter_user_email_max_length... OK
       Applying auth.0004_alter_user_username_opts... OK
       Applying auth.0005_alter_user_last_login_null... OK
       Applying auth.0006_require_contenttypes_0002... OK
       Applying auth.0007_alter_validators_add_error_messages... OK
       Applying auth.0008_alter_user_username_max_length... OK
       Applying auth.0009_alter_user_last_name_max_length... OK
       Applying auth.0010_alter_group_name_max_length... OK
       Applying auth.0011_update_proxy_permissions... OK
       Applying sessions.0001_initial... OK
   

2. Create superuser

   $ python manage.py createsuperuser                                              
   Username (leave blank to use 'bobson'): 
   Email address: bobson.lin@aiwill.tech
   Password: 
   Password (again): 
   Superuser created successfully.
   

3. Run project (http://127.0.0.1:8000/admin will show admin dashboard)

   $ python manage.py runserver
   
   Watching for file changes with StatReloader
   Performing system checks...
   
   System check identified no issues (0 silenced).
   June 21, 2019 - 03:24:05
   Django version 2.2.2, using settings 'dear_diary.settings'
   Starting development server at http://127.0.0.1:8000/
   Quit the server with CONTROL-C.
   

Display Templates

1. Create templates directory for entries app
2. Create functions(index, add) in views.py
3. Create entries/urls.py and adjust dear_diary/urls.py
4. Add entries app in settings.py INSTALLED_APPS section

Add Page Link

1. Use name argument in django.urls.path function.
2. In template file(*.html), add {% url '[name]' %} (eg. {% url 'add' %} for /add url)

Create Entry Model

1. Add Entry model class in models.py
2. Register Entry model in admin.py
3. Run command to create migration file and do migration.

   $ python manage.py makemigrations
   Migrations for 'entries':
   entries/migrations/0001_initial.py
       - Create model Entry
   
   $ python manage.py migrate
   Operations to perform:
   Apply all migrations: admin, auth, contenttypes, entries, sessions
   Running migrations:
   Applying entries.0001_initial... OK
   

4. Check http://127.0.0.1:8000/admin

Display Entries From Database

1. Query entries in views.index function.
2. Use for loop in index.html template.

Creating A Form

1. Create EntryForm in entries/forms.py.
2. Use EntryForm in views.add function.
3. Use form in add.html template.

Processing The Form

1. Use EntryForm to handle POST request.
2. Redirect after submit form.
3. Add CSRF token in form.