跳到主要内容

集成ISP菜单

将ISP(机场)链接与karing菜单集成, 可解决以下问题:

    1. 用户添加配置之后, 到期续费将被提醒, 增加复购;
    1. 当ISP(机场)域名失效、被wall封禁banned等, 直接修改订阅链接header信息, 即能更新入口
    • 用户无感知
    1. [TODO] 未来考虑增加更多玩法, 比如优惠提醒等.

一、案例​

设置菜单​

  • 在karing - 设置菜单 - 顶部显示 机场名称、服务到期时间、机场FAQ
  • 用户可点击 机场名称 进入机场续费or订购新套餐
  • 如下图: menu

服务到期提醒​

  • 当用户服务到期时间小于7天, 则显示红字的到期提示

  • 用户可点击 红字的到期时间 进入机场续费

  • 如下图:

    • expiration reminder
    • click to isp

机场管理面板​

二、设置逻辑​

  • 以下由两种方案, 推荐修改header的方式, 代码侵入比较小。

方案1 修改HTTP 标头（header）​

  • 在订阅链接的 HTTP响应（response）中加入四个响应标头
    • (必填) Subscription-Userinfo
      • 用于显示用户 已上传、下载、总共多少流量，套餐什么时候到期
      • upload= ; download= ; total= ; expire= ;
    • (必填) isp-name: 您的服务名称(机场名字)
      • 展示在 设置 - ISP - 第一行
      • 如果isp-name包含非ASCII字符(比如:中文), 必须使用urlencode
    • (必填) isp-url: 用户点击isp-name时跳转的URL
    • (可选) isp-faq: 您服务的FAQ URL
      • 展示在 设置 - ISP - 第二行
  • 修改后, 通过调试工具可显示, 如下图:
    • header

方案2 自定义URL Scheme​

  • karing支持通过scheme唤起karing的添加配置页面, 您可把自动导入karing的链接改成下面的形式
<a href="karing://install-config?url=xxxx&name=xxx&isp-name=xxx&isp-url=xxx&isp-faq=xxx">自动导入karing</a>
  • 注意:
    • url 必须通过urlencode转义

展示优先级​

  1. 默认设置 - ISP菜单仅展示一个ISP信息
    • 用户有多个订阅配置的情况下, 按照排序, 展示第一条有有效isp信息
  2. scheme的优先级高于header
    • 即首先会展示通过 karing://install-config 设置的isp信息, 如没有,则再判断response header

三、和karing进行合作​