search entry definition

搜索入口定义

什么是搜索入口？

搜索入口是指搜索种子时需要访问的网站页面地址，通常为网站对应的种子页面。

什么时候需要使用？

默认情况下，每个站点至少有一个搜索入口，该入口会搜索所有种子，如果你不希望每次都搜索所有种子，那么就需要使用新增入口来实现。

比如，可以创建几个入口：电影、音乐、剧集等，然后再配合 搜索方案，这样每次仅搜索相关种子即可

如何新增

• 打开 站点设置 ，在右边的列表中找到 搜索入口配置 图标

  

• 进入 站点搜索入口配置 页面

• 为了快速创建入口，可以直接复制默认入口，然后修改名称和分类即可

  

搜索入口各项参数说明

• 入口名称 : 搜索入口的名称，用于识别，如：影视、音乐等；

• 入口页面 : 对应的搜索页面地址，如 NexusPHP 默认对应的页面为 torrents.php ，地址中可以使用以下关键字：

  • $key$ : 最终会被替换为输入的搜索关键字；
  • 例子： /torrents.php?search=$key$

• 资源分类 : 这里会列出当前站点可用的分类，如果分类未定义，则不出现该选项；

• 搜索结果解析脚本文件 : 该脚本文件用于解析由搜索页面返回的内容，以下为常用默认值：

  • NexusPHP : /schemas/NexusPHP/getSearchResult.js
  • Gazelle : /schemas/Gazelle/getSearchResult.js

• 搜索结果解析脚本 : 可选，如果没有指定脚本文件，则可以直接填写脚本内容；脚本需要接收一个参数 options ，属性如下：

  • results : <输出>，数组，用于接收返回结果，参考 搜索结果对象定义说明；
  • errorMsg: <输出>，字符串，可用于没有找到结果或出错时给出文字提示；
  • responseText : 搜索页面返回的原始结果；
  • site : 当前站点配置；
  • resultSelector : 种子列表定位选择器；
  • page : 搜索页面的 jQuery 对象；
  • entry : 搜索入口信息
  • torrentTagSelectors : 定位种子标签的选择器，由网站定义
  • 参考脚本文件：https://github.com/ronggang/PT-Plugin-Plus/blob/master/resource/schemas/NexusPHP/getSearchResult.js

• 种子列表定位选择器 : 用于定位种子列表所在表格行，每个网站因样式不同会有所不同，可根据实际情况定义，常用默认值：

  • NexusPHP : table.torrent_list:last > tbody > tr
  • Gazelle : table.torrent_table:last > tbody > tr

搜索结果对象定义说明

{
  title: "种子标题，可以是 HTML",
  subTitle: "副标题",
  link: "种子对应的详细页面地址",
  url: "种子下载地址，如需远程下载，需要加上 passkey",
  size: "种子大小",
  time: "种子发布时间",
  author: "种子发布人信息",
  seeders: "当前做种数",
  leechers: "当前下载数",
  completed: "已完成数量",
  comments: "当前评论数",
  site: "当前站点配置信息，可指定为 options.site",
  tags: "当前种子的标签信息",
  entryName: "当前搜索入口名称，可指定为 options.entry.name",
  category: "当前分类信息，如果指定，则需要一个对象 {name: '分类名称', link: '分类连接地址(可选)'}"
}