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.

Tangible

<p><strong><a href="https://www.facebook.com/groups/loopsandlogic" rel="nofollow ugc">Facebook group</a> | <a href="https://loopsandlogic.com/" rel="nofollow ugc">homepage</a>| <a href="https://docs.loopsandlogic.com/" rel="nofollow ugc">docs</a> |<a href="https://tangibletalk.com/" rel="nofollow ugc">official support forum</a></strong></p>
<p><iframe loading="lazy" title="We reinvented HTML for WordPress: Introducing Loops & Logic" width="750" height="422" src="https://www.youtube.com/embed/-ObJkmhJ3qU?feature=oembed" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe></p>
<p><strong>Loops & Logic</strong> is a toolset that allows you to have extensive control over the display of WordPress content & data on your site’s frontend for when your theme or builder doesn’t have the options you need. This plugin gives you the power of custom PHP theme & builder module development using a simplified HTML-like syntax that will be familiar to any frontend developer.</p>
<h3>Support</h3>
<ul>
<li>Please see the <a href="https://loopsandlogic.com/" rel="nofollow ugc">official plugin site</a> and <a href="https://docs.loopsandlogic.com/" rel="nofollow ugc">the documentation</a> for a complete description of plugin features.</li>
<li>Support & discussions can be found on <a href="https://tangibletalk.com/" rel="nofollow ugc">our forum located here</a>.</li>
</ul>
<h3>Key Features</h3>
<ul>
<li>Use HTML templates with dynamic tags like Loop, Field, and If</li>
<li>Use theme location rules to apply <strong>custom templates</strong> to post types, taxonomies & more (similar to Beaver Themer or Elementor Theme Builder)</li>
<li>Easily <strong>enqueue</strong> your CSS stylesheets and Javascript anywhere using a visual location rule builder</li>
<li>Seamlessly write your CSS directly in <strong>SASS</strong> without worrying about compilation</li>
<li>Create query <strong>loops</strong> of any content type, such as: posts, pages, custom post types, attachments, users, taxonomies and terms</li>
<li>Display built-in and custom <strong>fields</strong></li>
<li>Build <strong>logic</strong> to display things based on certain conditions, for example: creating a menu, with some links only for logged-in users, or by user role</li>
<li>Create custom shortcodes to display anything from a custom field to an entire dynamic-data driven web page</li>
</ul>
<h3>Example Usage</h3>
<p>At the core of L&L is the ability to quickly and elegantly loop through WordPress data like in this example of displaying a list of links to the three most recent posts</p>
<pre><code><ul>
  <Loop type=post count=3 orderby=date order=desc>
    <li>
      <a href="{Field url}"><Field title /></a>
    </li>
  </Loop>
</ul>
</code></pre>
<p>Accomplishing the same thing in PHP is a little more complex:</p>
<pre><code><?php
$args = array(
    'post_type' => 'post',
    'posts_per_page' => 3,
    'orderby' => 'date',
    'order' => 'DESC',
);
$query = new WP_Query( '$args' ); ?>
<?php if ( $query->have_posts() ) : ?>
  <ul>
    <?php while ( $query->have_posts() ) : $query->the_post(); ?>

      <li>
        <a href="<?php the_permalink(); ?>">
          <?php the_title(); ?>
        </a>
      </li>

    <?php endwhile; ?>
  </ul>
<?php endif; ?>
</code></pre>
<p>It can be difficult to add PHP to your site if you’re not a backend developer, but L&L is a breeze to include, even in a page builder layout.</p>
<p>Page builders like Gutenberg, Elementor, and Beaver Builder often have gaps in their capabilities that would normally require you to either develop a custom add-on or purchase a bloated add-on pack just to get the one element you need. L&L adds a template editor module directly to each builder so that you can simply describe what you want to display in L&L code and place it using the builder interface. You can even copy-paste your L&L code between page builders if you work with more than one! It’s like having your own page builder addon factory.</p>
<h3>Plugin & Theme Support</h3>
<h4>Plugin Support:</h4>
<p>Loops & Logic works with the post types and custom fields added by most plugins, but plugins with special data structures like a custom tables or fields with data formats that need parsing require us to program explicit support.</p>
<h4>Bundled integrations:</h4>
<p><strong>✅ Advanced Custom Fields (ACF)</strong></p>
<p>L&L supports Advanced Custom Fields (ACF) field types in the core, allowing you to work with most of their field types out of the box! We also plan to support other WordPress custom field plugins such as Pods & Metabox in the future.</p>
<pre><code><Loop acf_flexible=field_name>
  <If field=layout value=layout_1>

    Layout 1
    <img src="{Field acf_image=field_name field=url}" />
    <Field acf_editor=field_name />

  <Else if field=layout value=layout_2 />

    Layout 2
    <Field acf_editor=field_name />
    <img src="{Field acf_image=field_name field=url}" />

  </If>
</Loop>
</code></pre>
<p><strong>✅ Elementor</strong></p>
<p>Loops & Logic provides an Elementor widget that allows you to either write L&L code directly in the page builder widget or select from a pre-existing saved template.</p>
<p><strong>✅ Gutenberg</strong></p>
<p>Loops & Logic provides a Gutenberg block that allows you to either write L&L code directly in the block builder block or select from a pre-existing saved template.</p>
<p><strong>✅ Beaver Builder</strong></p>
<p>Loops & Logic provides a Beaver Builder module that allows you to either write L&L code directly in the page builder module or select from a pre-existing saved template.</p>
<p><strong>✅ WP Grid Builder</strong></p>
<p>Loops & Logic provides a WP Grid Builder block that allows you to select from a pre-existing saved template to load in WP Grid Builder.</p>
<p><strong>✅ WP Fusion</strong></p>
<p>The freely-included WP Fusion integration allows you to use conditional logic to protect or display different content based on a user’s tags.</p>
<pre><code><If user_field=wp_fusion_tags includes value="123">
  User has tag ID 123
<Else />
  User does not have tag.
</If>
</code></pre>
<p>We’ll be rolling out premium addons for popular plugins in the coming months, so check out our website to see what’s available!</p>
<h4>Premium addons coming soon:</h4>
<ul>
<li>WooCommerce</li>
<li>Easy Digital Downloads</li>
<li>Modern Tribe Events Calendar</li>
<li>Gravity Forms</li>
<li>LearnDash</li>
<li>LifterLMS</li>
</ul>
<h4>Theme Support:</h4>
<p>Everything will work with themes built according to WordPress standards.</p>


Loops & Logic

As a WordPresser who slings HTML + Tailwind CSS, this plugin has been an absolute godsend. I can do complex queries in the front end, and can go further than any 'Posts Module/Block/Widget' UI could ever hope for.

The fact that there’s only ~700 downloads at the time of this review is borderline criminal, but hey, I like to adopt the good stuff early :)

Dave Bloom

Just brilliant. Great support too.


Quite a nifty and powerful plugin for lowcode templating :) Saves a ton of development time.


Excellent lowcode templating


This is no exaggeration. L&L has been a lifesaver to me and saved hundreds of hours of extra work in template building. Really well done, Tangible. "This is the way!"


Lifesaver


Thanks for this plugin, it's great for its simplicity and concept, I love the ACF support.



Great documentation!


Amazing and seamless

Loops & Logic is a template system with content loops and conditions.

Archivist – Custom Archive Templates vs Loops & Logic