JetEngine

JetEngine Layouts

From this block you’ll learn how to showcase the custom post types or taxonomies into listing and grid layouts.

Adding New Layout

  1. To add a new layout you need to navigate to JetEngine > Listings in WordPress Dashboard. Here click Add New button in the top left corner.
  2. A Listing Setup Item block will appear. Here you’ll have to select:

    • Listing source - here you can choose, if you want to create a listing template for the custom post type or for the term (in other words, the custom taxonomy).
    • From taxonomy / post type - here you need to specify the taxonomy or the post type for which you need to set the template. Just select the title of the taxonomy you’ve created.
    • Listing Item Name - here you can input the title for the new listing template.
  3. Click Create Listing Item to proceed with creating a new template for the layout.
  4. On Elementor editing page you’ll see Listing Grid widget in the Listing Elements block. Drag and drop it to the page where you want to place the layout.

Listing Grid Widget Settings

Content
General
  • Listing - here you need to select the listing template type to use in the layout.
  • Columns Number - here you have to specify the number of columns to be shown in the layout.
  • Use as Archive Template - enable this option in case you want to pull the number of posts to be displayed on Archive page from the default Reading settings.
  • Posts Number - here you need to set the number of posts to be displayed with the selected layout (in the case you’ve selected Use as Archive template option you won’t be able to set this value).
  • Not found message - here you can specify the text of the message, which appears when the data wasn't found. Also you can insert a shortcode for displaying the certain template.
  • Equal columns height - enable this optin in order to make equal height of the columns.
Posts Query

In this block you’ll be able to set the advanced parameters for the posts query (this is needed when you need to query the posts using different parameters, offsets, several terms with more complicated relations).

Click Add Item button to add the new query parameter.

  • Type - here you can specify the type of the query by which you want to display the posts. Depending on which parameter you’ve selected the options available will be different.

    Posts Parameters Type

    • Include Posts by IDs - here you need to type in the IDs of the posts or pages you want to be displayed with the listing grid.
    • Exclude Posts by IDs - here you can specify which posts or pages you want to shut from being displayed with the widget.
    • Get Child of - type in the hierarchical post or page ID from which you want to get the Child posts or pages.
    • Get posts with status - here you can enable displaying for all the posts that have the selected status (publish, draft, etc).

    Order and Offset

    • Posts Offset - here you can select the offset to apply for the posts displayed in the grid.
    • Order - select if you want to use ascending or descending order for the posts.
    • Order By - here you can order the posts by date, type, name, etc. You can also specify the random order if you don’t want the posts to have any set order.

    Tax Query

    • Taxonomy - here you need to select the taxonomy using which you want to query the posts (tag, category or any custom taxonomy available for the posts displayed).
    • Taxonomy from meta field - in the case you need to query the posts that have the taxonomy name type in the name that is set in the meta field.
    • Operator - here you can select the operator to include or exclude the posts/pages from the taxonomy you want to query when checking the taxonomy on having the needed terms inside it.
      • IN - this operator defines if you want to include the posts that have the defined term or taxonomy specified.
      • NOT IN - this operator will prevent the posts that contain the set term or taxonomy from being displayed.
      • AND - this operator enables for displaying all the posts or pages that contain both of the taxonomies and terms.
    • Field - here you can specify the field, which should be filled in in the case the posts are to be queried.
    • Terms - here you can specify the terms that need to be set in order for the post/page to be queried.
    • Terms from meta field - here you can specify the terms input in the meta field that define if the post would be queried.

      Please, note, that you can create several Tax Query items and set the Meta Query relation and Tax Query relation to display them using the more difficult relations:

      • AND - the posts that will be displayed need to meet all the Tax Query or Meta Query requirements, containing everything that is specified. In the case the post contains only one of the needed meta or taxonomy terms, it won’t be displayed in the listing grid.
      • OR - the posts that will be displayed need to meet at least one of the the Tax Query or Meta Query requirements, containing at least one feature that is specified.

    Meta Query

    • Key - here you need to fill in the name or ID of the meta field which you want to use to query posts or pages.
    • Operator - here you can set one of the operators to query the posts that meet the needed requirements.
      • Equal - the posts should have the meta field value that is equal to the set value in Value field.
      • Not equal - the posts should have the meta field value that is not the same as the set value in Value field.
      • Greater than - the posts should have the meta field value that is greater than the set value in Value field.
      • Greater or equal - the posts should have the meta field value that is equal or greater than the set value in Value field.
      • Less than - the posts should have the meta field value that is lesser than the set value in Value field.
      • Equal or less - the posts should have the meta field value that is equal lesser than the set value in Value field.
      • Like - the posts should have the meta field values that are similar to the set value in Value field by some criteria.
      • Not like - the posts should have the meta field values that are not similar to the set value in Value field by some criteria.
      • In - the posts should have the meta field values that include the set value in Value field.
      • Not in - the posts should have the meta field values that don’t include the set value in Value field.
      • Between- the posts should have the meta field value that is between the range of the set value in Value field.
      • Not between - the posts should have the meta field value that is not between the range of the set value in Value field.
    • Value - here you need to specify the value to use for the meta query operator.
    • Type - here you need to select one of the types to apply to the meta field value to work with it ( character, numeric, binary, date, decimal, signed, unsigned).

