UCenter 下面挂接了几个应用以及各个应用和 UCenter 的连接配置等设置都在“应用管理”里面,所以你可以在这里管理挂接在 UCenter 上的所有应用,删除或者添加应用,编辑其配置等。
登录 UCenter 1.5.0 => 应用管理,如下图所示:
从上图的“应用名称”可以看出来,我们演示的 UCenter 挂接了 3 个应用,分别是 SupeSite、Discuz!、个人家园。
“ID”:是各个应用在 UCenter 中的一个编码,这个很重要而且是唯一的,如果删除将继续编码,而不会重复出现删除过的 ID。
“应用的 URL”:这个是访问各个应用的 URL 地址,必须填写正确,这关系着该应用和 UCenter 的通信接口以及跟其他应用的互通设置。
“通信情况”:我们要求的结果是如上图所示的绿色的“通信成功”,这里是反映各个应用是否跟 UCenter 挂接成功的标志。如何才能使其通讯成功的方法我们后面详细说明。
一、编辑和删除应用
1、编辑应用配置
上图中我们点击其中一个应用右侧的“编辑”按钮,进入下图所示的界面(举例我们编辑第一个应用 SupeSite):
应用的 “ID” 是一个固定值,安装后就确定了的,无法修改。
“应用名称”:是可以修改的,一般为该应用站点名称,比如“SupeSite官方演示站”,限 20 字节。
“应用的 URL”:该应用与 UCenter 通信的接口 URL,结尾请不要加“/”,比如“http://x.discuz.net”
“应用 IP”:正常情况下留空即可。如果由于域名解析问题导致 UCenter 与该应用通信失败,请尝试设置为该应用所在服务器的 IP 地址。注意:填写真实 IP 地址。
“通信密钥”:就好像一把钥匙,它只能打开 UCenter 和该应用之间的门,最好是唯一的,也就是说每个应用和 UCenter 之间的这个密钥最好是不一样的。只允许使用英文字母及数字,限 64 字节。注意:应用端的通信密钥必须与此设置保持一致,否则该应用将无法与 UCenter 正常通信。
“应用类型”:这个根据实际情况选择即可,选错会影响跟其他应用的互通。可以选择的类型有:UCenter Home、X-Space、Discuz!、SupeSite、SupeV、ECShop、ECMall、其他。
“应用的物理路径”:默认请留空,如果填写的为相对路径(相对于UC),程序会自动转换为绝对路径,如 ../。
“查看个人资料页面地址”:URL 中域名后面的部分,如:/space.php?uid=%s 这里的 %s 代表 uid。
“应用接口文件名称”:应用接口文件名称,不含路径,默认为 uc.php 。
“标签单条显示模板”:当前应用的标签数据显示在其它应用时的单条数据模板。
“标签模板标记说明”:一行一个标记说明条目,用逗号分割标记和说明文字。如:subject,主题标题 url,主题地址。
“是否开启同步登录”:开启同步登录后,当用户在登录其他应用时,同时也会登录该应用。
“是否接受通知”:开启接受通知后,当管理员进行一些有关该应用的操作时,就会在“数据列表 => 通知列表”里通知该应用。比如在 UCenter 里面修改了一个用户的用户名,那么开启通知后,该应用及会接受到该用户的用户名被修改的通知并进行更新。
“应用的 UCenter 配置信息”:当应用的 UCenter 配置信息丢失时可复制左侧的代码到应用的配置文件中。比如某个应用的 config 文件被默认的覆盖了或丢失了,就可以直接拷贝出这里的 UCenter 配置信息加入其 config 文件即可,而不需要手动配置,减低了配置过程中出错的可能性。
编辑应用配置就是根据上面这些项目的说明按照规则来修改配置,但是注意这里很多项都不可以随便修改,比如通信密钥,在这里做了修改,那么该应用对应的 config 配置文件里面也要相应的修改为一样的,否则就会导致通信不成功了。
2、删除应用
删除一个应用很简单,选中本文第一个图中应用左侧的多选框,点击“提交”即可。
注意:这里删除应用没有二次确认提示,请慎重操作。
二、通信不成功的排查方法
上面我们已经把应用配置里面的每一项设置都讲解了一遍,但是如何配置这些设置的值使其通信成功呢?其实主要是应用配置和应用 config 文件的一致性,下图为其对应关系:
只要上图中高亮的几项在 UCenter 应用配置和 应用的 config 文件里保持一致,那么通信成功就不成问题了。
三、添加新应用
1、安装一个新应用
我们推荐的安装一个新应用的方法是在 UCenter 应用管理里面通过“添加新应用”来进行安装,这样安装的好处就是安装过程中配置 UCenter 信息的时候无需手动填写,可以自动识别 UCenter 访问地址和创始人密码,省去了填写这些信息的繁琐,而且可以确保信息的正确性。
UCenter 应用管理 => 添加新应用 => URL 安装 (推荐)
填写上图中蓝色高亮区域的“应用程序安装地址”,只需要修改前面的部分,比如应用的安装目录访问地址为:http://www.domain.com,那么只需将默认的 http://domainname/install/index.php 改为 http://www.domain.com/install/index.php 也就是修改 /install/index.php 前面的地址即可。
然后点击“安装”按钮开始安装该应用,除了无需填写 UCenter 信息之外其他安装步骤跟不通过 UCenter 后台安装应用完全一样。
2、安装后应用管理里面没有该应用
有一部分用户会遇到这个问题,按照正常的应用安装流程进行安装,但是安装完毕后到 UCenter 应用管理里面看不到该应用,引起这个问题的原因一般是由于安装过程中未配置 UCenter 信息,直接跳过去了导致的。解决方法如下:
到 UCenter 应用管理 => 添加新应用 => 自定义安装
只需填写图中高亮的几项即可:
“应用名称”:填写站点名称即可。
“应用的 URL”:填写站点的 URL 访问地址。
“通信密钥”:随便填写一串字母加数字的字符串,不要超过64字节即可。
“应用类型”:根据你安装的应用的类型选择即可。
“是否开启同步登录”、“是否接受通知”:这两项根据具体情况选择即可,不强制选择是。
打开应用的 config 文件,对照上面的设置配置 UCenter 部分的信息,配置方法本文前面已经介绍过了,不再赘述。
上面是我本地的举例配置,大家根据自身的情况修改其中的参数值即可。注意 UC_IP 和 应用 IP 默认可以留空,如果出现通信不成功的情况可以尝试都填写真实 IP 地址。
基本上通过这么两步操作,该应用就会被添加到了 UCenter 应用管理里面,也可以保证其通信成功。