Zephyr
Impreza
Guide
Support Forum

Grid

Updated 5 days ago

Grid element is deprecated in Impreza version 8.39. It won't be supported in the future. But Zephyr updates will not stop its functioning on any existing website.

What exactly does "deprecated" mean? #

  • Grid won't receive any new features and improvements
  • Grid won't receive fixes of its known bugs
  • Grid will continue to work after any future Zephyr update
  • Grid will receive critical bug fixes if any appear
  • The Grid interface will show you notification about its deprecated status, that recommends to use the following elements instead:
  • In future updates it will not be possible to add the Grid element

At the moment, deprecated elements are still available for adding in the builder interface.

In the Live Builder:

In the WPBakery Builder:

Why the Grid element became deprecated? #

The Grid is a complex element that historically:

  • is able to show inconsistent things: posts, terms, and images, those three are very different for purposes
  • has built-in filter options (the "Filter" tab in element settings), but at the same time, has relevance to a separate Grid Filter element
  • was created several years ago without taking into account constantly improved third-party plugins
  • (honestly) was created without taking into account good practices of developing for WordPress and doesn't provide enough hooks for customizations

That's why it has an overloaded internal structure and logic and requires refactoring. However, the main disadvantage of refactoring old elements is that it can break old websites. And it is impossible (literally) to test all Grid use cases.

So, we created a better analog from scratch. The "List" elements.

Should I manually replace the Grid with the Post List on all my websites? #

It's pretty optional. We understand that if you have dozens of sites, this will take a lot of time. But if you currently creating the new site we recommend not using the Grid.

What will happen with the Carousel element? #

Since the Carousel element doesn't have ability to be filtered/sorted/paginated, two paths will emerge:

  1. It will stay as is
  2. It will be deprecated, but Post List, Product List, Term List elements will have the "carousel" layout.

What are the current differences between the Grid and the "List" elements? #

Features of the Grid element not available in the Post List #

  1. Showing posts as "sticky"
  2. Order posts by random with pagination enabled
  3. Showing taxonomy terms
  4. Built-in filters: ability to show simple filters based on taxonomies without using a separate filter element
  5. Support filtering from WooCommerce product widgets

Features of the Post List element not available in the Grid #

  1. Showing different post types in a single list
  2. Include/exclude the current post
  3. Showing posts based on custom field values
  4. Showing posts based on authors
  5. Showing posts based on multiple taxonomies conditions
  6. Showing child posts of the chosen post or parent posts without child posts
  7. Showing posts, excluding the list of specified ones
  8. Showing posts, including/excluding the current one
  9. Showing posts of the current query with custom sorting and taxonomy conditions
  10. "Preload Style" option that allows changing the default spinner while filtering posts

Features of the Product List element not available in the Grid #

  1. Include/exclude hidden products
  2. Include/exclude the current product
  3. Showing products with a specified price or within a specified price range.
  4. Showing products based on the custom field values.
  5. Showing products based on multiple taxonomies conditions.
  6. Showing all products except the specified individual products.
  7. Showing recently viewed products.
  8. Showing the favorite products of the current visitor.
  9. Showing products of the current query with custom sorting and taxonomy conditions.
  10. "Preload Style" option that allows changing the default spinner while filtering products.

Features of the Term List element not available in the Grid #

  1. Showing taxonomy terms of the current post
  2. Showing taxonomy terms including/excluding the specified ones
  3. Showing taxonomy terms including/excluding the current term
  4. Showing taxonomy terms based on custom field values
  5. Hiding empty terms