操作手册

1、绑定域名下载程序

    1.1、绑定域名

        1.1.1、登录酷信官网:https://www.kxcms.com/user/index/index.html ,在个人中心点击我的应用,然后在PT小说聚合搜索程序商业授权后点击管理,

              

        1.1.2、首次登陆官网,需要点击密钥生成,此密钥以后会经常用到,且只生成一次,请妥善保存;

                    随后输入自己要帮绑定的域名进行域名绑定即可;

    1.2、下载程序

        1.2.1、进行域名绑定以后选择绑定过的域名点击打包

           

        1.2.2、在下方弹出的打包程序下选择PHP版本以后继续点击打包

               

        1.2.3、点击程序地址后的链接程序会自动下载,下载后上传到服务器即可;

            

2、服务器选择和程序安装

     2.1、服务器选择

    2.2、程序安装
        2.2.1、安装基本环境
            检查PHP版本
            安装php扩展 fileinfo
            安装php扩展 memcached
            安装php扩展 memcache
            安装php扩展 swoole
            安装php扩展 swoole_serialize 可选
            取消php禁用函数 shell_exe
        2.2.2.、进行加密配置,打包程序
            www.kxcms.com 在线获取
        2.2.3、安装加密Loader
            2.2.3.1、查看phpThread下载对硬盘版对应现成的loader
            wget http://www.ptcms.com/code/loader/loader.so
            2.2.3.2、下载授权文件
            wget 官网打包地址提供
        2.2.4、 修改php配置,加入以下宝塔
            extension=/www/server/ptcms/loader.so
            swoole_license_files=/www/server/ptcms/license
        2.2.5、下载源码
            wget 官网打包地址提供
            tar zxf 
            rm -rf 
            chown www:www -R *
        2.2.6、配置网站
            2.2.6.1 、宝塔指定网站目录为public
            2.2.6.2 、配置伪静态
            if (!-e $request_filename) {
            rewrite ^/(.*)  /index.php?s=$1 last;
            }
        2.2.7、配置采集
            修改host
            vim /etc/hosts
            106.13.47.93 api.kxcms.com api.ptcms.com
        2.2.8、 安装
            访问
            域名/install.php
        2.2.9、配置cron
            查看完整目录命令
            php kx cron:check
            /www/server/php/72/bin/php /www/wwwroot/***/kx cron:check
            如果配置到crontab
            php kx cron:master >> /dev/null 2>&1

3、网站域名设置

    3.1、CDN优化

        3.1.1、在服务商处开通CDN服务,参考教程配置到站点的CDN;

        3.1.2、再后台“系统设置-功能设置”启用CDN;

        3.1.3、如果开启了CDN缓存,那么手机端访问PC端域名自动跳转可能会出错,我们需要在PC页面模板中(比如system/footer.phtml)增加以下JS

        <script type="text/javascript">
