(本节表格结合本节漫画插件示例看,表格里?表示随意可以不写的属性)
<br>
## 2.2.1 sited(插件根节点)格式说明
```xml
<sited ver="3" debug="1" engine="34" schema="1">
```
||下级|类型|官方说明|补充说明|
|:-|:-|:-|:-|:-|
|sited|||||
||@ver|Int|插件版本|最少为1,每次更新前要加1。如果你先安装了低版本正式版插件,调试时就要加1不然引擎可能会读取先安装版本代码|
||@vip?|Int|app用户等级限制,0:普通用户可用;1:最低需要VIP用户;2:最低需要SVIP用户|(不写该属性的话默认为0的效果)|
||@debug?|1或0|是否开启调试模式|(不写该属性的话默认为0的效果)作为插件开发者我都是写1即开启,开启后才能使插件开发者模式下的容器app在运行本插件时生成调试log日志等|
||@private?|1或0|是否为私密插件|(不写该属性的话默认为0的效果)1为私密插件,在两条街不可见,收藏别人不可见,不可通过二维码分享出去|
||@engine|Int|需要支持的app引擎版本号|引擎越高实现功能越强,引擎版本的能力详见官方开发文档PDF。我新做插件是写34因为想兼容三平台可用,最新安卓版引擎是36,最新Win10版引擎是35,最新ios内测版引擎是34|
||@schema|Int|插件规范版本号(v27引擎开始支持),0为测试规范(旧格式),1为正式规范(新格式)|新来的插件者请写1,因为官方开发文档是基于schema="1"|
||@head?|String|指定头部节点名称(v27引擎支持)(不写该属性的话默认为:meta的效果)||
||@body?|String|指定主体节点名称(v27支持)(不写该属性的话默认为:main的效果)||
||@script?|String|指定脚本节点名称(v27支持)(不写该属性的话默认为:script的效果)||
||@sds?|Uri|插件自动更新接口(参考官方开发文档的插件更新接口规范)检查时,@sds末尾附上插件的url。插件托管在插件中心的,不需要添加||
<br>
## 2.2.2 meta(头部节点)格式说明
```xml
<meta>
<ua></ua>
<guid>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</guid>
<title>naver网漫</title>
<author>Guang</author>
<contact></contact>
<intro>[漫画](v3修复)LINE WEBTOON韩国naver官网。매일매일 새로운 재미, 네이버 웹툰.(部分章节提示下架,要登陆源网站观看)</intro>
<alert></alert>
<url>http://m.comic.naver.com/</url>
<expr>comic\.naver\.com\/</expr>
<logo>http://static.naver.net/m/comic/im/favicon/favicon_140327.ico</logo>
<encode>UTF-8</encode>
<about title="反馈" mail="xx@xx.com">
<item url="我邮箱是xx@xx.com" />
<item />
<item url="欢迎打赏插件开发者Guang,反馈问题。"/>
<item txt="点击或扫描二维码对[xxx]支付宝打赏" expr="https://qr.alipay.com/xxx" logo="http://xxx.jpg"/>
<item />
<item txt="扫描二维码对我的微信打赏" logo="http://xxx.jpg"/>
<item />
</about>
</meta>
```
||下级|类型|官方说明|补充说明|
|:-|:-|:-|:-|:-|
|>meta|||||
||>ua?|String|访问插件的默认UserAgent|此处ua标签写完后,后面每一级节点都可以自行设置ua属性,不写该属性的话默认继承父节点ua|
||>guid|GUID|插件唯一标识(采用小写无间隔),此标识为插件更新提供权限保障。示例:0a00983f87a24475 bcb6759603e76f7c|有[guid在线随机生成工具即点击此处](http://sited.noear.org/tool/?guid=1),对不同网站做插件要设置不同的guid,如果插件中心里2个插件的guid相同,后上传插件会覆盖先上传插件。升级插件时,ver加大,guid不改变|
||>title|String|插件名称(最好不要超过5个汉字)||
||>author|String|插件开发者(最好不要超过6个字母)||
||>contact|String|插件开发者联系方式:mail或sited磁链或phone|留空不写,因为app开发者还没做好该功能|
||>intro|String|插件介绍(显示在插件中心列表)|写插件介绍,最开头在方括号里面写插件内容类型标签(可在标签后面写此次版本插件修复了什么),标签选以下一个:[漫画][轻小说][小说][动画][视频][FM][音乐][图片][商品][资讯][直播][小游戏][小工具][综合]|
||>alert?|String|插件提醒(用户打开插件时,跳出提醒)|安装插件后首次打开插件时弹窗出现该节点中文本内容,如果不写内容或删去该节点就不会弹窗|
||>url|String|源网站地址|只能写一个域名。如果源网站url变化了,url节点里不要修改,而在main节点增加durl属性为变化后网站首页,expr节点内容里同时匹配新旧两个域名的网址,在book节点buildUrl函数对url参数做一下域名替换,以兼容用户在旧域名的收藏|
||>expr|String|匹配目标网址的正则表达式|写到xx\\.com\\/就可以停下来了,保证源网站所有网页url都被该正则表达式匹配到才能被插件解析。可写1个以上,比如同时匹配新旧两个域名|
||>logo?|Uri|插件图标(显示在插件中心列表)|写源网站icon图标的网址,如果不写或删去该节点就显示默认图标|
||>encode|String|目标网址的默认编码|一般中文小说网站编码是GBK的,该节点里写GB18030,以更好兼容全平台设备|
||>login?|Node|登录|见高级篇加login节点教程|
||>about?|Node|关于(简介、提供反馈渠道、让人赞助等)|见下文about节点说明。不写该节点留下联系方式接受反馈的,就不要发布到插件中心里|
<br>
## 2.2.3 meta>about节点说明
about节点中可以写一次title属性和mail属性,前者写的内容是app打开A按钮后弹窗首行标题;后者写插件者电子邮箱地址(在app弹窗中点击“反馈”后会调用邮箱软件准备发邮件到该地址,如果没有安装邮箱软件会没有效果,所以我还会在下级的item节点加上邮箱地址文本。
|about节点下级item节点(可以写多个)的属性|输出效果(每个属性各占一行)|
|:-|:-|
|txt|普通文本|
|title|加粗文本|
|url|下划线且A按钮弹窗上可复制的文本|
|logo,写图片的网址|图片|
|::expr|对::url或logo点击后的用浏览器打开expr(expr是写想打开的链接地址),expr属性写在url或logo的同一行|
|无属性,只有item节点|空一行|
(本节完)
- 序言
- 第一章 基础
- 1.1 Html基础
- 1.2 CSS选择器
- 1.2.1 标签选择器
- 1.2.2 class/id选择器
- 1.2.3 属性选择器
- 1.3 JavaScript基础
- 1.4 json基础
- 第二章 中级
- 2.1 插件结构总览
- 2.2 meta头部节点讲解
- 2.3 main主体节点讲解
- 2.4 script脚本节点讲解
- 2.5 插件的安装调试与发布
- 第三章 高级
- 3.1 插件高级特性
- 3.2 常见内容保护突破方法
- 3.3 开发文档所没说的事
- 3.4 电脑js脚本测试插件
- 3.5 加login节点教程
- 3.6 使用yeoman生成器
- 3.7 自动化发布插件
- 第四章 附录
- 4.1 markdown基本用法