无标题文档

文章管理 （article) 标签使用手册 Ver 1.0

标签属性使用指南 cms4j:article

1. | article_id | 指定显示某ID的文章
2. | class_id | 指定显示哪个栏目,多个栏目之间用逗号分隔
3. | special_id | 指定显示哪些专题,多个专题之间用逗号分隔
4. | page_size | 分页大小，即每页显示多少条
5. | filter | 条件过滤
6. | filter2 | 复合条件过滤
7. | order | 排序
8. | scope | 过滤不同区域(回收站、正常)的文章
9. | class_state | 栏目状态过滤
10. | audit_state | 文章审核状态过滤
11. | search | 文章查询，与 search_type 配合使用
12. | search_type | 文章查询字段（类别）
13. | audit_level | [后台] 审核级别过滤
14. | purview_type | [后台] 权限过滤

文章属性获取 使用指南 article_info

分类 | 返回值类型 | 调用方法 | 简要说明
ID | int | getID() | 文章ID
访问地址 | String | getURL() | 结合系统配置，取得查看文章的URL

标题

String

getTITLE(int leftCol,String outStr,String classNameFormat,String dateFormat,String isNewImgUrl)

取得文章标题
[int leftCol] 截取左边字符数
[String outStr] 超出的表示
[String classNameFormat] 栏目名称格式（全称|简称 1|2）
[String dateFormat] 添加日期显示格式
[String isNewImgUrl] isNew的图片地址

String

getTITLE(int leftCol,String outStr,String classNameFormat,String dateFormat,String isNewImgUrl,boolean isLinkToOut)

取得文章标题
[int leftCol] 截取左边字符数
[String outStr] 超出的表示
[String classNameFormat] 栏目名称格式（全称|简称 1|2）
[String dateFormat] 添加日期显示格式
[String isNewImgUrl] isNew的图片地址
[boolean isLinkToOut] 是否连接到外部URL

