WooCommerce Installation Guide

WooCommerce Installation Guide

  • updated 2 mths ago

 Install the Hello Retail WooCommerce Plugin

In this guide, you can read and learn about how to install the plugin for WooCommerce.

To integrate Hello Retail with your WooCommerce webshop, simply follow these steps below.  


  1. Start by logging into your WooCommerce Admin account.

  2. On the dashboard view, navigate to the left-hand side menu. Navigate to Plugins and then click on Add new. 

  3. Switch to Upload plugin

  4. Download the Hello Retail plugin for WooCommerce here - current version 1.2.31. The file is also attached in this guide.

    Choose the file from your disk/computer and Install the plugin:

  5. Now you simply have to Activate the "Hello Retail plugin" from the Plugin list:

  6. It is possible to set restrictions on access to the feeds by adding IP restrictions. This is done by adding Hello Retail's IP address into the field of IP restriction.

    (Note there is an input field for Hello Retail partner ID - this is not required and can be empty.)
  7. If you also purchased dynamic search, you'll need to send us a URL for that too (see next section) so you can just send both in the same email.

Provide product prices for the feed by filter hook.

(OPTIONAL) From version 1.2.30 it is possible to provide product prices for the product feed by hooking in to the filter "hello_retail_product_price_hook" - this will be called once for each product in the product feed, as the feed is being generated.

here is an example of how to hook in and what format to return:

add_filter("hello_retail_product_price_hook", "get_price_for_hello_retail", 1, 1);