(function () {
var ua = navigator.userAgent.toLowerCase();
if (/ipad/i.test(ua) || /iphone/i.test(ua) || /windows mobile/i.test(ua) || /android/i.test(ua)) {
setTimeout(function () {
window.location.href = "{$kx.config.mobileurl}__SELF__";
}, 300)
}
})();
</script> 3.1.4、如站点使用CDN加速,则会使用户的访问请求从源站转移至CDN加速节点,导致用户的阅读记录和书籍访问量异常,为了解决这个问题我们提供了js调用的方式来统计。
    3.1.4.1、在模板中引入JS代码使页面加载时请求统计代码

        /*JS*/
        {if $kx.config.app.use_cdn}
        <script src="/api/stat/novel/info.js"></script> //访问量
        <script src="/api/stat/novel/read.js"></script> //阅读记录
        {/if}
        注:默认模板kxmobileno1和kxwebno1用已经引入 , 此步可以略过,引入位置 template/*/system/footer.phtml
    3.1.4.2、在CDN提供商处将统计目录/api/stat/novel/设置为不缓存(设置目录缓存时间为0)
        阿里云:https://help.aliyun.com/knowledge_detail/40192.html
        腾讯云:https://cloud.tencent.com/document/product/228/11203
        百度云:https://cloud.baidu.com/doc/CDN/GettingStarted.html#.E7.BC.93.E5.AD.98.E8.BF.87.E6.9C.9F.E9.85.8D.E7.BD.AE

    3.2、域名与模板

        3.2.1、域名与模板的关系:

            3.2.1.1、本程序设计域名与模板是一一对应关系,模板在后台“界面管理-模板管理”内设置

            3.2.1.2、电脑端域名对应PC端模板,手机端域名对应手机端模板,MIP域名对应MIP模板,AMP域名对应AMP模板;

            3.2.1.3、修改域名对应的模板(如想电脑端地址访问手机端模板),请修改模板config.ini文件或提交工单;

        3.2.2、手机访问PC域名自动跳转手机域名需要满足以下条件才会自动跳转

            3.2.2.1、域名设置里面配置了pc端域名

            3.2.2.2、域名设置里面配置了手机端域名

            3.2.2.3、开启了跳转手机端的功能 

            3.2.2.4、CDN没有缓存

            3.2.2.5、在手机浏览器中访问了pc端域名下面的地址 

4、采集相关设置

    4.1、代理设置

        4.1.1、目前支持固定代理和自动代理

            固定代理比较简单,现在仅仅介绍自动代理的使用方式

            4.1.1.1、芝麻代理

            芝麻代理同系列的网站均可以使用比如http://http.taiyangruanjian.com/ 看提取页面和芝麻代理一致即可

            套餐购买的时候推荐5-25分钟的版本,这个相对更好一些,1-5分钟太短 25-3小时时间太长不能及时更换

            提取ip的时候数据格式选择JSON

            选择属性务必选择上 IP:PORT , 过期时间 

            测试的时候注意错误提示,需要把你服务器ip手动加入到白名单中

            测试通过后,请在任务管理中开启获取代理ip的任务,这样才会不断的校验代理ip是否过期及重新获取新的代理ip

    4.2、采集超时问题

        4.2.1、在后台“采集管理-采集设置-采集设置”内设置超时时间,超时时间为采集单页页面超时时间;

        4.2.2、程序默认超时时间为5秒,如果采集单页时间超过5秒扔没有成功,那么采集会中断;

        4.2.3、如果采集目标站点超时可以考虑把超时时长设置长一点;

        4.2.4、这里简单说下前台采集的一些配置优化,前台采集比较受服务器参数配置的影响

                尤其是nginx超时时间,php-fpm超时时间。如果前台分页一页太多数据的话,执行时间超过了nginx或者php的超时时间,那么就会被杀掉,这时候看到的就是卡死的现象了

                所以如果使用前台采集,希望优化以下几个参数

            4.2.4.1、调整后台每页处理的数量

            4.2.4.2、宝塔中加大PHP超时时间设置

            4.2.4.3、调整nginx 超时设置,这个宝塔官方没有拿出来配置项,只是给了配置文件所以希望不是专业人员请勿尝试

    4.3、分类匹配

        4.3.1、采集来的小说分类会根据后台“采集管理-采集设置-匹配设置”内设置的分类去匹配本站的分类;

        4.3.2、本程序有默认匹配分类,也可自行添加匹配分类,添加规则为“分类ID|分类名=匹配名1|匹配名2|匹配名3....”;

    4.4、封面设置

        4.1.1、程序默认封面不会保存到本地,所以不会开启封面校验和保存封面;

        4.1.2、默认封面不会保存到本地,因为保存过多封面的话会产生很多琐碎的小文件不利于迁移

                    如果需要开启封面本地化,配置选项位置在 采集管理->采集设置->封面设置

                    下面解释下其中部分选项的含义

            4.1.2.1、封面校验

                    封面校验是校验获取到封面地址是否正常,是否为默认封面,对于不合法不适合的封面进行舍弃,推荐开启

            4.1.2.2、保存封面

                    开启后会保存封面到指定存储中

            4.1.2.3、缩放宽度

                    对于较大的封面进行缩放减小空间占用,0为不缩放

            4.1.2.4、oss配置实例

         'key'      => 'aaa',
'secret' => 'bbb',
'bucket' => 'cover',
'endpoint' => 'oss-cn-hongkong.aliyuncs.com',
'url' => 'https://static.qidian.com',
'path' => 'cover',

            4.1.2.5、cos配置实例

        'key'      => 'aaa',
'secret' => 'bbb',
'bucket' => 'cover-123456',
'endpoint' => 'ap-beijing.myqcloud.com',
'path' => 'cover',
'url' => 'https://cover-123456.cos.ap-beijing.myqcloud.com',

5、SEO相关设置

    5.1、链接设置

        5.1.1、变量说明

            {key}-分类关键词或排行关键词或单页标识;

            {page}-页码;

            {pinyin}-小说名字拼音或作者名字拼音;

            {authorid}-作者标识(作者id);

            {novelid}-小说书号;

            {chapterid}-章节id;

            {siteid}-源站;

            {commentid}-评论标识。

        5.1.2、关于个别页面URL的特别说明

            5.1.2.1、链接设置时可以使用变量,只需要把变量名放在变量调用处即可;

            5.1.2.2、搜索首页URL为手机访问时点击搜索进入的页面URL,电脑端不存在搜索页;

            5.1.2.3、目录页URL为手机访问网站时的小说目录页URL,电脑端不存在小说目录页;

            5.1.2.4、小说评论详情页URL为手机访问网站时评论详情页面URL,电脑端不存在评论详情页面;

            5.1.2.5、 综合阅读URL为小说内容阅读页面URL;

            5.1.2.6、阅读尾页URL为小说读完或者读到最新更新,点击下一章跳转页面URL;

            5.1.2.7、单页URL为网站底部单页点击跳转页面URL;

    5.2、TKD设置

        5.2.1、变量说明

            5.2.1.1、当使用变量配置网站的TKD时,只需将变量名放在变量调用处,变量在网站TKD设置时会代替所对应的变量值。

                {sitename}-网站名称:调用系统设置-网站名称;

                {siteurl}-网站网址:调用系统设置-域名设置-网站地址;

                {categoryname}-分类名:调用内容管理-书及管理-分类管理(当作为变量使用时,可以代替具体的分类名称);

                {rankname}-排行名称 :调用排行名称,程序模板控制,如需修改,请修改对应模板代码(当作为变量使用时,可以代替具体的排行名称);

                {rankkey}-排行关键词:调用排行关键词,程序模板控制,如需修改,请修改对应模板代码(当作为变量使用时,可以代替具体的排行关键词);

                {novelname}-小说名:调用具体的小说名称;

                {author}-作者名:调用具体的作者名;

                {pagetitle}-单页名:调用运营管理-单页管理名称。

        5.2.2、关于TKD页面的特别说明:

            5.2.2.1、小说评论详情页为手机访问网站时评论详情页面,电脑端不存在评论详情页面;

            5.2.2.2、搜索页为手机访问时点击搜索进入的页面,电脑端不存在搜索页;

            5.2.2.3、小说目录页为手机访问网站时的小说目录页,电脑端不存在小说目录页;

            5.2.2.4、综合阅读页为小说内容阅读页面;

            5.2.2.5、阅读尾页为小说读完或者读到最新更新,点击下一章跳转页面。

            5.2.2.6、单页为网站底部单页点击跳转页面。

    5.3、sitemap

        5.3.1、本程序目前支持多种sitemap。

        5.3.2、向站长平台提交sitemap时请参考各个站长平台每页最多多少条数据限制修改每页数量;

6、百度站长平台

    6.1、搜索资源平台

        6.1.1、登录https://ziyuan.baidu.com

        6.1.2、绑定站点:注意建议绑定PC端站点、手机端站点、mip端站点、

            6.2.2.1按照下图指示选择添加网站,

                

            6.2.2.2、按照下图指示选择站点对应的协议头,如果配置过SSL证书的建议选择https://认证;

                

            6.2.2.3、站点属性根据自己站点类型进行选择,小说站点建议选择书籍文档类型;

            6.2.2.4、站点验证建议选择文件验证,下载验证文件上传到网站根目录下的public文件夹下即可;

        

        6.1.3、链接提交

            6.1.3.1、选择对应的站点点击“链接提交”,复制对应接口调用地址到后台“SEO设置-百度推送”下对应的推送地址填写处即可;

                

        

        6.1.4、数据查看:完成上述步骤以后,即可在搜索资源平台查看,点击、索引、收录、提交等数据;

    6.2、熊掌号使用

        6.2.1、特别说明:百度熊掌号已更名为百度移动专区;

        6.2.2、登录:https://ziyuan.baidu.com/;然后点击移动专区(没有开通熊掌号的需先开通才能使用)

        6.2.3、绑定站点:进入移动专区以后点击内容源设置,然后选择绑定新站点,之后按照步骤绑定站点即可

                    

        6.2.4、复制熊掌号接口地址到网站后台

           

        6.2.5、绑定站点之后就可以在移动搜索专区查看站点在熊掌号的各项数据;

7、神马站长平台

    7.1、绑定站点:登录神马站长平台,点击添加网站,分别添加自己站点的PC端、手机端和MIP域名;

    7.2、当提交数据时,复制推送地址的时候,一定要准确选择推送数据的站点,再复制推送数据,如选择mip数据提交,就选择mip的站点再复制推送地址;

8、采集规则说明

    8.1、关于站点

        8.1.1、采集三步骤:1、添加站点;2、添加规则;3、加入任务;

        8.1.2、站点管理说明:

            8.1.2.1、站点名:必填选项,为了方便记忆和管理建议填写将要进行采集的站点名;

            8.1.2.2、站点关键词:必填选项,填写与即将采集站点相关的关键词,利于优化;

            8.1.2.3、站点地址:填写将要进行采集的站点URL,注意不要忽略“http://”或“https://”协议头;

            8.1.2.4、站点权重:采集到的小说章节的权重,如同本小说由多站采集,阅读是小说章节会显示权重高的章节,章节权重最大值不能超过100;

            8.1.2.5、样式:采集到的章节样式,CSS控制,本程序暂时没有该页面,建议不要填写任何内容;

            8.1.2.6、备注:为采集到的章节备注,本程序暂时没有该页面,建议不要填写任何内容;

            8.1.2.7、添加新书:状态为“是”时,采集到的新书会添加入库,状态为“否”时,只会采集本站已有小说章节做匹配,不会添加新书;

            8.1.2.8、替换源站:采集到的小说第一次入库时,是否替换基准站为本站;

            8.1.2.9、最少章节:添加新书时,小说更新章节满足此处所填最少章节时才会进行采集入库;

            8.1.2.10、最少字数:添加新书时,小说更新字数满足此处所填最少字数时才会进行采集入库;

            8.1.2.11、添加条件:填写添加新书的条件,如:“或 [ OR ] 关系,最少章节与最少字数满足一个即可”、“和[AND]关系,最少章节和最少字数都需要满足”。

        8.1.3、建议配置:

            原创站点: 添加新书、不替换源站  ;

            优质站点: 不添加新书、不替换源站  ;

            普通站点: 不添加新书、不替换源站  ;

    8.2、关于规则

        8.2.1、规则管理

             8.2.1.1、规则名称:必填选项,可以和站点名称保持一致,可以另取名称;

             8.2.1.2、站点分类:站点分类为必选选项,分类决定了文章的优先匹配分类,不影响采集;

             8.2.1.3、所属站点:必选选项,此处将要添加的规则必须对应站点管理里面的站点;

             8.2.1.4、使用API的话,只需要填写API KEY;

             8.2.1.5、跳过始章、跳过尾章、章节名纠错、过滤重复章节、处理乱序、使用代理、下载选项等根据自己网站特性自由选择或填写;

             8.2.1.6、更新列表规则、信息页规则、目录页规则、章节页规则只需要将要采集的网站的对应页面的采集规则填写进去即可(使用正则表达式);

             8.2.1.7、章节VIP标识为获取到的章节页面HTML中含有这个字段标识则为VIP章节,不支持正则,建议写一个VIP章节特有的HTML标签即可;

        8.2.2、删除说明

            8.2.2.1、删除操作属于不可逆操作,请谨慎选择;

        8.2.3、导入/导出说明

            8.2.3.1、使用操作面板可以将此处填写的规则导出到主机本地,也可以将主机本地的规则导入到该站点;

        8.2.4、采集说明

            8.2.4.1、采集模式:后台采集可以关闭浏览器运行,在手动采集日志中查看进度;前台页面采集必须保证浏览器是打开状态;

            8.2.4.2、选用规则:选择将要进行采集的站点对应的规则;

            8.2.4.3、自定义页面:自定义将要采集的页面,自定义以后,页码位置请使用[页码],否则多页采集无效;

            8.2.4.4、开始页码、结束页码为必填选项;

            8.2.4.5、翻页间隔:当前页采集完成后等待多少秒后进入下一页;

        8.2.5、测试说明

            8.2.5.1、测试功能只是为了测试所写的功能是否可用,如果采集到内容就说明所写规则可用,如果没有采集到内容,说明所写规则有误,修改后再进行测试;

        8.2.6、任务说明

            8.2.6.1、当把对应规则添加到任务,才是采集的开始;

            8.2.6.2、选用规则为必选选项,选择将要采集站点的对应规则;

            8.2.6.3、采集时间间隔:单位秒,0只运行一次,大于0为循环运行;

            8.2.6.4、附加参数:“start/*/end/#” * 和 # 对应位置分别填上开始采集页码和结束采集页码;

            8.2.6.5、采集形式:必选选项,如选择运行测试,浏览器必须为打开状态,网站正常运行时,建议选择加入后台计划任务。

    8.3、自建接口

