{"id":17826,"date":"2019-02-15T17:32:19","date_gmt":"2019-02-15T17:32:19","guid":{"rendered":"http:\/\/wp\/?page_id=17826"},"modified":"2019-04-08T10:52:20","modified_gmt":"2019-04-08T10:52:20","slug":"maps-locations","status":"publish","type":"page","link":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-locations\/","title":{"rendered":"Maps Locations"},"content":{"rendered":"\n<div class=\"w2gm-docs w2gm-docs-side\">\n<h2 id=\"directory_locations\">Maps locations<\/h2>\n<p>There are 3 ways to provide locations functionality on maps site:<\/p>\n<ol>\n<li><strong>Use predefined locations<\/strong> - this way users are able to use <a href=\"#predefined_locations\">previously defined locations<\/a> for their listings. Autocomplete on addresses fields and \"Get my location\" button on addresses fields should be <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/advanced\/#miscellaneous\">disabled<\/a>. So addresses fields will be used by users to manually fill in streets, buildings, postal codes, e.t.c. Also <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/search\/\">search by address<\/a> should be disabled in the search form. Visitors will search listings only by previously defined locations drop-down menu. Actually radius search is not necessary in this method.<\/li>\n<li><strong>Use addresses fields<\/strong> - do not need to insert predefined locations. Users will use only addresses fields, <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/advanced\/#miscellaneous\">autocomplete function<\/a> and \"Get my location\" button on addresses fields can help them. Listings addresses fields (address line 1, address line 2, zip code) should contain whole information about country, state, city, region, streets, buildings, postal codes e.t.c. To get correct search results with nearby locations it is quite recommended to enable search by radius and set up default radius value in the <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/search\/\">search settings<\/a>.<\/li>\n<li><strong>Both methods<\/strong> <em>(default)<\/em> - usage of predefined locations + addresses fields. But in this case information in addresses fields may contain country, state, city, region, the same as selected predefined locations. It is recommended to exclude <a href=\"#locations_levels\">locations levels<\/a> from address line.<\/li>\n<\/ol>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-content\/uploads\/locations_search_options.png\" alt=\"\" width=\"867\" height=\"211\" class=\"alignnone size-full wp-image-18160\" \/><\/p>\n<p>Some additional explanation about plugin search engine and its fields <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/search\">here<\/a>.<\/p>\n<h3 id=\"predefined_locations\">Predefined locations<\/h3>\n<p>Site admin may create\/edit\/delete special predefined locations items. Management of directory locations tree has exactly the same functionality as standard WordPress categories, but these are separate items and have special administration page \"<em>Maps listings -&gt; Maps locations<\/em>\"<\/p>\n<p><i class=\"fa fa-star\"><\/i> Custom icons may be associated with maps locations displaying in the search form dropdown. Default icons files place in \"<em>resources\/images\/locations_icons\/<\/em>\" folder of the plugin. Site administrator can upload custom icons into \"<em>w2dc-plugin\/resources\/images\/locations_icons\/<\/em>\" folder of your child theme via the Files manager of hosting control panel or via FTP.<br \/>\n<i class=\"fa fa-exclamation-triangle\"><\/i> The plugin uses only one folder for icons: native folder or custom folder in your child theme when exists.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-content\/uploads\/location_icons.png\" alt=\"\" width=\"828\" height=\"95\" class=\"alignnone size-full wp-image-18161\" \/><\/p>\n<p>After <a href=\"#locations_levels\">locations levels<\/a> were successfully configured and locations tree completed - users may select any predefined location from select boxes group on create\/edit listing page.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-content\/uploads\/predefined_locations.png\" alt=\"\" width=\"640\" height=\"147\" class=\"alignnone size-full wp-image-18162\" \/><\/p>\n<p><i class=\"fa fa-star\"><\/i> <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/listings\/\">Listings<\/a> have an option to allow users to select more than 1 location for each listing.<\/p>\n<h3 id=\"locations_levels\">Locations levels<\/h3>\n<p>Just in some words, locations levels - these are names of nesting levels of directory locations tree. By default there are 3 locations levels: <strong>Country, State and City<\/strong>. Site admin can manage locations levels and exclude any of them from address strings.<\/p>\n<p>When your maps site will be used locally, for example, for visitors from one country or one state\/region - do not delete unnecessary locations levels and predefined locations, they are required to set correct location point at the Google map during listings creation\/edition. You can just exclude needed locations levels from address line - there is such option for each locations level, it allows to build custom address line at the frontend. See examples:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-content\/uploads\/locations_levels_addresses.png\" alt=\"\" width=\"449\" height=\"129\" class=\"alignnone size-full wp-image-18163\" \/><\/p>\n<p>Also when you set up local maps site - it is recommended to fill in \"<em>Default country\/state for correct geocoding<\/em>\" <a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/maps-addresses\/\">setting<\/a>.\n<\/div>\n<div class=\"w2gm-theme-sticky\">\r\n<h4 class=\"w2gm-table-of-contents-heading\">Table of Contents<\/h4>\r\n<ul class=\"w2gm-table-of-contents\">\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/\">Installation<\/a>\r\n<ul>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/demo-content\/\">Demo data import<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/update\/\">Plugin update<\/a><\/li>\r\n<\/ul>\r\n<\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/\">Maps management<\/a>\r\n<ul>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/settings\/\">Map settings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/ajax-loading\/\">Map AJAX loading<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/starting-point\/\">Map starting point and radius<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/controls\/\">Map controls<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/listings-sidebar\/\">Listings sidebar<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/search\/\">Search options<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-management\/markers\/\">Markers to display<\/a><\/li>\r\n<\/ul>\r\n<\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-listings\/\">Listings management<\/a>\r\n<ul>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-categories\/\">Maps categories<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps-locations\/\">Maps locations<\/a><\/li>\r\n<\/ul>\r\n<\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/\">Maps settings<\/a>\r\n<ul>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/frontend-submission\/\">Frontend submission<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/claim\/\">Claim Functionality<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/listings\/\">Listings settings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/listings-logos-images\/\">Listings logos & images<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/ratings\/\">Ratings settings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/search\/\">Search settings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/maps-addresses\/\">Maps & Addresses<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/email-notifications\/\">Email notifications<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/advanced\/\">Advanced settings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/settings\/customization\/\">Customization<\/a><\/li>\r\n<\/ul>\r\n<\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/content-fields\/\">Content fields<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/search\/\">Search form<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/sorting-of-listings\/\">Sorting of listings<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/maps\/\">Maps & Markers Icons<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/google-maps-keys\/\">Google API keys<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/frontend\/\">Frontend submission & dashboard<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/widgets\/\">Widgets<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/customization\/\">Customization styles & templates<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/change-texts\/\">How to modify texts<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/translation\/\">Translation<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/import\/\">CSV Import<\/a><\/li>\r\n\t<li><a href=\"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/documentation\/troubleshooting\/\">Troubleshooting<\/a><\/li>\r\n<\/ul>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Maps locations There are 3 ways to provide locations functionality on maps site: Use predefined locations - this way users are able to use previously defined locations for their listings. Autocomplete on addresses fields and \"Get my location\" button on addresses fields should be disabled. So addresses fields will be used by users to manually [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":7212,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-17826","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/pages\/17826","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/comments?post=17826"}],"version-history":[{"count":1,"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/pages\/17826\/revisions"}],"predecessor-version":[{"id":18288,"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/pages\/17826\/revisions\/18288"}],"up":[{"embeddable":true,"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/pages\/7212"}],"wp:attachment":[{"href":"https:\/\/www.salephpscripts.com\/wordpress_maps\/demo\/wp-json\/wp\/v2\/media?parent=17826"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}