String | getTITLE_COLOR() | 取得标题的颜色代码　如#000000
String | getTITLE_FONT() | 取得标题的字体，如em、stong
String | getTITLE_TEXT() | 取得标题的纯文本内容，不包括 HTML TAG
String | getTitleForLinkToOutsite(String title, boolean isLinkToOut) | 根据提供的标题，返回此文章应该返回的包括外部连接的URL [String title] 文章标题 [boolean isLinkToOut] 是否连接至外部
内容 |  | getCONTENT() | 文章内容
关键字 |  | getKEY_WORD() | 关键字
摘要 |  | getSUMMARY() | 文章摘要
| getSUMMARY(int leftCol) | 截取摘要前N个字符
添加日期 |  | getADD_DATE() | 添加日期
| getADD_DATE_FORMATED(String formatStr) | 取得指定格式的添加日期 [附：日期格式定义规则]
| getADD_DATE_FORMATED(String formatStr,boolean isShowDate,boolean isShowNewIcon,String newIconUrl) | 取得格式化的添加日期 [String formatStr] 日期格式 [boolean isShowDate] 是否显示日期 [boolean isShowNewIcon] 是否显示isNew图标 [String newIconUrl] isNew图标地址
来源 |  | getSOURCE() | 文章来源
添加人 |  | getADD_USER() | 添加人
所属专题 |  | getSPECIAL_ID() | 所属专题ID
| getSPECIAL_NAME() | 取得文章所属专题名称
显示模式 |  | getARTICLE_SHOW_MODE() | 显示模式 jsp | shtml
首页图片 |  | getHOMEPAGE_IMAGE() | 首页图片
作者 |  | getAUTHOR() | 作者
所属栏目 |  | getARTICLE_CLASS_ID() | 所属栏目ID
| getCLASS_NAME() | 所属栏目名称
| getCLASS_NAME2() | 取得文章所属栏目的简称
| getCLASS_NAME(String classNameFormat) | 取得所属栏目名称 [String classNameFormat] 为1时，则栏目名称，为2时，取栏目简称
点击数 | int | getCLICKS() | 文章点击数
| getCLICKS2() | 根据网页的显示模式,返回文章的点击量，当显示模式为动态JSP时，直接从库中取出点击量，当显示模式为静态shtml时，调用点击量显示公共JSP
推荐状态 |  | getCOMMEND_NAME() | 推荐状态的名称，"推荐" "普通"
| getCOMMEND_OPER_NAME() | 状态的操作名称，用于管理界面 "解荐" "推荐"
| getCOMMEND_OPER_STATE() | 如果是推荐，则返回false，即将要执行解荐，反之亦然
| getIS_COMMEND() | 是否为推荐，返回字形型的"true"或"false"
属性 |  | getPropertyID() | 取得文章的属性ID（IS_ONTOP｜IS_COMMEND｜IS_HOT｜COMMON）
| getPropertyName() | 取得文章的属性名称（固顶｜推荐｜热点｜普通）
| getInfoPropImage() | 取得文章属性的图片HTML代码,例如 <img src="/images/IS_ONTOP.gif" alt="固顶文章">
评论 |  | getIS_COMMENT() | 是否可评论
删除 |  | getIS_DEL() | 是否被删除
精华 |  | getIS_ELITE() | 是否为精华，返回字形型的"true"或"false"
热点 |  | getIS_HOT() | 是否为热点，返回字形型的"true"或"false"
固顶 |  | getONTOP_NAME() | 固顶状态的名称， "固顶" "普通"
| getONTOP_OPER_NAME() | 固顶状态的操作名称，用于管理界面，返回"解固"或"固顶"
| getONTOP_OPER_STATE() | 如果是固顶，则返回字符串"false"，即将要执行解固，反之亦然
| getIS_ONTOP() | 是否为固顶，返回字形型的"true"或"false"
链接至外部 |  | getLINK_TO_EXTERIOR() | 链接至外部URL
发布状态 |  | getRELEASE_STATE() | 发布状态
| getRELEASE_STATE_NAME() | 取得发布状态的名称
| getRELEASE_STATE_NAME(String immediatelyStr,String auditingStr) | 取得发布状态的名称 [String immediatelyStr] 如果审核通过，此显示此字符串 [String auditingStr] 如果审核未通过，则显示此字符串
保存日期 |  | getSAVE_DATE() | 保存日期
| getSAVE_DATE_FORMATED(String formatStr) | 取得保存日期 [附：日期格式定义规则]
| getSAVE_DATE_FORMATED(String formatStr,boolean isShowDate,boolean isShowNewIcon,String newIconUrl) | 取得格式化的保存日期 [String formatStr] 日期格式 [boolean isShowDate] 是否显示日期 [boolean isShowNewIcon] 是否显示isNew图标 [String newIconUrl] isNew图标地址
审核级别 |  | getCurrAuditLevel() | 文章当前审核级别
| getCurrAuditLevelName() | 文章当前审核级别的中文名称
静态页保存路径 |  | getHTML_SAVE_PATH() | 文章的HTML静态页保存路径

article 标签属性使用指南

1. | article_id 属性 | 指定显示某ID的文章

例如： <cms4j:article article_id = "1923"> 可过滤出 ID 为 1923 的文章。此属性通常用于文章的显示功能中。

2. | class_id 属性 | 指定显示哪个栏目,多个栏目之间用逗号分隔

例如： <cms4j:article class_id = "IMAGES_NEWS"> 可过滤出栏目编号为 IMAGES_NEWS 栏目的文章 <cms4j:article class_id = "IMAGES_NEWS,TEXT_NEWS"> 可过滤出栏目编号为 IMAGES_NEWS 为 TEXT_NEWS 两个栏目的文章

3. | special_id 属性 | 指定显示哪些专题,多个专题之间用逗号分隔

例如： <cms4j:article special_id = "IT"> 可过滤出专题编号为 IT 栏目的文章 <cms4j:article special_id = "JAVA,C#,NET"> 可过滤出专题编号为 JAVA 与 C# 以及 NET 三个专题的文章

