LensAdvizor FAQ

Basic Usage

How do I install LensAdvizor?

1. Visit our Shopify app page here and click "add app".

Once the app is installed, you will need to do the following:

For Shopify 2.0 Themes:
2. In Shopify navigate to Sales Channels > Online Store > Themes
3. For your currently active theme, click 'Customize'
4. From the middle, top dropdown select 'Product' and then 'Default Product'
5. In the left hand panel, under 'Product Information' click the '+ Add Block' link.
6. Select 'LensAdvizor' from the bottom section under APPS
7. Use the right hand drag icon to drag LensAdvizor to where you would like the 'Select Lenses' button to appear
8. Click 'Save' at the top right
9. From the middle, top dropdown select 'Cart'
10. In the left hand panel, under click '+ Add Section'
11. Select 'LensAdvizor' from the bottom section under APPS
12. Click 'Save' at the top right

Install App Extension

 

For Shopify 1.0 Themes:
2. No steps necessary, LensAdvizor will automatically be installed into your theme.

How do I use LensAdvizor?

LensAdvizor works similarly to how you would add products to a collection in Shopify. With LensAdvizor, you'll be creating a Lens Flow to which you'll add lenses.

1. Decide what lenses you want to offer with your products.
2. Create a Lens Flow.
3. Add your lenses.
4. Assign frame products.

Boom.​

The products assigned in Step 4 will feature an add-to-cart process that shows the lenses added in Step 3

What lenses can I add?

LensAdvizor allows you to add unlimited lenses, including:​

1. Clear
2. Blue-Light-Blocking
3. Photochromic (light-sensitive)
4. Non-Polarised Sunglasses
5. Polarised Sunglasses

You are free to create any Lens Grouping you like in LensAdvizor to fit your needs.

What prescription types can I add?

During the lens selection process, customers can choose five options:​

1. Single Vision
2. Progressive
3. Reading
4. Non-Prescription
5. Frame Only

How do I hide lens products on my store?

The 'All' product collection

Many themes use this hidden collection as the main product catalog page. Instead of using this default, you can create your own product collection called 'all' and set it to exclude products with vendor=LensAdvizor.

More information

Recommended products

Shopify's default product recommender does not allow you to exclude products. If you would like this section on your site, please use a product recommender app from the Shopify app store.

What does "Capped amount limit reached" mean?

When you sign up for a pricing plan, Shopify sets a cap for how much can be charged in any given month. When you see this message, it means that you are approaching this limit. Click on the "Upgrade now" link to set a higher cap.

I like your icons, can I use them?

Yes, you can use any of our default icons from our google drive link when setting up your Lens Flows in LensAdvizor.

Advanced Usage

How can I deploy to a draft Shopify 1.0 theme?

1. Copy the contents of lensadvizor.liquid from the old theme to the new theme. (Create the file on the new theme if necessary)

If you do not have a theme to copy from, you can find a copy of lensadvizor.liquid here.

2. Add this code block to theme.liquid. It can be anywhere in the file, but the default is just after the tag. 

<!-- LensAdvizor snippet starts -->
{% if request.page_type == 'product' or request.page_type == 'cart' %}
{% render 'lensadvizor' %}
{% endif %}
<!-- LensAdvizor snippet ends -->

How can I update LensAdvizor on my Shopify 1.0 theme

Go to LensAdvizor > Settings and click on the "Update Theme File" button.

Alternatively, to do this manually you can find the latest lensadvizor liquid here.

Once you download this file, you can go to your theme and replace the contents of lensadvizor.liquid with this file's contents.

How can I deploy to a draft Shopify 2.0 theme

1. In Shopify navigate to Sales Channels > Online Store > Themes
2. For the draft theme you want to deploy to, click 'Customize'
3. From the middle, top dropdown select 'Product' and then 'Default Product'
5. In the left hand panel, under 'Product Information' click the '+ Add Block' link.
6. Select 'LensAdvizor' from the bottom section under APPS
7. Use the right hand drag icon to drag LensAdvizor to where you would like the 'Select Lenses' button to appear
8. From the middle, top dropdown select 'Cart'
9 In the left hand panel, under click '+ Add Section'
10. Select 'LensAdvizor' from the bottom section under APPS

