好运锦鲤（时来运转）

历时一个多月的锦鲤主题，终于完成了。2019首发Z-blogPHP锦鲤主题模板（Koilee · 开运锦鲤），部分模块移植WP主题，目前主题已经完善，主题简洁、大气，适合个人博客及文章写作等，先介绍主题吧。

用户中心适配教程地址：https://www.liblog.cn/blog/430.html

√响应式√不限域名√永久使用√免费升级√免费体验√售后保障√原创作品√物超所值√SEO标题、关键词和描述

主题相关功能：

1.主题自带SEO设置（文章页，列表页，标签页等），主题设置-功能设置-开启自定义SEO
2.文章可自定义显示缩略图；
3.完美支持移动端自适应；
4.适配百度熊掌号（主题设置-功能）；
5.自定义css样式功能，如果需要某些样式，可在后台自定义修改，方便快捷，不受主题更新的影响，一劳永逸。
6.首页采用CMS和Blog模式双布局，后台自由切换，采用Html5+CSS3搭建，布局合理，适配百度熊掌号。Js+CSS无加密，购买后可二次开发（因二次开发而导致的网站错版，无法打开等问题均不在售后范围之内，可有偿提供技术支持！）。
7.模板采用图片延迟加载技术、视觉滚动等相关特效。去除占用CPU较高且无用的特效。
8.底部采用波浪式背景图片，简单却又不失调皮（皮一下很开心）。
9.首页CMS布局基本采用自定义文章的形式展示，给你最大化的自由！（往下有具体介绍）
10.博主介绍可以开启随机展示一句话，不会设置的往下看吧。

导航二级菜单，代码如下：（模块管理---导航栏，直接复制粘贴，名称和链接修改成自己的）

<li class="menu-item-has-children">
  <a href="/">一级菜单</a>
  <ul class="sub-menu dropdown-menu">
    <li><a href="/">二级菜单</a></li>
    <li><a href="/">二级菜单</a></li>
  </ul>
</li>

往期更新内容：

---、更新侧栏热评文章调用方式，原方式为网站所有文章，调用评论最多的8篇，这样一来热评的文章可能是几个月或者很久都不会变，更新之后采用固定天数调用，这个热评的天数跟侧栏热文文章的天数是一样的，设置方式，如图：90天之内的热门文章和热门评论。

---、优化后台logo，ico图标及网页背景图片接口模式，删除之前固定上传的模式。这里要特意说明下：因为采用接口模式，老客户更新之后可能会导致网站没有logo、ico图标及背景图错误的BUG，你们只需要在更新之后，换成对应的网址即可，如图：按照正常的逻辑，删除“_example”就可以了，例如：“/zb_users/theme/koilee/style/images/logo.png”这样就能正常了。

---、删除商品页面banner顶部信息接口，直接调用该分类名称及SEO描述，背景图调用第一篇文章的第一张图片（选取图片逻辑跟列表统一）

--、新增分类列表模板，分类管理-分类编辑，模板选择“imglist”，文章模板不用修改，然后提交。

--、删除原外链伪静态开关，新增外链中转页开关（取消了外链的伪静态，之前使用伪静态的可以把规则删除了，因为没有必要做伪静态，本身就是自己的网址，所以取缔。外链中转页增加开关，不喜欢中转页的关闭就直接访问链接。）

--、增加分类列表标题的变粗、变色功能（变色采用RGB代码，不懂的自己百度，或者直接填写英文颜色单词也可，比如：blue）。

--、修改评论显示，凡是会员显示为“铁粉”昵称，仿微博的功能，增加博主昵称（评论ID跟文章ID想用则显示博主，不在统一显示管理员）。

--、右侧客服信息增加微信显示，后台自传二维码。

--、侧栏博主信息增加微博显示功能（主题和用户中心自行配置）增加二维码显示。

--、底部滚动公告调用“推荐文章”（文章推荐功能，如果没有没有推荐则不显示，需要开启自定义缩略图才有效。）

--、新增网页底部滚动公告功能，自定义公告关闭的时候，显示6篇90天内的热门文章，如果开启自定义公告则显示自定义内容，不显示文章。

--、新增分类列表间广告代码接口，后台开启（联盟广告，html代码都可以，没有限制）

--、新增商品页广告接口，接口位置同“首页CMS模块上方广告”，解释一些，开启这个广告位那么商品页模板也会开启这个广告位，显示的广告跟首页CMS模块上方的广告是同一个。

--、修复搜索页面侧栏不显示文章数据的BUG。

--、新增文章列表新窗功能（后台--主题设置--功能设置--开启文章新窗口）

