pip install django-userena django-guardian easy-thumbnails
# settings.py
INSTALLED_APPS = [
# ...
'userena',
'guardian',
'easy_thumbnails',
'accounts', # 自訂用戶應用
]
AUTHENTICATION_BACKENDS = (
'userena.backends.UserenaAuthenticationBackend',
'guardian.backends.ObjectPermissionBackend',
'django.contrib.auth.backends.ModelBackend',
)
ANONYMOUS_USER_ID = -1
AUTH_PROFILE_MODULE = 'accounts.Profile' # 自訂 Profile 模型
# userena 設定
USERENA_SIGNIN_REDIRECT_URL = '/accounts/%(username)s/'
USERENA_ACTIVATION_REQUIRED = True
USERENA_MUGSHOT_SIZE = 100
USERENA_USE_HTTPS = False # 開發環境
# accounts/forms.py
from django import forms
from userena.forms import SignupForm, AuthenticationForm
from bootstrap.forms import BootstrapMixin # 需安裝 django-bootstrap-form
class BsSignupForm(SignupForm, BootstrapMixin):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.__bootstrap__()
class BsAuthenticationForm(AuthenticationForm, BootstrapMixin):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.__bootstrap__()
# urls.py
from django.conf.urls import patterns, include, url
from userena import views as userena_views
from accounts.forms import BsSignupForm, BsAuthenticationForm
urlpatterns = patterns('',
url(r'^accounts/signup/$', userena_views.signup,
{'signup_form': BsSignupForm}, name='userena_signup'),
url(r'^accounts/signin/$', userena_views.signin,
{'auth_form': BsAuthenticationForm}, name='userena_signin'),
url(r'^accounts/', include('userena.urls')),
# 其他 url...
)
# 目錄結構
templates/
└── userena/
├── base.html # 繼承專案 base.html
├── signup_form.html # 註冊表單
├── signin_form.html # 登入表單
└── profile_detail.html # 個人資料頁
{% extends "userena/base.html" %}
{% load i18n bootstrap %}
{% block content %}
{% endblock %}
預設僅允許字母數字底線,需自訂驗證規則:
# accounts/forms.py (續)
from django.utils.translation import ugettext_lazy as _
# 允許中文、字母、數字、底線、點
USERNAME_RE = r'^[\w\u4e00-\u9fff.]+$'
class BsSignupForm(SignupForm, BootstrapMixin):
username = forms.RegexField(
regex=USERNAME_RE,
max_length=30,
widget=forms.TextInput(attrs={'class': 'form-control'}),
label=_("Username"),
error_messages={
'invalid': _('用戶名僅限中文、英文、數字、底線和點')
}
)
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.__bootstrap__()
# 開發環境: 主控台輸出
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
# 生產環境: SMTP
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.exmail.qq.com'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'noreply@example.com'
EMAIL_HOST_PASSWORD = 'your_password'
DEFAULT_FROM_EMAIL = 'Example '
django-userena 已停止維護,新專案建議使用:
| 方案 | 特點 |
|---|---|
| django-allauth | 最流行,支援社交登入 (OAuth2)、郵件驗證、雙因子認證 |
| django-rest-auth / dj-rest-auth | DRF 專用,REST API 認證完整方案 |
| 自訂 User Model + 簡單 View | 輕量,完全控制,適合簡單需求 |
django-allauthdjango-userena==2.0.1、Django<2.0UserenaBaseProfile → AbstractUser 或 Profile OneToOne