py3.6 + xadmin的自学网站搭建
Posted 向前跑,带着冷眼与嘲笑
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了py3.6 + xadmin的自学网站搭建相关的知识,希望对你有一定的参考价值。
xadmin安装
由于安装时需要依赖包并且暂时不支持py3等原因,直接pip install的方法很容易就狗带了。
说一下我在网上找到的安装方式,在GitHub上有这个项目的开源代码,并且还有很多个版本可以选择。
克隆一份,clone地址:xadmin,新建一个空白的README.rst代替之前的文件。
cmd进入dos,执行python setup.py install,出现gbk解码问题,返回上一步确定README.rst是一个空白文件。这样安装xadmin就完成了。
狸猫换太子
算了还是叫太子换狸猫吧,admin文档太少用起来还不如自己写的后台管理,用xadmin更换django自带的admin,安装xadmin的过程与写一个app分支的过程一致。这里我简述一下步骤。
第一步,创建一个文件包放置xadmin的app,并且将app注册在settings.py文件中。
INSTALLED_APPS = [ \'django.contrib.admin\', \'django.contrib.auth\', \'django.contrib.contenttypes\', \'django.contrib.sessions\', \'django.contrib.messages\', \'django.contrib.staticfiles\', \'blog\', \'xadmin\', \'crispy_forms\',#必须要注册这两个app ]
第二步修改url,用xadmin代替admin。
from django_extra import xadmin from blog import views urlpatterns = [ # url(r\'^admin/\', admin.site.urls), url(r\'^xadmin/\', xadmin.site.urls), url(r\'^index/\', views.index ), ]
这里提醒一下,如果你之前创建好了数据库,在这里使用xadmin之前需要同步一下数据库的相关数据,就是:
python manage.py makemigrations
python manage.py migrate
当然你还需要创建后台管理的超级管理员。
python manage.py createsuperuser
当然你觉得英文界面可能对你不够友好,在settings里进行配置,设置为中文,这个与admin操作一致:
LANGUAGE_CODE = \'zh-hans\' TIME_ZONE = \'Asia/Shanghai\' USE_I18N = True USE_L10N = True USE_TZ = False
当然我们可以让后台搭建的好看一点:
class BaseSetting: \'\'\' 增加主题样式 \'\'\' enable_themes = True use_bootswatch = True class GlobalSetting(object): \'\'\' 修改标题 \'\'\' site_title = "jeff后台管理系统" site_footer = "http://www.cnblogs.com/Jeffding/" menu_style = "accordion"#下拉框收起来 xadmin.site.register(views.BaseAdminView, BaseSetting) xadmin.site.register(views.CommAdminView, GlobalSetting)
后台管理的搭建非常迅速,也非常好用,django的后台管理是根据数据表的管理,所以适用于大多数情况,给我们开发带来了便利。
登陆注册
为了使用django后台自带的认证与登陆,所以我们的用户表最好还是继承它的用户表比较好,这样我们登录认证和session写入django都帮我们做好了,所以别人做好的东西,当然是拿来用啦。
所以我们需要重写user模型。
第一步,修改settings.py配置文件,覆盖默认的user模型:
AUTH_USER_MODEL = "users.UserInfo"
class UserInfo(AbstractUser): """ 用户表 """ nickname = models.CharField(verbose_name=\'昵称\', max_length=32) address = models.CharField(verbose_name=\'地址\', max_length=100) cellphone_number = models.CharField(verbose_name=\'手机号\', max_length=11) birthday = models.DateField(verbose_name=\'生日\', null=True, blank=True,) avatar = models.ImageField(verbose_name=\'头像\', upload_to=\'static/imgs/%Y/%m\',default=\'static/imgs/default.png\') create_time = models.DateTimeField(verbose_name=\'创建时间\', auto_now_add=True) sex_choices = [ ("male", "男"), ("female", "女"), ] sex = models.CharField(choices=sex_choices, default=\'male\', verbose_name=\'性别\', max_length=6) class Meta: verbose_name = \'用户信息\' verbose_name_plural = verbose_name def __str__(self): return self.username
衍生的model是继承了AbstractUser的,所以在写的过程中不要写与父类重复的字段(尤其是登陆字段)如果写重复了会导致在哪登陆都无法登陆的情况。
最后一步别忘了同步数据表。
这里提一个映射模板的方法,我们可以从视图函数中返回,简洁的写法可以调用TemplateView模块:
from django.views.generic import TemplateView urlpatterns = [ url(r\'^$\', TemplateView.as_view(template_name="index.html"), name=\'index\'), ]
我们在模板中可以用name反向找到url,虽然as_view可以将模板直接当作视图函数,但是没办法写试图函数的逻辑处理,所以这种方式使用的并不多。
正式需要写登陆这样有业务处理逻辑的试图函数url指向view,毕竟django是MVC的框架。
关于登陆,django自己有一个后台的登陆系统,并且xadmin的登陆是它自己做的,你没有进行配置,我们登陆可以使用这个模块:
from django.shortcuts import render from django.contrib.auth import login as dj_login, authenticate def login(request): if request.method == "POST": user_name = request.POST.get("username", "") pass_word = request.POST.get("password", "") user = authenticate(username=user_name, password=pass_word) print(user_name, pass_word) if user is not None: dj_login(request, user) return render(request, "index.html", {}) else: return render(request, "login.html", {"msg": "username or password is wrong"}) elif request.method == "GET": return render(request, "login.html", {})
避免auth的login方法与我们定义的视图函数名称重复,我们导入时更换函数名。
如果我们想要使用账号或者邮箱都可以登录,那么我们需要自定义auth方法。django允许我们在配置文件中增加一个变量完成自定义。
首先,更改配置文件,增加自定义变量:
AUTHENTICATION_BACKENDS = (\'users.views.CustomBackend\',)#所以我们还需要在试图函数下定义CustomBackend类
然后在视图函数中重写ModelBackend的认证方法:
from django.shortcuts import render from django.contrib.auth import login as dj_login, authenticate from django.contrib.auth.backends import ModelBackend from django.db.models import Q from .models import UserInfo # Create your views here. class CustomBackend(ModelBackend): def authenticate(self, username=None, password=None, **kwargs): try: user = UserInfo.objects.get(Q(username=username) | Q(email=username))#密码存的是密文,不能pwd=pwd if user.check_password(password):#这个方法是AbstractUser的校验方法 return user except Exception as e: return None
使用类的方式进行操作,重写登陆类:
from django.views.generic.base import View class LoginView(View): def get(self, request): return render(request, "login.html", {}) def post(self, request): user_name = request.POST.get("username", "") pass_word = request.POST.get("password", "") user = authenticate(username=user_name, password=pass_word) if user is not None: dj_login(request, user) return render(request, "index.html", {}) else: return render(request, "login.html", {"msg": "用户名或密码错误"})
url也要改成as_view:
url(r\'^login.html$\', views.LoginView.as_view(), name="login"),
在前端使用{% url \'name\'%}会自动生成url得路径,并且静态文件的路径也可以使用这种方式生成:
开头需要标明:
{% load staticfiles %}
对于静态文件地址可自动生成:
<link rel="stylesheet" type="text/css" href="{% static \'css/reset.css\' %}">
验证码自动生成库:
django-simple-captcha文档:Using django-simple-captcha。
项目GitHub地址:mbi/django-simple-captcha。
让我简单的说就是pip就直接安装好了。
使用此工具自动生成验证码校验:
第一步:注册。
INSTALLED_APPS = [ \'django.contrib.admin\', \'django.contrib.auth\', \'django.contrib.contenttypes\', \'django.contrib.sessions\', \'django.contrib.messages\', \'django.contrib.staticfiles\', \'users\', \'course\', \'organization\', \'operation\', \'xadmin\', \'crispy_forms\', \'captcha\', ]
第二步:配置url。
from django.conf.urls import url, include url(r\'^captcha/\', include(\'captcha.urls\')),
第三步:同步数据库。
它在我们数据库建了一张表用来存放生成的随机码信息。
第四步:建立form自动认证。
from captcha.fields import CaptchaField class RegisterForm(Form): email = fields.EmailField(required=True) password = fields.CharField(required=True,min_length=5) captcha = CaptchaField(error_messages={"invalid":"验证码错误"})
第五步,在视图中实例化出对象传到前端。
class RegisterView(View): #显示注册页面 def get(self,request): #把form传给前端,里边是验证码需要在前端显示 register_form = RegisterForm() return render(request,\'register.html\',{\'register_form\':register_form})
第六步,在前端自动生成验证码。
<div class="form-group marb8 captcha1 "> <label>验 证 码</label> {{ register_form.captcha }} </div>
可以说这个插件比我们之前手写的那个要好用一些。
根据此判定我们的验证码是否一致。
注册激活
邮箱发送验证码
建一个新的app组件utils组件的新功能就是email_send。
from users.models import EmailVerifyRecord import random, string from django.core.mail import send_mail from self_study.settings import EMAIL_FROM def send_register_email(email, send_type=\'register\'): email_record = EmailVerifyRecord() code = random_str(16) email_record.code = code email_record.email = email email_record.send_type = send_type email_record.save() email_title = \'\' email_body = \'\' if send_type == \'register\': email_title = \'自学网注册激活链接\' email_body = \'请点击下面的链接激活你的账号:http://127.0.0.1:8000/active/{0}\'.format(code) send_status = send_mail(email_title, email_body, EMAIL_FROM, [email]) if send_status: pass def random_str(randomlength=8):#生成随机数 salt = \'\'.join(random.sample(string.ascii_letters + string.digits, randomlength)) return salt
EMAIL_HOST = \'smtp.sina.com\' EMAIL_PORT = 25 EMAIL_HOST_USER = "emailforproject@sina.com" EMAIL_HOST_PASSWORD = "********" EMAIL_USE_TLS = False EMAIL_FROM = "emailforproject@sina.com"
def post(self,request):#注册提交过来表单的时候,由此接收 register_form = RegisterForm(request.POST) if register_form.is_valid(): user_name = request.POST.get(\'email\', \'\') #去库里查询有没有这个邮箱,有就是已经注册过了 if models.UserInfo.objects.filter(email=user_name): return render(request, \'register.html\', {\'register_form\': register_form, \'msg\' : \'用户已经存在\'}) #没有就是新用户,继续流程 else: #获取前端填的表单,写进user库里 pass_word = request.POST.get(\'password\', \'\') user_info = models.UserInfo() user_info.username = user_name user_info.email = user_name user_info.password = make_password(pass_word) #加密密码之后再存入库 user_info.save() send_register_email(user_name,\'register\') return render(request, \'login.html\') else: return render(request, \'register.html\', {\'register_form\': register_form})#把register_form传给前端是因为 这里包含错误信息,需要在前端显示
拿到链接以后需要注册。
上传图片
upload地址:
image = models.ImageField(upload_to=\'org/%Y/%m\', verbose_name=\'封面图\', max_length=100)
配置文件中指定文件存储位置:
MEDIA_URL = \'/static/media/\' MEDIA_ROOT = os.path.join(BASE_DIR, \'static/media/\')
模板中配置:
<img width="200" height="120" class="scrollLoading" data-url="{{ MEDIA_URL }}{{ org.image }}"/>
为了让这里的{{ MEDIA_URL}}生效(当然你可以使用手动地址/static/media/{{org.image}}),需要配置setting文件:
TEMPLATES = [ { \'BACKEND\': \'django.template.backends.django.DjangoTemplates\', \'DIRS\': [os.path.join(BASE_DIR, \'templates\')] , \'APP_DIRS\': True, \'OPTIONS\': { \'context_processors\': [ ....... \'django.template.context_processors.media\', # 配置html页面获取MEDIA_URL路径 ], }, }, ]
最后前端生成了我们需要的url就会向后端get图片。
from django.views.static import serve from self_study.settings import MEDIA_ROOT url(r\'^static/media/(?P<path>.*)$\', serve, {\'document_root\': MEDIA_ROOT})
分页组件(django-pure-pagination)
分页组件的GitHub中有配置的介绍:django-pure-pagination。
先注册,再配置,更改view传给前端,最后在前端进行引用。
INSTALLED_APPS = [ \'pure_pagination\', # 注册分页app ]
PAGINATION_SETTINGS = { \'PAGE_RANGE_DISPLAYED\': 10, \'MARGIN_PAGES_DISPLAYED\': 2, \'SHOW_FIRST_PAGE_WHEN_INVALID\': True, }
from pure_pagination import Paginator, PageNotAnInteger try: page = request.GET.get(\'page\', 1) # 获取当前页码,如果没有默认1 except PageNotAnInteger: # 如果获取页码出错,默认1 page = 1 p = Paginator(all_orgs, 1, request=request) # 执行分页函数,参数1数据库的数据,参数2显示多少条数据,参数3request orgs_page = p.page(page) # 返回一个,包含了分页数据和分页导航的对象 return render(request, \'org-list.html\', {\'all_orgs\': orgs_page})
<div class="pageturn"> <ul class="pagelist"> {% if all_orgs.has_previous %} <li class="long"><a href="?{{ all_orgs.previous_page_number.querystring }}" class="prev">上一页</a></li> {% endif %} {% for page in all_orgs.pages %} {% if page %} {% ifequal page all_orgs.number %} <li class="active"><a href="?{{ page.querystring }}" class="page">{{ page }}</a></li> {% else %} <li><a href="?{{ page.querystring }}" class="page">{{ page }}</a></li> {% endifequal %} {% else %} <li class="none"><a href="">...</a></li> {% endif %} {% endfor %} % if all_orgs.has_next %} <li class="long"><a href="?{{ all_orgs.next_page_number.querystring }}" class="next">下一页</a></li> % endif %} </ul> </div>
以上是关于py3.6 + xadmin的自学网站搭建的主要内容,如果未能解决你的问题,请参考以下文章