Best practices for adding the plugin to your site
Page Sections
How do I update the width of my plugin?
This is an item that is controlled by the layout of your website. We do not have a way to toggle this inside of our Dashboard.
Depending on your websites shop page is laid out, our plugin may be forced into a Tablet or Mobile view even when viewed on a Desktop. By using certain height and width you can ensure it always displays the correct views for your customer when they visit your shop page.
Our plugin automatically changes to a tablet view when the Width is below 1024 px (641-1023px)
We recommend reaching out to the person or company in charge of your website and asking for them to set the Width to 1024 or more. If you have any questions, please loop your Account Manager into an email with your Web person / Company and we are happy to assist.
How does it look in Tablet mode VS Desktop?
There are a few key differences between how our plugin displays on a Desktop VS Tablet. Certain features of the plugin may not show up if your customer is forced into the wrong display type from width issues.
Desktop Version - 1024px
You will notice there are some parameters on the left hand side for the customer to filter through your shop.
After clicking into a filter, you will be able to see a "back" arrow. This is only visible on desktop mode
When in the checkout screen everything will be displayed with out needing to scroll
Tablet Version - 641px to 1023px
When in Tablet version the sorting moves to a button "Sort by" in the top right corner.
Once your customer clicks into the "Sort by" button they will see all the parameters:
Checkout will also have a slightly different flow on Tablet where it usually won't all fit on one screen requiring the user to scroll a bit more:
Mobile Version - 1px - 641px
56% of ALL Web traffic comes from mobile phones. This is arguably the most important to ensure is displaying correctly.
Advanced Script Loading Option
For custom Content Management Systems, websites powered by their own single page app (SPA) system, or for sites where non-standard loading is required, we have built controls that allow you (the owner of the website) to control when the plugin content loads rather than using our default functionality.
A custom method in our script can be called which will load all plugins. The method can be called anytime after the <script> has been loaded, and optionally after any specific <div> tags have been added to the DOM.
window.CONCOM_LOADER.run()
A parameter exists as part of the <script> tag that will prevent plugins from loading by default:
<script src="https://plugin.contractorcommerce.com?key=your_key" data-autoload="false"></script>