ZBlogPHP 模板开发三大核心:列表循环 loop、分页调用、面包屑导航,是搭建首页、分类页、内容页必备代码。新手吃透这三块,就能自主修改主题、制作专题模板,适配 IT 技术博客布局。
一、Loop 文章循环调用(列表核心)
loop 用于循环输出文章,首页、栏目列表、侧边推荐通用。
1. 基础全量循环(栏目 list.html)
{foreach $articles as $article}
<div class="item">
<h3><a href="{$article.Url}">{$article.Title}</a></h3>
<div class="info">
<span>发布时间:{$article.Time()}</span>
<span>分类:{$article.Category.Name}</span>
</div>
<p>{$article.Intro}</p>
</div>
{/foreach}2. 指定数量循环(首页调用置顶 / 推荐)
{php}
$toplist=GetArticleList(5,array('istop'=>1));
{/php}
{foreach $toplist as $article}
<a href="{$article.Url}">{$article.Title}</a>
{/foreach}GetArticleList (数量,筛选条件):5 = 调取 5 篇,istop=1 调取置顶文章
可选筛选:inzy=1 精选、tag = 标签名、cid = 栏目 ID
3. 循环自定义字段
{foreach $articles as $article}
{if $article.Metas.soft_ver}<span>版本:{$article.Metas.soft_ver}</span>{/if}
{/foreach}二、分页代码(list 栏目页必备)
ZBlog 自带分页标签,直接放入循环外即可,自适应页码、上一页、下一页。
<div class="page">
{$pagebar->PageBar()}
</div>分页样式自定义
.page{margin:15px 0;text-align:center;}
.page a{padding:4px 8px;border:1px #eee solid;margin:0 3px;}
.page span.current{background:#06c;color:#fff;padding:4px 8px;}注意:只有列表页存在分页,首页固定条数调用无需分页。
三、面包屑导航(全站通用,利于 SEO)
面包屑:首页→一级分类→文章标题,提升爬虫抓取、用户体验,利于收录排名。
1. 内容页 article.html 面包屑
<div class="bread">
<a href="{$zbp->Config('ZC_BLOG_HOST')}">首页</a>
{if $article.Category.ParentID>0}
> <a href="{$article.Category.Parent.Url}">{$article.Category.Parent.Name}</a>
{/if}
> <a href="{$article.Category.Url}">{$article.Category.Name}</a>
> {$article.Title}
</div>2. 栏目列表页 list.html 面包屑
<div class="bread">
<a href="{$zbp->Config('ZC_BLOG_HOST')}">首页</a>
{if $category.ParentID>0}
> <a href="{$category.Parent.Url}">{$category.Parent.Name}</a>
{/if}
> {$category.Name}
</div>四、常用拓展调用
1.栏目导航循环(头部菜单)
{foreach $zbp->GetCategoryList() as $cate}
<a href="{$cate.Url}">{$cate.Name}</a>
{/foreach}1.侧边最新文章
{php}$newlist=GetArticleList(8);{/php}
{foreach $newlist as $v}<a href="{$v.Url}">{$v.Title}</a>{/foreach}五、模板修改避坑
1.修改模板后后台清空缓存,代码才生效;
2.循环标签{foreach}{/foreach}必须成对,缺写导致页面错乱;
3.面包屑多级分类依靠 ParentID,分类后台设置父栏目才会显示上级。
六、SEO 优化要点
1.面包屑自带内链,强化栏目权重传递;
2.列表合理分页,避免单页内容过多,提升抓取效率;
3.列表摘要 Intro 控制字数,精简内容提升页面加载速度。
标签: ZBlog 模板开发 ZBlog loop 循环 ZBlog 分页代码 ZBlog 面包屑导航 ZBlog 主题修改


