PostTag 单个文章标签

PostTag是一个文章类,是用来获取一篇文章信息的标签,如: 文章标题,文章内容, 文章发布时间,文章自定义字段信息等.

获取方法

title()

title() 获取文章标题,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的title,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章标题

例子:

<?php
echo PostTag::title(); // 打印当前文章的标题
echo PostTag::title(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章标题
echo PostTag::title(array('id'=>10)); //打印指定id的文章标题
?>

date()

date() 获取文章的发布时间,包含有一个参数, 设置为:

array(
    'format' => 'Y-m-d H:i', //时间显示格式 默认为 2009-10-1 10:38
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)

format的设置格式和php中date的设置格式一样

  • 当没有设置uri或者id时,自动获取出当前文章的时间,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章时间

例子:

<?php
echo PostTag::date(); // 打印当前文章的发布时间
echo PostTag::date(array('format'=>'Y年m月d日')); //打印指定格式的发布时间
?>

content()

content() 获取文章内容,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的内容,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章内容

例子:

<?php
echo PostTag::content(); // 打印当前文章的内容
echo PostTag::content(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章内容
echo PostTag::content(array('id'=>10)); //打印指定id的文章内容
?>

author()

author() 获取文章发布人名称,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的发布人,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章发布人

例子:

<?php
echo PostTag::author(); // 打印当前文章的发布人
echo PostTag::author(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章发布人
echo PostTag::author(array('id'=>10)); //打印指定id的文章发布人
?>

thumb()

thumb() 获取文章缩略图,返回的是缩略图的访问地址,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的缩略图,如果当前不是文章或没有缩略图,则返回空
  • 当设置uri或者id时,返回对应的文章缩略图

例子:

<?php
echo PostTag::thumb(); // 打印当前文章的缩略图
echo PostTag::thumb(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章缩略图
echo PostTag::thumb(array('id'=>10)); //打印指定id的文章缩略图
?>

diagram()

diagram() 获取文章所属分类对象,返回的是一个diagram对象,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的diagram对象,如果当前不是文章,则返回空的对象
  • 当设置uri或者id时,返回对应的文章diagram对象

例子:

<?php
echo PostTag::diagram()->title; // 打印当前文章的diagram对象的标题
echo PostTag::diagram(array('uri'=>'ubuntu_news_9.10'))->content; //打印指定uri的文章的diagram对象的内容
echo PostTag::diagram(array('id'=>10))->uri; //打印指定id的文章的diagram对象的网址
?>

is_post()

is_post() 判断是否是一篇文章,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章是否是一篇文章,如果当前不是文章,则返回false
  • 当设置uri或者id时,返回对应的文章是否是一篇文章

例子:

<?php
if(PostTag::is_post() { // 判断当前文章是否是一篇文章
    echo '是一篇文章';
}

if (PostTag::is_post(array('uri'=>'ubuntu_news_9.10')) { //判断指定uri的文章是否是一篇文章
    echo '是一篇文章';
}

if (PostTag::is_post(array('id'=>10)) { //判断指定id的文章是否是一篇文章
    echo '是一篇文章';
}
?>

is_star()

is_star() 是用来判断当前文章是否是加星推荐文章,包含有一个参数,设置为.

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章是否是加星推荐文章,如果当前不是,则返回false
  • 当设置uri或者id时,返回对应的文章是否是一篇加星推荐文章

例子:

<?php
if(PostTag::is_post() { // 判断当前文章是否是一篇加星推荐文章
    echo '是一篇加星推荐文章';
}

if (PostTag::is_post(array('uri'=>'ubuntu_news_9.10')) { //判断指定uri的文章是否是一篇加星推荐文章
    echo '是一篇加星推荐文章';
}

if (PostTag::is_post(array('id'=>10)) { //判断指定id的文章是否是一篇加星推荐文章
    echo '是一篇加星推荐文章';
}
?>

next_post_link()

next_post_link() 获取文章的下一篇文章,返回一个带文章链接的字符串,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的下一篇文章,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章的下一篇文章

例子:

<?php
echo PostTag::next_post_link(); // 打印当前文章的下一篇文章
echo PostTag::next_post_link(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章的下一篇文章
echo PostTag::next_post_link(array('id'=>10)); //打印指定id的文章的下一篇文章
?>

next_post()

next_post() 获取文章的下一篇文章对象,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的下一篇文章对象,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章的下一篇文章对象

例子:

<?php
echo PostTag::next_post()->title; // 打印当前文章的下一篇文章的标题
echo PostTag::next_post()->link; // 打印当前文章的下一篇文章的访问网址
echo PostTag::next_post(array('uri'=>'ubuntu_news_9.10'))->title; //打印指定uri的文章的下一篇文章的标题
echo PostTag::next_post(array('id'=>10))->link; //打印指定id的文章的下一篇文章的访问网址
?>

has_next_post()

has_next_post() 判断是否有下一篇文章,返回true或false, 包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动判断当前文章的是否有下一篇文章,如果没有,则返回false
  • 当设置uri或者id时,返回对应的文章是否有下一篇文章

例子:

<?php
if (PostTag::has_next_post()){ // 判断是否有下一篇文章 
    echo PostTag::next_post_link(); //打印下一篇文章的链接
}

if (PostTag::has_next_post(array('uri'=>'ubuntu_news_9.10')){ //判断指定uri的文章是否有下一篇文章
    echo PostTag::next_post_link(array('uri'=>'ubuntu_news_9.10')) //打印指定uri的文章的下一篇文章链接
}

?>

previous_post_link()

previous_post_link() 获取文章的上一篇文章,返回一个带文章链接的字符串,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的上一篇文章,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章的上一篇文章的链接

例子:

<?php
echo PostTag::previous_post_link(); // 打印当前文章的上一篇文章
echo PostTag::previous_post_link(array('uri'=>'ubuntu_news_9.10')); //打印指定uri的文章的上一篇文章
echo PostTag::previous_post_link(array('id'=>10)); //打印指定id的文章的上一篇文章
?>

previous_post()

previous_post() 获取文章的上一篇文章对象,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的上一篇文章对象,如果当前不是文章,则返回空
  • 当设置uri或者id时,返回对应的文章的上一篇文章对象

例子:

<?php
echo PostTag::previous_post()->title; // 打印当前文章的上一篇文章的标题
echo PostTag::previous_post()->link; // 打印当前文章的上一篇文章的访问网址
echo PostTag::previous_post(array('uri'=>'ubuntu_news_9.10'))->title; //打印指定uri的文章的上一篇文章的标题
echo PostTag::previous_post(array('id'=>10))->link; //打印指定id的文章的上一篇文章的访问网址
?>

has_previous_post()

has_previous_post() 判断是否有上一篇文章,返回true或false, 包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动判断当前文章的是否有上一篇文章,如果没有,则返回false
  • 当设置uri或者id时,返回对应的文章是否有上一篇文章

例子:

<?php
if (PostTag::has_previous_post()){ // 判断是否有上一篇文章 
    echo PostTag::next_previous_link(); //打印上一篇文章的链接
}

if (PostTag::has_previous_post(array('uri'=>'ubuntu_news_9.10')){ //判断指定uri的文章是否有上一篇文章
    echo PostTag::previous_post_link(array('uri'=>'ubuntu_news_9.10')) //打印指定uri的文章的上一篇文章链接
}

?>

post()

post()用来获取文章对象,包含有一个参数, 设置为:

array(
    'uri' =>'', // 文章的访问网址
    'id' => '' //文章的id
)
  • 当没有设置uri或者id时,自动获取出当前文章的对象,如果当前不是文章,则返回空对象
  • 当设置uri或者id时,返回对应的文章对象

文章对象的属性有:

id // 文章id
user // 文章发布人的对象
user_id //文章发布人的id
diagram //文章所属的diagram对象
diagram_id //文章所属的diagram id
title // 文章的标题
content // 文章的内容
link // 文章封装好的访问网址 在打印文章列表时候用到
thumb //文章的缩略图
date // 文章的发布时间(为一个长度为10的unix时间)
is_star // 是否为推荐文章, 返回1或0
attachments // 文章对应的附件列表, 为一个对象集
customvalues // 文章对应的自定义值列表, 为一个对象集

例子:

<?php
echo PostTag::post()->title; // 打印当前文章的标题
echo PostTag::post(array('uri'=>'ubuntu_news_9.10'))->title; //打印指定uri的文章标题
echo PostTag::post(array('id'=>10))->title; //打印指定id的文章标题
?>

自定义字段

获取自定义字段的方法很简单,和直接获取文章对象的属性一样的操作

例子:(假设我们有3个自定义字段的标签分别为(访问链接:visit_link, 原用户作者:username, 文章关键词:keyword)

visit_link; //打印访问链接
echo PostTag::post()->username; //打印原用户作者
echo PostTag::post()->keyword; 打印文章关键词
?>

内容索引