Matthew Boynes

<p>This plugin adds a store/location directory to your WordPress site. Once you add stores, you can add the Store Search widget to your widget area or you can add the form to your theme manually.</p>
<p>This plugin is intentionally light and simple. It’s very flexible and is intended to be something on which you can build.</p>
<h3>Filters</h3>
<h4>wpsd_radius_options</h4>
<p>Param: <code>array( 5, 10, 25, 50, 100 )</code></p>
<p>This filter allows you to modify the options in the radius dropdown in the store search form. Values are in miles by default.</p>
<h4>wpsd_register_post_type</h4>
<p>Param: <code>true</code></p>
<p>This filter allows you to disable the <code>store</code> post type altogether. To do so, simply add <code>add_filter( 'wpsd_register_post_type', '__return_false' )</code> to your theme or plugin.</p>
<h4>wpsd_post_type_args</h4>
<p>This filter gives you the ability to modify the arguments passed to <code>register_post_type()</code> for the ‘store’ post type. See <a href="https://codex.wordpress.org/Function_Reference/register_post_type" rel="nofollow ugc">register_post_type in the Codex</a> for valid arguments and values.</p>
<p>Param:</p>
<pre><code>array(
    'public'      => true,
    'has_archive' => true,
    'supports'    => array( 'title' ),
    'labels'      => array(
        'name'                => __( 'Stores', 'store-directory' ),
        'singular_name'       => __( 'Store', 'store-directory' ),
        'all_items'           => __( 'Stores', 'store-directory' ),
        'new_item'            => __( 'New store', 'store-directory' ),
        'add_new'             => __( 'Add New', 'store-directory' ),
        'add_new_item'        => __( 'Add New store', 'store-directory' ),
        'edit_item'           => __( 'Edit store', 'store-directory' ),
        'view_item'           => __( 'View store', 'store-directory' ),
        'search_items'        => __( 'Search stores', 'store-directory' ),
        'not_found'           => __( 'No stores found', 'store-directory' ),
        'not_found_in_trash'  => __( 'No stores found in trash', 'store-directory' ),
        'parent_item_colon'   => __( 'Parent store', 'store-directory' ),
        'menu_name'           => __( 'Stores', 'store-directory' ),
    )
)
</code></pre>
<h4>wpsd_automap</h4>
<p>Param: <code>true</code></p>
<p>By default, a Google Map is added to the store archive views and store singular views using the <code>'loop_start'</code> action. This may not be desirable in all circumstances, especially if you loop through your posts multiple times. To disable this, add <code>add_filter( 'wpsd_automap', '__return_false' )</code> to your theme or plugin. If you choose to disable this, see the <code>wpsd_the_map()</code> tempalte tag to manually display the map.</p>
<h4>wpsd_mappable_data</h4>
<p>Param:</p>
<pre><code>array(
    'name'      => $post->post_title,
    'address'   => get_post_meta( $post->ID, 'address', true ),
    'latitude'  => $post->latitude,
    'longitude' => $post->longitude,
    'distance'  => $post->distance
)
</code></pre>
<p>Param: <code>$post</code></p>
<p>This filter allows you to customize the data used in the map. There is also a javascript “hook” that works in tandem with this, <code>wpsd_custom_create_marker</code>. To use the data you pass through the <code>wpsd_mappable_data</code> filter, you need to define a javascript function, <code>wpsd_custom_create_marker( latlng, data )</code>. This function should take two params, where the first is a <code>google.maps.LatLng</code> object and the second is an object with your filtered data. Armed with this data, you can create the marker however you need! See <code>js/maps.js:wpsd_create_marker()</code> for an example of how to create a marker.</p>
<h3>Template Tags</h3>
<h4>wpsd_the_store_search_form()</h4>
<p>Output the store search form. If you choose not to use the provided widget, this lets you add the form wherever you’d like.</p>
<h4>wpsd_the_map()</h4>
<p>Param: <code>$posts</code> array An array of posts to map. Each entry in the array should contain the following keys:</p>
<ul>
<li><code>'name' =></code> The marker title.</li>
<li><code>'address' =></code> The marker address.</li>
<li><code>'latitude' =></code> The latitude of the point.</li>
<li><code>'longitude' =></code> The longitude of the point.</li>
<li><code>'distance' =></code> The distance of the point from the center (optional, not presently used).</li>
</ul>
<p>See <code>WPSD_Search::get_mappable_data()</code> for an example.</p>
<p>Param: <code>$lat</code> float The latitude of the center point for the map.<br />
Param: <code>$long</code> float The longitude of the center point for the map.</p>
<p>Output a Google Map with the given points (posts) centered around the given latitude and longitude.</p>
<h3>Other Notes for Developers</h3>
<p>Beyond the above, pretty much everything in this plugin is modifiable by editing the properties of the singleton classes. Here are some examples:</p>
<ul>
<li>To change the post type, e.g. to be <code>'location'</code> instead of store, you can set it by calling <code>WPSD_Post_Type()->post_type = 'location';</code> from your theme or plugin (ideally during <code>after_setup_theme</code> at a priority higher than 10).</li>
<li>To change the units from miles to kilometers, <code>WPSD_Post_Type()->units = 'km';</code></li>
</ul>


Store Directory

A simple, flexible plugin for keeping a store/location directory and searching for them by radius.

Meks

Risto Jovanovic

<p>Meks Easy Maps was originally created as a feature for our <a href="https://mekshq.com/theme/trawell/" rel="nofollow ugc">Trawell WordPress theme</a> but now it can be used on any WordPress website.</p>
<p>With Meks Easy Maps WordPress plugin you can easily assign locations to your posts and categories via Google Map user-friendly interface. The plugin is highly configurable and provides you with the various options for displaying the map.</p>
<p>Meks Easy Maps WordPress plugin is created by <a href="https://mekshq.com" rel="nofollow ugc">Meks</a></p>
<h3>Features</h3>
<ul>
<li>Assign Google Map or Open Street Map locations to your posts and categories</li>
<li>Display post location pin above or below your post content</li>
<li>Display all posts with locations on the current category template/archive</li>
<li>Display category location pin on category template/archive</li>
<li>Shortcode to manually display pins with posts or categories on any page</li>
<li>Several display settings to fine-tune the map behavior like clustering (pin grouping) and polylines (lines that connects pins)</li>
<li>Street view support</li>
</ul>
<h3>Live example?</h3>
<p>You can see Meks Easy Maps live example on our <a href="https://mekshq.com/demo/trawell/" rel="nofollow ugc">Trawell theme demo website</a></p>
<h3>Quick shortcode guide</h3>
<p>Besides the automatic display of your posts and categories on the map, you can embed your map anywhere on the website by using the predefined <strong><code>[mks_map]</code></strong> shortcode.</p>
<ul>
<li>Use <strong><code>[mks_map type="posts"]</code></strong> to display all your posts with locations on a single map.</li>
<li>Use <strong><code>[mks_map type="posts" cat="2"]</code></strong> if you want to display posts from a specific category only (cat parameter represents the category ID).</li>
<li>Use <strong><code>[mks_map type="categories"]</code></strong> to display all your categories with locations.</li>
</ul>


Meks Easy Maps

Easily display map locations for your posts and categories with Google Maps or OSM.

Store Directory vs Meks Easy Maps