--、新增文章推荐功能（新建文章，右侧，设为推荐即可，需要开启自定义缩略图功能）。

--、缓存侧栏部分调用数据，减少数据库的请求次数（相对来说有一丢丢作用的还是）

--、侧栏缓存内容包括，文章推荐、热评文章，最近发表、热门文章、热门标签、如果重新生成缓存txt文件，需要编辑下任意文章，无需修改，直接提交即可更新缓存的txt文件。

--、侧栏的最新留言和读者墙需要在任意文章发表评论即可生成新的缓存txt文件。

自定义公告格式：

<li><a href="/" target="_blank" title="这是一条广告，可以在后台开启设置"> 公告：《这是一条公告，可以在后台开启设置》</li>
<li><a href="/" target="_blank" title="也可以关闭自定义公告，显示近一个月热门文章。"> 公告：《也可以关闭自定义公告，显示近一个月热门文章。》</li>

看下效果吧：用户网站

主题未使用缓存之前是97次请求查询

主题启用之后是56次

--、修复顶部出现1像素白边的问题。

--、增加网站关闭侧栏按钮功能（需要开启自定义缩略图，新建或者编辑文章的时候右侧，开启关闭侧栏即可）

--、优化侧栏侧栏模块部分功能及代码，删除重复内容。

--、因微语未能完善其显示效果，所以暂时取消微语一栏功能，后续有完美方案在添加，对此深感抱歉（如果你觉得不想取消微语，此版本可以无需更新。）

--.修复在线更新主题文件出错的BUG。

--.优化跳转页源代码。

更新公告模块（原微语模式）效果如下：

设置方式：

左侧菜单，页面管理，新建页面，标题和正文随意，然后设置底部“别名”（例如：notice）然后右侧提交。

回到主题配置-首页设置（如图）

PS：红框内设置的就是公告模式，这里取决于伪静态的设置，有些可能需要填写ID，最稳妥的设置方法是：页面管理找到刚才新建的页面，点击前面的曲别针图标，如图

然后在新窗口页面复制链接就可以了，如图（红框内的地址，填写在主题设置里）

微语发布的时候，正文选中文字，点击编辑器右上方“文本标记”，下拉，选择“微语模板”即可，然后在下方设置摘要信息就行了。

设置完成，往下看，找到微语自定义摘要，设置首页显示的摘要信息，如图：

--、新增360搜索出图功能，采用普通文章模式，无需手动设置，自动开启。

新增留言墙单页，设置如下：

页面管理---标题自拟，正文自写，别名（访问链接）设置随意，然后右侧模板选择“readers”

最后提交，然后就ok了。

调用数据为：一年内（365天）评论次数最多的前100名用户（可能目前还不完善，但是不影响使用，不需要可以不开启）

效果图：

--、网站分类所属的子分类栏目列表，如果分类下没有子分类则不显示。图

--、优化文章页相关推荐标签过多显示出错的BUG。

--、优化跳转页面样式表，增加一个广告位（广告设置，分类列表顶部广告代码。）

--、修复移动端部分视频无法自适应的BUG。

--、移动端导航菜单新增会员登录功能，登录链接设置为（主题配置---基本配置---顶部登录功能--会员登录/注册链接）

--、修复文章归档样式错乱的BUG（方法如下）

页面管理，新建页面，填写文章标题，内容随便写点什么（反正也不会显示），然后填写归档文章的别名：“archive”（可自定义），最后在右侧选择模板“sitemap”，提交，完毕，不会设置看图。

----、分享代码关闭后后打赏等功居右对齐改为居中对齐，如图。

----、优化首页友情链接和友链页面，标题的调用方法。（原先固定的，现修改为原模块名称。）

模块管理，找到友情链接和图标汇集，然后修改名称：

----、更新屏幕尺寸1200像素时，轮播右侧图文显示错位的BUG，

----、文章没有图片也未使用自定义缩略图时的默认图片更改为随机显示图片（1-9张随机显示）

----、适配用户中心（）普通会员和永久会员的独立标识，如图：

永久会员显示----普通会员（周、月、年）----管理员（未适配）：

--------

PS：需要的话自己设置，打开主题配置，基本设置---自定义css（右侧开启）：

代码：

.single-avatar.vip3 {
    display: inline-block;
    padding: 4px;
    width: 70px;
    height: 70px;
    background: url(你的域名/zb_users/theme/koilee/style/images/avatar_admin.png) -1px 0 no-repeat;
}

----、首页CMS模块增加开关，精简部分PHP接口代码。

----.鉴于文章版权问题，优化主题模板自带的版权功能。看图吧：

原创效果图：

