萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Django 整合 django-userena 實現用戶註冊登入完整教學

為什麼選擇 django-userena?

  • 內建註冊、登入、密碼重設、啟用郵件、個人資料、頭像、隱私設定
  • 支援匿名用戶、權限細粒度控制
  • 提供預設範本與完整 Demo 專案
  • 活躍維護 (截至 Django 1.8 時代),現代替代方案見文末

安裝與基礎配置


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  # 開發環境

整合 Bootstrap (覆寫表單與範本)

1. 自訂表單加入 Bootstrap 樣式


# 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__()

2. 覆寫 URL 指定自訂表單


# 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...
)

3. 覆寫範本 (關鍵步驟)


# 目錄結構
templates/
└── userena/
    ├── base.html          # 繼承專案 base.html
    ├── signup_form.html   # 註冊表單
    ├── signin_form.html   # 登入表單
    └── profile_detail.html # 個人資料頁


{% extends "userena/base.html" %}
{% load i18n bootstrap %}

{% block content %}
{% csrf_token %} {{ form|bootstrap_horizontal }}
{% 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 2.0+)

django-userena 已停止維護,新專案建議使用:

方案特點
django-allauth最流行,支援社交登入 (OAuth2)、郵件驗證、雙因子認證
django-rest-auth / dj-rest-authDRF 專用,REST API 認證完整方案
自訂 User Model + 簡單 View輕量,完全控制,適合簡單需求

遷移建議

  1. 新專案直接用 django-allauth
  2. 舊專案維護:鎖定 django-userena==2.0.1、Django<2.0
  3. 遷移時注意:UserenaBaseProfile → AbstractUser 或 Profile OneToOne
copyright © 萬盛學電腦網 all rights reserved