西游之路——python全栈——CRM项目之Kingadmin开发

一、Kingadmin设计

　　1、原因

　　　　由于每个用户都需要增删改查，所有开发一个Kingadmin模块，支持所有用户，只需配置注册即可

　　2、创建APP之Kingadmin，并把statics、templates及相关的views跟urls导入致Kingadmin

二、自动发现及注册功能开发

　　1、程序启动则自动触发注册

　　　　流程：  程序启动    ==>   解析views视图   ==>   调用app_setup模块下kingadmin_auto_discover函数   ==>   逐一触发其app下的Kingadmin模块   ==>   调用sites模块实例化后创建一个字典（只实例化一次），再执行register函数进行注册动作，并把信息封装到字典

==========================

from kingadmin import app_setup
app_setup.kingadmin_auto_discover()

==========================

from django import conf   # 动态获取settings配置

def kingadmin_auto_discover():
    for app_name in conf.settings.INSTALLED_APPS:
        try:
            mod = __import__('%s.kingadmin' % app_name)
            print(mod.kingadmin)
        except ModuleNotFoundError:
            pass

==========================

from crm import models
from kingadmin.sites import site
from kingadmin.admin_base import BaseKingAdmin

class CustomAdmin(BaseKingAdmin):
    list_display = ['name', 'source', 'contact_type', 'contact', 'consultant', 'consult_content', 'status', 'date']
    list_filter = ['source', 'consultant', 'status', 'date']

site.register(models.CustomerInfo,CustomAdmin)
site.register(models.Menus)
site.register(models.UserProFile)
site.register(models.StudyRecord)
site.register(models.CustomerFollowUp)

=========================

from kingadmin.admin_base import BaseKingAdmin

class AdminSite(object):
    def __init__(self):
        self.enabled_admins = {}

    def register(self,model_class,admin_class=None):
        """注册admin表"""
        # 根据model中类名获取APP名
        app_name = model_class._meta.app_label
        # 根据model中类名获取表名，类名的小写
        model_name = model_class._meta.model_name

        # 不传值时默认BaseKingAdmin，并实例化
        if not admin_class:
            admin_class = BaseKingAdmin()
        else:
            # 每次实例化，防止使用同一内存地址
            admin_class = admin_class()
        # ??????? admin_class为对象才能 .model添加存入对象
        admin_class.model = model_class  # 把model_class赋值给admin_class为了能关联起来
        if app_name not in self.enabled_admins:
            self.enabled_admins[app_name] = {}
        self.enabled_admins[app_name][model_name] = admin_class

        print(model_class,admin_class)

site = AdminSite()   # 只实例化一次，后面的导入为调用对象

========================

dict = {
    'app1':{'表名1':'自定义类名1','表名2':'自定义类名2'},
    'app2':{'表名1':'自定义类名1','表名2':'自定义类名2'},
}

三、APP首页开发

　　1、URL

re_path('^kingadmin/', include('kingadmin.urls')),


urlpatterns = [
    re_path('^$', views.app_index,name='app_index'),
    re_path('^/(w+)/(w+)/$', views.table_obj_list,name='table_obj_list'),
    re_path('^login/', views.acc_login),
    re_path('^logout/', views.acc_logout,name='logout'),
]

　　2、视图函数

def app_index(request):
    return render(request, 'kingadmin/app_index.html',{'site':site})

　　3、setting配置与templates模块

注意：从上往下找

　　

　　4、templates模块

{% extends 'kingadmin/index.html' %}

{% block right-content-container %}
    <h1 class="page-header">app</h1>

    <div>
        {% for app_name,app_tables in site.enabled_admins.items %}
        <table class="table table-striped">
            <thead>
                <tr>
                    <th>{{app_name}}</th>
                </tr>
            </thead>
            <tbody>
                {% for model_name in app_tables %}
                <tr>
                    <td><a href="{% url 'table_obj_list' app_name model_name %}">{{model_name}}</a></td>
                    <td>ADD</td>
                    <td>Change</td>
                </tr>
                {% endfor %}
            </tbody>
        </table>
        {% endfor %}
    </div>

{% endblock %}

