The general installation instructions and code snippets for widgets can be found in the HelpfulCrowd app under Setttings > Widgets and on the </>embed tab for the respective widget.
Whilst the code snippets work in 99% of instances, all different website publishing tools have different approaches and methods and ways that they handle java script.
The following is provided as accurate as at the time of writing this article, however if you consider that it is no longer current, please reach out to us so that we can update it for other users.
By way of example, we will refer to the Product Summary Widget for the following examples.
We will now cover some of the widget installation nuances and behaviors on different web publishing platforms.
- Normal websites
- Adobe Muse
If you are using ECWID or Shopify, then the MAIN HelpfulCrowd widgets are automatically installed in the ECWID and SHOPIFY storefront. For these eCommerce platforms, the following will only apply to the OPTIONAL HelpfulCrowd widgets.
On a normal website, you would perform the following actions:
- Insert the script tag between the <head> </head> tags, ideally just above </head> tag
- Insert the the wrapper div in the <body> section or container where you want the widget to display
At times it may not be possible to insert the script tag in the head section. In these scenarios, it is possible to have both the script tag first, followed by the wrapper div together in the <body> section of container where you want the widget to display.
If we don't currently have an integration with your eCommerce platform, you can simply hardcode the Product ID from the HelpfulCrowd catalog into the wrapper div for the respective widget to display the relevant review and Q&A information for that product page.
Out of the box, WordPress does not support inserting java script tags into the <head> section of a WordPress site.
To add the script tag into the <head> section, a 3rd party plugin must first be installed and then the script tag included using the plugin. You may already have an existing plugin installed that provides the required functionality, so it is best practice to keep plugins to a minimum where possible.
If you do require a plugin, many HelpfulCrowd customers have been able to add the script tag to the <head> section using the Script n Styles plugin. Once the script tag has been added to the <head> section, then the wrapper div can be added to the relevant block or container using the HTML tab.
Please note that HelpfulCrowd has no association with the Script n Styles developer and cannot provide any support for this plugin. This is one of many plugins available on WordPress that provides this functionality.
The scroll functionality of "write review | ask question" from the product summary widget to the main product tabs widget does not function on Wix sites. This is due to the way that Wix loads Ecwid into their pages, via an Iframe.
If you have a Wix site and experience this issue, then you can request to disable the hyperlinks by sending us a chat message and advising that you're on a Wix site.
Some customers have reported limited functionality when writing reviews directly from the storefront or trying to view review photos from the storefront with a site published with Adobe Muse. After extensive investigation, we cannot identify any technical reason why this behaviour should occur and we would recommend users reach out to the Adobe Muse support desk for assistance.