內容簡介
為什麼要使用 Simple Locator？
Simple Locator 適合開發人員尋找實現任何文章類型的位置搜尋的方法。它與其他插件不同之處在於可允許使用現有的自訂欄位作為地理位置資料來源。
沒有存在帶有經緯度座標欄位的文章類型嗎？Simple Locator 包含一個預設的「位置」文章類型，其包含經度、緯度、地址、電話號碼、網站等欄位。此文章類型的名稱和標籤可由插件設置進行配置。
Simple Locator 還提供開發人員友好的選項以添加自定義的 Google Maps 樣式。可從現有列表中選擇，使用預設樣式或添加自己的 JSON 樣式。
使用 Simple Locator
新增位置。這可以是包含經緯度座標欄位的預設「位置」文章類型或現有的自訂文章類型。也可以使用包括的 CSV 匯入工具進行批量匯入位置。
使用 Shortcode [wp_simple_locator] 或 Widget 來顯示搜尋表單。短碼提供更多的地圖和表單自定義選項。
詳細資訊請訪問locatewp.com。
重要提示：Simple Locator 要求 WordPress 版本 3.8 或更高版本，並且 PHP 版本 5.4 或更高。
更多資訊
短碼選項
顯示表單和結果的短碼為 [simple_locator]。有多個選項可用於自定義表單和結果：
distances - 一個逗號分隔的數字列表，用於自定義表單中可選擇的距離列表。預設為 5,10,20,50,100。
mapheight - 地圖高度（像素）。預設為 250。
mapcontainer - 自定義容器的唯一 ID，用於加載地圖（HTML 元素的 ID 參數）。
resultscontainer - 自定義容器的唯一 ID，用於加載搜索結果（HTML 元素的 ID 參數）。
buttontext - 提交按鈕上要顯示的文字內容。預設為「搜索」（Search）。
addresslabel - 自訂地址表單標籤
mapcontrols - 隱藏或顯示地圖控件
mapcontrolsposition - Google 地圖格式化的控件位置（例如：TOP_LEFT）
showgeobutton - 是否顯示「使用我的位置」按鈕。在不包含 https 連接的網站上會隱藏此按鈕。預設為 false。
geobuttontext - 如果顯示，自定義地理位置按鈕的文字內容。預設為「使用我的位置」（Use My Location）。
ajax - 是否使用 ajax 請求提交表單。預設為 true。
formmethod - 表單提交的方法。預設為「post」。如果使用 GET 方法進行非 AJAX 請求，必須指定結果頁面。
placeholder - 自定義搜尋輸入框的 placeholder 內容。預設為「輸入位置」（Enter a Location）
noresultstext - 自定義未返回結果時顯示的文字內容。預設為「未返回結果」（No results found）。
ajax - 要禁用 AJAX 表單提交，使用 ajax=”false”。注意：非 AJAX 表單不可使用自定義地圖/結果容器（自 v1.3.0 新增）
perpage – 與 AJAX 選項一起使用。如果非 AJAX 表單中包含 perpage 選項，則結果將顯示簡單的分頁，限制為指定的每頁數量。 （如：ajax=”false” perpage=”15″）。 AJAX 表單不支援分頁功能。
resultspage - 如果正在提交非 AJAX 表單（請參閱
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
Why use Simple Locator?
Simple locator is ideal for developers who are looking for a way to implement location search for any post type. Simple locator is different in that it allows the selection of any existing custom fields for use as the geocoded data sources.
Don’t have an existing post type with geocoded latitude and longitude fields? Simple Locator includes a default “Locations” post type with fields for latitutde, longitude, address, phone number, website, & more. This post type’s name and labels are configurable through the plugin settings.
Simple Locator also offers developer-friendly options for adding custom Google Maps styling. Select from an existing list, leave the default styles, or add your own JSON styles.
Using Simple Locator
Add locations. This can either be the included “locations” post type or an existing custom post type with existing geocoded fields. Locations can also be imported in bulk using the included CSV importer.
Use the Shortcode [wp_simple_locator] or Widget to display a search form. The shortcode offers more options for map and form customization.
For more information visit locatewp.com.
Important: Simple Locator requires WordPress version 3.8 or higher, and PHP version 5.4 or higher.
More Information
Shortcode Options
The shortcode to display the form and results is [simple_locator]. There are several options available for customizing the form and results:
distances – A comma separated list of numbers used to customize the list of available distances to choose from in the form. Defaults to 5,10,20,50,100
mapheight – The height of the map in pixels. Defaults to 250.
mapcontainer – The unique ID of a custom container in which to load the map (ID parameter of HTML element).
resultscontainer – The unique ID of a custom container in which to load the search results (ID parameter of HTML element).
buttontext – Text to display in submit button. Defaults to “Search”.
addresslabel – Customize the address form label
mapcontrols – Hide or show the map controls
mapcontrolsposition – Google Maps formatted position for map controls (ex: TOP_LEFT)
showgeobutton – Whether to show or hide the “Use My Location” button. This button is hidden on sites that do not include an https connection. Defaults to false.
geobuttontext – Customize the text content of the geolocation button if shown. Defaults to “Use My Location”.
ajax – Whether to submit the form with an ajax request. Defaults to true.
formmethod – The method of which the form submits. Default to “post”. If using a GET method with a non-ajax request, a results page must be specified.
placeholder – Customize the search input placeholder text. Defaults to “Enter a Location”
noresultstext – Customize the text displayed if no results are returned. Defaults to “No results found”.
ajax – To disable AJAX form submission, use ajax=”false”. NOTE: custom map/results containers are not available for non-AJAX forms (added in v1.3.0)
perpage – Used in conjunction with AJAX option. If a perpage option is included in a non-AJAX form, the results will be displayed with simple pagination, limited to the number per page specified. (Ex: ajax=”false” perpage=”15″). Pagination is not available with AJAX forms.
resultspage – If a non-ajax form is being submitted (see ajax option), a separate results page may be specified.
taxonomies – To include taxonomy filters in the search form, use a comma-separated list of taxonomy names/slugs. The form will include select menus for each of the taxonomies specified. (AJAX only)
taxonomy_field_type – If taxonomy fields are displayed, the field type may be either “select” or “checkbox”. Defaults to “select”.
allowemptyaddress – Set as “true” to allow empty address fields to be submitted (useful for returning all locations regardless of the user-specified location)
showall – Whether to show all locations on page load. Defaults to false.
Visit locate.wp for more detailed information.
Widget Use
Options include the title, distance options, and the map height. To use the widget outside of a predefined sidebar area, use the following function in your template, as outlined in the WordPress documentation. The widget name is SimpleLocator\Widgets\Form (must include namespaces).
Form Options
To enable Google Places autocomplete in the search form, visit Settings > Simple Locator > General, and select the “Enable Autocomplete in Search” option. Your form will now include an autocomplete dropdown populated by the Google Places API.
Singular View
By default, a map of the location is added to the content on singular views. To remove this feature, update the setting under Simple Locator > General Settings.
Extending & Customizing Map Display
A number of JavaScript functions are provided to extend and customize the map results. Visit locatewp.com for a list and usage details.
Filters
For a complete description of available filters and example usage, see the plugin website.
simple_locator_form($output, $distances, $taxonomies, $widget) – Customize the search form HTML
simple_locator_result($output, $result, $count) – Customize the result output within the result list
simple_locator_infowindow($infowindow, $result, $count) – Customize the display of results within the Google Maps infowindow
simple_locator_post_fields() – Add additional fields to the search parameters (field names for $_POST data)
simple_locator_sql_select($sql) – Add additional fields to the SELECT sql query during search
simple_locator_sql_join($sql) – Join additional fields in the sql query during search
simple_locator_sql_where($sql) – Add additional WHERE parameters to the sql query during search
simple_locator_form_in_results($display_form) – Whether to show the form in results (bool)
simple_locator_all_locations_text($text) – Filter the text output of “All Locations”
simple_locator_map_pin_single($html) – Filter the single view map pin
simple_locator_js_map_options($options) – Filter the Javascript options passed to Google Maps for map display
simple_locator_autocomplete_js_options($options) – Filter the Javascript options passed to the Google Maps Autocomplete API
simple_locator_form_taxonomies($taxonomies) – Filter the taxonomies displayed in the search form
