{"id":363187,"date":"2025-09-28T11:28:23","date_gmt":"2025-09-28T05:28:23","guid":{"rendered":"https:\/\/directorist.com\/?post_type=docs&#038;p=363187"},"modified":"2025-09-28T11:28:23","modified_gmt":"2025-09-28T05:28:23","password":"","slug":"listings-with-map","status":"publish","type":"docs","link":"https:\/\/directorist.com\/docs\/listings-with-map\/","title":{"rendered":"Listings with Map"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\"><strong>Overview<\/strong><\/h2>\n\n\n\n<p>The Listings with Map extension adds a new layout view for directory and search results pages, allowing visitors to browse listings and view them on an interactive map side by side. The listings and advanced search filters are shown on the left, while the map with dynamic markers appears on the right.<\/p>\n\n\n\n<p>This layout is ideal for location-based directories, such as real estate, hotels, restaurants, travel services, or any business where users need to explore listings by location. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Key Features\u00a0<\/strong> <\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Display listings and interactive map side by side in a single layout.<\/li>\n\n\n\n<li>Built-in shortcode for flexible placement with adjustable parameters.<\/li>\n\n\n\n<li>Choose between 2-column or 3-column layout for listings.<\/li>\n\n\n\n<li>Supports both Grid and List views for better browsing.<\/li>\n\n\n\n<li>Advanced filtering with categories, tags, locations, and more.<\/li>\n\n\n\n<li>Fully responsive and optimized for desktop and mobile. <\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Installation &amp; Configuration<\/strong> <\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to <strong>Directory Listings &gt; Themes &amp; Extensions<\/strong><\/li>\n\n\n\n<li>Find<strong> \u201cListings with Map\u201d <\/strong>and<strong> <\/strong>click<strong> Install <\/strong>and then <strong>Activate.<\/strong><\/li>\n\n\n\n<li>Navigate to <strong>Directory Listings &gt; Settings &gt; Extensions &gt; Extension General<\/strong><\/li>\n<\/ol>\n\n\n\n<p><strong>Settings Reference<\/strong> <\/p>\n\n\n\n<p><strong>1. Layout Settings<\/strong> <\/p>\n\n\n\n<ol class=\"wp-block-list\"><\/ol>\n\n\n\n<p>Columns: Choose between 2-column or 3-column layout for displaying listings next to the map.<\/p>\n\n\n\n<p><strong>2. Listing Settings<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Default View: Choose how listings should be displayed (Grid or List view).<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Display <strong>\u201cView As\u201d <\/strong>Dropdown: Toggle visibility of the \u201cView As\u201d option on the All Listings page.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Display <strong>\u201cSort By\u201d <\/strong>Dropdown: Toggle visibility of the \u201cSort By\u201d option to allow sorting by title, date, or price.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"438\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86-1024x438.png\" alt=\"\" class=\"wp-image-363213\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86-1024x438.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86-300x128.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86-768x328.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86-1536x657.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-86.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><strong>Shortcode Setup<\/strong> <\/p>\n\n\n\n<p>The extension comes with a dedicated shortcode for flexible placement:<\/p>\n\n\n\n<p><strong>[directorist_all_listing view=&#8221;listings_with_map&#8221; map_height=&#8221;800&#8243;]<\/strong> <\/p>\n\n\n\n<p><strong>Supported Parameters (Inherited from All Listings)<\/strong> <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Directory_type<\/strong>: Filter by directory type slug.<\/li>\n\n\n\n<li><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; directory_type=&#8221;business&#8221;]<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"428\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87-1024x428.png\" alt=\"\" class=\"wp-image-363214\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87-1024x428.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87-300x125.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87-768x321.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87-1536x642.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-87.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>orderby<\/strong>: Sort by title, date, rand, or price.<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; orderby=&#8221;date&#8221;]<br><\/li>\n\n\n\n<li><strong>order<\/strong>: asc or desc (default: desc).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; order=&#8221;asc&#8221;]<br><\/li>\n\n\n\n<li><strong>listings_per_page<\/strong>: Set number of listings per page.<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; listings_per_page=&#8221;6&#8243;]<br><\/li>\n\n\n\n<li><strong>category<\/strong>: Filter by category slugs (comma-separated).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; category=&#8221;buffet, cafe&#8221;]<br><\/li>\n\n\n\n<li><strong>tag<\/strong>: Filter by tag slugs (comma-separated).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; tag=&#8221;italian, seafood&#8221;]<br><\/li>\n\n\n\n<li><strong>location<\/strong>: Filter by location slugs (comma-separated).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; location=&#8221;japan&#8221;]<br><\/li>\n\n\n\n<li><strong>ids<\/strong>: Display listings by IDs.<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; ids=&#8221;1,2,5&#8243;]<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>featured_only<\/strong>: Show only featured listings (yes\/no).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; featured_only=&#8221;yes&#8221;]<br><\/li>\n\n\n\n<li><strong>popular_only<\/strong>: Show only popular listings (yes\/no).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; popular_only=&#8221;yes&#8221;]<br><\/li>\n\n\n\n<li><strong>logged_in_user_only<\/strong>: Restrict listings to logged-in users (yes\/no).<br><strong>Shortcode:<\/strong><\/li>\n<\/ul>\n\n\n\n<p>[directorist_all_listing view=&#8221;listings_with_map&#8221; logged_in_user_only=&#8221;yes&#8221;]<br><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>redirect_page_url<\/strong>: Redirect listings page to another URL.<br><strong>Shortcode:<\/strong>\u00a0<\/li>\n<\/ul>\n\n\n\n<p>[directorist_all_listing view=&#8221;listings_with_map&#8221; redirect_page_url=&#8221;https:\/\/www.example.com&#8221;]<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>header<\/strong>: Show or hide the header area (yes\/no).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; header=&#8221;no&#8221;]<br><\/li>\n\n\n\n<li><strong>display_preview_image<\/strong>: Show or hide listing preview images (yes\/no).<br><strong>Shortcode:<\/strong>\u00a0<\/li>\n<\/ul>\n\n\n\n<p>[directorist_all_listing view=&#8221;listings_with_map&#8221; display_preview_image=&#8221;yes&#8221;]<br><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>show_pagination<\/strong>: Enable or disable pagination (yes\/no).<br><strong>Shortcode:<\/strong> [directorist_all_listing view=&#8221;listings_with_map&#8221; show_pagination=&#8221;no&#8221;]<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Frontend Preview of Business Hours<\/strong> <\/h2>\n\n\n\n<p>After configuring the settings, the final output appears as: <\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Listings &amp; Filters on the Left<\/strong> \u2013 Users can browse listings in Grid\/List view and apply filters for categories, tags, or locations.<br><\/li>\n\n\n\n<li><strong>Map with Markers on the Right<\/strong> \u2013 An interactive map shows pins for each listing location, updating dynamically as filters are applied.    <\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"435\" src=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88-1024x435.png\" alt=\"\" class=\"wp-image-363215\" srcset=\"https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88-1024x435.png 1024w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88-300x127.png 300w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88-768x326.png 768w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88-1536x652.png 1536w, https:\/\/directorist.com\/wp-content\/uploads\/2025\/09\/image-88.png 1600w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><strong>Notes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Use the <strong>map_height<\/strong> parameter in the shortcode to adjust map height for better design consistency.<br><\/li>\n\n\n\n<li>For directories with many listings, enable pagination or filters to improve performance.<br><\/li>\n\n\n\n<li>If caching is enabled, clear the cache after configuration to ensure map markers update correctly.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Overview The Listings with Map extension adds a new layout view for directory and search results pages, allowing visitors to browse listings and view them on an interactive map side by side. The listings and advanced search filters are shown on the left, while the map with dynamic markers appears on the right. This layout [&hellip;]<\/p>\n","protected":false},"author":22343,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[694],"doc_tag":[],"class_list":["post-363187","docs","type-docs","status-publish","hentry","doc_category-extensions"],"year_month":"2026-03","word_count":644,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Fairose Farabi","author_nicename":"farabisovware","author_url":"https:\/\/directorist.com\/author\/farabisovware\/"},"doc_category_info":[{"term_name":"Extensions","term_url":"https:\/\/directorist.com\/docs-category\/extensions\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/363187","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\/22343"}],"replies":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/comments?post=363187"}],"version-history":[{"count":0,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/363187\/revisions"}],"wp:attachment":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/media?parent=363187"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_category?post=363187"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_tag?post=363187"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}