How does Citadela Directory WordPress plugin work? New Custom types & directory blocks added [Updated 2020]

Author: Categories: Citadela - best Gutenberg theme and plugins
Updated: April 6, 2021
How does Citadela Directory WordPress plugin work? New Custom types & directory blocks added [Updated 2020]

Citadela WordPress Directory plugin is exceptional for its ability to enhance any modern WP theme with portal functionality. The essential requirement is the compatibility of the theme with WordPress 5.2 and active Ait membership (no matter which one). To find out where you can use this plugin on your site, what are its advantages and differences compared to our old portal themes, read our previous article about 1st WordPress directory plugin that adds directory features to any block-based theme.

We show you how does Citadela WordPress Directory plugin work and what exactly does it add to the WordPress editor:

What kind of website can use listing features?

Listing portal

Any listing portal with data directory organization can use Citadela WordPress Directory plugin. We have released its first version at the end of September 2019. It comes with basic features. We continue to develop new features to have the same features as our second version of directory themes.

Non-listing portal

Even you do not run the listing portal website you should use directory functionality. Why? Basically, you must persistently improve website content. You are looking for new and new ways how to do that.

Lately, we come with an innovative idea of how to display data in a blog post or on other pages. Enrich website content even you do no have portal or listing website. You take your data and show them instead of just boring in the new modern way. Think about your visitors. They need precise information. In this way, you can give them a lot more imagination. In the end, you offer them a higher class, because they find new and useful knowledge.

Where do you find subpages for the directory functionality?


We recently changed the location of Special Pages and created a separate new Custom type from them. You will also learn more about newly added Custom types and directory blocks (updated in January 2020).

1. Citadela Directory WordPress plugin settings page

The first thing you’ll notice after installation of the plugin is that there is a new settings page called Citadela Directory in the sidebar (on your left-hand side in wp-admin). Here you can set up Google Maps API key and insert the generated keys for Google reCaptcha v3 to eliminate spam on your site.

2. Custom type: Items

Items is the first Custom type that Citadela Directory plugin adds into the administration. There are following fields in its submenu:

  • All Items – you can create new items here. If you previously had any of the directory themes from Ait-Themes, you’ll find all your “old” migrated items here too.
    We’ll give you a step by step guide for creating an Item in a separate tutorial.
  • Add New (Item)
  • Item Categories – here you can add and edit individual categories for items
  • Item Locations – likewise the above, add and edit item locations

3. Citadela Directory blocks that can be placed anywhere

In the current version of the Citadela Directory plugin, there are 7 universal directory blocks available. Their variability lies in the fact that you can insert them anywhere on the page – into Posts, Pages, as well as into particular pages created by the plugin itself.

These are the following directory blocks:

  • Directory Map – Displays items on the map according to selected parameters
  • Directory Search Form – A block through which users search for items
  • Directory Categories List – Displays a list of categories by certain parameters
  • Directory Locations List – Displays locations by certain parameters
  • Directory Items List – Displays items according to filter selected by the user
  • Directory Map (for posts) [NEW] – Displays posts on the map according to selected parameters
  • Posts Search Form [NEW] – A block that allows users to search for posts

Get Citadela Directory plugin with all directory blocks included in Lifetime Membership!

Buy Lifetime Membership

4. Custom type: Special Pages [NEW]

Initially, Citadela Directory plugin generated several Special Pages directly within Pages. Later, these Special Pages were separated into a separate section and transformed into Custom type. So now you can find a new Custom type Special Page in wp-admin. You can see it directly in left sidebar (as a new menu item). This change has only visible impact. the principle of operation remains the same as before.

If you’ve already entered data on the Pages, you don’t have to worry, you won’t lose anything. All data stay safe during the update.

Lisiting portal creator - Special Pages

These are the following special pages:

  • Directory Search Results page
  • Item Detail page
  • Item Category page
  • Item Location page
  • Posts Search Results page [NEW]

What are special pages used for?

Special pages can be used to create a structure and layout of the page. That means you can set which blocks will be on a certain page as well as where they’ll be placed. You can also reorder the blocks, move them around the page, sort them to columns or completely change the default layout.

How to order blocks in WordPress listing detail

At the same time you can remove a block that you don’t currently need and add it back later. This is the biggest difference between Citadela Directory plugin and our old directory themes, in which the layout of the directory pages was more or less fixed, based on the design of the directory theme in use.

Automatically extracted data

Special pages are also characterized by the fact that they automatically pull a certain type of data onto the page – search results, items, categories, or locations. Web visitor gets to the special page by searching for an item, category or location and clicking on results. So, keep in mind that anything you add to special pages will appear on all other related pages with this data.

Since Special Pages are automatically generated by Citadela Directory plugin, they cannot be deleted.

5. Citadela Directory Blocks for Special Pages

Each special page has different directory blocks. The biggest advantage is the flexibility of their arrangement. You can choose the blocks you need and display them on the page or reorder them to achieve a completely different layout of your page. For example, you can arrange blocks into columns or insert other WordPress core blocks in between them; or even add Citadela Directory blocks that can be inserted anywhere (blocks from section 3 above).

As mentioned above, different blocks are available for each Special Page. But don’t worry. You don’t need to search for them precisely, because only specific blocks are displayed on a particular Special Page.

Listing Blocks in Gutenberg WordPress Editor Citadela Theme

Meet the special Citadela Directory blocks

Special blocks available for Directory Search Results page only

  • Automatic Map
  • Directory Search Results

Special blocks available for Item Detail page only

(that extract data from Item Custom type)

  • Item Featured Image
  • Automatic Directory Map
  • Item Content
  • Item Contact Details
  • Item Contact Form
  • Item Opening Hours

Special blocks available for Item Category page only

  • Automatic Directory Map
  • Directory Search Results
  • Directory Subcategories List

Special blocks available for Item Location page only

  • Automatic Directory Map
  • Directory Search Results
  • Directory Sublocations List

Special blocks available for Posts Search Results page only

  • Automatic Directory Map (for posts)
  • Posts Search Form