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

演示地址：https://www.talklee.com/

主题已经上架Z-Blog应用中心，点击此处前往应用中心购买，也可以直接@我付款购买（有折扣）

主题相关功能：

• 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>

更新说明（2019年/8月）：

V、更新标题颜色js代码，点击文本框自动调用rgb调色板，如图：

V、优化文章视频代码。

V、增加列表模板顶部Banner图片功能。

V、优化横排模板(imglist)和商品模板(cataimg)自定义背景图功能，设置方法，后台---主题配置---功能设置如图：

cateimg文件夹下有10张图片，其中1-5是默认模板(catalog)和文章模板使用的，另外的6-10张图片是横排模板和商品模板使用的，图片背景地址仅写出路径即可，不要写图片的完整地址（也可以把图片下载，放到腾讯云储存里面），默认地址路径：“/zb_users/theme/koilee/include/cateimg/”

网站前台显示图片网址为："/zb_users/theme/koilee/include/cateimg/1.jpg"，想更换图片的请按照规则命名，数字1-10，后缀为：“jpg”。

V、优化右侧返回顶部title标签。

V、修改搜索模板页点击查看更多无反应的BUG。

V、优化文章归档代码。

PS：关于热更简单说下，目前正在研究新的授权方案，带完成之后增加热更功能。另外说下，私下分享或者二次销售主题的客户将无法继续更新和使用主题，主题后台将无法设置。且用且珍惜吧！

∧_∧..

视频教程：

V、更新文章存档样式表。

V、更新模板置顶效果。

V、更新商品列表、商品详情页演示地址接口（需要开启自定义缩略图开关，后台未设置演示地址则不显示，nofollow标签，链接加密）。

V、适配应用中心“百度收录查询”插件，搜索ID：“baidu_recond”安装启用即可；

PS：可能会使页面打开速度变慢，介意者勿用，但会提升百度收录速度（插件开发者原话）

V、评论缓存再次优化，审核接口无效，所以更改原接口，评论成功之后，即可更新一次缓存，也可以随意删除一个评论来更新侧栏留言评论的数据。

V、优化评论用户标签，评论者设置为铁粉用户。

---、优化文章归档样式及功能（设置方法，页面管理，新建文章，右侧模板选择“sitemap”）内容，标题，别名随意，然后提交即可，不上图了，点击查看效果：文章归档

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

---、修改底部轮播公告偶现错位BUG。

---、优化评论叠层以小头像显示。

---、修复评论头像加V标识。

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

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

---、修改商品模板排列样式（更新之后需要强制刷新Ctrl+F5，如果开启CDN需要清空缓存。）

---、优化列表底部翻页JS代码，不会出现未加载时导致错位的BUG。

---、优化部分php及js代码，删除冗余代码，提升网站打开速度。

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

--、标题美化增加开关，修改部分文字描述。

--、优化侧栏部分模块的css样式。

--、商品页模板“主题售价”改为“商品售价”。

--、更新点赞打赏功能在某些情况下不居中的BUG。

--、优化文章版权（文章来源修改为文章地址，不然总有人弄错，，，）

--、修复关闭侧栏时间没有对齐的BUG。

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

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

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

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

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

--、其他，我也忘记了，精简了一些PHP代码，值得更新。

--、移动端后台登录功能增加开关且登录之后显示后台链接。

--、微语公告右上角标可以后台自定义。

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

--、优化页面加载的流畅度。

--、修复滚动公告关闭之后列表页、文章页等页面依然存在的BUG。

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

自定义公告格式：

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

--、微语功能完善，增加时间显示，新增自定义摘要。

--、完善侧栏显示信息，如果用户登录网站，侧栏则显示用户信息，未登录时显示网站管理信息。

--、新增用户编辑接口，QQ、微信，用户可自定义。

--、修复文章有序列表代码。

--、优化已知BUG若干。

--、更新版本号。

--、更新5.4青年小图标。

--、修复移动端手机验证码没有文本框的BUG。

--、修复标题过长导致“推荐”错位的BUG。

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

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

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

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

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

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

--、分离相关JS代码，功能特效使用独立的js来完成，不开启则没有相关js代码。

--、取消侧栏读者墙功能（读者墙单页依然有效），因为跟最近留言冲突，所以取消。

--、美化评论，增加评论楼层的顺序。优化自适应显示效果。

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

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

更新数据调用缓存，需要重新启用主题，你可以直接点击启用主题（锦鲤），也可以先启用默认主题，然后在重新启用新主题（需要删除模块管理-主题自带插件的读者墙栏目，不要拖拽到右侧侧栏（如果侧栏有那么请移除），因为新版已经删除此代码），然后会在/zb_users/cache/目录下生成一个名为koilee_cache的文件夹，这里就是txt静态文件。

PS：如果启用新主题之后，发现侧栏的文章调用都是空的，请在文章管理，编辑任意一篇文章（无需修改内容），点击右侧提交即可在缓存目录下生成缓存的数据文件。评论没有的话，需要在任意一篇文章下发表评论，即可生成新的缓存文件。注意，缓存文件仅在此种情况下（编辑修改文章，成功发表评论）才会生成最新的数据，如没有以上操作，缓存时间则是上次生成的时间。文章的编辑（新建）和删除都会重新生成文章数据，发表和删除评论也都会重新生成新的留言和读者墙缓存文件。哦对，有人可能会问，后台首页重新编译并清空缓存会不会更新？问得好，有点水平，但是可能要让你失望了，我的答案是不会，别问为什么。好了，问题就说这些，在使用过程中遇到问题可以直接QQ留言给我。

设置侧栏内容后发现没有效果请按一下方式操作：

• 1.文章管理--随便编辑一篇文章，然后右侧提交，前台刷新就可以了。

• 2.如果留言不更新，登录后台，评论管理，随便找一个评论，点击右侧审核，然后点击顶部审核管理，找到刚才的评论，点击审核通过，或者任意删除一个评论也可。

看下效果吧：用户网站

主题未使用缓存之前是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模板）：

主题后台介绍及预览：

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

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

首页设置：

首页设置也比较简单，显而易见的就不说了，介绍下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.talklee.com/zb_users/theme/koilee/include/hitokoto/hitokoto.txt

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

广告设置：

没什么好说的，填写广告代码，开启就行了，针对PC端和移动端展示不同的广告，留空就不显示。

功能设置：

轮播（关闭册右侧文章也会被关闭没，默认开启）。

是否开启CMD模式（默认开启）。

视觉滚动特效（默认开启）。

自定义缩略图（设置分类所显示的缩略图，如果文章没有图片，则优先显示自定义，如果没有自定义那么随机显示图片，文章没有图片移动端则不显示，默认关闭）。

是否开启自定义SEO插件（文章、列表、标签均可以设置不同的关键词和描述，默认关闭）。

新窗口链接（点击任意链接都是在新窗口打开，默认关闭）

其他的看页面预览吧：主题永久免费更新维护，确保每个人都能正常使用。

首页截图：

分类模板图（默认）：

文章、留言展示效果图：