{"id":369095,"date":"2025-10-27T10:31:44","date_gmt":"2025-10-27T04:31:44","guid":{"rendered":"https:\/\/directorist.com\/?post_type=docs&#038;p=369095"},"modified":"2025-10-29T12:16:18","modified_gmt":"2025-10-29T06:16:18","password":"","slug":"theme-setup-cutomization","status":"publish","type":"docs","link":"https:\/\/directorist.com\/docs\/theme-setup-cutomization\/","title":{"rendered":"Full Theme Setup &amp; Customization"},"content":{"rendered":"\n<p><strong><br><\/strong>Applies to: OneListing-Pro (premium). For the free OneListing theme, most steps are similar but some features\/extensions are not included.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Quickstart (10 minutes)<\/strong><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Install Theme:<\/strong> <em>Appearance \u2192 Themes \u2192 Add New \u2192 Upload<\/em> and upload onelisting-pro.zip. Activate.<br><\/li>\n\n\n\n<li><strong>Install Required Plugins:<\/strong> <em>Appearance \u2192 Install Plugins<\/em> \u2192 install\/activate: <strong>Directorist<\/strong> and <strong>Elementor<\/strong> (required).<br><\/li>\n\n\n\n<li><strong>Install Recommended Extensions (optional):<\/strong> Business Hours, Listings with Map, Social Login, Pricing Plans, Booking, Claim Listing, PayPal, Stripe, Contact Form 7, Mailchimp for WP.<br><\/li>\n\n\n\n<li><strong>Import Demo:<\/strong> <em>Tools \u2192 Demo Content Install<\/em> (or <em>Plugins \u2192 WpWax Demo Importer \u2192 Install Demo Contents<\/em>).<br><\/li>\n\n\n\n<li><strong>Flush Permalinks:<\/strong> <em>Settings \u2192 Permalinks \u2192 Save<\/em> (no change needed).<br><\/li>\n\n\n\n<li><strong>Set Menus &amp; Widgets:<\/strong> <em>Appearance \u2192 Menus<\/em> (assign <strong>Primary<\/strong>), <em>Appearance \u2192 Widgets<\/em> (Footer widgets).<br><\/li>\n\n\n\n<li><strong>Tweak Directory Builder:<\/strong> <em>Directory Listings \u2192 Directory Builder<\/em> (configure <strong>Add Listing<\/strong>, <strong>Single<\/strong>, <strong>All Listings<\/strong>, <strong>Search Forms<\/strong>).<br><\/li>\n\n\n\n<li><strong>Launch.<\/strong><strong><br><\/strong><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Getting Started with Themes<\/strong><\/h2>\n\n\n\n<p>onelisting-pro is a general\u2011purpose directory theme for <strong>Directorist<\/strong>. It ships with a modern design, Elementor compatibility, and pre\u2011built directory layouts. The theme relies on the Directorist plugin and optionally on several official extensions for monetization, booking, maps, etc.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"495\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113-1024x495.png\" alt=\"\" class=\"wp-image-369097\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113-1024x495.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113-300x145.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113-768x371.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113-1536x742.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-113.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Overview of Our Themes<\/strong><\/h3>\n\n\n\n<p>Directorist offers multiple themes (e.g., OneListing (free), onelisting-pro, dList, dPlace, dCar, dRealEstate, etc.). onelisting-pro is the <strong>flexible, all\u2011rounder<\/strong> choice suitable for business directories, services, real estate, classifieds, and events.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Requirements<\/strong><\/h2>\n\n\n\n<p><strong>WordPress:<\/strong> 5.0+ (latest stable recommended)<br><strong>PHP:<\/strong> 7.2+ (7.4+ recommended for performance)<br><strong>Database:<\/strong> MySQL 5.6+ or MariaDB 10.0+<br><strong>Memory:<\/strong> WordPress memory limit 512MB+<br><strong>Web server:<\/strong> Apache\/Nginx with pretty\u2011permalinks enabled<br><strong>SSL:<\/strong> Strongly recommended for payments and logins<\/p>\n\n\n\n<p><strong>Tip:<\/strong> Ask your host to increase memory_limit, max_execution_time (300s), upload_max_filesize (64M+), and post_max_size (64M+) if demo import times out.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Theme Installation Guide<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>A) Through WordPress<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Download the theme installation file from the download section of the dashboard page of the Directorist website. You need to login to the dashboard first.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"429\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114-1024x429.png\" alt=\"\" class=\"wp-image-369098\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114-1024x429.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114-300x126.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114-768x322.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114-1536x643.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-114.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Go to the admin panel of your website now, then navigate to <em>Appearance \u2192 Themes \u2192 Add New \u2192 Upload Theme<\/em>.<br><\/li>\n\n\n\n<li>Select onelisting-pro.zip \u2192 <strong>Install Now<\/strong> \u2192 <strong>Activate<\/strong>.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"448\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115-1024x448.png\" alt=\"\" class=\"wp-image-369099\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115-1024x448.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115-300x131.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115-768x336.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115-1536x672.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-115.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>B) Through FTP\/SFTP<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Extract onelisting-pro.zip locally.<br><\/li>\n\n\n\n<li>Upload the theme folder to \/wp-content\/themes\/<br>(e.g., \/wp-content\/themes\/onelisting-pro\/).<br><\/li>\n\n\n\n<li>Go to <em>Appearance \u2192 Themes<\/em> and <strong>Activate<\/strong>.<br><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"755\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-116-1024x755.png\" alt=\"\" class=\"wp-image-369100\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-116-1024x755.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-116-300x221.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-116-768x566.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-116.png 1210w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Install Prepackaged Plugins \u2014 Full list<\/strong><\/h3>\n\n\n\n<p>Go to <em>Appearance \u2192 Install Plugins<\/em> and install\/activate:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Required:<\/strong> Directorist, Elementor<br><\/li>\n\n\n\n<li><strong>Demo:<\/strong> WpWax Demo Importer (deactivate after import)<br><\/li>\n\n\n\n<li><strong>Utilities:<\/strong> Contact Form 7 (contact forms), MC4WP: Mailchimp for WordPress (newsletter)<br><\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"312\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117-1024x312.png\" alt=\"\" class=\"wp-image-369101\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117-1024x312.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117-300x91.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117-768x234.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117-1536x468.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-117.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"602\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118-1024x602.png\" alt=\"\" class=\"wp-image-369102\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118-1024x602.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118-300x176.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118-768x451.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118-1536x902.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-118.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Optional Directorist Extensions:<\/strong> Please navigate to Directory listings &gt; Themes &amp; Extensions &gt; Required Extensions and install\/activate Business Hours, Listings with Map, Social Login, Pricing Plans, Booking, Claim Listing, PayPal Gateway, Stripe Gateway and other required extensions.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"479\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119-1024x479.png\" alt=\"\" class=\"wp-image-369103\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119-1024x479.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119-300x140.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119-768x359.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119-1536x718.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-119.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><strong>Note:<\/strong> Install all of the above to mirror the demo exactly.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><\/h2>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Demo Content Import Guide<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>A) One\u2011Click Import (Recommended)<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ensure all required\/recommended plugins are <strong>active<\/strong>.<br><\/li>\n\n\n\n<li>Go to <em>Tools \u2192 Demo Content Install<\/em> (or <em>Plugins \u2192 WpWax Demo Importer \u2192 Install Demo Contents<\/em>).<br><\/li>\n\n\n\n<li>Click <strong>Install<\/strong> and wait for completion.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"531\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120-1024x531.png\" alt=\"\" class=\"wp-image-369104\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120-1024x531.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120-300x156.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120-768x398.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120-1536x797.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-120.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Flush Permalinks:<\/strong> <em>Settings \u2192 Permalinks \u2192 Select \u201cPost name\u201d \u2192 Save<\/em>.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"682\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121-1024x682.png\" alt=\"\" class=\"wp-image-369105\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121-1024x682.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121-300x200.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121-768x512.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121-1536x1023.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-121.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>B) If Installation Fails<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>This is usually hosting\u2011level timeouts\/limits. Try:<br>\n<ul class=\"wp-block-list\">\n<li>Increase PHP limits (memory_limit, max_execution_time, upload_max_filesize, post_max_size).<br><\/li>\n\n\n\n<li>Clear browser\/server caches and retry.<br><\/li>\n\n\n\n<li>Use a fresh site (import <strong>overwrites<\/strong> existing data).<br><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Fallback (Manual Import):<\/strong> Use the <strong>One Click Demo Import<\/strong> plugin to import content.xml, widgets.wie, customize.dat; then paste the additional settings via <em>Directorist \u2192 Settings \u2192 Import\/Export \u2192 Import<\/em>.<br><\/li>\n\n\n\n<li>Still stuck? Open a ticket with hosting or contact theme support (see <strong>Contact<\/strong>).<br><\/li>\n<\/ul>\n\n\n\n<p><strong>Warning:<\/strong> Demo import <strong>replaces<\/strong> content\/settings. Use only on new sites.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Listing Setup<\/strong><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Run Directorist Setup:<\/strong> <em>Directorist \u2192 Setup Wizard<\/em> to create essential pages and defaults. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>General Pages:<\/strong> Verify <em>Directory Listings \u2192 Settings \u2192 Pages, Links &amp; Views<\/em> are mapped (Add Listing, All Listings, Dashboard, Search, etc.). All Pages should be mapped perfectly. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>Monetization:<\/strong> Install <strong>Pricing Plans<\/strong> (WooCommerce or built\u2011in), configure plans and checkout pages. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>Maps:<\/strong> Install <strong>Listings with Map<\/strong>, add API keys (Google Maps\/Mapbox) under <em>Directorist \u2192 Settings<\/em>. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>Booking\/Appointment:<\/strong> Install <strong>Booking<\/strong> and configure availability calendars and slots. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>CSV Import (Migration):<\/strong> <em>Directory Listings \u2192 Settings \u2192 Tools \u2192 Listings Import<\/em> to bulk import listings from CSV. [Directorist Core Doc link]<br><\/li>\n\n\n\n<li><strong>Email &amp; Auth:<\/strong> Configure <strong>Social Login<\/strong> and <strong>email templates<\/strong> for submissions, approvals, expirations. [Directorist Core Doc link]<br><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Appearance Settings<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Customization<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Colors:<\/strong> <em>Appearance \u2192 Theme Options \u2192 Colors<\/em>. Choose preset or primary color and component colors.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"740\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122-1024x740.png\" alt=\"\" class=\"wp-image-369106\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122-1024x740.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122-300x217.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122-768x555.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122-1536x1111.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-122.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Logo &amp; Site Identity:<\/strong> <em>Appearance \u2192 Customize \u2192 Site Identity<\/em>. Upload logo, set <strong>Site Icon<\/strong> (favicon).<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"900\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-123-1024x900.png\" alt=\"\" class=\"wp-image-369107\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-123-1024x900.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-123-300x264.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-123-768x675.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-123.png 1204w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Preloader:<\/strong> <em>Theme Options \u2192 General<\/em>. Enable\/disable; upload transparent GIF if custom.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"496\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124-1024x496.png\" alt=\"\" class=\"wp-image-369108\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124-1024x496.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124-300x145.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124-768x372.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124-1536x744.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-124.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Typography:<\/strong> <em>Theme Options \u2192 Typography<\/em>. Set body and heading fonts\/sizes.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"383\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125-1024x383.png\" alt=\"\" class=\"wp-image-369110\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125-1024x383.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125-300x112.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125-768x288.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125-1536x575.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-125.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Menu<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Create menus at <em>Appearance \u2192 Menus<\/em>. Assign <strong>Primary<\/strong> location.<br><\/li>\n\n\n\n<li><strong>Multi\u2011Column Menu:<\/strong> Please select the Menu Parent and Menu Order to manage the multi column menu properly.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"687\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126-1024x687.png\" alt=\"\" class=\"wp-image-369111\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126-1024x687.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126-300x201.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126-768x515.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126-1536x1030.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-126.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Widgets<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Footer widget areas are available under <em>Appearance \u2192 Widgets<\/em>. Drag widgets to the desired footer columns.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"499\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127-1024x499.png\" alt=\"\" class=\"wp-image-369112\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127-1024x499.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127-300x146.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127-768x374.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127-1536x749.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-127.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Theme Options (explain all major tabs)<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>General:<\/strong> Preloader toggle and you can upload a custom preloader gif image.<br><\/li>\n\n\n\n<li><strong>Header:<\/strong> Choose header layout; toggle Header Search, Account, &#8220;Add Listing&#8221; button; configure global Banner (can be overridden per page).<br><\/li>\n\n\n\n<li><strong>Layout Defaults:<\/strong> Set container width, sidebar positions, banner visibility, page\/blog\/post defaults.<br><\/li>\n\n\n\n<li><strong>Blog Settings:<\/strong> Configure archives (layout, meta, excerpt, read\u2011more).<br><\/li>\n\n\n\n<li><strong>Post Settings:<\/strong> Configure single posts (featured image, meta visibility, next\/prev).<br><\/li>\n\n\n\n<li><strong>Error Page Settings:<\/strong> Customize the 404 page (title, message, button).<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"743\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128-1024x743.png\" alt=\"\" class=\"wp-image-369113\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128-1024x743.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128-300x218.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128-768x557.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128-1536x1115.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/10\/image-128.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Builder Settings (Directory Builder)<\/strong><\/h2>\n\n\n\n<p>Configure under <em>Directory Listings \u2192 Directory Builder<\/em>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Add Listing (Form Builder)<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Drag &amp; drop default and <strong>Custom Fields<\/strong> into the <strong>Active Fields<\/strong> area.<br><\/li>\n\n\n\n<li>Mark fields <strong>Required<\/strong>, set visibility, placeholders, validation, and conditional logic (where applicable).<br><\/li>\n\n\n\n<li><strong>Tip:<\/strong> To display a <strong>custom field<\/strong> on the single listing page, also add that field to <strong>Single Page Layout \u2192 Content<\/strong> (see below).<br><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>All Listings (Archive \/ Card Layout)<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Customize <strong>All Listing Grid<\/strong> and <strong>List<\/strong> card designs under <strong>All Listing Layout<\/strong>.<br><\/li>\n\n\n\n<li>Add\/remove card elements (thumbnail, title, rating, price, categories, location, favorite, badges).<br><\/li>\n\n\n\n<li>Configure the order and visibility per view for consistent UX.<br><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Single Listing (Detail Page)<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>In <em>Settings \u2192 Personalization<\/em>, you may choose the <strong>Directorist Custom<\/strong> template for Single Listings.<br><\/li>\n\n\n\n<li>In <strong>Single Page Layout<\/strong>, arrange <strong>Header<\/strong>, <strong>Content<\/strong> (sections like Description, Gallery, Video, Amenities, Map, Reviews, Author, Contact), and <strong>Sidebar<\/strong> blocks.<br><\/li>\n\n\n\n<li>Surface any <strong>Custom Fields<\/strong> needed in the <strong>Content<\/strong> section.<br><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Search Form<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Build <strong>Basic<\/strong> and <strong>Advanced<\/strong> search forms under <strong>Search Forms<\/strong>.<br><\/li>\n\n\n\n<li>The <em>Basic<\/em> bar can include multiple fields (not just Text\/Category\/Location).<br><\/li>\n\n\n\n<li>Add field groups (price range, tags, custom meta) and ordering.<br><\/li>\n\n\n\n<li>Keep Basic minimal and push refinements into Advanced for speed.<br><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Explain Child Theme<\/strong><\/h2>\n\n\n\n<p>Using a <strong>child theme<\/strong> preserves your customizations during parent theme updates.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Option 1 \u2014 Use the packaged child (if provided)<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Upload onelisting-pro-child.zip via <em>Appearance \u2192 Themes \u2192 Add New \u2192 Upload<\/em>.<br><\/li>\n\n\n\n<li>Activate <strong>onelisting-pro Child<\/strong>.<br><\/li>\n\n\n\n<li>Keep the parent <strong>onelisting-pro<\/strong> installed (not active). Your edits go into the child theme.<br><\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Option 2 \u2014 Create a child theme manually<\/strong><\/h3>\n\n\n\n<p><strong>\/wp-content\/themes\/onelisting-pro-child\/style.css<\/strong><\/p>\n\n\n\n<p>\/*<\/p>\n\n\n\n<p>&nbsp;Theme Name: onelisting-pro Child<\/p>\n\n\n\n<p>&nbsp;Template: onelisting-pro<\/p>\n\n\n\n<p>&nbsp;Text Domain: onelisting-pro-child<\/p>\n\n\n\n<p>*\/<\/p>\n\n\n\n<p><strong>\/wp-content\/themes\/onelisting-pro-child\/functions.php<\/strong><\/p>\n\n\n\n<p>&lt;?php<\/p>\n\n\n\n<p>add_action(&#8216;wp_enqueue_scripts&#8217;, function () {<\/p>\n\n\n\n<p>&nbsp;&nbsp;&nbsp;&nbsp;\/\/ Load parent and then child style<\/p>\n\n\n\n<p>&nbsp;&nbsp;&nbsp;&nbsp;wp_enqueue_style(&#8216;parent-style&#8217;, get_template_directory_uri() . &#8216;\/style.css&#8217;);<\/p>\n\n\n\n<p>&nbsp;&nbsp;&nbsp;&nbsp;wp_enqueue_style(&#8216;child-style&#8217;, get_stylesheet_uri(), [&#8216;parent-style&#8217;], wp_get_theme()-&gt;get(&#8216;Version&#8217;));<\/p>\n\n\n\n<p>});<\/p>\n\n\n\n<p>Zip the onelisting-pro-child folder and upload via <em>Appearance \u2192 Themes \u2192 Add New \u2192 Upload<\/em>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Option 3 \u2014 WP\u2011CLI<\/strong><\/h3>\n\n\n\n<p>wp scaffold child-theme onelisting-pro-child &#8211;parent_theme=onelisting-pro<\/p>\n\n\n\n<p><strong>Where to customize?<\/strong> Add templates, CSS\/JS, and snippets to the child theme. Avoid editing the parent theme directly. Follow Directorist Customization Guide.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Translating Theme<\/strong><\/h2>\n\n\n\n<p>Use <strong>Loco Translate<\/strong> to localize:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Install &amp; activate <strong>Loco Translate<\/strong>.<br><\/li>\n\n\n\n<li><em>Loco Translate \u2192 Themes \u2192 onelisting-pro<\/em> \u2192 <strong>New language<\/strong> \u2192 choose language and location (<strong>System<\/strong>).<br><\/li>\n\n\n\n<li>Click <strong>Sync<\/strong> once, then translate strings.<br><\/li>\n\n\n\n<li>Repeat for <strong>Plugins<\/strong> (Directorist + installed extensions) to translate interface strings across the site.<br><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Updating Theme<\/strong><\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Backup first<\/strong> (theme, plugins, database).<br><\/li>\n\n\n\n<li><strong>Update via Upload (easiest):<\/strong> <em>Appearance \u2192 Themes \u2192 Add New \u2192 Upload<\/em> \u2192 select new zip \u2192 <strong>Install<\/strong> \u2192 <strong>Replace current with uploaded<\/strong>.<br><\/li>\n\n\n\n<li><strong>Or via FTP:<\/strong> delete \/wp-content\/themes\/onelisting-pro\/ and upload the new folder.<br><\/li>\n\n\n\n<li><strong>After update:<\/strong> update bundled plugins\/extensions.<br><\/li>\n\n\n\n<li><strong>Best practice:<\/strong> test updates on a <strong>staging<\/strong> copy before production.<br><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Permalink Setup (fix 404)<\/strong><\/h2>\n\n\n\n<p>If you see 404 on listings or archives:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <em>Settings \u2192 Permalinks<\/em> and click <strong>Save<\/strong> (no changes needed).<br><\/li>\n\n\n\n<li>Ensure <em>Directory Listings \u2192 Settings \u2192 Pages, Links &amp; Views<\/em> pages are properly assigned.<br><\/li>\n\n\n\n<li>If using multilingual or custom slugs, re\u2011save those settings and flush caches.<br><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Contact<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Product support:<\/strong><a href=\"https:\/\/directorist.com\/contact\/\"> https:\/\/directorist.com\/contact\/<br><\/a><\/li>\n\n\n\n<li><strong>Email (demo import issues):<\/strong> support@wpwax.com<br><\/li>\n\n\n\n<li><strong>Docs hub:<\/strong><a href=\"https:\/\/directorist.com\/documentation\/\"> https:\/\/directorist.com\/documentation\/<br><\/a><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Appendix \u2014 Troubleshooting &amp; Tips<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Demo Import stalls:<\/strong> increase PHP limits; temporarily disable security\/WAF rules; try manual import.<br><\/li>\n\n\n\n<li><strong>Maps not showing:<\/strong> add API keys and enable correct map provider and billing; check console errors.<br><\/li>\n\n\n\n<li><strong>Images look soft:<\/strong> use properly sized thumbnails; regenerate thumbnails after changing sizes.<br><\/li>\n\n\n\n<li><strong>Slow directory:<\/strong> paginate archives; limit heavy widgets on the homepage; cache pages and enable object caching.<br><\/li>\n\n\n\n<li><strong>Search UX:<\/strong> keep Basic search lean (3\u20135 fields); move filters to Advanced; use icons sparingly on cards.<br><\/li>\n\n\n\n<li><strong>GDPR\/Privacy:<\/strong> enable consent checkboxes on forms; update Privacy Policy.<br><\/li>\n\n\n\n<li><strong>Child theme strategy:<\/strong> all template overrides and CSS belong in the child theme to survive updates.<br><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Applies to: OneListing-Pro (premium). For the free OneListing theme, most steps are similar but some features\/extensions are not included. Quickstart (10 minutes) Getting Started with Themes onelisting-pro is a general\u2011purpose directory theme for Directorist. It ships with a modern design, Elementor compatibility, and pre\u2011built directory layouts. The theme relies on the Directorist plugin and optionally [&hellip;]<\/p>\n","protected":false},"author":24585,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[695],"doc_tag":[],"class_list":["post-369095","docs","type-docs","status-publish","hentry","doc_category-themes"],"year_month":"2026-03","word_count":1485,"total_views":"0","reactions":{"happy":"0","normal":"0","sad":"1"},"author_info":{"name":"yousuf.sovware","author_nicename":"yousuf-sovware","author_url":"https:\/\/directorist.com\/author\/yousuf-sovware\/"},"doc_category_info":[{"term_name":"Themes","term_url":"https:\/\/directorist.com\/docs-category\/themes\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/369095","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/users\/24585"}],"replies":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/comments?post=369095"}],"version-history":[{"count":0,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/369095\/revisions"}],"wp:attachment":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/media?parent=369095"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_category?post=369095"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_tag?post=369095"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}