1. Django Tutorial(Airbnb) - Custom User Model

🌈 Custom User Model

🔥 Substituting a custom User model

🔥 Model field

1. Django custom User model

1) createsuperuser

• admins site(http://127.0.0.1:8000/admin)로 접근하면 Admin Site에 접근하기 위한 로그인창이 나타나는데요,, console 명령을 통해 관리자 계정(superuser)을 생성 후 로그인이 가능합니다.
  • 🔎 python manage.py createsuperuser
• 명령으로 간편하게 관리자 계정을 생성 가능하다는 것은 Django가 이미 User 모델을 가지고 있기 때문이에요. 따라서 Django가 이미 가지고 있는 User 모델("AbstractUser")을 상속받고 이를 확장시켜 사용해볼께요.
• Django가 가진 User 모델에 추가로 필드를 확장시키기 위해서 settgins.py의 설정에서 아래와 같이 명시해 주어야해요. 이를 "Substituting a custom User model"라 합니다.
  • 참고 : https://docs.djangoproject.com/en/2.2/topics/auth/customizing/
  • 🔎 AUTH_USER_MODEL = '[앱이름].[모델명]'

# settings.py
# Custom User Model
AUTH_USER_MODEL = "users.User" # 👈 users앱의 "User" Model을 확장에 사용할꺼에요:)

2) models.py

• settgins.py의 설정을 통해 Django의 모델을 상속받기로 설정하였다면, models.py에서 "AbstractUser"를 상속 받아옵니다.

from django.contrib.auth.models import AbstractUser # 👈 AbstractUser를 import
from django.db import models
class User(AbstractUser):
    pass

• 혹시, 이미 superuser를 통해 관리자 계정을 생성하였거나, Model에 데이터가 이미 존재하여 오류가 발생하였다면, DB를 초기화시키기 위해서 "db.sqlite3"를 지우고 migration 시켜주세요!
  • 🔎 "db.sqlite3" 삭제
  • 🔎 python manage.py makemigrations && python manage.py migrate

3) admin.py

• 생성한 Model을 Admin Site에서 나타나게 하려면,, Model을 admin.py에 등록시켜줘야 합니다.

from django.contrib import admin
from . import models # 👈 해당 model이 존재하는 파일을 import
@admin.register(models.User) # 👈 데코레이터로 등록
class CustomUserAdmin(admin.ModelAdmin):
    pass

2. Model field

1) ImageField()

• ImageField는 이미지 파일을 저장하는 필드에요,, 아래 오류가 나타난다면 "pillow"를 설치합니다:)
• "pillow" 설치 방법 : 🔎 pipenv install pillow

2) CharField() & TextField()

• CharField는 성별, 제목, 이름 등 짧은 Text를 위한 Field이고, TextField는 소개, 설명 등 긴 문장을 저장하는 Field가 필요입니다.
• max_length 속성
  • CharField에서는 텍스트의 길이를 제한하기 위해 max_length 속성을 항상 이용합니다.
• null 속성
  • null은 빈값을 DB에 허용하지 결정하는 속성으로 default로 "null=False"가 적용되어 있으나, "null=True"로 지정하면, DB에 빈값을 허용시킵니다.
• console에 아래처럼 나타난 것은 기존에 이미 생성된 데이터는 어떻게 할건지에 대해 물어보는 거에요:) 1번은 console에서 처리하겠다는 의미이고, 2번은 현재 명령을 취소하고 에디터에서 이를 처리하겠다는 의미입니다.
• default 옵션
  • default를 사용하면 DB에 필드가 비어있을 경우, 필드값을 null로 두는게 아니라 default로 지정할 수 있어요. default를 통해 이미 생성된 데이터의 해당 필드값을 ""의 내용으로 채워줄 수 있어요!
• blank 속성
  • blank를 사용하면 Admin Panel 상의 빈 값을 허용시킬지 결정할 수 있어요. default로는 "blank=False"이며, "blank=True"로 지정하면 Admin Site 상에서 form의 빈값을 허용시킵니다. 이에 "blank=True" 지정하면 Admin Panel에 "This field is required" 에러가 발생하지 않아요!
