Eric Teubert

<h4>Quick Start</h4>
<p>The plugin assumes your articles are well categorized.<br />
To display the archive, use the shortcode anywhere in a page or article.</p>
<pre><code>[archivist category="kitten"]
[archivist tag="kitten"]
</code></pre>
<p>Replace “kitten” with your category/tag. Watch out, we need the slug here.<br />
That’s the name without capital letters and spaces.</p>
<h4>Placeholders</h4>
<p>You can specify a custom template to display the archive elements.<br />
Go to <code>Settings > Archivist</code> for plugin preferences.<br />
Use HTML and any of the following template placeholders.</p>
<ul>
<li><code>%TITLE%</code> – The post title.</li>
<li><code>%PERMALINK%</code> – The post permalink.</li>
<li><code>%AUTHOR%</code> – The post author.</li>
<li><code>%CATEGORIES%</code> – The post categories as unordered list.</li>
<li><code>%CATEGORIES|...%</code> – The post categories with a custom separator. Example: <code>%CATEGORIES|, %</code></li>
<li><code>%TAGS%</code> – The post tags with default separator.</li>
<li><code>%TAGS|...%</code> – The post tags with a custom separator. Example: <code>%TAGS|, %</code></li>
<li><code>%EXCERPT%</code> – The post excerpt.</li>
<li><code>%POST_META|...%</code> – Any post meta. Example: <code>%POST_META|duration%</code>.</li>
<li><code>%POST_META|...|...%</code> – Any post meta list, separated by custom HTML. Example: <code>%POST_META|guest|<br>%</code></li>
<li><code>%DATE%</code> – The post date with default format.</li>
<li><code>%DATE|...%</code> – The post date with custom format. Example: <code>%DATE|Y/m/d%</code></li>
<li><code>%POST_THUMBNAIL|...x...%</code> – The post thumbnail with certain dimensions. Example: <code>%POST_THUMBNAIL|75x75%</code></li>
<li><code>%COMMENTS%</code> – The post comment count.</li>
<li><code>%ACF|field_name%</code> – Display <a href="https://www.advancedcustomfields.com" rel="nofollow ugc">ACF</a> field. Uses the <a href="https://www.advancedcustomfields.com/resources/get_field/" rel="nofollow ugc"><code>get_field()</code></a> function.</li>
</ul>
<p>You can add your own placeholders:</p>
<pre><code>add_filter( 'archivist_template_render', function( $template, $post ) {
    // modify $template
    return $template;
}, 10, 2 );
</code></pre>
<h4>Pagination</h4>
<p>If you have many entries, you may prefer to paginate. The archivist comes with asynchronous pagination built-in. Use the <code>pagination</code> parameter in the shortcode to activate it. Its value is the amount of items you want to display per page.</p>
<pre><code>[archivist category="kitten" pagination="10"]
</code></pre>
<p>Pagination controls are displayed both on top and at the bottom of the archive. You can customize this by setting <code>controls</code> to <code>top</code> or <code>bottom</code>.</p>
<pre><code>[archivist category="kitten" pagination="10" controls="top"]
</code></pre>
<h4>Filter by Query</h4>
<p>Are you feeling bold? Is filtering by category or archive not satisfying you? Read on, I’ve got a challenge for you.<br />
WordPress uses a certain query syntax to define the so called loop which is used to display the archive.<br />
You can find the complete documentation at https://codex.wordpress.org/Class_Reference/WP_Query<br />
and you can take advantage of every single parameter or combination of parameters listed there. Some examples:</p>
<pre><code>[archivist query="year=1984&author_name=gorwell"]
</code></pre>
<p>Lists all entries from the year <code>1984</code> by the author with <code>user_nicename</code> <code>gorwell</code>.</p>
<pre><code>[archivist query="tag=straw+mask&post_status=private&orderby=comment_count&order=DESC"]
</code></pre>
<p>Lists all entries marked with post status <code>private</code> which are tagged with both <code>straw</code> and <code>mask</code>, ordered by the amount of comments in a descending order.</p>
<h4>Using multiple Templates</h4>
<p>When you install the plugin, there is just one templated called “default”.<br />
If you don’t specify a specific template in the shortcode, this one will be used.<br />
Therefore the following two shortcodes yield identical results.</p>
<pre><code>[archivist category="kitten"]
[archivist category="kitten" template="default"]
</code></pre>
<p>You can add as many templates as you like. Think twice before deleting one. If it’s still in use, the archive can’t be displayed.</p>


Archivist – Custom Archive Templates

Shortcode Plugin to display an archive by category, tag or custom query. Customizable via HTML templates.

chsxf

<p>mCatFilter for WordPress allows you to exclude categories from The Loop for display on the home page, in feeds and some archive pages.</p>
<h4>Key features</h4>
<ul>
<li>Very simple setup and configuration</li>
<li>No theme manipulation required</li>
<li>Excluded categories are still available through custom queries </li>
<li>Fully integrated with the WordPress internationalization API</li>
</ul>
<h4>System requirements</h4>
<ul>
<li>PHP version <strong>5.2.4</strong> or higher</li>
<li>WordPress 3.2+</li>
</ul>
<h3>Usage</h3>
<p>By default, mCatFilter does not exclude any category. To select excluded categories, proceed as follow :</p>
<ol>
<li>Go to your Administration panel </li>
<li>Go to your mCatFilter page</li>
<li>Check any category you want to exclude from the list</li>
<li>Click “Save changes” button</li>
<li><em>You’re done !</em> Selected categories should be excluded from default queries</li>
</ol>
<p>You can also select/deselect a category for exclusion from the edit category form.</p>
<h3>Online Resources</h3>
<p>If you have any questions that aren’t addressed in this document, please visit <a href="https://wordpress.org/support/plugin/mcatfilter" rel="ugc">the support forums</a>.</p>
<h3>Known issues</h3>
<p>None at this time</p>
<h3>License</h3>
<p>mCatFilter, as WordPress, is released under the terms of the GNU GPL v2 (see license.txt).<br />
Permission to use, copy, modify, and distribute this software and its documentation under the terms of the GNU General Public License is hereby granted. No representations are made about the suitability of this software for any purpose. It is provided “as is” without express or implied warranty.</p>


mCatFilter

Excludes categories from The Loop for display on the home page, in feeds and some archive pages.

Archivist – Custom Archive Templates vs mCatFilter