function get_price_for_hello_retail($product) {
    return array(
        "price" => some_function_to_get_price($product),
        "oldPrice" => some_function_to_get_regular_price($product),
        "priceRangesTo" => some_function_to_get_max_range_price($product),

1: priceRangesTo is an optional field and should only be set for products that show a price range.
2: Prices should be returned as floats or numeric strings. Not html.

Create a blank search page

For Hello Retail dynamic search to work on your webshop, you'll have to create a new blank page. This is so the search results can be displayed on.

You can see an example of an empty search page here. Also, you can read more about the blank page and dynamic search here.

Steps - Create a new blank search page in Wordpress (WooCommerce)

  1. Login to your WP Admin.
  2. Navigate to Pages > Add new page:

  3. Provide a relevant pagename for this new page, e.g. "Search results" and publish the page:

  4. Make sure this page does not show up in the navigation of your webshop. This depends on how you've implemented the actual navigation of new pages for your website. However, normally pages does not show up to be default.
  5. Lastly, submit the URL to your blank search page by sending an email to: support@helloretail.com

Updating the Hello Retail Module - WooCommerce

In the cases where you are using Hello Retail with your WooCommerce platform and you have installed the Hello Retail plugin that automates a lot of the setup and daily processes, it is a good idea to perform an update.

This serves for the purpose if  we encounter bugs or update the Hello Retail's services, the module will also be updated. 

Updating the plugin is simply a process of uninstalling the old version and installing the new one.

Steps - Update the Hello Retail Module

  1. To uninstall the old version, login to your WooCommerce account.
  2. On the dashboard view, navigate to the left-hand side menu. Navigate to Plugins and then click on Installed Plugins. You will then be shown a list of the installed modules.

  3. In the list of plugins, locate the Hello Retail business integration and click on the Deactivate button.

  4. After deactivation, you can delete the plugin by pressing on the Delete button.

    Now the plugin has been deleted so you can simply install the updated plugin as you would do a fresh install.

    You can find a complete guide for doing that here.

Configure Webshop

After the installation setup of your platform and the onboarding flow, make sure to have your webshop configured. Read this guide here on how to do so:

Configure Webshop

Change log

= 1.2.31 2024.02.05 =

- Update price helper with improved handling of various formatting settings.

= 1.2.30 2024.01.23 =

- Add a custom filter for developers to hook in an provide product prices for the feed.

= 1.2.29 2024.01.17 =

- Redesign of helper function to extract prices from priceHtml and filters.

= 1.2.28 2023.12.05 =

- Add option to enable backend conversion tracking if conversion tracking is not working for some payment methods.
- Fix minor issues that would cause PHP warnings 

= 1.2.27 2023.11.23 =

- Make sure we dont output thousands separator.

= 1.2.26 2023.11.22 =

- Remove partnerId input field from admin.
- Update script and tracking implementation to new standard.

= 1.2.25 2023.11.13 =

- Improved price helper + include option to output prices for debug (internal).
- Add support for HPOS.

= 1.2.24 2023.10.20 =

- Add new field to product feed containing product category ids including the category parent ids.

= 1.2.23 2023.09.25 =

- Add productTerms and customAttributes tags to the product feed
- Add product created and updated date in the product feed
- Add endpoint for content feed
- Add updated info endpoint

= 1.2.22 2023.05.17 =

- Fix issue where a product that had once been variable but is now simple would include attributes from the variations

= 1.2.21 2023.04.19 =

- Fix issue that caused issues with including tax on prices in all cases

= 1.2.20 2023.04.14 =

- Make the product feed handle products without prices gracefully

= 1.2.19 2023.03.28 =

- Redo how we get prices for products
- Remove a few plugin-specific helpers that are not needed since the price calculation is now better

= 1.2.18 2023.03.16 =

- Add our IP as default IP restriction

= 1.2.17 2022.10.12 =

- Add country to order feed

= 1.2.16 2022.09.27 =

- Only get variant attributes from variants in stock
- Add categoryIds to the product feed
- Add specific support for the Woocommerce Multi-Language plugin

= 1.2.13 2021.12.09 =

- Handle if fixed price is set using comma as a thousands separator for WPC component

= 1.2.12 2021.12.09 =

- Fix a few places where comparing string 0 would unintentionally return false

= 1.2.11 2021.12.07 =

- Don't use empty() function when a valid value can be 0

= 1.2.5 2021.08.11 =

- Fix composite product might be null and not "null"
- Use isset instead of !isnull

= 1.2.3 2020.11.18 =

- Fix minor issues that would cause PHP notice
- Prevent empty variant SKU from breaking product feed

= 1.2.1 2020.09.11 =

- Update attribute value in CDATA now that it isn't escaped anymore

= 1.1.19 2019.11.19 =

- Add visibility field to feed

= 1.1.16 2019.05.24 =

- Improved way of getting products
- Changed image size to the one used by the current WooCommerce theme
- Exclude categories for simple feed option

= 1.1.14 2019.04.10 =

- Add tags to simple feed format
- Add simpleFeed option

= 1.1.13 2019.04.01 =

- Version bump to 1.1.13
- Check product is published before attempting to include it in feed
- Use different function to get composite price

= 1.1.12 2019.03.29 =

- Restructure everything regarding getting product prices

= 1.1.7 2019.01.10 =

- Made sure we don't include refunds in the order feed

= 1.1.6 2018.12.07 =

- Added support for IP restriction 
- Add better error-handling in feeds

= 1.1.5 2018.11.26 =

- Added proper pagination support for product and category feeds.
- Added SKU to product feed.
- Add support for the brand discount module

= 1.1.3 2018.03.23 =

- Stripped out illegal characters from product data when writing the feed.

= 1.1.2 2018.03.22 =

- Replaced usage of the deprecated method get_currentuser() with wp_get_current_user().

= 1.1 2017.12.22 =

- Made the plugin work with WooCommerce 3.2
- Moved source files into src/ directory for packaging

= 1.0.3 2017.12.21 =

- Fixed feed limit issue
- Added cart span

= 1.0.2 2017.12.15 =

- Fixed feed limit

= 1.0.1 2017.12.15 =

- Info endpoint added

= 1.0.0 2017.12.13 =

- Initial Release

Like Follow
  • 8 mths agoLast active
  • 4028Views
  • 1 Following