Zonos logo
DOCS

Magento

/

Zonos Hello for Magento 

Learn about the Zonos Hello plugin for Magento. 

Are you looking to give your international customers the same kind of shopping experience as your domestic customers? Let us introduce you to Zonos Hello!

When an international shopper arrives at your site, Hello immediately welcomes the shopper and messages them in their local language, letting them know you sell globally. It’s quick and easy to integrate our extension and start delivering a better experience for your international shoppers.

Features

  • Welcome the international customer to your store.
  • Enable currency conversion throughout your site.
  • Display estimates for duties and taxes.
  • Localize the messaging inside Hello.
  • Personalize the shopper experience.
  • Eliminate customer anxiety toward hidden international fees.
  • Zonos Hello supports multi-country eCommerce shops.

Getting started

  1. Sign up for Hello - Once you create an account, you will be given access to Zonos Dashboard.
  2. Installation - Install the Hello for Magento plugin if you haven’t already.

Installation

For Magento 2.0, 2.1 and 2.2, you will need PHP 7.0.6 or greater or PHP 7.1.x, whichever is compatible with your version of Magento.

For Magento 2.3, you will need PHP 7.1.x.

You can find Zonos Hello for Magento 2 on the Magento marketplace.

There are three options to install the Zonos Hello module.

Option 1 - Web setup wizard (preferred method)

To install the app, follow the instructions from the Magento User Guide.

Option 2 - Install via Composer

Important - Installation with this method must be performed by an experienced Magento developer.

This option will install Zonos Hello as a dependency.

To install the app, (from your terminal) go to your <root magento dir>, then follow the steps below:

  • composer require zonos/hello
  • php bin/magento module:enable Zonos_Hello
  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile

To uninstall the app:

  • php bin/magento module:uninstall Zonos_Hello
  • php bin/magento setup:di:compile

Option 3 - Download the extension

Important - You will not be able to run: php bin/magento module:uninstall Zonos_Hello, because it was not installed through Composer.

To install the Zonos Hello module:

  1. Go to the Magento marketplace.

  2. Search for “Zonos Hello”.

  3. Download the Zonos Hello app for Magento 2 extension.

  4. Extract the extension into the <root magento dir>/app/code/Zonos folder (create any folder that does not exist).

  5. From the command line, change the directory to your root Magento 2 directory.

  6. Run the following commands:

    • php bin/magento module:enable Zonos_Hello
    • php bin/magento setup:upgrade
    • php bin/magento setup:di:compile

To uninstall the Zonos Hello module:

  • php bin/magento module:disable Zonos_Hello
  • php bin/magento setup:di:compile

Hello configuration

  1. Obtain your Site Key at https://dashboard.zonos.com/settings/integrate.

  2. Go to your Magento Admin > Stores > Configuration > Zonos > Zonos Hello. 3 Configure the following options as instructed below:

    1. Enable - This allows the Zonos Hello widget to display duty and tax quotes while customers visit your product pages.
    2. Site Key - Enter your Zonos-provided site key obtained from Step 1.
    3. Currency Conversion Selectors - If you want Zonos Hello to convert currency, paste your CSS selectors here. Multiple selectors are separated with a comma, e.g. .price,.__current-price,.__subtotal,.__original-price.
    4. Hide Domestic Elements (OPTIONAL) - If you need or want to hide domestic elements for your international customers, input CSS selectors for elements you want to hide e.g. .nav-6,.action-add.