转载效果图：

开启方式变更为：主题配置---功能设置：

新建文章（编辑文章）标题下方有转载接口，开启版权功能且填写文章作者才会显示转载的效果图，否则显示原创效果。

----，优化部分文章显示超出屏幕的Bug。

----.更新列表文章的点赞样式。前提开启（点赞插件：新·文章点赞开发版）

----.适配商品购买模板（需要开启用户中心，插件ID：LayCenter，购买功能），可实现在线购买。

设置方法：用户中心（ID：LayCenter）---销售配置---购买按钮（如图）： .buybtn

----.适配用户中心文章的收藏功能（前后颜色不同，已于区分，不喜欢这个颜色的，主题后台自定义css修改）；

设置方法：用户中心---常规配置，收藏按钮----基于元素添加（如图）：.ds-reward-stl

----优化页面整体效果及自适应展示效果，修改手机版导航为左侧菜单，修复三级导航菜单重叠BUG，优化三级菜单背景颜色。

----、新增部分图片特效，新增右侧跳转网页底部功能。

----、修复评论墙调换页面错乱的现象。

----、修改网站边框之间的间距。

----、用户评论，最新留言等侧栏新增用户加V图标。

--.新增网页底部自定义接口代码（可以放置相关代码，比如JS等）。

--.优化百度熊掌号代码接口，熊掌号基本已经完了，原API接口已经失效了更换成了“搜索结果出图”，需要的开机，不需要的关闭就行了。

--.修复三级菜单样式代码。

--.优化移动端评论头像显示效果。

--.新增导航三级菜单写法（文字和链接自行替换）

<li class="menu-item-has-children">
  <a href="/">一级菜单</a>
  <ul class="dropdown-menu sub-menu">
    <li><a href="/">二级菜单</a></li>
    <li>
      <a href="/" class="menu-th3">二级菜单</a>
      <ul class="sub-menu dropdown-menu">
        <li><a href="/">三级菜单</a></li>
      </ul>
    </li>
  </ul>
</li>

新增商品页

可以搭配cataimg列表使用，查看演示，两种方法。

设置如下：

第一种：发布（编辑）文章，点击右侧，模板，选择“itheme”如图：

第二种：如果不想每次都选择的话，那么选择左侧菜单，分类管理--编辑分类--选择文章分类模板“itheme”如图：

然后保存，所有此分类下的文章都将会采用“itheme”商品页模板。（如果没有采用那么需要手动修改模板，参考第一种方法），哦，对了，商品页的价格接口需要开启，自定义缩略图才能看见，否则显示浏览量。

--.修复首页cms模板底部轮播出错的BUG。

--.修改部分CSS样式表，优化移动自适应部分错位等情况。

--.新增文章页灯箱效果（不知道什么是灯箱效果的，点击文章图片就知道了）。

--.新增cms首页部分cms模块开关功能，修改cms模块位置。

--.修改BUG若干（你能发现的或者你反馈的我都已经修复，不一一列出，更新后没有效果请CTRL+F5强制刷新，还不好使的话清空CDN缓存，要是还不好使，好吧，你单独找我吧。。。可能我忘记了。）

--.修复搜索页面的关键词高亮与可风用户中心搜索记录有冲突的BUG（感谢可风的技术支持，后期还是适配更多关于可风用户中心。）

--.优化了H2-H5标签样式表。（别再来找我说H2没有了，我受够了，喏，给你们更新了）

--.优化导航栏间距。

--.删除和优化搜索框，减少在导航栏所占用的空间。

--.新增评论用户加V标识。

--.修复打赏微信和支付宝位置错误的BUG。

--.优化移动端自适应展示效果。

--.修复因为百度熊掌号导致的JS错误。

--.精简JS，减少不必要的加载。

--.修复文章页面评论无法关闭及上下篇出错的BUG。

--.修复评论之后无法显示评论内容的BUG。

--.新增侧栏作者介绍微信模块。（自定义Font图标）

--.新增自定义背景图片。

--.修改logo尺寸宽度。

--.优化导航栏跟随的背景效果。

先介绍主题后台：（基本设置）

购买主题之后应该先设置分类模板：（下图）如果不设置，那么打开分类显示的都是首页。

设置分类模板（否则打开无论打开哪个分类页面都是首页的效果），

进入后台，分类管理，修改分类，

模板选择：catalog（默认）也可以选择cataimg（效果图在下方）,该分类文章的默认模板：single (无需修改)，效果如图：

效果图（catalog模板）：

横排效果图（cataimg模板）：

主题后台介绍及预览：

主题配置.jpg

