{"id":778,"date":"2025-03-24T14:27:39","date_gmt":"2025-03-24T14:27:39","guid":{"rendered":"https:\/\/wpgeodirectory.com\/documentation\/article\/gd-locations\/"},"modified":"2025-04-03T15:24:00","modified_gmt":"2025-04-03T14:24:00","slug":"gd-locations","status":"publish","type":"gd_place","link":"https:\/\/wpgeodirectory.com\/documentation\/article\/location-manager\/gd-locations\/","title":{"rendered":"GD > Locations"},"content":{"rendered":"\n<div class=\"wp-block-blockstrap-blockstrap-widget-alert d-flex align-items-center fade show alert alert-success mb-3\" role=\"alert\"><span class=\"fas fa-check-circle me-2\"><\/span><span class=\"flex-grow-1\">All Widgets come as Widgets, Shortcodes or Blocks. Learn more about our <a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-widgets\/what-makes-geodirectory-widgets-special\/\">Super Duper Widgets<\/a>.<\/span><\/div>\n\n\n\n<p>The <strong>&nbsp;Locations widget<\/strong>&nbsp;displays locations currently in your database such as<strong> Countries, Regions, Cities or Neighborhoods<\/strong>. The widget can show a location type such as &#8220;cities&#8221; <strong>relevant to the current Country or Region<\/strong> being viewed or this <strong>can be manually filtered<\/strong> in the settings to show specific locations.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Widget Options<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Title<\/strong> <strong>&#8211;<\/strong> The title for the widget.<\/li>\n\n\n\n<li><strong>Show Locations &#8211; <\/strong>Select which locations to be shown in the list (default is Cities).<\/li>\n\n\n\n<li><strong>Output Type (<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong>Select whether to display the locations as a list or an image grid.<\/li>\n\n\n\n<li><strong>Number of Locations &#8211; <\/strong>Select the number of locations to be shown.<\/li>\n\n\n\n<li><strong>Show Pagination on Top (Checkbox) <strong>(<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong><\/strong>If checked, pagination options will appear at the top.<\/li>\n\n\n\n<li><strong>Show Pagination at Bottom <strong>(Checkbox) (<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong><\/strong>If checked, pagination options will appear at the bottom.<\/li>\n\n\n\n<li><strong>Show Advanced Pagination Details <strong>(<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong><\/strong>This option will display advanced pagination info after the pagination (such as &#8220;Showing Page X of Y&#8221;). <\/li>\n\n\n\n<li><strong>Disable Location Filter? (Checkbox) &#8211; <\/strong>If checked, the Location Filter will be disabled.<\/li>\n\n\n\n<li><strong>Show Current Location Only (Checkbox) &#8211; <\/strong>If checked, only the current location will be displayed.\u00a0 <strong><br><\/strong><\/li>\n\n\n\n<li><strong>Country Slug <strong>(<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong><\/strong>Filters the locations by country slug when Location Filter is enabled.<\/li>\n\n\n\n<li><strong>Region Slug <strong>(<a href=\"https:\/\/wpgeodirectory.com\/documentation\/article\/core-features\/hidden-advanced-settings\/\">A<\/a>) &#8211; <\/strong><\/strong>Filters the locations by region slug when Location Filter is enabled.\u00a0<\/li>\n\n\n\n<li><strong>Show\/Hide Options (Widget only) &#8211; <\/strong>Choose where the widget should be displayed. <strong><br><\/strong><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Example Output<\/h2>\n\n\n\n<p>Sample output, with cities being shown as <strong>image grid: <\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/wpgeodirectory.com\/documentation\/wp-content\/uploads\/2025\/03\/file-iDEKsbrRQQ.png\" alt=\"\"\/><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The &nbsp;Locations widget&nbsp;displays locations currently in your database such as Countries, Regions, Cities or Neighborhoods. The widget can show a location type such as &#8220;cities&#8221; relevant to the current Country or Region being viewed or this can be manually filtered in the settings to show specific locations. Widget Options Example Output Sample output, with cities [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"article\/tags":[],"article\/categories":[213,425],"class_list":["post-778","gd_place","type-gd_place","status-publish","hentry","gd_placecategory-extensions-features","gd_placecategory-location-manager"],"_links":{"self":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/778","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/types\/gd_place"}],"author":[{"embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/comments?post=778"}],"version-history":[{"count":0,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/778\/revisions"}],"wp:attachment":[{"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/media?parent=778"}],"wp:term":[{"taxonomy":"gd_place_tags","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/tags?post=778"},{"taxonomy":"gd_placecategory","embeddable":true,"href":"https:\/\/wpgeodirectory.com\/documentation\/wp-json\/wp\/v2\/article\/categories?post=778"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}