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 features the lenses added in Step 3

What lenses can I add?

Right now, LensAdvizor allows you to add unlimited lenses from five categories:​

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

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.

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:

<lensadvizor-quick-buy
class="la-select-lenses-btn"
data-la-quick-buy
data-la-product-id="{\{ card_product.id }\}"
data-la-variant-id="{\{ card_product.selected_or_first_available_variant.id }\}"
data-la-product-json="{\{ card_product | json | escape }\}"
data-la-flow-id="{\{ collection.metafields.lensadvisor.collection_id }\}"
>
</lensadvizor-quick-buy>

Remove the back slashes for the variables, and replace card_product and collection variables with the product and collection variables used in your theme code.

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 translate text?

In order to translate text in LensAdvizor, or to set different text in English, copy and paste the contents of this file into LensAdvizor > Settings > Advanced: Custom JS Injector.

Please be sure to check the locale you are translating for and enter the desired locale for the translation. For example, for Spanish you would use "es" as the locale and put this in the first line between the quotes.

If you have multiple locales enabled for your store through Shopify Markets, you can find the locale code as the first part of the URL after the domain name. For example, for https://mystore.com/en-intl/products/abcde, the locale code is "en-intl". LensAdvizor supports multiple locale codes, so you can copy and paste the entire contents of the file into the Advanced: Custom JS Injector, once for each locale.

 translation

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.