Install Walityk on PrestaShop

This guide covers installing the Walityk module on a PrestaShop store (1.7, 8.0, 8.1, 8.2). Plan for 10 minutes.

1. Download the module

1. Open the Walityk dashboard → Sites → New site, pick PrestaShop.
2. Click Download module. You get walityk.zip.

2. Upload to PrestaShop

1. PrestaShop admin → Modules → Module Manager.
2. Click Upload a module.
3. Pick walityk.zip. The module installs automatically.
4. Click Configure.

3. Configure the module

On the module config page:

1. Paste your Walityk site key (from step 1, format wlk_live_…).
2. Tick the hooks to enable: Catalog, Cart, Order, Customer account.
3. Save. The module attaches required hooks (displayHeader, actionValidateOrder, etc.).

If you run a multistore setup, configure one key per store.

4. Connect your destinations

On Destinations in the Walityk dashboard:

• GA4: Measurement ID + API secret.
• Meta CAPI: Facebook OAuth → authorize Pixel + Conversions API.
• Google Ads: connect your account if you run SEA.

5. Verify events arrive

1. Walityk dashboard → Live debug tab.
2. Browse your store: home, product, add to cart, checkout.
3. Check Meta Events Manager → Test events and GA4 → Realtime.

E-commerce events shipped

• page_view everywhere
• view_item_list on category listings
• view_item on product page
• add_to_cart / remove_from_cart on cart
• begin_checkout / add_payment_info at checkout
• purchase on confirmation
• refund on a back-office refund

Not working?

• Module not listed after upload: ensure ZIP is under 16 MB and PHP upload_max_filesize ≥ 16M.
• No events: clear the PrestaShop cache (Advanced → Performance → Clear cache) and disable debug mode.
• “hook not found” error: open Modules → Configure Walityk and click Reinstall hooks.

Compatibility

• ✅ PrestaShop 1.7.6+, 8.0, 8.1, 8.2
• ✅ Official themes (Classic, Hummingbird)
• ✅ Multistore
• ⚠️ Very old 1.6 themes: not supported, migrate to 1.7+ first

Need help? hi@walityk.com.