使用前提
此插件为免费插件,需要有一定的 Linux 基础,并不是拿来即用,还需安装讯搜(xunsearch)服务端,请详细阅读以下内容。
必须先在您的服务器上安装服务端,服务器操作系统要求必须是 Linux、BSD 或其它类 UNIX 系统,同时安装了 gcc、make 等基础编译环境。
不支持 Windows 安装服务端,网站和服务端可以不在同一服务器,只需配置好远程服务端地址即可。
点此下载讯搜服务端安装包(此包已替换 libevent 版本为2.1.12 并修复一处 PHP SDK 错误,支持到PHP8.3.x),也可以去官网下载安装,如果安装失败可能是 libevent 版本过低导致,需要自行替换。目前在 Debian11/12上成功安装,其他 Linux 系统自行尝试,使用宝塔面板的在应用商店中可下载安装 讯搜服务端 (只支持Centos)
讯搜服务端安装
1、在线下载安装包并解压,或手动上传安装包
wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2
tar -xjf xunsearch-full-latest.tar.bz2
2、执行安装脚本
cd xunsearch-full-1.4.17
sh setup.sh
3、启动脚本
cd /usr/local/xunsearch
bin/xs-ctl.sh restart
如果网站和讯搜不在同一服务器,请使用 -b inet 方式启动脚本 bin/xs-ctl.sh -b inet restart
启动后可执行以下命令检测运行环境
/usr/local/xunsearch/sdk/php/util/RequiredCheck.php
生成索引
讯搜服务端安装成功后需要手动生成索引,生成完毕后即可正常使用。
对于首次使用时才需生成索引,后续新增/编辑/删除文章插件会自动更新索引
SSH连接到服务器
CD进入到讯搜安装目录,如果未指定安装目录,默认为 usr/local/xunsearch
修改以下命令并执行
sdk/php/util/Indexer.php --source=mysql://user:dbpass@host/dbname --sql="SELECT post.log_ID as id,post.log_CateID as cateid,post.log_AuthorID as authorid,post.log_Tag as tag,post.log_Status as status,post.log_Title as title,post.log_Content as content,post.log_PostTime as posttime FROM zbp_post AS post WHERE post.log_Status = 0 AND post.log_Type = 0 AND post.log_ID>0 AND post.log_ID<=100000 ORDER BY post.log_ID asc" --project=/www/wwwroot/网站目录/zb_users/plugin/xunsearch/post.ini
以上中的 user 为数据库用户名,dbpass 为数据库密码,host 为数据库地址(本地直接填localhost,远程填写IP),dbname 为数据库名;修改为自己的数据库信息即可,绿色代表分段索引(对于数据量大而言,数据量小可删除绿色部分),网站目录修改为自己网站目录。
开机启动
// Debian 开机启动,其他系统自行百度
// 在 /ect/init.d 下新建 xunsearch 文件,填入以下内容
#!/bin/sh
### BEGIN INIT INFO
# Provides: xunsearch
# Required-Start: $network $remote_fs $local_fs
# Required-Stop: $network $remote_fs $local_fs
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: [启动项的简短说明]
# Description: [启动项的完整说明]
### END INIT INFO
# 路径改成讯搜的安装路径
bash /usr/local/xunsearch/bin/xs-ctl.sh -b inet restart
exit 0
// chmod +x xunsearch 文件加上可执行的属性
// update-rc.d xunsearch defaults 将这个启动脚本加入开机启动项中
配置说明:
插件目录下的 post.ini 为配置文件,其中 server.index server.search 项分别为 索引服务和搜索服务,如果网站和讯搜为同一服务器,只需要填入端口即可。不为同一服务器则需要填写远程地址+端口号(记得防火墙放行)
搜索技巧
使用讯搜(xunsearch)搜索,确保已成功生成索引数据,并且已连接到讯搜服务端。
可使用 "tag:标签名" 格式搜索包含该标签的文章
可使用 "title:关键词" 只搜索标题包含搜索词的文章
关键词前面使用‘-’号,表示排除特定关键词,‘-’号和关键词之间不能有空格;如:学生 -学校,表示只搜索包含学生且排除有学校的内容。
拼写纠错
在搜索列表页面可使用 $article->Correcteds 获得纠错数组对象(无结果时返回空数组),可在需要的地方使用 foreach 循环输出对象,其中 Value 为纠错关键词,Url 为搜索地址。
支持多词搜索(用空格分开)
支持模糊搜索(多个词匹配一个即可)
支持条件搜索(具体查看官网)
支持搜索词高亮(请确保插件或主题中未过滤 html 标签)
支持搜索纠错(此功能建立在搜索日志基础上)
插件截图~
拼写纠错演示
1. 您在购买应用前,须要先确认该应用是否符合您的使用需求,数字化商品不支持试用。依据《消费者权益保护法》第二十五条规定,该应用为在线下载的数字化商品,在购买后一经下载安装不能退款。
2. 您在应用中心购买的应用,仅是该应用的许可使用权,该应用的所有权仍归应用提供方所有。
3. 一个应用仅可用于单一账号使用,未经本站和应用提供方同意,不得二次发布、赠送、转售、租让、盗版等,否则我们将永久关闭用户账号并保留继续追究相关责任的权利。
4. 如包含该应用的网站被转售或赠送、租让等,请另用新账号购买该应用或移除该应用,否则将视为违反使用协议被永久取消该账号的使用权利。
5. 如无特殊说明,已购买应用仅包括相关使用权及免费更新服务,应用中心及应用提供方不提供额外售后安装等服务。
6. 您使用应用中所存在的风险,完全由用户自己承担,包括系统受损、资料丢失以及其它任何风险。
7. 用户不得利用该应用以任何方式从事违反法律法规及社会公序良俗的行为,用户须对其不当使用行为可能带来的后果负全部法律责任,本站及应用提供方不承担任何责任。
8. 应用提供方和本站如发现用户将应用安装于黄赌毒诈等非法网站,将停止用户相关的使用权和服务,并将用户相关违法信息上报至网络监管部门。
9. 本站及应用提供方保留在不通知您及不对您承担责任的情况下变更、限制、冻结或终止您对某些内容的使用的权利。
1. 请先注册账号,然后登录“应用中心”。
2. 直接点击“购买应用”,跟随指引即可。
1. 购买者在自己的Z-Blog网站登录,进入后台,在左侧菜单栏点击“应用中心”菜单。
2. 在“应用中心”的首页,使用应用中心注册账号进行登录。
3. 进入“我的应用仓库”,即可看到已购买成功的应用,点击“下载”即可下载安装。
1. 如果通过自己网站后台无法正常访问应用中心,请谨慎购买,因为这将可能导致应用无法顺利下载安装。
2. 如已购买收费应用无法正常下载,请在自己网站后台检查Z-Blog及应用更新,如均已更新至最新版本仍无法下载请及时与我们联系。
3. 应用更新时有可能覆盖本地设置,请在更新前做好备份。