WPMake

← Back to BlogPost-Purchase Hub Installation Guide: From Zip File to Live in 5 MinutesTUTORIAL

Post-Purchase Hub Installation Guide: From Zip File to Live in 5 Minutes

⏱ 8 min read  ·  👤 david  ·  Sep 1, 2026

A clean install is the foundation for everything else Post-Purchase Hub does, and there is genuinely not much to it: upload, activate, walk the seven-step wizard, place one test order. The wizard itself claims about two minutes, which is roughly right if you already know your shipping times.

This guide covers the whole path from zip file to a live order timeline, with the exact screens and settings you will see along the way.

What you need before you start

  • WordPress 6.5 or newer (tested up to 7.1)
  • PHP 8.1 or newer — check under Tools → Site Health → Info → Server if you are not sure
  • WooCommerce, active. This is a hard requirement rather than a recommendation: the plugin will not activate without it.
  • The Post-Purchase Hub zip, or nothing at all if you would rather install from the plugin directory

It supports both High-Performance Order Storage and legacy post storage, so you do not need to change how WooCommerce stores orders first.

Step 1: Install the plugin

Two routes, both from Plugins → Add New. Search for WPMake Post-Purchase Hub and click Install Now, or choose Upload Plugin and select the zip. WordPress handles the extraction itself — no FTP, no unzipping, no file manager.

The WordPress Add Plugins screen with the Upload Plugin form open and a Choose File button
Plugins → Add New → Upload Plugin, or just search the directory for “WPMake Post-Purchase Hub”.

Step 2: Activate

Click Activate once the install finishes. Activation on its own changes nothing on your storefront — a notice appears pointing at the setup wizard, and until you finish that wizard your customers see exactly what they saw before.

That is worth knowing if you are installing on a live store mid-morning: there is no window where the site looks half-configured.

WordPress admin notice confirming Post-Purchase Hub is installed, with a Start the setup wizard button
Activation puts nothing live on its own — it points you at the setup wizard.

Step 3: Run the setup wizard

Click Run the setup wizard from the notice, or start it from WooCommerce → Post-Purchase Hub. It opens with a question rather than a settings form, and your answer decides which of the remaining steps you are shown:

  • Set everything up — the full walkthrough: order statuses, delivery estimates, tracking, what customers can do, and how it all appears.
  • Keep customers informed — timelines and delivery estimates only. The self-service actions keep their defaults.
  • Cut support tickets — cancellation requests, reordering, invoices and the help form. The timeline keeps the stage map the plugin ships with.
First screen of the Post-Purchase Hub setup wizard offering Set everything up, Keep customers informed, or Cut support tickets
The wizard asks what you are trying to achieve first, then only asks the questions that go with it.

The full path runs Welcome → Statuses → Delivery → Tracking → Actions → Display → Finish. Every step has a Skip this step link, and a skipped step keeps a sensible default you can change later on the settings screen.

Two steps are worth slowing down for. Statuses is where each WooCommerce status you use — including custom ones added by other plugins — is mapped onto a stage the customer sees, and where you mark internal statuses as not shown. Delivery is where handling time and per-shipping-method transit times go; skip it and customers simply see no estimate, which is honest but not very useful. The timeline walkthrough covers both screens in detail.

Step 4: Choose how it appears

The Display step is the one that decides how much of your theme is involved, and the safe answer is the default:

  • Additive — add to my theme’s pages (recommended). The plugin’s sections are added to the order pages your theme already draws, through WooCommerce’s own hooks.
  • Full replacement — use this plugin’s order page. Takes the order page layout over entirely. It looks different in every theme, and the plugin is blunt that this is the single biggest source of support tickets for plugins of this kind.
Setup wizard Display step offering Additive or Full replacement, with a preview of the order progress list built from a real order
The Display step previews the result using a real order from your store before anything goes live.

Stay additive unless you have a specific reason not to. The preview underneath is built from an actual order in your store, so what you see is what a customer would have seen.

