自定义认证后跳转页面的设置

[修改履历]
加入wiwizGetDisconnectLink()函数。(2013.3.5)
URL参数中加入认证令牌码与终端MAC地址。(2015.10.16)
URL参数中加入us参数与加入wiwizGetUserString()函数。(2017.4.29)


一般，当热点用户连接至该热点并成功通过认证后，将见到一个默认的认证后页面。这个页面将提示用户一些很有用的信息，如用户的原始请求地址、剩余的连接时间、连接结束时刻、热点管理员推送来的公告信息、系统提示信息、认证令牌码（tokencode）、终端设备的MAC地址及其他一些链接等。

热点管理员也可以自行制作任何式样和内容的自定义认证后页面，以满足不同的需求。在Wiwiz Web面板中（用户菜单 >> 我的热点 >> 热点设置）设置”自定义跳转URL“或”自定义HTML“后即可。之后，当热点用户连接至该热点并成功通过认证后，将见到这个热点管理员自定义的认证后页面。

我们也提供了开发接口供热点管理员在自定义认证后页面中调用，以实现和在默认认证后页面中相同的面向热点用户的提示信息。
我们提供两种接口，一种是URL参数；另一种是Javascript函数。详细的接口说明请参考以下内容。

1. URL参数：
url – 用户的原始请求地址
et – 连接结束时刻
rm – 剩余的连接时间
t – 认证令牌码（tokencode）
us – 自定义追踪信息（userstring）
mac – 终端设备的MAC地址

2. Javascript函数：
2.1. 准备工作
注意，调用Javascript函数前，
如果采用”自定义跳转URL”，则首先需要加入以下语句：
<script src="http://cp.wiwiz.com/as/s/portal/?js=1&gw_id=XXXX"></script>
XXXX代表Hotspot ID。
如果采用”自定义HTML”，则首先需要加入以下语句：
<script src="/as/s/portal/?js=1"></script>

2.2. 可调用函数：
2.2.1. wiwizGetEndingTime() – 返回连接结束时刻。

2.2.2. wiwizGetRemaining() – 返回剩余的连接时间(秒数)。

2.2.3. wiwizShowCountdown(d, h, m, s) – 以倒计时方式显示剩余的连接时间。
参数说明: d, h, m, s分别代表日、小时、分钟、秒的分割字符。如不指定参数则使用默认分割字符。
调用用例: wiwizShowCountdown(" days ", " hours ", " minutes ", " seconds ");

2.2.4. wiwizCountdownNotice(tm, msg) – 设置倒计时提示消息。在连接结束前tm秒显示消息文本msg。
参数说明：
tm 连接结束前的秒数
msg 代表消息文本

2.2.5. wiwizGetBulletin() – 用于显示在Wiwiz Web面板编辑热点时设置的公告信息。

2.2.6. wiwizGetDisconnectLink() – 用于获取用户自主断开已认证连接的链接地址。
返回值说明：此函数将返回一个URL。此URL只可在用户的浏览器中请求，请求后的返回Response含义如下：

Response返回结果 含义
wiwiz_user_disconnect(0) 认证连接立即切断
wiwiz_user_disconnect(1) 认证连接无法立即切断，但即将会自动切断
wiwiz_user_disconnect(2) 连接不存在或已切断

使用例:
var url = wiwizGetDisconnectLink();
var script = document.createElement('script');
script.setAttribute('src', url);
document.getElementsByTagName('head')[0].appendChild(script);

function wiwiz_user_disconnect(s) {
switch(s) {
case 0:
alert("The connection will shutdown immediately.");
break;
case 1:
alert("The connection will shutdown in seconds.");
break;
case 2:
alert("The connection does not exist or already shut down.");
break;
}
}

2.2.7. wiwizGetUserString() – 返回自定义追踪信息（userstring）。

2.3. 可重写函数：
2.3.1. 调用wiwizCountdownNotice()后，提示消息将按照默认式样显示。如果你需要定制显示的方式或式样，你可以重写一个叫做wiwizUpdateNotice(str)的函数。参数str代表消息的文本。
例如：

function wiwizUpdateNotice(str) {
alert(str); //alert the message
}

2.3.2. 调用wiwizGetBulletin()后，公告信息将按照默认式样显示。如果你需要定制显示的方式或式样，你可以重写一个叫做 wiwizUpdateBulletin(title, content)的函数。参数title代表公告的标题，content代表公告的详细内容。
例如：

function wiwizUpdateBulletin(title, content)
alert(title + "\n" + content); //alert the bulletin
}

2.3.3. 当接近超过流量限制时，wiwizTrafficAlert()函数将会被触发调用，你可以重写它以定制你的流量限制提示。

Comments are closed.