9、任务与日志

    9.1、采集任务

        9.1.1、可以在对应规则后面直接选择任务,填上参数为“start/开始页码/end/结束页码”,选择加入后台计划任务,点击确认执行 以后就算加入到采集任务

    9.2、采集日志

        9.2.1、手动采集为进行单页手动采集时的日志,在这里不过过多说明;

        9.2.2、自动采集日志为后才自动采集日志,后台采集日志可以查看每个任务一天内的采集情况;

        9.2.3、如果采集出现问题多可查看采集日志发现问题;

10、命令行

11、模板管理

    11.1、模板使用

        11.1.1、一个域名对应一个模板,在后台“界面管理-模板管理-模板管理”选择域名对应的模板,如果想要域名对应不同的模板(如:电脑端域名对应手机模板,请修改模板对应的配置文件);

    11.2、模板改动

        11.2.1、如对现有模板不满意,可以修改模板对应代码;

12、自定义页面

        12.1、添加自定义页面需要将写好的页面文件代码上传到 /template/*/custom/ 目录下,并且PC端和移动端的模板都要写好,模板的TKD分别用以下所说的变量调用;

        12.2、添加自定义页面说明

            12.2.1、URL说明:请不要和其他已有页面url冲突,可以设置成比如“/gg.html”男生频道 “/active/yuandan.html”元旦活动;

            12.2.2、标题说明:在模板内使用 $title 调用;

            12.2.3、描述说明:在模板内使用 $description 调用;

            12.2.4、关键词说明:在模板内使用 $keywords 调用;

            12.2.5、模板说明:模板文件请放到 /template/*/custom/ 目录下,请pc和手机模板都制作好;

            12.2.6、自定义参数说明:在模板内使用 $params['参数名'] 或 $params.参数名 调用,数组请输入json字符串。

        12.3、添加完成以后,选中页面点击启用,页面就可以访问,点击禁用,则页面不允许访问。
联系我们
qq
QQ:3358162308
weixin
电报:@PTCMS
email
邮件:support#ptcms.com
address
地址:北京中关村车库咖啡
Copyright © 2009 - 2014 PTCMS Studio All Right Reserved。苏ICP备13037930号