Spring Sale: Our new update is live! Save 30% on Pro and Pro Unlimited for a limited time.

Conditions and Assignments

In this article, we're going to discuss the Conditions Control on individual Elements, as well as leveraging it for assignments with the Header, Footer, and Layout Builders.

  1. Getting Started
  2. Setting a Basic Condition
  3. Using “and” Statements
  4. Removing Statements
  5. Using “or” Statements
  6. Using Expressions
  7. Assigning Headers, Footers, and Layouts

The Conditions control allows users to output content based on certain criteria being met. For example:

  • Displaying different content for logged in vs logged out users.
  • Displaying content only if it exists. For instance, if a post has a featured image then output that asset; otherwise, do not output anything. This allows us to avoid outputting empty Elements that appear broken.
  • Displaying content within a certain timeframe. This can be useful if you have things you need to show leading up to an event, which you then want to have swapped out with something else once that event has arrived.
  • Having a global header with an Element inside it that only shows on certain pages (for instance, maybe a Post Navigation Element on individual blog posts). Using this method, you would not have to design two nearly identical headers and assign them to different contexts. Instead, you could simply build the one header and include the conditional content inside it and have that header work everywhere.

These are just a handful of ideas to explore, but there are many more possibilities and permutations available.

Getting Started

The Conditions control for an individual Element can be found under the Customize control section in the Inspector. Once there, you will find it at the end of the Setup control group:

Conditions and Assignments

Setting a Basic Condition

To begin working on your assignemnt conditions, click on the Conditions control to reveal the following popup:

Conditions and Assignments

Click on Add Condition Group to introduce your first conditional statement. The default value when adding your first statement might be different depending on the Element you are inspecting or the Builder you are in. Let's say you're working on some content for your site and you only want it to show up on your blog posts. One way to accomplish this would be selecting the dropdown and choosing Post Type from it. Doing so will reveal two more inputs to the right:

Conditions and Assignments

The control immediately proceeding the first dropdown is a toggle that allows you to switch your statement between is / is not. The last dropdown is contextual based on your first dropdown selection. Since we have selected Post Type for that input, this dropdown will be poulated with all relevant post types in your installation (e.g. Post, Page, Product, Portfolio Item, et cetera). Since we want this to show up for our blog posts, you would select Post to get the final conditional statement seen above.

Using and Statements

Now let's say that you want this content to show up on only blog posts that are part of the Standard Post Format. We could accomplish this by adding an and statement to our current condition. To do this you would click on the and button, which will reveal a new line for you to add your new statement:

Conditions and Assignments

You can take this as far as is necessary depending on your needs. For example, say that you wanted to exclude this content from showing in a Standard Post that has a Category of Travel. You could accomplish this by adding another and statement like so:

Conditions and Assignments

Removing Statements

To remove a particular statement from your condition, hover over that line to reveal an to the right:

Conditions and Assignments

Clicking on the will remove the statement from your condition. Keep in mind that there is no confirmation while doing this, so your statement will be removed immediately.

Using or Statements

There may be times where you discover that what you need to accomplish your desired output is an or statement. To introduce an or statement into your condition, simply click the Add Condition Group button again at the bottom of the popup.

For instance, you might have a situation where you want your content to show up on blog posts, but only if the currently logged in user is a Subscriber or a Customer. To accomplish that you could do something like the following:

Conditions and Assignments

Just like and statements, you can add as many or statements as are necessary. That being said, it is highly encouraged that you keep your conditions as simple as possible due the fact that stacking complex statements together might make it difficult to debug things if a problem should arise.

Using Expressions

As of Pro v4.1.0, X v8.1.0, and Cornerstone v5.1.0, Element Conditions now feature Expresions, which are centered around performing basic operations on WordPress meta values, allowing users to craft completely custom statements to fit your build's unique requirements. Check out this video on Element Condition Expressions.

For example, imagine that you wanted to apply a condition to an Element so that it was only output if the Comment Count on your Post was greater than 10. To do this, you would select the Element you wish to apply the condition to and go to Customize Conditions Number, which would reveal the following inputs:

Conditions and Assignments

You see that we have two inputs on either side of an operator in the middle, which can be cycled through by clicking on it just like our other more simple expressions. Either input can house Dynamic Content or static input, so to achieve the example we're going after, you might do something like the following with {{dc:post:comment_count}} in the first input, the > operator in the middle, and 10 for the final input:

Conditions and Assignments

As mentioned previously, there are three types of data that conditional expressions can work on, each with their own unique operators:

  • String
    • is: returns true if a strict match is detected between the two values (e.g. This matches. / This matches.)
    • is not: returns true if a strict match is not detected between the two values (e.g. Apples / Oranges)
    • in: returns true if the value of the first input appears as a substring of the second (e.g. howdy / Well howdy, folks!)
    • not in: returns true if the value of the first input does not appear as a substring of the second (e.g. running / biking, hiking, swimming)
  • Number
    • ==: returns true if the numeric value of both inputs is exactly the same.
    • !=: returns true if the numeric value of both inputs is not the same.
    • >: returns true if the numeric value of the first input is greater than the second.
    • >=: returns true if the numeric value of the first input is greater than or equal to the second.
    • <: returns true if the numeric value of the first input is lesser than the second.
    • <=: returns true if the numeric value of the first input is lesser than or equal to the second.
  • Before
    • before: returns true if the datetime of the first input is before the datetime of the second input.
    • after: returns true if the datetime of the first input is after the datetime of the second input.

Assigning Headers, Footers, and Layouts

There are certain parts of the site building processnamely the Header, Footer, and Layout Buildersthat will require you to assign a context, indicating where they should be output on your site. To do this you will need to use the Assignment Control, which leverages the Conditions Control we have been talking about throughout this article in conjunction with a Priority input.

The Assignment Control can be found under the relevant contextual Settings tab for any particular builder. Below is a screenshot taken from the Layout Builder:

Conditions and Assignments

There are two parts to be aware of when assigning anything: the Conditions and Priority. As we have discussed in this article so far, the Condition Control is where you will specify the logic for how something should be output. The Priority comes into play if you have two assets that might potentially overlap in some instances, allowing you to specify which should take precedent over the other. In these cases, the layout with the lowest priority will be used.

See something inaccurate? Let us know