{"id":388882,"date":"2026-10-24T10:21:21","date_gmt":"2026-10-24T10:21:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/jcat-category-article-lists\/"},"modified":"2026-10-24T10:20:48","modified_gmt":"2026-10-24T10:20:48","slug":"jcat-category-article-lists","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/jcat-category-article-lists\/","author":261219,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.3.2","stable_tag":"0.3.2","tested":"7.1.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"JCat \u2013 Category Article Lists","header_author":"Janiko","header_description":"Compact lists of published articles and pages, with textual depth and category semantics.","assets_banners_color":"","last_updated":"2026-10-24 10:20:48","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/geba.fr","rating":0,"author_block_rating":0,"active_installs":0,"downloads":74,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.3.2":{"tag":"0.3.2","author":"janiko","date":"2026-10-24 10:20:48","revision":3763058}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3763085,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3763085,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3.2"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[610,245,243,166,80],"plugin_category":[43,57],"plugin_contributors":[86192],"plugin_business_model":[],"class_list":["post-388882","plugin","type-plugin","status-publish","hentry","plugin_tags-categories","plugin_tags-list","plugin_tags-pages","plugin_tags-posts","plugin_tags-shortcode","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-janiko","plugin_committers-janiko"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/jcat-category-article-lists\/assets\/icon-128x128.png?rev=3763085","icon_2x":"https:\/\/ps.w.org\/jcat-category-article-lists\/assets\/icon-256x256.png?rev=3763085","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>JCat displays compact lists of published WordPress posts and pages, optionally filtered by a category. It supports category IDs, slugs or exact names, sorting, ascending or descending order, a maximum number of entries, and inclusion of child categories.<\/p>\n\n<p>JCat can also decorate items with classes and data attributes based on their approximate textual length and category assignments. These allow your theme to style short, standard and in-depth entries differently. The optional color-toggle button requires JavaScript; the lists themselves render in PHP.<\/p>\n\n<p>The optional <code>secu_etat_editorial<\/code> taxonomy is recognized when it exists, but is not required. JCat does not create custom taxonomies. Without a category filter, it lists published posts and pages across the site; note that pages are only included in category-filtered lists if they have categories assigned.<\/p>\n\n<p><strong>Examples:<\/strong><\/p>\n\n<ul>\n<li><code>[jcat_list]<\/code> \u2014 all published posts and pages<\/li>\n<li><code>[jcat_list slug=\"security\"]<\/code> \u2014 posts in a category and its descendants<\/li>\n<li><code>[jcat_list id=\"12\" children=\"no\" sort=\"date\" order=\"desc\" limit=\"10\"]<\/code><\/li>\n<li><code>[jcat_list name=\"Network Security\" title=\"no\"]<\/code><\/li>\n<\/ul>\n\n<p><strong>Parameters:<\/strong><\/p>\n\n<ul>\n<li><code>id<\/code> \u2014 numeric category ID<\/li>\n<li><code>slug<\/code> \u2014 category slug<\/li>\n<li><code>name<\/code> \u2014 exact category name or slug (legacy-compatible)<\/li>\n<li><code>sort<\/code> \u2014 <code>name<\/code> (default), <code>title<\/code>, <code>date<\/code>, <code>modified<\/code><\/li>\n<li><code>order<\/code> \u2014 <code>asc<\/code> or <code>desc<\/code> (default is descending for dates and ascending otherwise)<\/li>\n<li><code>limit<\/code> \u2014 maximum number of items; <code>0<\/code> means unlimited<\/li>\n<li><code>children<\/code> \u2014 <code>yes<\/code> (default) or <code>no<\/code><\/li>\n<li><code>title<\/code> \u2014 <code>yes<\/code> (default) or <code>no<\/code>, whether to show a category heading<\/li>\n<\/ul>\n\n<p>If several category selectors are supplied, <code>id<\/code> takes precedence over <code>slug<\/code>, which takes precedence over <code>name<\/code>. A missing category does not display the entire site list. Only published content is displayed. Beware of placing unlimited lists on very large sites: processing article bodies to classify length has a performance cost. Caching at page level or setting a limit may help.<\/p>\n\n<h3>Shortcode settings<\/h3>\n\n<p>The shortcode tag defaults to <code>[jcat_list]<\/code>. Administrators can change it under <strong>Settings &gt; Category Article Lists<\/strong>, including choosing the tag previously used by an existing installation. Only one tag is registered at a time; changing the setting does not rewrite existing content. Confirm that the chosen tag is not already in use by another plugin.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload and activate the plugin through WordPress.<\/li>\n<li>Add a <code>[jcat_list]<\/code> shortcode in an article or page.<\/li>\n<li>Optionally filter by category using <code>id<\/code>, <code>slug<\/code> or <code>name<\/code>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20change%20my%20posts%3F\"><h3>Does it change my posts?<\/h3><\/dt>\n<dd><p>No. JCat reads published content and renders a list; it does not alter posts or taxonomy terms.<\/p><\/dd>\n<dt id=\"does%20it%20need%20the%20optional%20editorial%20taxonomy%3F\"><h3>Does it need the optional editorial taxonomy?<\/h3><\/dt>\n<dd><p>No. The optional editorial taxonomy is only used to classify draft-like items if present.<\/p><\/dd>\n<dt id=\"does%20it%20cache%20its%20results%3F\"><h3>Does it cache its results?<\/h3><\/dt>\n<dd><p>No persistent cache. Query and text analysis take place during rendering.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.3.2<\/h4>\n\n<ul>\n<li>Aligned the translation text domain with the WordPress.org plugin slug.<\/li>\n<li>Preserved the configurable shortcode tag and existing CSS and settings identifiers.<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Added an administrator-configurable shortcode tag (default: <code>jcat_list<\/code>).<\/li>\n<li>Made public-facing texts and the WordPress.org readme English-only, ready for localization.<\/li>\n<li>Kept rendering behavior, list styling classes, and existing shortcode attributes unchanged.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>Prepared WordPress.org release and standardized translation domain.<\/li>\n<li>Removed a site-specific uncategorized ID assumption and cached repeated word counts within a request.<\/li>\n<li>Preserved shortcode arguments, styling hooks, and optional editorial taxonomy integration.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Previous locally installed release.<\/li>\n<\/ul>","raw_excerpt":"Display configurable lists of published posts and pages using a simple category shortcode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/388882","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=388882"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/janiko"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=388882"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=388882"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=388882"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=388882"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=388882"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=388882"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}