====== GetPost 函数 ======
通过GetPost 可以获取指定的文章或页面或是其它类型的Post表的数据
===== 1.7新版本的语法及参数 =====
//返回id为10的Post对象实例,如果没有就返回一个空的Post对象实例
$post = GetPost(array('id'=>10)) //返回object(Post类型)
array参数如下
array(
'id' => 10, //指定ID(可省略)
'title' => 'abc', //指定Post标题(可省略)
'alias' => 'cba', //指定Post别名(可省略)
'titleoralias' => 'ddd', //指定Post标题or别名(可省略)
'idorname' => 'fff', //指定Post的ID或标题or别名(可省略)
//以下是原$option参数的key键
'post_type' => null, //指定查询Post表的类型 (可省略)
'post_status' => null, //指定查询Post表的状态 (可省略)
'only_article' => false, //指定是查找文章 (可省略)
'only_page' => false, //指定是查找页面 (可省略)
'where_custom' => array(array('=', 'log_Template', '')), //自定义where
'order_custom' => array('log_CommNums' => 'ASC'), //自定义order
)
===== 1.6版本及更早的语法 =====
$post = GetPost($idorname, $option = null)
===== 调用参数 =====
^参数类型 ^参数 ^ 默认值 ^描述 ^
|mixed|$idorname| |文章ID、标题或者别名|
|array|$option |null|附加选项|
==== 参数说明 ====
=== option ===
''option''参数可指定更多配置选项,默认均为''false'',参考如下
$option = array (
"only_article" => true //只检索文章
//"only_page" => true //只检索页面
);
:!:两个选项同时为true时只有only_article选项有效。
===== 返回值 =====
返回指定的Post实例,若存在同名的文章或页面则只返回第一个结果,若指定的文章不存在则返回空的Post实例。
===== 代码示例 =====
==== 例1 ====
获取ID为10的文章
$post=GetPost(10);
使用变量为id时,要用int传递才能正常显示,如下$id是已经被指定字符串变量,则通过下面这种方式才能使用:
$post=GetPost((int)$id);
==== 例2 ====
搜索文章标题或别名为"abc"的文章(设定选项为不检索页面)
$post=GetPost("abc",array('only_article'=>true));
==== 例3 ====
在模板中,获取并输出获取到的页面(假设是为获取aboutme页面数据)代码参考如下
{$aboutme=GetPost("aboutme",array('only_page'=>true));}
{$aboutme.Title}
{$aboutme.Intro}