基本配置很简单，一目了然，就是设置博客的关键词，描述，网站标题和LOGO等常规操作，这里应该不用特殊说明，所以就略过了。

哦对了，顶部登录更改了，变成在导航栏，这样简洁而且很好看。如果你开启了QQ登录或者启用的用户中心，那么直接填写登录或者注册的链接就行了，是否开启你决定，有开关，没有启用用户中心的（好比我的博客）关闭就好了。

首页设置：

首页设置.jpg

首页设置也比较简单，显而易见的就不说了，介绍下CMS模块对应的接口吧。

轮播设置：

默认情况下：轮播的图片尺寸为：831*380（像素）右侧对应的是四篇文章，如果你开启了百度的信息流广告，那么文章就得减少一篇，如果右侧文章想设置其他数量，那么左侧的轮播高度也要随之增减，看具体情况。如果不动代码，不会查看高度，就设置默认的数量即可。以免左右高度不一样，影响网站的美观及排版。

直接填写文章ID即可，这里说下两个功能：

第一个是，如果关闭了首页的轮播（幻灯片）那么此处也是关闭的。

第二个是广告代码，这里可能很多人不理解，解释下，不知道大家用不用广告联盟，如果没有广告的话就不用看了，如果开启的百度等联盟代码，那么这里可以获取广告联盟代码，设置信息流，配置广告样式（一般设置左图右文），然后复制代码，放在如图的接口了，开启右侧的开关就可以了。

往下走，继续设置：

对应首页的精选导读：

这里就很简单了，设置精选导读，不需要的话关闭就行了。

然后是文章调用数量模块：

首页精选导读下方的最近文章数量，你想设置几篇就直接填写数字，比如8，那么就是调用最新的8篇文章。

第二个：侧栏，先说下侧栏的调用顺序：左侧菜单，模块管理，找到主题和插件创建的模块，然后把你想展示的模块拖拽到右侧。

首页显示的是（默认侧栏），分类页（包括标签，作者，时间等页面）显示的是（侧栏2），文章页显示的是（侧栏3），搜索页显示的的（侧栏4）

介绍完侧栏，在回来介绍调用侧栏热门标签（数量），这就很简单了，想在侧栏展示多少标签就填写数量就行了；

然后是热门天数（文章推荐和热门天数是TAB切换展示的，直接拖拽（文章推荐/热门文章）即可），比如想展示一个月的热门，那么就填写30（一年是365天，我知道这是废话，但还得写出来），就行了。

最后是文章推荐，直接填写显示的文章ID即可，比如（1,1,1,1,1,1）数字之间用英文状态下的逗号（,）隔开，最多不要超过9篇。

再往下：

对应首页的：

调用哪个栏目就填写栏目的ID即可。（最好是比如，两个栏目或者四个栏目）什么，你不知道分类ID是什么？好吧，看图：

在继续：

对应首页：

这个就简单了，不需要填写分类ID，直接选择就行，但是得填写调用的数量，默认是10篇。

在继续：

对应首页：

是的，这里又得写调用分类的ID了，其实我尝试过，写成直接选择的模式，不过尚未成功，所以还得手动填写分类ID，不知道分类ID的，看上图吧，然后填写调用的文章数量即可（默认每个分类显示4篇）。

CMS到此设置完成，在看看其他的：

这个是设置侧栏博主的相关信息，比如博主的ID，背景图，文本超链接等。还可以编辑作者的信息，也可以开启右侧随机显示一句话。

要开启随机显示一句话必须要有文本教程如下：

新建一个txt文本文档，命名为：hitokoto.txt （不能随意修改，否则不能正常展示）

然后直接填写你想展示的文字即可，比如：

人一生会遇到约万人，两个人相爱的概率是.。所以你不爱我，我不怪你。
不管看到什么样的过去，都请不要迷失自己，不管你变成什么样子，我都是你的同伴。
自己永远是孤单的，但你可以让其他人变得不孤单。
要改变别人的心真是件很难办的事，不过改变自己要容易一点。
风筝的线你随时可以放开，只是别盼望我会回来。
做不到的话，不过就是一死。但是，赢了就能活下去，要是不战斗就赢不了。

就这样，每个自然段一句话，然后上传到“/zb_users/theme/koilee/include/hitokoto/”此目录，开启即可；

如果出现乱码可能是文本的编码不同导致，可以在使用本站的文件：https://www.liblog.cn/zb_users/theme/koilee/include/hitokoto/hitokoto.txt
下载到本地，修改内容，上传FTP至相关目录即可。

剩下的没没什么好说的了，文章版权，分享代码（需要先开启文章赞赏）等。

广告设置：

广告配置.jpg