Store List

Store List is a page where you may list all your site vendors. Now this has many features, filters, maps and many other aspects. So let’s start with very basics, how you will have a “Store List” page?

Well, it’s very simple, you just have to create WP page from your site’s wp-admin -> Pages -> Add New

You may add any title for this page, no restriction at all. But in page content area you have to add this short code –

[wcfm_stores]

You will see a page like this –

Well, by default this page comes with 12 stores in each page and 3 stores per row, and off course all active vendor’s stores.

Now, you may change this page display and listed stores. Here is list all supported short code attributes –

• theme -> default: classic, alternate: simple, compact
• per_page -> change how may stores will display in each page (default: 12) -> use: per_page=”20″ (now 20 stores will display in each page)
• per_row -> default: 3, change use: per_row=”2″ (up to 5 supported)
• has_map -> Well this page comes with a map to show all stores using map view, Default: YES, disable use: has_map=”no”
• map_zoom -> Default map zoom: 5
• auto_zoom -> map will auto-zoom depending upon store point on map or not? Default: YES, disable use:  auto_zoom=”no”
• orderby -> you may set this define stores display order. Default: newness_asc,  alternate: newness_desc, alphabetical_asc, alphabetical_desc, rating_asc, rating_desc, random
• has_orderby-> this is used for enable/disable orderby drop-down for this page. Default: YES, disable use: has_orderby=”no”

Filter attributes: this will help you to setup filters for this page –

• has_search -> this is used for enable/disable search box filter for this page. Default: YES, disable use: has_search=”no”
• search_term-> you may use this to set default search term for the page. Use: if you set -> search_term=”test” then it will show all stores which name has “test” keyword
• has_category -> this is used for enable/disable category filter. Default: YES, disable use: has_category=”no”
• search_category-> you may use this to set default search category for the page. Use: if you set -> search_category=”51″ then it will show all stores which associated with category ID 51
• has_country -> this is used for enable/disable country filter. Default: YES, disable use: has_country=”no”
• has_state -> this is used for enable/disable state filter. Default: YES, disable use: has_state=”no”
• has_city-> this is used for enable/disable city filter. Default: NO, disable use: has_state=”yes”
• search_city -> you may use this to set default search city for the page. Use: if you set -> search_city=”kolkata” then it will show all stores which are from “kolkata” city
• has_zip -> this is used for enable/disable zip code filter. Default: NO, disable use: has_zip=”yes”
• search_zip -> you may use this to set default zip code for the page. Use: if you set -> search_zip=”7112233″ then it will show all stores which have this zip code “712233”
• has_radius -> this is used for enable/disable radius filter. Default: yes, disable use: has_radius=”no” (Though it’s default value “yes” still it will only work if you enable “Store List Radius Filter” option from GEO Location setting)
• has_product -> this will help you to show only those stores which already has some published products, Default: NO, use: has_product=”yes” (now it will list only those stores which already has products in store)
• includes -> you may specify particular store ids, comma separated, hence only those will b visible, use: includes=”2,3,8,65″ (now only these 4 stores will be visible)
• excludes -> you may exclude few particular stores form list, use: excludes=”5,4,9,65″ (now these 4 stores will be exclude from list)
• include_membership -> you may include by membership id as well, hence all vendors associated that membership will be shown
• exclude_membership -> you may exclude by membership id as well, hence all vendors associated that membership will be excluded

Well, don’t get confused on the uses of these parameters, here’s how your short code will look like  –

[wcfm_stores search_category="9,12" has_product="yes" has_radius="yes"]

More Use Cases

Store List for “kolkata” city and category “Home Delivery” –

[wcfm_stores has_radius="no" has_country="no" has_state"no" has_city="yes" has_zip="yes" search_city="kolkata" store_category="12"]

Do not add space between double quotes (“).

Available theme options:

• Classic (Default)
• Compact
• Simple

You may set this as short code attribute ->

[wcfm_stores theme='simple']

Store List page basic theme : Classic and Per Row: 3

Store List page theme : Compact and Per Row: 4

To use this theme you have to add theme=”compact” attribute to your store list page short code –

[wcfm_stores theme="compact"]

You may change “Per Row” to 3

You may change “Per Row” to 5

Alternate Theme: Simple, Per Row: 3

To use this theme your short code will be ->

[wcfm_stores theme="simple"]

You may tweak few things from settings panel as well.

You may disable store list sidebar from WCFM Admin Setting -> Marketplace Setting Tab

You may change sidebar display position, whether left of right!

Well, in mobile view by default sidebar comes under store lists. Now you may tweak this and show sidebar first and then stores. But there is no setting option for this. You may achieve this by adding a small code snippet to your child theme’s functions.php –

add_filter( 'wcfmmp_is_allow_mobile_sidebar_at_bottom', '__return_false' );

Store List page comes with a map at top of the page. It shows listed stores locations in map. As you know you may disable this using short code attributes. But this map will only visible if you add Google Map API key at WCFM Admin Setting -> Marketplace Setting Tab

You may generate API key from here – https://developers.google.com/maps/documentation/javascript/

Now, vendor has to set their location in map from WCFM Vendor Dashboard -> Setting -> Store

As Admin you may also set this from WCFM Admin Dashboard -> Vendors -> Vendors Manager -> Store Setting

Now you will see stores locations in map –

Store List page has a special sidebar are, that’s only for this page. You will find this at wp-admin -> Appearance -> Widgets

There has some special widgets only for this sidebar as well.

These widgets are mainly for filtering stores list. Well you may add any other widgets in this sidebar as well.

What is GEO Locate?

While it’s true that your IP address doesn’t reveal your address or identity, it can reveal to someone what city or even general area you are in…within several miles in some instances. And it does it in an instant. (Remember—only people with some technical know-how can do that. The average person won’t have a clue.)

That amazing technological feat is made possible by something called geolocation software. Like something from a movie, geolocation software first zeroes in on your country, and then your region, city, and often finally your ZIP code.

How WCFM integrates this?

Now, we are using same technology to show relevant stores to a customer by filtering his/her location. Well, first you have to enable this module from WCFM Admin Setting -> Marketplace Setting Tab -> GEO Locate

If this module enabled hence customer’s location will auto-populate at store list location filter and store visible only for those locations –

You may also setup “Radius Search” filter for store list. It allows you to search within 100 KM radius.

If you are using Store List sidebar then you have to setup this using widget. Go to wp-admin -> Appearance -> Widgets -> Add “Store List” Radius Search” widget under Store List sidebar –

Now, you will see Radius Search option under store list sidebar –

Just insert your address and set radius for search, it will show you stores available within set radius.

If you are not using store list sidebar and have default filter then also you may use radius filter. You just have to specify this with store list short code –

[wcfm_stores has_radius="yes"]

Now, you will see radius filter –

Well, if you are using radius filter then country and state filter will be auto-hidden.