Date Query

  • Column - here you can select how to display posts (by post date, post date GMT, post modified, post modified GMT)
  • After - here you can set the date, after which to retrieve posts.
  • Before - here you can set the date, before which to retrieve posts.
Terms Query

In this block you’ll be able to set the advanced parameters for the terms query (this is needed when you have to query the terms using different parameters, offsets, several terms with more complicated relations). Please, note that it works only for the Terms source.

  • Get terms of posts - here you need to add the IDs of the posts from which you want to query the terms.
  • Order By - here you can set the needed order to display the terms (name, sug, count, term group, description, parent, count, term ID, etc.)
  • Order - here you can set the ascending or descending order to apply for the post.
  • Hide Empty - enable this option to hide the empty taxonomies from view.
  • Include terms - here you need to specify the terms which should be in the taxonomy to include it.
  • Exclude terms - here you have to specify the terms that will define the category as the one to be excluded.
  • Offset - here you can set the offset for the terms to be displayed.
  • Child of - here you can specify if you want to display the terms that are the child ones of the parent taxonomy.
Meta Query

Click Add Item button to add a new circumstance for the terms query.

  • Key - here you need to type in the meta key of one of the meta fields added for the taxonomy type.
  • Operator - here you can set one of the operators to query the terms that meet the needed requirements.
    • Equal - the terms should have the meta field value that is equal to the set value in Value field.
    • Not equal - the terms should have the meta field value that is not the same as the set value in Value field.
    • Greater than - the terms should have the meta field value that is greater than the set value in Value field.
    • Greater or equal - the terms should have the meta field value that is equal or greater than the set value in Value field.
    • Less than - the terms should have the meta field value that is lesser than the set value in Value field.
    • Equal or less - the terms should have the meta field value that is equal lesser than the set value in Value field.
    • Like - the terms should have the meta field values that are similar to the set value in Value field by some criteria.
    • Not like - the terms should have the meta field values that are not similar to the set value in Value field by some criteria.
    • In - the terms should have the meta field values that include the set value in Value field.
    • Not in - the terms should have the meta field values that don’t include the set value in Value field.
    • Between - the terms should have the meta field value that is between the range of the set value in Value field.
    • Not between - the terms should have the meta field value that is not between the range of the set value in Value field.
  • Value- here you need to specify the value to use for the meta query operator.
  • Type - here you need to select one of the types to apply to the meta field value to work with it ( character, numeric, binary, date, decimal, signed, unsigned).
  • Meta Query Relation - in the case you’re using several meta query methods, just select the needed relation to specify how the query should be done.
    • AND - the terms that will be displayed need to meet all the Meta Query requirements, containing everything that is specified. In the case the terms contains only one of the needed meta or terms, it won’t be displayed in the listing grid.
    • OR - the terms that will be displayed need to meet at least one of the the Meta Query requirements, containing at least one feature that is specified.
    Widget Visibility
    • Hide widget if - here you can select whether you want the widget to be always showed or hide it when query is empty.
    Slider
    • Enable Slider - enable this option if you want to display listing grid in a carousel form.
    • Slides to Scroll - here you can define how many slides you want to scroll.
    • Show Arrows Navigation - enable this option if you want to add navigation arrows to the slider to provide easy switching from slide to slide for the visitors.
    • Arrow Icon - here you can select the icon for the navigation arrows.
    • Show Dots Navigation - enable this option if you want to add navigation dots to the slider to provide easy switching from slide to slide for the visitors.
    • Autoplay - here you can enable autoplay option for switching slide to slide of the slider automatically.
    • Autoplay Speed - here you can define the speed of switching from slide to slide.
    • Infinite Loop - turn on the option if you want the slides to repeat.
    • Animation Speed - in this field you need to define the speed of animation effect when switching from slide to slide.

    Displaying Related Posts

    From this block one can learn how to add the related posts block using the Listing Grid widget.

    1. First, add the Listing Grid widget to the page template where you need to display the related posts.
    2. Navigate to Content > Posts Query and here select Posts Parameters query type from the dropdown.
    3. Type in the %current_id% macros in Exclude posts by IDs field in order to let the query exclude the currently displayed posts on the page from the query.
    4. In order to exclude the specific category term from showing up add Tax Query query type in Posts Query block.
    5. In Taxonomy block select Categories and then specify the term macros %current_categories% you want to exclude in Terms field. Don't forget to specify IN operator in Operator dropdown.
    6. To exclude the specific tag from showing up you need to add the new query item and then select Tax Query query type and Tags in Taxonomy dropdown. Then type in %current_tags% in Terms field and specify IN operator.