用于前端的用户注册、登录、找回密码、个人中心等操作。
1. 安装:
在最新版2.4版已经集成了这个插件,默认是关闭的,具体文件在couch/addons/extended里。
文件中的“couch/addons/kfunctions.php”文件中的以下行来激活插件(新安装时会有一个名为kfunctions.example.php的文件——该文件应改名为kfunctions.php)- 我们的前端代码还会使用“会话”和“数据绑定表单”,所以也要激活它们。
require_once( K_COUCH_DIR.'addons/extended/extended-users.php' ); //激活用户插件 require_once( K_COUCH_DIR.'addons/cart/session.php' ); //激活会话插件 require_once( K_COUCH_DIR.'addons/data-bound-form/data-bound-form.php' ); //激活数据绑定表单
安装完成了。
2. 实现
我们的附件包带了一个具体的用户实现,把user文件夹放到网站的根目录,注意不是couch的目录,是要和它同级。
你会看到有五个写好的couch前端模板:
index.php //用于扩展本地用户账户的主要模板,它会关联到后台的“用户”,且可以定义任意数量的自定义字段
login.php // 登录界面,注意会替代系统默认的后台登录界面
lost-password.php // 找回密码,会替代系统默认的找回密码页面
profile.php // 这也是一个数据绑定表单的经典实现,用于编辑当前登录用户关联的克隆页面(包含"users/index.php")
register.php // 注册页面,一个简单的Databound表单,可以创建"users/index.php"的克隆页面,因此,用这个必须先用index.php
用户账户(users/index.php)
这个模板就是couch的普通模板,显而易见,第一步我们必须注册它,用超级管理员登录后台后,再在前端访问它。
回到管理员面板,侧边栏应该会出现这个模板,如果没有出现,那是没有注册成功。
好了,有个默认页面,取消发布它。
目前,我们的用户模板准备好了,再创建用户账户前,还有最后一步:你会在“couch/addons/extended/”文件夹里找到一个叫“config.sample.php”的文件。把它改名为“config.php”。在文本编辑器
中打开它,并指定我们用户模板的名称(即“users/index.php”)作为“users_tpl”设置的值,具体如下:
// 所需模板名称 $t['users_tpl'] = ''; $t[''login_tpl'] = ''; $t['lost_password_tpl'] = ''; $t['registration_tpl'] = '';
修改为:
//所需模板名称 $t['users_tpl'] = 'users/index.php'; $t[''login_tpl'] = ''; $t['lost_password_tpl'] = ''; $t['registration_tpl'] = '';
注意,注册所有模板(users/profile.php除外),都是这2步。
1. 前端访问注册。
2. 然后再配置文件里添加。
请确保只有在模板已向 Couch 注册(即其名称出现在管理面板侧边栏)后,才在配置文件中指定模板名称。
最后,是时候看看“扩展”模块的实际作用了。
---------------通用的登录登出按钮,用于扩展用户插件----------------
<cms:if k_logged_in> <a href="<cms:logout_link />" class="uk-button uk-button-default">退出</a> <cms:else /> <a href="<cms:login_link />" class="uk-button uk-button-default">登录</a> </cms:if>