odoo 11 之signup_with_phone模块分析

signup_with_phone模块的主要功能是允许用户用自己的手机号作为注册登录账号，这里会进行手机号码格式的严格检查，该模块依赖odoo自带的auth_signup注册模块。

该项目地址在https://github.com/odooaktiv/SignupWithPhone，不过目前是10.0版本的，稍微修改下也可以在11.0版本下使用。下面分析其具体原理。

第一部分是使用到的XML布局文件

       1.auth_signup模块的auth_signup_login_templates.xml文件

        这个文件包含4个模板，对应的是auth_signup.login，auth_signup.fields，auth_signup.signup，auth_signup.reset_password。

        我们来一一分析每一个模板的内容，首先是auth_signup.login模板

　　这个模板继承了我们的登录模板web.login，主要功能是找到其中的submit按钮，在这个按钮之前放2个链接，一个显示Don't have an account,一个显示Reset Password.

但是这里的每个链接都在class属性上使用了bootstrap中的pull-right样式，最终的结果不是显示在submit按钮左侧，而是右侧，如下图所示

默认情况下这两个链接是不现实的，因为每个链接都有个t-if判断值，odoo系统默认是不设置的，如果需要只能手动设置，设置的位置如下：

第2个模板是auth_signup.fields，此模板会被第三个模板调用

这里主要设置了注册时需要填写的字段，包含Email, Name, Password, Confirm Password 4个input文本。

第3个模板是auth_signup.signup，主要负责将注册界面组合成一个整体

这里还调用了web.login_layout模板，主要实现头部的odoo图标和底部的数据库连接效果，此处不做详细分析。其余代码有3大作用，一是调用模板2 auth_signup.fields，用于显示

注册的填写字段，二是如果填写不合规范的时候，有错误提醒，三是左侧显示''Sign Up按钮”，右侧显示“Already have an account?”链接。

填写内容不合规范的时候，提示错误的信息截图

第4个模板是auth_signup.reset_password，主要用于给用户发邮件，进行密码的重设

这里像前面的模板3一样，调用了web.login_layout模板，还有根据一些属性值来判断是不是显示html控件，目前我们不关系这些。这里的主要代码在与显示"Your Email"输入框，“Confirm”按钮和“Back to Login”链接。

如果有错误，显示提示内容：

到此，auth_signup模块的xml主要模板全部理完，下面开始signupWithPhone模块的XML分析。

2.signupWithPhone模块的auth_signup_inherit.xml分析

这里主要包含2个模板，change_email_label和auth_signup.fields。

change_email_label模板主要改变登录界面的Email为Email/Mobile,提示用户既可以使用邮件也可以是电话

auth_signup.fields模板主要是对auth_signup中的auth_signup.fields的重写，多了个Mobile字段，也是我们今天的主要字段。

　　效果图如下

这样涉及到的XML视图文件都已分析完毕。

第二部分    原理分析

这里要解决的一个问题，就是signupWithPhone是怎么做到可以使用电话号码作为登录账号的呢？

首先在signupWithPhone模块里面没有modles文件夹，也就意味着没有对原来类或表做任何字段的增加，只能说是Mobile手机字段是存储到了已有表的某个字段中了，带着这个疑问我们来看看后台的注册代码。

这里只有一个AuthSignupController类，继承于web/controllers/main.py文件中的Home类，虽然是继承Home这个Controller类，但此处的AuthSignupController和auth_signup模块中的类名一样，这里的类自然是对auth_signup模块里类的方法的重写和扩展。这里有3个方法，

这里我们重点关心get_auth_signup_qcontext方法

    def get_auth_signup_qcontext(self):
        """ Shared helper returning the rendering context for signup and reset password.
            Check Condition If Email not Exists, then Signup with Mobile.
        """
        if request.params.items() and request.params['mobile']:
            try:
                carrier._is_mobile(number_type(phonenumbers.parse(request.params['mobile'])))
            except NumberParseException:
                request.params['error'] = _("Please Enter Valid Mobile Number")
        if request.params.items() and request.params['login']:
            if not tools.single_email_re.match(request.params['login']):
                request.params['error'] = _("Please Enter Valid Email")        
        if request.params.items() and request.params['mobile'] and request.params['login'] == '':
            request.params['login'] = request.params['mobile']
        qcontext = request.params.copy()
        qcontext.update(self.get_auth_signup_config())
        if qcontext.get('token'):
            try:
                # retrieve the user info (name, login or email) corresponding to a signup token
                token_infos = request.env['res.partner'].sudo().signup_retrieve_info(qcontext.get('token'))
                for k, v in token_infos.items():
                    qcontext.setdefault(k, v)
            except:
                qcontext['error'] = _("Invalid signup token")
                qcontext['invalid_token'] = True
        return qcontext

以上红色代码表示，如果注册了电话号码，没有填写邮件，那么将会把mobile字段对应的值，赋值给login参数

    def do_signup(self, qcontext):
        """ Override do_signup for Create User & Partner with Extra field Mobile.
        """
        values = { key: qcontext.get(key) for key in ('login', 'name', 'password','mobile') }
        assert values.get('password') == qcontext.get('confirm_password'), "Passwords do not match; please retype them."
        supported_langs = [lang['code'] for lang in request.env['res.lang'].sudo().search_read([], ['code'])]
        if request.lang in supported_langs:
            values['lang'] = request.lang
        self._signup_with_values(qcontext.get('token'), values)
        request.env.cr.commit()

以上的红色代码，抽取了对应的login,name,password,mobile 4个参数的值，当然，此时的login和mobile值是一样的，如果用户没有填写邮件的话。

这样signupWithPhone模块，就完成了使用电话号码的注册过程，而不仅仅是只允许用户使用邮件注册。

注册的过程中，auth_signup模块，而作为管理员在后台新增用户的时候，或者使用Oauth2进行登录的时候，用户名都没有进行验证是否属于邮件格式，其他都可以作为登录账号。

那么这里就有一个问题，就是在找回密码的时候，问题就变得复杂了，分3种情况，第一种是邮件的，第二种是电话号码的，第三种是非邮件亦不是电话号码的。对于前2种情况，在重设密码的时候，可以分别使用发送邮件和发送手机验证码的方式实现对密码的修改，第三种就暂时无法处理。

貌似对于重设密码的问题，需要单独开一篇文章来讨论了，待续.....