Update admin.py

src/DjangoBlog-master/oauth/admin.py

@@ -1,54 +1,77 @@
 import logging
 
 from django.contrib import admin
-# Register your models here.
+# 注册模型到admin后台（此处注释用于提示后续需注册模型）
 from django.urls import reverse
 from django.utils.html import format_html
 
+# 创建当前模块的日志记录器
 logger = logging.getLogger(__name__)
 
 
+# 定义OAuthUser模型的Admin管理类
 class OAuthUserAdmin(admin.ModelAdmin):
+    # 配置后台搜索字段：支持按昵称和邮箱搜索
     search_fields = ('nickname', 'email')
+    # 每页显示20条记录
     list_per_page = 20
+    # 列表页显示的字段
     list_display = (
-        'id',
-        'nickname',
-        'link_to_usermodel',
-        'show_user_image',
-        'type',
-        'email',
+        'id',                  # ID
+        'nickname',            # 昵称
+        'link_to_usermodel',   # 关联的本地用户（自定义字段）
+        'show_user_image',     # 用户头像（自定义字段）
+        'type',                # 第三方登录类型
+        'email',               # 邮箱
     )
+    # 列表页中可点击跳转编辑页的字段
     list_display_links = ('id', 'nickname')
+    # 列表页的筛选器：按关联用户和登录类型筛选
     list_filter = ('author', 'type',)
+    # 初始定义的只读字段（空列表，后续动态添加）
     readonly_fields = []
 
+    # 动态获取只读字段：编辑时所有字段均为只读
     def get_readonly_fields(self, request, obj=None):
-        return list(self.readonly_fields) + \
-               [field.name for field in obj._meta.fields] + \
-               [field.name for field in obj._meta.many_to_many]
+        if obj:  # 编辑已有对象时
+            # 原只读字段 + 所有模型字段 + 所有多对多字段
+            return list(self.readonly_fields) + \
+                   [field.name for field in obj._meta.fields] + \
+                   [field.name for field in obj._meta.many_to_many]
+        return self.readonly_fields  # 新增时使用初始只读字段
 
+    # 禁用新增权限：不允许在后台手动添加OAuthUser记录
     def has_add_permission(self, request):
         return False
 
+    # 自定义字段：显示关联本地用户的链接
     def link_to_usermodel(self, obj):
-        if obj.author:
+        if obj.author:  # 若存在关联用户
+            # 获取关联用户模型的app标签和模型名
             info = (obj.author._meta.app_label, obj.author._meta.model_name)
+            # 生成关联用户在admin后台的编辑页URL
             link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))
+            # 返回HTML格式的链接（显示用户昵称或邮箱）
             return format_html(
                 u'<a href="%s">%s</a>' %
                 (link, obj.author.nickname if obj.author.nickname else obj.author.email))
 
+    # 自定义字段：显示用户头像
     def show_user_image(self, obj):
-        img = obj.picture
+        img = obj.picture  # 获取头像URL
+        # 返回HTML格式的图片标签（限制宽高为50px）
         return format_html(
             u'<img src="%s" style="width:50px;height:50px"></img>' %
             (img))
 
+    # 自定义字段的显示名称
     link_to_usermodel.short_description = '用户'
     show_user_image.short_description = '用户头像'
 
 
+# 定义OAuthConfig模型的Admin管理类
 class OAuthConfigAdmin(admin.ModelAdmin):
+    # 列表页显示的字段
     list_display = ('type', 'appkey', 'appsecret', 'is_enable')
-    list_filter = ('type',)
+    # 列表页的筛选器：按登录类型筛选
+    list_filter = ('type',)