四、model_obj_list开发之生成列表跟过滤

　　1、URL

　　　　见上

　　2、views视图

def get_filter_result(admin_class,request):
    filter_conditions = {}
    for key,val in request.GET.items():
        # val为空时不过滤
        if val:
            filter_conditions[key] = val
    filtered_querysets = admin_class.model.objects.filter(**filter_conditions).all()
    return filtered_querysets,filter_conditions

@login_required()
def table_obj_list(request,app_name,model_name):
    """取出指定model里的数据返回给前端"""
    admin_class = site.enabled_admins[app_name][model_name]

    # 调用函数过滤处理，并返回
    querysets,filter_conditions = get_filter_result(admin_class, request)
    admin_class.filter_conditions = filter_conditions

    return render(request, 'kingadmin/table_obj_list.html',{
        'querysets':querysets,
        'admin_class':admin_class,
    })

　　3、templates模块

{% extends 'kingadmin/index.html' %}
{# 导入标签模块 #}
{% load kingadmin_tag %}  {# build_table_row' is not a registered tag library 重启即可 #}

{% block right-content-container %}
    <h1 class="page-header">app</h1>

    <div>
        <form action="">
            {% for filter_column in admin_class.list_filter %}
                {% build_filter_ele filter_column admin_class %}
            {% endfor %}
            <input type="submit" value="过滤">
        </form>
    </div>

    <div>
        <table class="table table-striped">
            <thead>
                <tr>
                    {% for column in admin_class.list_display %}
                    <th>{{column}}</th>
                    {% endfor %}
                </tr>
            </thead>
            <tbody>
                {% for obj in querysets %}
                <tr>{% build_table_row obj admin_class %}</tr>
                {% endfor %}
            </tbody>
        </table>

    </div>

{% endblock %}

　　4、templatetags自定义

from django.template import Library
from django.utils.safestring import mark_safe
import datetime

register = Library()

@register.simple_tag
def build_table_row(obj,admin_class):
    """生成一条记录html element"""
    ele = ''
    for column_name in admin_class.list_display:
        column_obj = admin_class.model._meta.get_field(column_name)
        if column_obj.choices:  # 判断字段是否为choice
            column_data = getattr(obj, 'get_%s_display' %column_name)()   # 获取choice的值
        else:
            column_data = getattr(obj, column_name)  # 反射
        ele += '<td>%s</td>' % column_data
    return mark_safe(ele)

@register.simple_tag
def build_filter_ele(filter_column,admin_class):
    """过滤"""
    #获取字段对象
    column_obj = admin_class.model._meta.get_field(filter_column)
    try:
        filter_select = '<select name=%s>' % filter_column
        for choice in column_obj.get_choices():
            selected = ''
            # if filter_column in admin_class.filter_conditions:  # 当前字段被过滤了
            if str(choice[0]) == admin_class.filter_conditions.get(filter_column):  # 当前值被选中
                selected = 'selected'
            option = "<option value='%s' %s>%s</option>" % (choice[0],selected,choice[1])
            filter_select += option
    except AttributeError as e:
        print('err',e)
        filter_select = '<select name=%s__gte>' % filter_column
        # 判断字段属性
        if column_obj.get_internal_type() in ('DateField','DateTimeField'):
            time_obj = datetime.datetime.now()
            time_list = [
                ['--------------',''],
                ['Today',time_obj],
                ['Past 7 day',time_obj-datetime.timedelta(7)],
                ['This month',time_obj.replace(day=1)],
                ['Past 3 month',time_obj-datetime.timedelta(90)],
                ['This year',time_obj.replace(month=1,day=1)],
                ['Any day',''],
            ]
            for i in time_list:
                selected = ''
                time_to_str = '' if not i[1] else '%s-%s-%s' %(i[1].year,i[1].month,i[1].day)
                if time_to_str == admin_class.filter_conditions.get('%s__gte' %filter_column):  # 当前值被选中
                    selected = 'selected'
                option = '<option value=%s %s>%s</option>' % (time_to_str,selected,i[0])
                filter_select += option

    filter_select += '</select>'
    return mark_safe(filter_select)