Magento 2 Post-Purchase Reviews Extension User Guide
This guide covers installation, configuration, and day-to-day use of the Toweringmedia Post-Purchase Reviews extension for Magento 2. The module sends delivery-aware experience-check emails, routes customer responses, collects verified reviews, and exports approved reviews for Google and Bing syndication.
Table of Contents
- Overview
- System Requirements
- Installation
- Configuration
- Customer Flow
- Admin Grids
- Google / Bing Syndication
- Troubleshooting
- Frequently Asked Questions
Overview
Post-Purchase Reviews bridges the gap between order complete and public product review. Instead of sending a generic review request immediately, the extension:
- Schedules an invitation when an order reaches complete status
- Sends an experience-check email after delivery (or a fixed delay)
- Routes the response — Great/OK customers toward reviews; Problem customers toward staff recovery
- Collects verified reviews on-site via secure token links
- Moderates and syndicates approved reviews to Google/Bing XML feeds
Composer Package
toweringmedia/module-post-purchase-reviews
System Requirements
- Magento 2.4.x
- PHP 8.1+
- toweringmedia/module-base (required)
- toweringmedia/module-ai-core (optional, for AI-drafted emails)
- Toweringmedia Composer repository credentials
Installation
Step 1: Configure Composer Authentication
Add your Toweringmedia credentials to auth.json in your Magento root directory.
Step 2: Install the Extension
composer require toweringmedia/module-post-purchase-reviewsStep 3: Enable and Upgrade Magento
php bin/magento module:enable Toweringmedia_PostPurchaseReviews
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flushStep 4: Enable in Admin
Go to Stores → Configuration → Towering Media → Post-Purchase Reviews → General and set Enabled to Yes.
Configuration
First Experience Email
- When to send — After delivery (polls tracking, with fallback delay) or After order complete (fixed day delay)
- Days after delivery — extra buffer after delivery is confirmed
- Fallback days after shipment — send anyway if tracking never confirms delivery
- Days after order complete — used in fixed-delay mode
Review Follow-Up
- Days before backup review-invite email — sends if the customer responded Great/OK but has not submitted a review yet
AI Email Drafting (Optional)
- Use AI Core for email copy — requires
toweringmedia/module-ai-core - Brand tone — e.g. friendly, professional, premium
Compliance
- Include public review link in review-invite emails — optional link to the standard Magento review form
Google / Bing Syndication
- Publisher name — appears in the XML feed
- Enable public product review feed URL
- Auto-approve submitted reviews — skip manual moderation when appropriate
Notifications
- Problem alert email — staff inbox for problem submissions (defaults to store email)
Customer Flow
Experience Email
The first email asks How was your experience? with three buttons:
- Everything went great
- It was fine
- I had a problem
Links are tokenized — customers do not need to log in. The first email does not ask for a product review.
Great / OK Response
Customer sees a thank-you page with a link to the verified review form. If they do not review within the configured delay, a backup review-invite email is sent by cron.
Problem Response
Customer completes a problem intake form. Staff receive an alert email with order context. The case appears in Problem Recovery in admin.
Public URLs
/postpurchasereviews/experience/index?token=…— experience landing/postpurchasereviews/review/form?token=…— review form/postpurchasereviews/feed/productreviews— syndication XML feed
Admin Grids
Towering Media → Post-Purchase Reviews
- Invitations — scheduled and sent invitations, status, and timing
- Problem Recovery — problem cases; mark Contacted or Resolved
- Review Submissions — pending reviews; Approve, Reject, or Export feed
Google / Bing Syndication
When reviews are approved, export the Google Product Review XML v2.4 feed from the Review Submissions grid or access:
https://yourstore.com/postpurchasereviews/feed/productreviews
Submit this URL in Google Merchant Center or Bing Merchant Center per their product review program requirements.
Troubleshooting
Experience emails not sending
- Confirm the module is enabled for the store view
- Verify Magento cron is running (
bin/magento cron:run) - Check invitation status in the Invitations admin grid
- Confirm order reached complete status (not closed only)
AI emails fall back to templates
- Verify
Toweringmedia_AiCoreis installed and enabled - Check AI drafting is enabled in configuration
Feed empty or missing reviews
- Reviews must be approved in Review Submissions
- Confirm feed is enabled in syndication settings
Frequently Asked Questions
Does the customer need a Magento account?
No. All customer-facing links use secure tokens tied to the order invitation.
Can I send the review request in the first email?
By design, the first email is an experience check only. Review collection happens on the thank-you page or via the backup review-invite email after a positive response.
Does it work with virtual or downloadable products?
Yes. Virtual orders skip shipment tracking and use completion-based delivery assumptions.
How many reviews per order?
v0.1.x supports one review invitation per order (multi-SKU orders use the primary product context).