zblogphp辅助函数GetPost可以通过ID或别名获得指定文章或页面数据,包括文章的标题、内容、发布日期、浏览量、URL地址、文章评论、所属分类等页面数据。
GetPost 函数
通过GetPost函数可以获取指定的文章或页面的数据,在zblogphp程序中,文章和页面是不同的概念,属于两种不同的内容页面,这点从网站后台中有文章管理和页面管理就可以知道!
该函数被封装在zblogphp程序中的zb_system/function/c_system_event.php函数文件内,我们只需要在主题制作、二次开发、插件开发中调用GetPos函数即可获得指定文章或页面数据!
GetPost语法
GetPost(参数1, 参数2)
参数1,可以是指定文章或页面的ID、标题,或者是别名;但注意,如果存在同名的文章或页面则只返回第一个结果,若指定的文章不存在则返回空。
参数2,可省略不写,附加选项,类型为数组类型,有两个参数值,默认均为false,参考如下:
参数2= array ( "only_article" => true //只检索文章 //"only_page" => true //只检索页面);
两个选项同时为true时只有only_article选项有效。
语法示范:
如果我们指定获取文章标题或别名为“abc”的数据,则GetPos函数中参数1的值是设置为“abc”,参数2设置为不检索页面,代码如下:
GetPost("abc", array ("only_article" => true));
如果我们指定获取文章标题或别名为“abc”的数据,则GetPos函数中参数1的值是设置为“abc”,参数2设置为不检索文章,代码如下:
GetPost("abc", array ("only_page" => true));
如果我们指定获取文章标题或别名为“abc”的数据,参数1设置为“abc”,参数2省略不写。
GetPost(“abc”);
若存在同名“abc”的文章或页面,则只返回第一个结果,若指定的文章标题或别名“abc”不存在则返回空。
GetPost 函数示例
例1:指定ID
指定获取ID为10的文章或页面的数据
$post=GetPost(10);
使用变量为id时,要用int传递才能正常显示,如下$id是已经被指定字符串变量,则通过下面这种方式才能使用:
$post=GetPost((int)$id);
例2:指定文章标题或别名
搜索文章标题或别名为“abc”的文章(设定选项为不检索页面)
$post=GetPost("abc",array('only_article'=>true));
输出指定数据
我们可以把GetPost函数获得的数据赋值给变量$post,这样,变量$post就获得了指定文章或页面的所有数据,这些数据包括文章的标题、内容、发布日期、浏览量、URL地址、文章评论、所属分类等内容,然后,就可以输出$post获得的数据到页面中!
1、获取指定ID文章或页面的数据并输出
比如,我们要获取ID为45的文章或页面的数据,并在zblogphp模板中调用,就可以在网站前台的网页中显示输出信息:
{php}$post=GetPost(45);{/php}<h2><a href="{$post.Url}" title="{$post.Title}">{$post.Title}</a></h2>
其中,{$post.Url}调用的输出是文章url,{$post.Title}调用并输出的是文章标题。
2、获取文章标题或别名的数据并输出
比如,我们要获取文章标题或别名为“abc”的数据,并在zblogphp模板中调用,就可以在网站前台的网页中显示输出信息:
{php}{$post=GetPost("abc",array('only_{/php}<h2>{$post.Title}</h2><p>{$post.Intro}</p>
其中,{$post.Title}调用并输出的是文章标题,{$post.Intro}调用并输出的是文章摘要。
当获取指定文章或页面的数据都赋值为变量$post,就可以用{$post.XXX}来调用指定文章的某个具体数据,
调用代码 | 说明 |
---|---|
{$post.Title} | 文章的标题 |
{$post.Url} | 文章的URL |
{$post.ID} | 文章的ID |
{$post.Content} | 文章的内容 |
{$post.Time('Y年m月d日')} | 文章发布日期 |
{$post.ViewNums} | 文章阅读量/浏览量 |
{$post.CommNums} | 文章评论数 |
{$post.Category.Url} | 文章所属分类的URL |
{$post.Category.Name} | 文章所属分类的名称 |
{$post.CateID} | 文章所属分类的ID |
{$post.AuthorID} | 文章作者ID |
{$post.IsLock} | 是否禁止评论,0为不禁止 |
{$post.Alias} | 文章别名 |
{$post.Type} | 文章类型 |
{$post.Status} | 文章状态 |