Directorist - Advanced Fields
Adds advanced custom fields like iframe, shortcode, video, editor, featured checkbox, repeater to Directorist listing forms and displays.
Overview
Advanced Fields for Directorist is an extension for the Directorist plugin that introduces a set of powerful, flexible custom fields for directory listing forms and single listing layouts.
It is designed for site owners who need more advanced listing structures than the default Directorist fields, while still staying inside the familiar Directorist ecosystem.
With this extension, you can enrich directory listings using:
Embedded media
Dynamic structured data
Rich text content
Repeating field groups
Custom feature highlights
All fields are fully configurable from the Directorist Directory Type form builder.
Available Advanced Fields
The extension currently provides eight advanced field types designed to enhance listing flexibility.
1. iFrame Field
The iFrame Field allows you to embed external content directly inside a listing.
Use Cases
Third-party booking widgets
External maps
Interactive dashboards
External tools or applications
How It Works
Add the iFrame field in the Directory Type form builder.
In the listing form, users paste an iframe embed code.
The plugin sanitizes the iframe attributes for safety.
The iframe renders inside the single listing page.
Benefits
Keeps visitors on your website
Allows integration with external platforms
No custom coding required
Notes
Use iframe embeds only from trusted sources, since they render external content.
2. Shortcode Field
The Shortcode Field allows listings to render any WordPress shortcode.
Use Cases
Contact forms
Galleries
Sliders
Pricing tables
Plugin integrations
How It Works
Add a Shortcode field in the builder.
Users enter a shortcode (example):
[contact-form-7 id="123"]
On the single listing page, the plugin executes the shortcode and outputs the result.
Benefits
Integrates listings with other WordPress plugins
Allows highly flexible listing layouts
Makes listings dynamic and extensible
Notes
Shortcodes should be restricted to trusted plugins to avoid executing unsafe logic.
3. YouTube Video Field
The YouTube Video Field allows users to attach a YouTube video to a listing.
Use Cases
Business promo videos
Property walkthroughs
Product demonstrations
Tutorials
How It Works
The listing form provides a YouTube URL input.
The plugin extracts the video ID.
It generates an embed URL:
https://www.youtube.com/embed/{video_id}
The video is displayed on the single listing page.
Benefits
Users only need to paste a YouTube link
Consistent video styling
Automatic embed conversion
Notes
Both standard YouTube URLs and short links are supported.
4. Vimeo Video Field
The Vimeo Video Field functions similarly to the YouTube field but for Vimeo-hosted content.
Use Cases
Creative portfolios
Agency presentations
Brand showcase videos
Premium hosted media
How It Works
Users enter a Vimeo video URL.
The plugin extracts the video ID.
The video is embedded using:
https://player.vimeo.com/video/{video_id}
The Vimeo player appears on the single listing page.
Benefits
Supports high-quality Vimeo content
Seamless integration alongside YouTube videos
Simple URL input
5. WP Editor Field
The WP Editor Field adds a mini WordPress editor inside the listing form.
Use Cases
Listing-specific descriptions
FAQ sections
Rich formatted notes
Policy details
Custom content blocks
How It Works
Add the WP Editor field in the form builder.
The listing form loads a TinyMCE editor instance.
Users can format text with headings, lists, and basic styling.
On the listing page, content is output using:
wp_kses_post()
This ensures only safe HTML is rendered.
Benefits
Familiar WordPress editing experience
Supports formatted text
Stores structured content separate from the main listing description
6. Featured Checkbox Field
The Featured Checkbox Field allows users to highlight key attributes of a listing.
Use Cases
Amenities
Service highlights
Key selling points
Trust indicators
Examples:
24/7 Support
Free Parking
Verified Business
Premium Service
How It Works
Configure checkbox options in the builder.
Each option contains:
value
label
The listing form shows selectable checkboxes.
Selected options appear on the single listing page as a styled list with icons.
Benefits
Makes key attributes easy to scan
Converts long descriptions into structured highlights
Improves listing readability
7. Feature List Field
The Feature List Field is an enhanced version of the Featured Checkbox field with additional styling controls.
Use Cases
Display feature badges
Show categorized listing attributes
Apply custom styles or icons
Examples:
Family Friendly
Business Ready
Outdoor Seating
Pet Friendly
How It Works
Each option supports the following configuration:
| Option Property | Purpose |
|---|---|
| option_value | Stored value |
| option_label | Display text |
| option_icon | Icon class |
| option_class | Custom CSS class |
On the listing page, features render as:
<ul class="feature-list">
<li class="option_class">
<i class="option_icon"></i>
option_label
</li>
</ul>
Benefits
Highly customizable display
Easy theming with CSS
Icon support for visual emphasis
8. Repeater Field
The Repeater Field is the most powerful field type in the extension.
It allows you to create repeating groups of sub-fields.
Use Cases
Education history
School
Degree
Year
Work experience
Company
Position
Start date
End date
Team members
Name
Position
Email
Profile link
Schedules
Day
Start time
End time
How It Works
Step 1 — Configure Repeater Field
In the Directory Type builder:
Add a Repeater field
Define sub-fields, including:
field type
key
label
placeholder
options
Step 2 — Listing Form
The listing form displays dynamic fieldset cards.
Users can:
Click + Add item to add rows
Click – Remove to delete rows
Each row contains the configured sub-fields.
Step 3 — Data Storage
Values are stored as a JSON array inside a hidden field.
Example structure:
[
0 => [
'school' => 'Oxford University',
'degree' => 'MBA'
],
1 => [
'school' => 'Harvard',
'degree' => 'PhD'
]
]
Step 4 — Display Output
On the single listing page:
Each repeater item becomes a card
Labels and values are displayed cleanly
Field types are respected
Examples:
URLs → clickable links
Checkboxes → multiple labels
Colors → color swatches
Benefits
Create complex data structures without coding
Fully dynamic frontend forms
Works seamlessly in both admin and frontend listing editing
Technical Architecture
Advanced Fields integrates deeply with Directorist using WordPress hooks and template overrides.
Field Registration
Fields are registered using filter hooks:
atbdp_form_advanced_widgets
directorist_field_template
directorist_single_item_template
This ensures fields appear naturally in the Directorist Directory Type builder.
Template Structure
Two template groups handle rendering.
Listing Form Templates
templates/listing-form/
Responsible for:
Input fields
Form UI
Field validation
Single Listing Templates
templates/single/
Responsible for:
Frontend display
Rendering stored values
Helper Utilities
Shared helper functions live in:
includes/class-helper.php
These helpers manage:
File path utilities
YouTube and Vimeo parsing
Repeater sub-field rendering
Data processing
Scripts and Styles
Custom JavaScript and CSS are loaded in both:
Frontend listing forms
WordPress admin listing editor
This ensures consistent behavior and appearance.
Related Products
Auto WebP Converter
A WordPress plugin that converts images to WebP format during upload, reducing file sizes & improving website performance.
Directorist - Advanced Social Links
An extension for Directorist plugin that adds advanced social networking options to listing forms and single listing pages.
Directorist - Bulk Actions
Streamline directory management with powerful bulk operations for listings and taxonomies. Import, export, update, and delete at scale.
Directorist - Custom Badges
A Directorist extension that allows you to create and manage custom badges for your listings with advanced conditions.
Directorist - Custom Map Styles
A Directorist extension enabling custom Google Maps styling, letting users override default map designs with personalized configurations.