Skip to content

How to Install the App

The app installs from a different place on each platform. Pick yours below.

The Built for Shopify version is the current app, and it installs from the Shopify App Store.

  1. Open the Shopify App Store listing and click Add app.

  2. Grant the permissions that connect the app to your store.

  3. In your Shopify admin, go to Apps and open RevenueHunt Product Quiz Maker.

  4. Confirm the app access and permissions.

  5. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

Going back to the legacy version

Select Switch to legacy app in the Shopify side menu. Your progress is saved in both versions, so nothing is lost either way.

See Switch to legacy.

The legacy app installs from the same Shopify App Store listing as the current one. You choose between the two interfaces inside the app.

  1. Open the Shopify App Store listing and click Add app.

  2. Grant the permissions that connect the app to your store.

  3. In your Shopify admin, go to Apps and open RevenueHunt Product Quiz Maker.

  4. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

Moving to the Built for Shopify version

  1. Open the app in your Shopify admin.

  2. Select Switch to Built for Shopify in the Shopify side menu.

    Switching from the legacy app to Built for Shopify

  3. Confirm the app access and permissions.

Your progress is saved in both versions, and you can switch back whenever you want.

To bring a quiz you have already built across, use Migrate from Legacy App in the New quiz menu. See how to migrate a legacy quiz.

The quiz runs as a WordPress plugin that connects your store to RevenueHunt.

  1. Install and activate WooCommerce, if it is not already running.

  2. Install and activate the Product Recommendation Quiz plugin. It is on the WordPress Plugin Directory and on the WooCommerce Marketplace. Both are free.

  3. In your WordPress admin, open the Product Quiz tab.

  4. Grant the permission that connects the app to your WooCommerce store.

  5. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

What the free plugin covers

Either plugin puts you on the Free plan, which covers up to 100 quiz responses a month. Above that the app asks you to upgrade to a Basic plan, billed monthly.

See Plans and pricing for the rest of the plans.

The plugin is not connecting

See WordPress and WooCommerce troubleshooting.

The quiz runs as a Magento module. Installing it needs command line access to your server, so this one is a developer task.

  1. Download the Product Recommendation Quiz module from the Product Recommendation Quiz for Magento page.

  2. Install the module from the zip file, or with Composer.

    The commands for each route

    From a zip file

    • Unzip the file into app/code/Revenuehunt.
    • Enable the module: php bin/magento module:enable Revenuehunt_ProductQuiz
    • Apply the database updates: php bin/magento setup:upgrade
    • Flush the cache: php bin/magento cache:flush

    With Composer

    • Make the module available in a Composer repository, such as the private repo.magento.com, the public packagist.org, or a public GitHub repository added as vcs.
    • Add that repository to your configuration: composer config repositories.repo.magento.com composer https://repo.magento.com/
    • Install the module: composer require Revenuehunt/module-productquiz
    • Enable the module: php bin/magento module:enable Revenuehunt_ProductQuiz
    • Apply the database updates: php bin/magento setup:upgrade
    • Flush the cache: php bin/magento cache:flush

  3. In your Magento admin, go to Stores > Settings > Configuration > Services > Magento Web API > Web API Security and set Allow Anonymous Guest Access to Yes. See the Magento documentation on anonymous API security.

    Where the module keeps its configuration
    Setting Configuration path
    Api URL Test product_quiz/general/prq_api_url_test
    Admin URL Test product_quiz/general/prq_admin_url_test
    Is Test mode product_quiz/general/prq_is_test
    API URL product_quiz/general/prq_api_url
    Admin URL product_quiz/general/prq_admin_url
    RH Domain product_quiz/hidden/rh_domain
    API key product_quiz/hidden/rh_api_key
    Token product_quiz/hidden/rh_token
    Shop hash id product_quiz/hidden/rh_shop_hashid

  4. In your Magento admin, go to Marketing and open Product Recommendation Quiz.

  5. Grant the permission that connects the app to your Magento store.

  6. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

What the module needs

  • Your website must have a valid HTTPS or SSL certificate.
  • The module does not run on a local or development environment.

  • The MiniCart integration is off by default. If your theme uses MiniCart, uncomment this line in view/frontend/layout/default.xml.

        ```html

    ```

For the developer installing it
  • Composer package: revenuehunt/module-productquiz
  • API endpoint: POST Revenuehunt\ProductQuiz\Api\PrqSetTokenManagementInterface to Revenuehunt\ProductQuiz\Model\PrqSetTokenManagement
  • Controller: adminhtml > prqfw/index/index
  • Source and issues: Magento module repository on GitHub

The quiz installs as a BigCommerce app.

  1. Open the BigCommerce listing for Product Recommendation Quiz and click get this app.

  2. Grant the permission that connects the app to your BigCommerce store.

  3. In your BigCommerce admin, go to Apps and open Product Recommendation Quiz.

  4. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

The standalone version runs on its own, with no store behind it. It suits a shop built on Wix, Squarespace Commerce, Odoo, or anything else the app has no plugin for.

Two things work differently here

  • Products are not pulled from a store. Add them by hand or through a Google Product Feed.
  • There is no add to cart and no checkout. The customer reads the results page and clicks a product to open it.

  1. Sign up on the RevenueHunt registration page. An email address and a password are all it takes.

  2. Log in to your account.

  3. Add your products and collections in the in-app Catalogue.

  4. Check that the app opens on its Dashboard. That is where your quizzes are listed.

Work through the Success Checklist next, to build and publish your first quiz.

Filling the catalogue

See how to add products in Standalone RevenueHunt app.

Changing your username or password

Contact customer support to change either one.

This article explains how to install the RevenueHunt app on each platform, and how to check that the install worked.