分类文章列表#categoryArticles()

分类文章列表(categoryArticles)

说明

此指令是在任何页面,用来读取文章列表。例如:最新文章、热门文章等

用来读取某一个分类下的文章

语法

#categoryArticles()
    #for(article : articles)
        // do something
    #end
#end

| 参数 | 说明 | | -------- | -------- | | categoryId| 分类标识,这个是在创建分类的时候自由填写,发布文章的时候勾选对应的分类。| | categoryFlag| 分类标识,这个是在创建分类的时候自由填写,发布文章的时候勾选对应的分类。| | hasThumbnail| 是否需要缩略图,值为 true 和 false。| | orderBy | 根据什么进行排序,目前支持的值有:order_number(用户自定义排序)、comment_count(文章的评论数量)、comment_time(文章的评论时间)、view_count(文章的访问量)、created(文章的创建时间)、modified(文章的修改时间)| | count | 要显示多少篇文章,默认10|

返回参数

category:分类的信息


{
    "flag": "free",
    "icon": "https://ossweb-img.qq.com/images/lol/web201310/skin/big10006.jpg",
    "pid": 0,
    "title": "free",
    "type": "category",
    "top": true,
    "htmlView": "artlist_product.html",
    "modified": 1612316600000,
    "id": 2461,
    "tag": false,
    "slug": "free",
    "summary": "图标只用于前台显示,是否显示决定于模板",
    "created": 1597476165000,
    "count": 58,
    "parentId": 0,
    "url": "/article/category/free",
    "layerNumber": 0,
    "style": "product",
    "layerString": ""
}

articles:文章集合信息

[
    {
        "flag": "plain",
        "orderNumber": 0,
        "showImage": "https://img.ifuntools.cn/file_images/article/20180606152826410720015.png",
        "title": "Apeaksoft iPhone Transfer 1.1.10....IOS数据传输工具",
        "content": "<p>IOS数据传输工具</p> \n<p>它能够在iOS设备和电脑之间或从iOS到iTunes之间备份短信,联系人,图片,音乐,视频,书籍,PDF等,让你可以自由的在电脑和iPhone之前传输文件。</p>",
        "draft": false,
        "htmlView": "article_free.html",
        "modified": 1608082793000,
        "id": 1807,
        "text": "IOS数据传输工具 它能够在iOS设备和电脑之间或从iOS到iTunes之间备份短信,联系人,图片,音乐,视频,书籍,PDF等,让你可以自由的在电脑和iPhone之前传输文件。",
        "viewCount": 165,
        "normal": true,
        "images": [
            "https://img.ifuntools.cn/file_images/article/20180606152826410720015.png",
            "https://img.ifuntools.cn/file_images/article/20180606152826412884720.png",
            "https://img.ifuntools.cn/file_images/article/20180606152826409643121.png",
            "https://img.ifuntools.cn/file_images/article/20180606152826413584618.png",
            "https://img.ifuntools.cn/blog/20191024/xvamUkAAIwPg.png?imageslim"
        ],
        "thumbnail": "https://img.ifuntools.cn/file_images/article/20180606152826410720015.png",
        "created": 1596823382000,
        "commentEnable": true,
        "active": false,
        "userId": 1,
        "orignalContent": "IOS数据传输工具\n\n它能够在iOS设备和电脑之间或从iOS到iTunes之间备份短信,联系人,图片,音乐,视频,书籍,PDF等,让你可以自由的在电脑和iPhone之前传输文件。",
        "url": "/article/1807",
        "commentCount": 18,
        "commentStatus": true,
        "trash": false,
        "editMode": "markdown",
        "firstImage": "https://img.ifuntools.cn/file_images/article/20180606152826410720015.png",
        "style": "free",
        "status": "normal"
    }
]

Article文章属性在整个JPress里面都是同一份,后面不再说明

示例

读取分类标识为"free"的文章,数量为4
#categoryArticles(categoryFlag="free",count = 4)
	#for(article:articles)
	// do something
	#end
	#end
	
	读取分类ID为"2461"的文章,数量为4
	#categoryArticles(categoryId=2461,count = 4)
	#for(article:articles)
	// do something
	#end
	#end
	
	读取分类标识为"free"的文章,按照view_count(文章的访问量)倒序排序,读取5篇文章
	#categoryArticles(categoryFlag="free",orderBy="view_count desc",count=5)
		#for(article : articles)
			// do something
		#end
	#end
	
	读取分类标识为"free"的文章,按照view_count(文章的访问量)倒序排序,读取5篇文章,需要缩略图
	#categoryArticles(categoryFlag="free",orderBy="view_count desc",count=5,hasThumbnail=true)
		#for(article : articles)
			// do something
		#end
	#end
	
	
	按照view_count(文章的访问量)读取5篇文章
	#categoryArticles(categoryFlag="free",orderBy="view_count desc",count=5)
		#for(article : articles)
			// do something
		#end
	#end
	
	同上,需要缩略图
	#categoryArticles(categoryFlag="free",orderBy="view_count desc",count=5,hasThumbnail=true)
		#for(article : articles)
			// do something
		#end
	#end
			

加入我们!

如果你想系统学习JPress涉及到的知识点,或者希望有人解答你在深度使用JPress时遇到问题,
加入QQ群是个很不错的选择