Metro - Shopify Widget Builder App

Shopify widget builder app | Version 1.0.0


You are entitled to get free lifetime updates to this product + exceptional support from the author directly.

This documentation is to help you regarding install, set up & customization of the app. Please go through the documentation carefully to understand how this app works


In order to work properly the app needs the following:

  1. SSL is required. The Shopify Admin uses HTTPS for all pages. If you don't have SSL enabled for your domain please contact your hosting provider and ask to enable SSL for this domain. Depending on your hosting provider, you might need to buy a SSL certificate. Failure to use SSL when running an embedded Shopify app will cause errors in web browsers, due to mixed content restrictions.
  2. PHP version 5.5 or greater is required
  3. cURL is required. In order to make authentication requests to Shopify API, PHP cURL extension is required. If CURL is not enabled please contact your hosting provider and ask to enable cURL.

We recommend to install this plugin within a brand new WordPress install. In order to obtain the best performance you do not need other plugins or templates to slow down WordPress. Also you can install our future apps here as well. Would be nice to have all your Shopify apps within one place.

When the plugin is activated, it will create a few pages within your website. Those pages are being used to authenticate with the Shopify API and are not to be deleted. If some how you remove one by mistake, you can just Deactivate than Activate the plugin again.

Getting Started #back to top

This plugin has three parts:

1. Super Admin Area

This is the place where you edit app's settings like: Shopify API key, API secret, pricing details ( how much would you charge / shop / month, trial days & test charges), set up whitelisted shops and much more.

2. User Admin Area

This is the app's admin area that integrates within shops. Your users ( shop owners ) will be able access it right from their shops, make the required changes and add functionality to their shops.

3. Storefront

The app's storefront functionality. The script and data that are being loaded within shops. The whole script it's pretty small ( ~ 20KB ) and it does not slow down the shops speed since it follows Shopify rules (it's being added after the document is loaded).

App Install & setup #back to top

In order to use the app:

  1. Install & activate the plugin within your WordPress website.
  2. Create a Shopify Partner account (Shopify Partners). In order to receive money from Shopify make sure to fill out your PayPal account details.
  3. Within your Shopify Partner Dashboard create an app (see video below).
  4. Copy the API key and API secret from the app and paste it within WordPress plugin super admin area (see video below).
  5. Within your Shopify Partner Dashboard create a development store and install/test the app ( see video below ).
  6. Within App's Super Admin Area adjust your pricing details ( how much would you charge / shop / month, trial days & test charges), set up whitelisted shops and much more.

Using The App Within Shops #back to top


Metro is widget builder that shows your store's categories or products in an interactive way. Metro is best fit for your store's homepage which is like a website’s virtual front door, and can serve as a place to jump start site exploration. Metro makes it easy for your visitors to discover their desired products/categories right from the start.

Widget types

With Metro you can create two types of widgets: simple and filterable. Using the filterable feature you can segment categories further. A filterable widget block could have sections like: Men, Women, Children and each section could have different items that could point to a certain category.

Adding widgets to your storefront

Once you've created a widget block, within edit mode, on the ride side panel you can copy the "widget shortcode" and add it within your store's homepage, or any other page. Please see the "Video / tutorials" section.

App uninstall #back to top

The app handles uninstall gracefully, the app does not keep files within the theme's folder. Basically users don't have to do anything, however if users added widget div shortcodes within their theme, they might want to remove those even if it does not have any functional or visual impact to their theme.

Also from within the Super Admin Area you can remove a certain shop access to the app. If you do that the shop does not have access to the app anymore. Since you would remove a shop access, in order the shop to install the app again first it needs to delete the app from within Shop Admin Area > Apps.

Video tutorials #back to top

App install and setup

Create filterable widget

Place shortcode within storefront homepage

Place shortcode within a regular page

Version History (Changelog) #back to top


                                        Version 1.0.0 - Jan 1th, 2017

                                        - first release