How does Citadela Directory plugin work? It adds new Custom types and directory blocks

Author: Categories: Building Directory Portals
Updated: November 6, 2019
How does Citadela Directory plugin work? It adds new Custom types and directory blocks

In the previous article we introduced one of our latest plugins – Citadela Directory plugin, which enhances any modern WP theme with directory functionality. The basic requirement is compatibility of the theme with WordPress 5.2 and active Ait membership. To find out where on your site can you use this plugin, what are its advantages and differences compared to our old directory themes, read 1st WordPress directory plugin that adds directory features to any block based theme.

Today we’ll show you how Citadela Directory plugin works and what exactly does it add to the WordPress editor:

1. New Custom Type: Citadela Directory

The first thing you’ll notice after installation of the plugin is that there is a custom type 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

The second custom type that Citadela Directory plugin adds to the administration is Items. 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 Citadela Directory plugin there are 5 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 special pages created by the plugin itself.

These are the following directory blocks:

  • Directory Google 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

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

Buy Lifetime Membership

 

4. Special Pages in Pages

Citadela Directory plugin generates several special pages that are located directly within Pages. These are the following special pages:

  • Directory Search Results page
  • Item Detail page
  • Item Category page
  • Item Location page

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.

Reordering blocks in special page layout

Reordering blocks in special page layout

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 subpages with this data.

Since Special Pages are automatically generated by Citadela Directory plugin, they cannot be deleted. The only exception is the Directory Search Results page.

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

The best way to find out which blocks are available for you to use in your Special Page is:

  • Click the “+“ symbol on a specific Special Page
  • Look for Citadela Directory Blocks tab
  • Click on the tab to see all the blocks that can be added to a particular special page you’re on.
  • You’ll also find other generally available Citadela Directory blocks here.
Finding available blocks for special Page

Step-by-step guide of finding available Citadela directory blocks for special Page you are using

 

Meet the special Citadela Directory blocks

Infographics of special directory blocks for pages and posts

See this image to better understand which special directory blocks you can use everywhere

 

Special blocks available for Directory Search Results page only

  • Automatic Directory Google Map
  • Directory Search Results
Special blocks available for Directory Search Results page

These 2 special blocks are available for Search Results page

 

Special blocks available for Item Detail page only

(that extract data from Item Custom type)

  • Item Featured Image
  • Automatic Directory Google Map
  • Item Content
  • Item Contact Details
  • Item Contact Form
  • Item Opening Hours
Special blocks available for Item Detail page

For Item Detail page can be used only these blocks

 

Special blocks available for Item Category page only

  • Automatic Directory Google Map
  • Directory Search Results
  • Directory Subcategories List
Special blocks available for Item Category page

See this infographics to find out which special blocks you can insert on Item Category page

 

Special blocks available for Item Location page only

  • Automatic Directory Google Map
  • Directory Search Results
  • Directory Sublocations List
Special blocks available for Item Location page only

These three directory blocks can be placed on Item Location page

In the coming weeks, we’ll gradually introduce each directory block separately and bring you more information on how to work with special pages or how to create a homepage on your directory website.