Az egyéni felhasználói modell helyettesíti a Django alapértelmezett User modelljét, hogy illeszkedjen az alkalmazás igényeihez — új mezőket adhat hozzá, megváltoztathatja a bejelentkezési azonosítót (pl. e-mail felhasználónév helyett), vagy testreszabhatja a viselkedést. A kritikus, gyakran ismételt tanács: az egyéni felhasználói modellt a projekt kezdetén állítsa be, még akkor is, ha nem szükséges módosítás, mert később rendkívül fájdalmas a változtatás.
The default User has fixed fields (username, email, first/last name) and uses
USERNAME as the login field. Real apps often need:
✓ Email-based login (no username)
✓ Extra fields (phone, avatar, role, preferences) on the user itself
✓ Custom authentication behavior
⚠️ Changing the user model AFTER migrations exist is VERY hard — the User model is
referenced by auth, admin, sessions, foreign keys throughout the database.
Swapping it later requires complex, risky data migrations.
→ ALWAYS define a custom user model at project START (before the first migration),
even an empty one, so you can extend it freely later. Django's docs strongly
recommend this for EVERY new project.
Ez a legfontosabb gyakorlati tanulság: szinte semmibe nem kerül egy egyéni felhasználói modell beállítása az első napon, de egy már megállapított projekthez való hozzáadása jelentős, hibára hajlamos feladat — ezért csinálja meg előre biztosítékként.
# models.py — add fields, keep Django's auth behavior
from django.contrib.auth.models import AbstractUser
class User(AbstractUser):
phone = models.CharField(max_length=20, blank=True)
avatar = models.ImageField(upload_to="avatars/", blank=True)
is_premium = models.BooleanField(default=False)
# settings.py — tell Django to use it
AUTH_USER_MODEL = "myapp.User"
Az AbstractUser megtartja a Django összes alapértelmezett mezőjét és hitelesítési mechanizmusát — csak új mezőket adhat hozzá. Az egyszerűbb, leggyakoribb megközelítés.
from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin
class User(AbstractBaseUser, PermissionsMixin):
email = models.EmailField(unique=True)
USERNAME_FIELD = "email" # log in with EMAIL instead of username
REQUIRED_FIELDS = []
objects = CustomUserManager() # a manager defining create_user/create_superuser
Az AbstractBaseUser teljes kontrollt biztosít a felhasználói modell felett (pl. a felhasználónevet teljesen eltávolítva csak e-mail alapú bejelentkezéshez) — több munka, de maximális rugalmasság.
from django.conf import settings
from django.contrib.auth import get_user_model
# in models — reference via settings.AUTH_USER_MODEL
author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
# in code — get the active user model dynamically
User = get_user_model() # NOT a direct import of the default User
Mindig a settings.AUTH_USER_MODEL (modellekben) és get_user_model() (kódban) segítségével hivatkozzon a felhasználói modellre, soha ne importálja közvetlenül az alapértelmezett User modellt — így a kód az egyéni modellel működik.
Az egyéni felhasználói modell használata fontos tudás, amely egy kritikus, gyakran hangsúlyozott gyakorlati tanulsággal jár, amelyet minden Django fejlesztőnek internalizálnia kell: állítsa be az első napon minden projektben.
Ennek azért van olyan nagy jelentősége, mert a nehézség assymetrikus — egy egyéni felhasználói modell meghatározása az első napon (még egy üres AbstractUser alosztály is) szinte semmibe nem kerül és felbecsülhetetlen rugalmasságot nyújt, míg a projekt migrációi és adatai után utána egy egyéni felhasználói modellre való áttérés rendkívül fájdalmas és kockázatos, mert a User modell a Django egész területén mélyen hivatkozva van (hitelesítés, admin, munkamenetek) és idegenkulcsok az egész adatbázisában, összetett, hibára hajlamos adatmigrációkat igényelve a módosításhoz.
Ez az oka annak, hogy a Django saját dokumentációja erősen ajánl egy egyéni felhasználói modellt minden új projekthez, az azonnali szükséglettől függetlenül — ez biztosíték egy jövőbeli migrációs rémálom ellen.
Ezen túl az alapvető időzítési tanács, az egyéni felhasználói modellek létrehozásának megértése — AbstractUser a mezők egyszerű hozzáadásához a Django hitelesítési viselkedésének megtartásával (a gyakori, könnyű eset), és AbstractBaseUser a teljes kontrolhoz, például az e-mail alapú bejelentkezéshez (a felhasználónév teljes eltávolítása) — értékes a valódi alkalmazásigények teljesítéséhez (extra felhasználói mezők, alternatív bejelentkezési azonosítók, egyéni hitelesítés).
Egyaránt fontos a felhasználói modellre való helyes hivatkozás (a settings.AUTH_USER_MODEL és get_user_model() segítségével, soha közvetlenül importálva), hogy a kód bármilyen konfigurált felhasználói modellel működjön.
Mivel szinte minden valódi alkalmazásnak vannak Django alapértelmezésein túli felhasználó-specifikus igényei (és még azok is, amelyeknek nincsenek, profitálnak a rugalmasságból), és mivel az ennek nem való beállítása költsége olyan magas, az egyéni felhasználói modellek megértése — különösen a projekt elején való felállítás parancsa — fontos, gyakorlatilag kritikus tudás, amely megakadályozza a gyakori és komoly projektszintű hibát, így a Django bevált gyakorlatának gyakran idézett darabjává válik.