• 새로운 필드를 추가하였거나, 필드가 수정되었다면 migrate로 진행해주어야 반영됩니다:)
  • 🔎 python manage.py makemigrations → python manage.py migrate
• choices 속성
  • choices 옵션은 CharField 필드에서 선택 목록을 제공해 줍니다. 선택 목록을 상수로 만들어 choices의 값으로 지정하면 아래처럼 선택 목록이 표시됩니다. 참고로 이 속성은 필드의 form 양식을 custom한 것이기 때문에 migrate를 해주지 않아도 적용되요:)

from django.contrib.auth.models import AbstractUser
from django.db import models
class User(AbstractUser):
    """Custom User Model"""
    GENDER_MALE = "male"  # 👈 "male"은 DB에 저장될 값
    GENDER_FEMALE = "female"  
    GENDER_OTHER = "other"  
    GENDER_CHOICES = (
        (GENDER_MALE, "Male"),  # 👈 "Male"은 admin에 표시되는 값
        (GENDER_FEMALE, "Female"), 
        (GENDER_OTHER, "Other"), 
    )
    LANGUAGE_ENGLISH = "en" # 👈 "en"은 DB에 저장될 값
    LANGUAGE_KOREAN = "kr"
    LANGUAGE_CHOICES = (
        (LANGUAGE_ENGLISH, "English"), # 👈 "English"는 admin에 표시되는 값
        (LANGUAGE_KOREAN, "Korean"),
    )
    avatar = models.ImageField(null=True, blank=True)
    gender = models.CharField(choices=GENDER_CHOICES, max_length=10, null=True, blank=Tru)
    bio = models.TextField(default="", blank=True)
    language = models.CharField(choices=LANGUAGE_CHOICES, max_length=2)

3) DateTimeField() vs DataField()

• DateTimeField는 날짜와 시간까지 입력을 제공하는 필드이며, DateField 날짜만 입력이 필요할 때 사용합니다.
  • 🔎 birthdate = models.DateField(null=True)
• 옵션으로는 "auto_now"와 "auto_now_add"가 대표적입니다.
  • auto_now : Model의 Object가 저장될 때마다 값을 갱신
  • auto_now_add : Model에 Object가 최초 저장 때만 값을 저장

4) BooleanField

• BooleanField는 False와 True값만 저장할 때 사용하는 Field이며, 일반적으로 default 옵션과 함께 사용됩니다.
  • 🔎 superhost = models.BooleanField(default=False)

from django.contrib.auth.models import AbstractUser
from django.db import models
# Create your models here.
class User(AbstractUser):
    """Custom User Model"""
    GENDER_MALE = "male"
    GENDER_FEMALE = "female"
    GENDER_OTHER = "other"
    GENDER_CHOICES = (
        (GENDER_MALE, "Male"),
        (GENDER_FEMALE, "Female"),
        (GENDER_OTHER, "Other"),
    )
    LANGUAGE_ENGLISH = "en"
    LANGUAGE_KOREAN = "kr"
    LANGUAGE_CHOICES = (
        (LANGUAGE_ENGLISH, "English"),
        (LANGUAGE_KOREAN, "Korean"),
    )
    CURRENCY_USD = "usd"
    CURRENCY_KRW = "krw"
    CURRENCY_CHOICES = (
        (CURRENCY_USD, "USD"),
        (CURRENCY_KRW, "KRW"),
    )
    avatar = models.ImageField(null=True, blank=True)
    gender = models.CharField(
        choices=GENDER_CHOICES, max_length=10, null=True, blank=True
    )
    bio = models.TextField(default="", blank=True)
    birthdate = models.DateField(null=True)
    language = models.CharField(
        choices=LANGUAGE_CHOICES, max_length=2, null=True, blank=True
    )
    currency = models.CharField(
        choices=CURRENCY_CHOICES, max_length=3, null=True, blank=True
    )
    superhost = models.BooleanField(default=False)

• Birthdate만 Bold가 적용되었는데, 이는 blank=False이기 때문입니다. 즉, Admin Site에서 빈값을 허용하지 않겠다는 의미이죠. 이 처럼 반드시 입력해야 저장할 수 있는 필드는 Bold가 적용되 있습니다:)