Loops & Logic

Description

Facebook group | homepage| docs |official support forum

Loops & Logic 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.

Support

Key Features

  • Use HTML templates with dynamic tags like Loop, Field, and If
  • Use theme location rules to apply custom templates to post types, taxonomies & more (similar to Beaver Themer or Elementor Theme Builder)
  • Easily enqueue your CSS stylesheets and Javascript anywhere using a visual location rule builder
  • Seamlessly write your CSS directly in SASS without worrying about compilation
  • Create query loops of any content type, such as: posts, pages, custom post types, attachments, users, taxonomies and terms
  • Display built-in and custom fields
  • Build logic to display things based on certain conditions, for example: creating a menu, with some links only for logged-in users, or by user role
  • Create custom shortcodes to display anything from a custom field to an entire dynamic-data driven web page

Example Usage

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

<ul>
  <Loop type=post count=3 orderby=date order=desc>
    <li>
      <a href="{Field url}"><Field title /></a>
    </li>
  </Loop>
</ul>

Accomplishing the same thing in PHP is a little more complex:

<?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; ?>

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.

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.

Plugin & Theme Support

Plugin Support:

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.

Bundled integrations:

✅ Advanced Custom Fields (ACF)

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.

<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>

✅ Elementor

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.

✅ Gutenberg

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.

✅ Beaver Builder

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.

✅ WP Grid Builder

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.

✅ WP Fusion

The freely-included WP Fusion integration allows you to use conditional logic to protect or display different content based on a user’s tags.

<If user_field=wp_fusion_tags includes value="123">
  User has tag ID 123
<Else />
  User does not have tag.
</If>

We’ll be rolling out premium addons for popular plugins in the coming months, so check out our website to see what’s available!

Premium addons coming soon:

  • WooCommerce
  • Easy Digital Downloads
  • Modern Tribe Events Calendar
  • Gravity Forms
  • LearnDash
  • LifterLMS

Theme Support:

Everything will work with themes built according to WordPress standards.

Blocks

This plugin provides 1 block.

  • Loops & Logic

Installation

  1. Install & activate in the admin: Plugins -> Add New -> Upload Plugins

Reviews

སྤྱི་ཟླ་བཅུ་པ། 22, 2023
As I am not a programmer, I was struggling really hard for a long time to output the images from an ACF gallery field as a slider on a single custom post template. I can't believe it took me so long to find this plugin and it took me only an hour to create what I wanted using an external slider script (splide). Absolutely amazing tool. I am excited to dive deeper into the possibilities! Thank you for this genius plugin!
སྤྱི་ཟླ་བཅུ་པ། 3, 2023
I needed help when swapping Custom Content Shortcode for Loops and logic. With outstanding support, I got the swap done in no time, and with an improved result! This must be one of the very best plugins out there, with very dedicated people behind it. THANK YOU!
སྤྱི་ཟླ་བརྒྱད་པ། 26, 2023
I've only just scratched the surface of what this fantastic plugin can do. I'm really excited to add this to my standard go-to toolbox for WordPress development and lean more about the extensive functionality over time. Thanks a lot for all the efforts making this plugin happen!
སྤྱི་ཟླ་བརྒྱད་པ། 12, 2023
This plugin is just brilliant. Can't believe I only found this now. I went through dozens of ways to display dynamic content on my site, but this just blows them all away. It's super flexible, incredibly extensive and works intuitive. Really excited to see where this project will go in the future. Keep up the good work! 😀
སྤྱི་ཟླ་བདུན་པ། 24, 2023
So compatible with Divi Builder. Simple and great tool joins dinamics ACF.
Read all 38 reviews

Contributors & Developers

“Loops & Logic” is open source software. The following people have contributed to this plugin.

Contributors

“Loops & Logic” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Loops & Logic” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.1.2

Release Date: 2024-03-15

  • ACF integration
    • Date field types: Ensure unformatted value is passed to date conditions
    • Group, Flexible Content, Repeater: Correctly set up subfield loop after change to List loop type to support extended parameters such as offset/count/sort/filter
  • Post loop: Handle case when extended query parameter for post/user/category/tag slug is not array
  • Sass module: Revert to SCSS-PHP 1.11.1 to keep compatibility with PHP 7.4
  • Taxonomy term loop: Correctly pass post object IDs to query

4.1.0

