The plugin assumes your articles are well categorized.
\nTo display the archive, use the shortcode anywhere in a page or article.<\/p>\n
[archivist category=\"kitten\"]\n[archivist tag=\"kitten\"]\n<\/code><\/pre>\nReplace \u201ckitten\u201d with your category\/tag. Watch out, we need the slug here.
\nThat\u2019s the name without capital letters and spaces.<\/p>\n
Placeholders<\/h4>\n
You can specify a custom template to display the archive elements.
\nGo to Settings > Archivist<\/code> for plugin preferences.
\nUse HTML and any of the following template placeholders.<\/p>\n\n%TITLE%<\/code> \u2013 The post title.<\/li>\n%PERMALINK%<\/code> \u2013 The post permalink.<\/li>\n%AUTHOR%<\/code> \u2013 The post author.<\/li>\n%CATEGORIES%<\/code> \u2013 The post categories as unordered list.<\/li>\n%CATEGORIES|...%<\/code> \u2013 The post categories with a custom separator. Example: %CATEGORIES|, %<\/code><\/li>\n%TAGS%<\/code> \u2013 The post tags with default separator.<\/li>\n%TAGS|...%<\/code> \u2013 The post tags with a custom separator. Example: %TAGS|, %<\/code><\/li>\n%EXCERPT%<\/code> \u2013 The post excerpt.<\/li>\n%POST_META|...%<\/code> \u2013 Any post meta. Example: %POST_META|duration%<\/code>.<\/li>\n%POST_META|...|...%<\/code> \u2013 Any post meta list, separated by custom HTML. Example: %POST_META|guest|
%<\/code><\/li>\n%DATE%<\/code> \u2013 The post date with default format.<\/li>\n%DATE|...%<\/code> \u2013 The post date with custom format. Example: %DATE|Y\/m\/d%<\/code><\/li>\n%POST_THUMBNAIL|...x...%<\/code> \u2013 The post thumbnail with certain dimensions. Example: %POST_THUMBNAIL|75x75%<\/code><\/li>\n%COMMENTS%<\/code> \u2013 The post comment count.<\/li>\n%ACF|field_name%<\/code> \u2013 Display ACF<\/a> field. Uses the get_field()<\/code><\/a> function.<\/li>\n<\/ul>\nYou can add your own placeholders:<\/p>\n
add_filter( 'archivist_template_render', function( $template, $post ) {\n \/\/ modify $template\n return $template;\n}, 10, 2 );\n<\/code><\/pre>\nPagination<\/h4>\n
If you have many entries, you may prefer to paginate. The archivist comes with asynchronous pagination built-in. Use the pagination<\/code> parameter in the shortcode to activate it. Its value is the amount of items you want to display per page.<\/p>\n[archivist category=\"kitten\" pagination=\"10\"]\n<\/code><\/pre>\nPagination controls are displayed both on top and at the bottom of the archive. You can customize this by setting controls<\/code> to top<\/code> or bottom<\/code>.<\/p>\n[archivist category=\"kitten\" pagination=\"10\" controls=\"top\"]\n<\/code><\/pre>\nFilter by Query<\/h4>\n
Are you feeling bold? Is filtering by category or archive not satisfying you? Read on, I\u2019ve got a challenge for you.
\nWordPress uses a certain query syntax to define the so called loop which is used to display the archive.
\nYou can find the complete documentation at https:\/\/codex.wordpress.org\/Class_Reference\/WP_Query
\nand you can take advantage of every single parameter or combination of parameters listed there. Some examples:<\/p>\n
[archivist query=\"year=1984&author_name=gorwell\"]\n<\/code><\/pre>\nLists all entries from the year 1984<\/code> by the author with user_nicename<\/code> gorwell<\/code>.<\/p>\n[archivist query=\"tag=straw+mask&post_status=private&orderby=comment_count&order=DESC\"]\n<\/code><\/pre>\nLists all entries marked with post status private<\/code> which are tagged with both straw<\/code> and mask<\/code>, ordered by the amount of comments in a descending order.<\/p>\nUsing multiple Templates<\/h4>\n
When you install the plugin, there is just one templated called \u201cdefault\u201d.
\nIf you don\u2019t specify a specific template in the shortcode, this one will be used.
\nTherefore the following two shortcodes yield identical results.<\/p>\n
[archivist category=\"kitten\"]\n[archivist category=\"kitten\" template=\"default\"]\n<\/code><\/pre>\nYou can add as many templates as you like. Think twice before deleting one. If it\u2019s still in use, the archive can\u2019t be displayed.<\/p>\n","protected":false},"excerpt":{"rendered":"
Shortcode Plugin to display an archive by category, tag or custom query. Customizable via HTML templates.<\/p>\n","protected":false},"author":65,"featured_media":14487,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"Archivist \u2013 Custom Archive Templates - \u8587\u6653\u6735\u63d2\u4ef6\u76ee\u5f55","description":"Shortcode Plugin to display an archive by category, tag or custom query. Customizable via HTML templates."},"footnotes":""},"categories":[1],"tags":[644,11,198,345,13],"class_list":["post-14486","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-archive","tag-category","tag-loop","tag-shortcode","tag-tag"],"_links":{"self":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/14486","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/comments?post=14486"}],"version-history":[{"count":0,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/14486\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media\/14487"}],"wp:attachment":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media?parent=14486"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/categories?post=14486"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/tags?post=14486"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}