-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
107 lines (75 loc) · 4.55 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
=== Mapple ===
Contributors: andrekelling
Donate link: https://andrekelling.de/
Tags: google maps, client cpt, shortcode, no jquery, no style
Requires at least: 4.7
Tested up to: 4.9.5
Stable tag: 1.5.2
Requires PHP: 7.0
License: GPLv3.0 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
To show a google map with the locations of your clients. You can output additionally a sorted listing table of all your clients. Just with shortcodes.
== Description ==
This plugin is for showing your clients.
You can output a google map with markers and a table as a list of all clients.
You can tag clients and show a search and filter bar.
This Plugin does not need jQuery on the FrontEnd!
The google map is centered shown to all markers added. Markers got little Infowindows with client's name, website and address.
Map style and marker image customisation is possible.
A few notes about technical things:
* provides a new custom post type `clients`
* map functionality works over the REST_API
* the limit of fetched `clients` posts is unset. Beware of the risk fetching too much!!! (proper limitation feature is planned)
### Shortcodes
* `[mapple_map]` will create the google map with marker
* `[mapple_clients]` will create a table with all clients
There are a few possible attributes you can provide to your `mapple_clients` shortcode.
Here a full example with all possible options:
`[mapple_clients title-name="Name" title-address="Adresse" title-desc="Beschreibung" title-tags="Branche" title-search="Suche" title-search-placeholder="lostippen..." title-filter-label="Nach Branche filtern" with-tags="true" with-search="true"]`
all `title-` attributes are for customising wordings.
`[mapple_clients title-name="Name" title-address="Adresse" title-desc="Beschreibung" title-tags="Branche" title-search="Suche" title-search-placeholder="lostippen..." title-filter-label="Nach Branche filtern"]`
all `with-` attributes activate the tags coloumn, and filter when search is also active.
`[mapple_clients with-tags="true" with-search="true"]`
### Credit
* Plugin banner image taken from <a href="https://unsplash.com/@rawpixel?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from rawpixel">rawpixel</a>
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/plugin-name` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the Clients->Settings screen to configure the plugin. Get a Google Maps API key and enter on this plugin's settings page.
== Frequently Asked Questions ==
= Why my images aren't loaded in the google map infobox? =
If you have a JS error in your browser console that a GET request to the REST API of an media item failed.
It might be that your requested image is WP internally connected to another post with another post-type which isn't open for REST requests.
You can follow this guide for success: <a href="https://scottbolinger.com/custom-post-types-wp-api-v2/" target="_blank" rel="noopener noreferrer" title="Guide to allow REST support">https://scottbolinger.com/custom-post-types-wp-api-v2/</a>
== Screenshots ==
1. Output of Map and Table on the Front End. In between some text. You can place your shortcodes around.
2. custom styled Map with open infowindow
3. New custom clients Post Type with address autocompletion
4. Enable search and filter section for clients in the table
== Changelog ==
= 1.5.2 =
* fix google map infobox not opening if media request fails
* add broken image for failed media request in infobox
= 1.5.1 =
* remove default 10 post entries limit from table and map
= 1.5.0 =
* enable google maps marker image customisation
* fix infowindow opening when thumbnail image size missing
* remove nowrap style from table title column
= 1.4.1 =
* fix JS error appearing on pages without mapple_clients table output
= 1.4.0 =
* enable google maps style customisation
* remove unused `php_vars` from wp_localize_script
= 1.3.0 =
* enable shortcode attribute `title-filter-label` to customise tag filter label
* enable cpt clients featured image to get used in maps info window
= 1.2.0 =
* fix to show just the tags used by custom post type clients and not all
= 1.1.0 =
* enable tag's for custom post type "clients"
* add optional show tag's column in clients table
* add optional search and filter section for clients table
* enable shortcode attributes to customise table headings
= 1.0.0 =
* Initial version