Release Date: 2024-03-12

  • ACF integration
    • Breaking change: Date field types now get their default formatting from the field setting for Return Format. Previously the defaults were from site setting (Date field), “Y-m-d H:i:s” (Date/Time), and “H:i:s” (Time). Now they use the selected format in each field’s settings, or ACF’s default return format: “d/m/Y” (Date), “d/m/Y g:i a” (Date/Time), and “g:i a” (Time).
    • Improve handling of “format” and “locale” attributes
  • Editor
    • Formatter
    • Add keyboard shortcuts to support formatting by entire document or selected lines
    • Start a fork of Prettier HTML formatter to customize based on template language definition
    • Linter: Improve HTML linter rule for unique ID so it applies only to static tags
    • Update CodeMirror modules and Prettier
  • HTML module
    • Add comprehensive HTML test suite with test files from Parse5, Prettier, and Unified
    • Refactor to improve performance: ~3% faster
  • Loop types
    • Consolidate everywhere that accepts a list to support comma-separated list and JSON array
    • Improve sort by field using “field_compare”
    • List, Map, Map Keys: Support query parameters for base loop, such as offset, count, sort, filter, pagination
    • List: Use field name “value”, like “sort_field=value”
    • Map keys: Use field name “key” or “value”. Keep default order of keys as defined, unless “sort_field=key” is applied – previously was sorted alphabetically.
  • Gutenberg integration: Template block: Remember previously selected template when switching tabs
  • Sass module: Upgrade Sass compiler (scssphp) to 1.12.1, and CodeMirror Sass language support
  • Taxonomy term loop: Ensure “post” attribute accepts list variable
  • Template post types: Ensure templates always have a universal ID assigned, during post save and before exporting. This improves how duplicate templates are handled during import.
  • Template tag/shortcode: Ensure no post matches if attribute “name” is an empty string – See WP_Query matches any post when query parameter “name” is an empty string

4.0.2

Release Date: 2024-01-18

  • ACF integration: For relational fields, apply loop query parameters such as sort, order, paged, and exclude
  • Editor: Change key map to expand Emmet abbreviation to Shift+TAB, to prevent conflict with TAB to select autocomplete suggestion
  • Framework: Improve plugin settings page styles
  • Paginator: Improve how AJAX script is loaded
  • Post loop: Support use of exclude and include together, which is not natively supported by WP_Query

4.0.1

Release Date: 2024-01-04

  • Fix issues related to code reorganization: Mobile Detect and WP Fusion; Add integration tests to ensure no regression

4.0.0

Release Date: 2024-01-03

  • Documentation: Reference pages for developers and contributors, with technical details of how the codebase is organized.
  • Editor: New code editor based on CodeMirror 6 is enabled by default for template post types, Gutenberg, and ACF Template field. The old editor is still used for Elementor and Beaver Builder until integration is complete.
  • Framework and Modules: Features have been organized into modules which can be independently built, documented, tested, and optionally published. This replaces the previous Plugin Framework and Interface module.
  • GitHub repository: New home of the Template System source code and project, with better developer experience and social collaboration. Welcome to start new issues, pull requests, and discussions.
  • Testing: Improve coverage of unit tests, and prepare foundation for end-to-end tests with headless browser and WordPress environment in Docker. This is an on-going effort to exercise and verify all features of the plugin.

Other improvements:

  • ACF integration: Add Field tag attribute “acf_textarea” to apply formatting based on field settings
  • Archive screen: Add bulk action to move selected posts to trash
  • Assets edit screen: Improve documentation
  • Atomic CSS: Generate CSS utility classes on demand.
    Similar to Tailwind, this feature uses a style engine called UnoCSS to generate CSS rules from utility classes found in an HTML template, every time it is saved. On the frontend, the generated styles are minified together, removing any redundant rules. Enable in plugin settings.
  • Edit screen: Add Preview pane with auto-refresh
  • Editor: Hyperlink extension – Add clickable link icon next to a valid URL; Improve color picker
  • Import/Export
    • Add export rule to include/exclude template categories
    • Update PNG Compressor with better support for Firefox
    • Use compressed format (PNG) by default
  • Show admin menu, edit screens, and template editor (Gutenberg, Elementor, Beaver) only to admins with unfiltered_html capability. On multisite installs, by default only network admins have this capability, not subsite admins.
  • Update included libraries
    • HJSON, Select2, Chart.js, Mermaid, ..
    • Prism: Update library to 1.29.0 – Replace Clipboard.js with browser-native navigator.clipboard