Then press Finish and go live. That is the moment customers start seeing timelines.

Step 5: Find your settings

Everything afterwards lives at WooCommerce → Post-Purchase Hub, with six tabs down the left and a Search settings… box that filters as you type:

  • General — the status panel, and whether the plugin adds to or replaces your order pages
  • Timeline — status-to-stage mapping, delivery estimates, working days and holidays
  • Actions — what customers can do, and the rules around cancellation requests
  • Guest Access — order lookup for customers who checked out without an account
  • Emails — a pointer to where these emails are actually configured
  • Advanced — request history retention and what happens on uninstall
Post-Purchase Hub General settings tab showing the Status panel and the Order page display setting
The General tab opens with a Status panel: setup, tracking data, invoices, template conflicts, daily cleanup and database version.

Read the Status panel before you walk away. Nothing in it is a setting — it is what the other tabs have added up to. It states whether setup is complete and your order pages are live, whether a tracking plugin was detected, whether an invoice plugin was found, whether any template conflicts exist, when the daily cleanup next runs, and whether the database is up to date.

Step 6: Place a test order

Log in as a test customer, place a small order, and open My Account → Orders. The order table gains a Progress column showing the current stage and its timestamp, and only the actions that actually apply to each order. Open the order and you get the full Order progress list — Placed, Confirmed, Packed, Shipped, Out for delivery, Delivered — each marked Done, In progress or Not yet, with an estimated delivery range underneath.

Then move the order along a status from the admin and watch the timeline follow.

One thing that surprises people: orders placed before you installed the plugin show their stages without dates. WooCommerce does not keep a history of status changes, so the plugin can only record them from the moment it is active, and it shows an honest blank rather than an invented date. Run wp wpmphub backfill-timeline from WP-CLI to fill in what can be derived from the dates WooCommerce does store.

Optional: guest order lookup

If a lot of your customers check out without an account, enable it under Settings → Guest Access, then put the [wpmphub_order_lookup] shortcode on a page and link it from your footer or your order emails. It is off by default, and it is built so that guessing reveals nothing: the customer enters an order number and billing email, and the signed link is emailed to the address already on the order, never to the address typed into the form. It is rate limited, with a link lifetime you control.

First-run checklist

  1. Wizard finished, so the storefront is actually live
  2. Every status you use mapped to a stage, with internal statuses set to “not shown to customers”
  3. Handling time set, and a transit time on every shipping method you offer
  4. Self-service actions chosen, and the cancellation request rules reviewed
  5. Order page display left on Additive unless you deliberately chose otherwise
  6. Test order placed, Progress column and Order progress list both confirmed
  7. Order emails checked — see branding your post-purchase emails

Frequently asked questions

Will this break my theme’s My Account page?

It is designed not to. Additive mode adds sections through WooCommerce’s own hooks and leaves your templates alone. Full replacement is opt-in, and the plugin checks first whether your theme has customised those templates — if it has, replacement stays off rather than producing a broken page.

Do I need a tracking plugin for it to be useful?

No. Without one, customers see a delivery estimate worked out from your handling and transit times. If you do run Advanced Shipment Tracking or WooCommerce Shipment Tracking, real tracking data replaces the estimate automatically and you do not have to do anything.

What happens to my data if I delete the plugin?

Nothing is deleted unless you ask for it. Settings and request history stay in place, so reinstalling picks up where you left off. If you would rather it cleaned up after itself, switch on Delete all data when uninstalling under Settings → Advanced first — that one has no undo.

Does it send anything to an external server?

No. The plugin makes no outbound HTTP requests of any kind — no telemetry, no update pings, no remote fonts or images, no analytics.

Where to go next

With the install done, the two settings that change the most for customers are the timeline and the self-service actions. Start with customising the order status timeline, then set up self-service order cancellations. If you are still deciding whether any of this is worth the effort, the case for an Amazon-level post-purchase experience makes the argument in about two minutes.

Post-Purchase Hub Installation Guide: From Zip File to Live in 5 Minutes