4. | page_size 属性 | 分页大小，即每页显示多少条

例如： <cms4j:article page_size = "10"> 每页显示 10 条

5. | filter 属性 | 条件过滤

属性可选值 | 功能 | 示例
myadded | 我添加的文章 | <cms4j:article filter = "myadded">
audited | 已审核的 | <cms4j:article filter = "audited">
auditing | 未审核的 |
ontop | 固顶 |
hot | 热点（热门） |
commend | 推荐 |
summary_image | 所有带“首页图片” |
today | 当日 |
month | 本月 |

6. | filter2 属性 | 复合条件过滤

filter2 属性的用法与 filter 属性的完全相同，通过与filter同用,实现复合过滤。 例如： <cms4j:article filter="hot" filter2="month"> 可过滤出当月所有热点文章

7. | order 属性 | 排序

属性可选值 | 功能 | 示例
[默认] | 添加日期降序 | <cms4j:article order = "date_desc">
date_desc | 添加日期降序 | <cms4j:article order = "date_desc">
date | 添加日期升序 | <cms4j:article order = "date">
clicks_desc | 点击量降序 |
clicks | 点击量升序 |
id_desc | ID降序 |
id | ID升序 |

8. | scope 属性 | 过滤不同区域(回收站、正常)的文章

属性可选值 | 功能 | 示例
[默认] | 取未被删除的文章，即正常的文章 | <cms4j:article scope = "">
all | 所有文章，包括“回收站”中的 | <cms4j:article scope = "all">
recycle_bin | 回收站中的 | <cms4j:article scope = "recycle_bin">

9. | class_state 属性 | 栏目状态过滤

属性可选值 | 功能 | 示例
[默认] | 栏目状态为使用中的文章 | <cms4j:article class_state = "">
use | 栏目状态为使用中的文章 | <cms4j:article class_state = "use">
stop | 栏目状态为停用的文章 | <cms4j:article class_state = "stop">
all | 所有栏目的文章 | <cms4j:article class_state = "all">

10. | audit_state 属性 | 文章审核状态过滤

属性可选值 | 功能 | 示例
[默认] | 审核通过的 | <cms4j:article audit_stata = "">
audited | 审核通过的 | <cms4j:article audit_stata = "audited">
auditing | 审核中的 | <cms4j:article audit_stata = "auditing">

11. | search 属性 | 文章查询，与 search_type 配合使用

与 search_type 一起使用，即可组成文章查询功能 例如： <cms4j:article search="dekn" search_type="title"> 过滤（搜索）出文章标题中含有 dekn 的所有文章

12. | search_type 属性 | 文章查询字段（类别）

属性可选值 | 功能 | 示例
[默认] | 按标题查询 | <cms4j:article search_type = "">
title | 按标题查询 | <cms4j:article search_type = "title">
content | 按内容查询 | <cms4j:article search_type = "content">
all | 按标题或内容查询 | <cms4j:article search_type = "all">

13. | audit_level 属性 | [后台] 审核级别过滤

属性可选值 | 功能 | 示例
[默认] | 忽略审核级别，取所有文章 | <cms4j:article audit_level = "">
1 | 一级审核者，普通用户 | <cms4j:article audit_level = "1">
2 | 二级审核者，中层决策者 | <cms4j:article audit_level = "2">
3 | 三级审核者，最高决策者，最终发布 | <cms4j:article audit_level = "3">

14. | purview_type 属性 | [后台] 权限过滤

属性可选值 | 功能 | 示例
[默认] | 任何都可以访问的信息 | <cms4j:article purview_type = "">
operat | 拥有“文章查看权限”才可获得文章 | <cms4j:article purview_type = "operat">
audit | 拥有“文章审核权限”才可获得文章 |
admin | 拥有“文章管理权限”才可获得文章 |

版权所有： www.cms4j.com | 专业的 JAVA / JSP 版网站内容管理系统