Stencil Integration
Integrating Findify with BigCommerce Stencil style themes
Follow the steps listed below:
- Enable HTML editing on your store
- Feedback API integration
- Search page integration
- Disable default quick search
- Add our JS
Step 1: Enable HTML editing on your store
Important note: if for some reason after integration search is not working or you think your website is broken, you can revert to the unmodified theme and contact us!
In the beginning, you need to make a copy of your current theme, so that you can edit theme files directly:
- Go to
Storefront Design > My Themes
- Click on
Customize
- Scroll on the left to the section
Edit theme files
and click onmake a copy
- Add
with Findify
to the end of your theme name and click onSave a Copy
- Go to
Storefront Design > My Themes
- On the current theme select 'Advanced -> Make a copy'
- Put a name on the copy of the current theme
- On the copy of the theme select
Edit theme Files
- A window showing HTML code should open
You're ready to start the integration process!
Step 2: Feedback API integration
Product tag:
Open the file templates > pages > product.html
Paste the code snippet before {{/partial}}
<div data-findify-event="view-page" data-findify-item-id="{{product.id}}"></div>
<div data-findify-filter="brand" data-findify-filter-value="{{product.brand.name}}"></div>
<div data-findify-filter="id" data-findify-filter-value="{{product.id}}"></div>
Order tag:
Open the file templates > pages > order-complete.html
Paste the code snippet before {{/partial}}
<div class="findify_purchase_order" style="display:none">
<span class="order_number">{{ order.id }}</span>
</div>
If you're using BigCommerce Optimized Page Checkout
Please, follow the instructions below for the Optimized Page Checkout flow!
Open the file templates > pages > order-confirmation.html
Paste the code snippet before the second {{/partial}}
(it refers to the {{#partial "page"}}
)
<div class="findify_purchase_order" style="display:none">
<span class="order_number">{{ checkout.order.id }}</span>
</div>
Get our script tag during the onboarding or in the Merchant Dashboard and paste it before the first {{/partial}}
(it refers to the {{#partial "head"}}
)
Cart content tag:
Open the file templates > layout > base.html
Paste the code snippet before </body>
<div data-findify-event="update-cart">
{{#each cart.items}}
{{#if type '===' 'Item' }}
<div data-findify-item-id="{{product_id}}" data-findify-unit-price="{{ price.value }}" data-findify-quantity="{{ quantity }}"></div>
{{/if}}
{{/each}}
</div>
Step 3: Search page integration
Open the file templates > pages > search.html
Paste the following code snippet after {{#partial "page"}}
<style>.findify-component-spinner{margin:60px auto 0 auto!important;position:relative;-webkit-transform:translateZ(0);-ms-transform:translateZ(0);transform:translateZ(0);-webkit-animation:findify-component-spinner-animation 0.7s infinite cubic-bezier(.67,.35,.7,.8);animation:findify-component-spinner-animation 0.7s infinite cubic-bezier(.67,.35,.7,.8);border-radius:50%;width:60px;height:60px;-ms-transform-origin:50% 50%;-webkit-transform-origin:50% 50%;transform-origin:50% 50%}.findify-component-spinner:after{border-radius:50%;width:60px;height:60px}@-webkit-keyframes findify-component-spinner-animation{0%{-webkit-transform:rotate(90deg);transform:rotate(90deg)}100%{-webkit-transform:rotate(450deg);transform:rotate(450deg)}}@keyframes findify-component-spinner-animation{0%{-webkit-transform:rotate(90deg);transform:rotate(90deg)}100%{-webkit-transform:rotate(450deg);transform:rotate(450deg)}}.findify-component-spinner{border-top:3px solid #eaeaea;border-right:3px solid #eaeaea;border-bottom:3px solid #eaeaea;border-left:3px solid #c6c6c6}}</style>
<div data-findify-attr="findify-search-results" style="min-height: 400px;">
<div class="findify-component-spinner">
<div style="display:none;">
Paste the following code snippet before {{/partial}}
</div>
</div>
</div>
Step 4: Disable default quick search
To disable the default BigCommerce quick search, you need to comment out the content of quick-results.html
file that you can find in the Templates -> Components -> Search
folder
Step 5: Add our JS
Please, follow this guide to see how you can add our JS snippet to your store Adding Custom Scripts to Stencil Themes
If you want to make the search work even faster you can follow these steps, but things can break upon theme update
Open the file templates > layout > base.html
Paste the code snippet containing our script before </body>
You can get the script tag during the onboarding or in the Merchant Dashboard
Updated about 2 months ago