新闻| 文章| 资讯| 行情| 企业| wap手机版| article文章| 首页|会员中心|保存桌面|手机浏览
普通会员

易达信息科技

企业列表
新闻列表
推荐企业新闻
联系方式
  • 联系人:依依
友情链接
  • 暂无链接
首页 > 新闻中心 > RuleAPP详细设置教程,手把手教你学会这款Typecho客户端
新闻中心
RuleAPP详细设置教程,手把手教你学会这款Typecho客户端
发布时间:2024-12-13        浏览次数:19        返回列表

本教程主要是讲解RuleAPP的详细配置,包括数据的调用,第三方登录和在线支付的配置,以及如何对RuleAPP进行二次开发。在这篇教程中,除了基本的配置外,还会讲解目录的结构,开发的框架等信息,帮助各位更好的使用RuleAPP建设自己的客户端应用。到目前为止,正式版也已经即将推出,所以希望这篇教程能够帮助所有的用户掌握RuleAPP。

RuleAPP详细设置教程,手把手教你学会这款Typecho客户端

RuleAPP是一款基于uniapp技术,ColorUI框架开发的Typecho客户端应用,目前已经兼容安卓苹果APP,H5网页,和微信QQ小程序。

我已经在语雀补充了更加详细的文档,建议前往阅读:RuleProject社区应用帮助文档

RuleAPP需要进行修改的配置文件主要有三个,,还有一个则是RuleAPP本身的全局配置文件/utils/api.js。

想必这里已经看出来了,。通过这些路径就可以找到对应的页面,就可以开始自己修改。但是,这需要有网页知识和vue的基础才行。

注意:目前推荐文章在内容管理中进行推荐,图片轮播则采用mid调用方式,已经和截图不同。

因为无数次有人提意见说需要加一个接口访问密钥来保证安全,但是我一直觉得没有必要,而且这个完全可以通过nginx实现。不过奈何询问的还是太多,所以还是增加一个访问密钥鉴权的模式。具体可以在api.js看到如下代码:

在RuleApi接口的那个反向代理域名的伪静态增加如下代码(比如我希望文章接口需要密钥鉴权才有数据):

typechoContents就是文章接口的路径(具体可以看接口文档),$http_key设置的123456就是访问密码。这样配置完成后,就必须在api.js配置为123456,那么请求文章接口才可以获得数据。如果要其它模块也验证,就按照上面代码复制粘贴。

对于RuleAPP而言,这个文件负责配置第三方登录,微信支付(对的,有且只有微信支付在这里配置),图标和启动图,还有打包相关。图标和启动图想必已经很直观了,这里就只说几个注意点。

请务必切记,mainifest.json的配置是不需要的!不要配置!!!!支付宝当面付可参考如下教程获取相关信息,再通过RuleApi的可视化配置中心配置即可:

支付宝当面付官方文档

微信Native支付可参考如下教程获取相关信息,再通过RuleApi的可视化配置中心配置即可:

微信Native支付官方文档

设置完成后,比如我设置的名称是ruleapp,那么在网页中,就可以通过超链接的或者js跳转的形式直接点击打开,比如如下代码:

而这里,我提供了两个参数,一个是快捷登录(配合会员中心项目),一个是打开app文章阅读。

推荐使用RuleUser项目,已经集成相关功能了。

RuleUser安装及配置教程,让你的Typecho用户系统模块化

去看这个教程吧:uniapp从基本配置到打包发布,详细流程

目前RuleApp使用的是unipush1.0版本(2.0版本强制用他们的云函数很坑),所以在打包时需要勾选Push模块。

启动图广告已经整合到付费广告模块。

目前RuleApi已经集成了Typecho的自定义字段功能,而在APP代码内,暂时只通过这个功能实现了图文显示类型。因为我使用的是typecho小灯泡模板,所以我的类型字段是abcimg,可以个根据自己的模板进行修改,涉及的APP文件主要有以下三个。

如果要改成自己的字段,可以先在可视化配置中心定义,然后在APP的api.js定义,如下图所示。

然后在从上述三个文件中搜索abcimg,改成自己所用typecho模板的字段和对应值。如果自己二次开发需要用到更多的自定义字段,可以去看RuleApi的接口文档。

想要进行复杂的二次开发,需要系统性的学习vue和uniapp的官方教程,这个百度就有,不需要我多说。这里就提一些简单的。

去看ColorUI的官方文档就好了:点击进入

负责控制app全局样式的文件就是static/base.css,不过注意在uniapp中,一般像素大小是upx而不是px,其它的就和普通的css没区别了。

一般来说,typecho的模板很多都会带一些自定义标签,就比如现在用的人很多的joe,以及我现在用的小灯泡模板。为了满足功能的需要,这些模板一般都会加自定义的,也就是markdown无法解析的标签对,所以如果遇到这种情况,就需要在RuleAPP里匹配模板的解析机制。

js的replace方法负责替换,第一个是正则表达式,直接复制PHP的就行,第二个是html代码,有网页开发基础就可以自己定义样式和内容。这段自定义标签有几个参数,用在那里,实际上每个typecho模板都肯定会写的,要做的就是复制粘贴,然后自己定义一下css。就这样,模板有几个自定义标签,就加个几行,就可以完成全部的解析,前提是找到你使用模板的标签解析方法,一般顺着function.php就可以找到。

同样的,评论也是如此。

RuleAPP支持编译为微信小程序,QQ小程序,并在理论上支持所有小程序平台(如果编译出现问题,可以来群里反馈)。

小程序要求域名必须备案,接口必须https,否则在发布后会出现网络错误,切记!!!

uni统计,uni-app统计,多端统计

有啥遗漏的我再补充吧,可以直接在交流群里提意见。