How can I show LensAdvizor on Home and Collection pages?

You can show LensAdvizor buttons for any product on any page. To do this:

  1. Go to your Sales Channel > Online Store Theme > Customize
  2. Click on App Embeds in the far left icon menu
  3. Turn on "LensAdvizor Quick Buy"
  4. Modify your theme code wherever you would like the button and inject the following:

{% liquid
    assign lacollectionId = ""
    unless request.page_type == "collection"
        for collection in product.collections
            if collection.metafields.lensadvisor.collection_id  != blank
                assign lacollectionId = collection.metafields.lensadvisor.collection_id
            endif
        endfor
    else
        assign lacollectionId = collection.metafields.lensadvisor.collection_id
    endunless
%}
<lensadvizor-quick-buy
  class="la-select-lenses-btn"
  data-la-quick-buy
  data-la-product-id="{{ product.id }}"
  data-la-variant-id="{{ product.selected_or_first_available_variant.id }}"
  data-la-product-json="{{ product | json | escape }}"
  data-la-flow-id="{{ lacollectionId }}"
  >
</lensadvizor-quick-buy>
<script type="application/json" data-lensadvizor-product="{{ product.id }}">{{ product | json }}</script>

Replace product and collection variables with the product and collection variables used in your theme code.

NOTE: If this code is dynamically loaded (e.g. using the section-rendering concept of Shopify), please also add data-la-quick-view="1" to <lensadvizor-quick-buy> or call LensAdvizor.init()

How do I hide the lens products from the cart?

You can use template variables to test if a Line Item is a lens product and then choose how to display this row. This requires knowledge of HTML, CSS, and Shopify Template code.

If the product vendor has not been modified, you can use this code to test that it is a lens product:

{% unless item.vendor == "LensAdvizor" %}
{% endunless %}

If the product vendor has been modified, you can iterate over the Line Item properties and test for _productType=="lens"

How can I hide internal properties from the cart?

In your cart.liquid template, you find the code that loops over and displays cart item properties. Just inside this loop, update the code that checks for the first character to the following:​

{% assign first_character_in_key = p.first | truncate: 1, '' %}
{% unless p.last == blank or first_character_in_key == '_' %}
{%endunless%}

Usually you will replace:

{% unless p.last == blank %}

with:

{% assign first_character_in_key = p.first | truncate: 1, '' %}
{% unless p.last == blank or first_character_in_key == '_' %}

How can I exclude specific products from a Lens Flow?

You can exclude specific products from a Lens Flow, even if you have assigned by product collection, by adding the tag remove-rx on the frame product. This will prevent the Select Lenses button from appearing on that specific product.

How can I translate text?

Please use the Translation left hand navigation menu in the app.

Clicking on the Settings gear icon will allow you to add a new translation for a locale, please make sure the locale is in all lowercase characters, such as 'pt-pt' instead of 'pt-PT'.

How can I remove LensAdvisor products on default products view?

All shopify stores have a default “all” collection which shows every product attached to your store. This means LensAdvisor products may start to appear on your product pages. To remove them: 

  1. Go to “Collection”
  2. Create a new collection called: “All” 
  3. In Collection Type: 
  • Automated. 
  • Product Must Match: All Collections
  • Product Vendor | Is not equal to | LensAdvizor 

4. Save

This process will override the default “all” collection and remove all the LensAdvisor products. 

Pricing

How do the pricing plans work?

There is a fixed monthly fee based on the plan you choose. Commission based plans cost charge a percentage of each order you process through LensAdvizor after the initial included orders. This means that you only pay for what you use after the monthly plan.

What does "% per order value" mean?

We charge a set percentage as a fee on the value of orders processed through LensAdvizor after the set number of included orders.

This means that for a Pro plan, you will be charged 0.199 USD for 10 USD of order revenue, and this is only applicable to orders processed after the number of included orders have been exceeded.

What are the main differences in each tier?

Most features of LensAdvizor are available to every tier.

The Pro plan comes with the ability to assign by product collection, create Add-Ons, and set Rx Limits. Each tier also has a different percentage cost per order value. Support priority also differs for each tier. Please see our pricing page for more information.