FisHotel ShipTracker WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA
Self-hosted shipment tracking for WooCommerce. Tracks UPS & USPS packages, sends automated email notifications, and provides a branded tracking page for customers.
Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/dierks27/fishotel-shiptracker/releases/download/v1.1.0/fishotel-shiptracker-v1.1.0.zipSelf-hosted shipment tracking for WooCommerce. Tracks UPS & USPS packages, sends automated email notifications, and provides a branded tracking experience for customers.
Requirements
- WordPress 5.8+
- PHP 7.4+
- WooCommerce 7.0+ (tested up to 9.6)
Installation
- Download the latest release from the Releases page.
- In your WordPress admin, go to Plugins > Add New > Upload Plugin.
- Upload the ZIP file and click Install Now.
- Activate the plugin.
Alternatively, clone this repository into your wp-content/plugins/ directory:
cd wp-content/plugins/
git clone https://github.com/Dierks27/fishotel-shiptracker.gitConfiguration
After activation, navigate to WooCommerce > ShipTracker in the WordPress admin.
Carrier Setup
UPS:
- Go to the Carriers tab.
- Enter your UPS OAuth Client ID and Client Secret.
- Toggle sandbox mode on/off as needed.
- Click Test Connection to verify credentials.
USPS:
- Go to the Carriers tab.
- Enter your USPS OAuth Client ID and Client Secret.
- Click Test Connection to verify credentials.
Settings
| Setting | Default | Description |
|---|---|---|
| Default Carrier | UPS | Carrier pre-selected when adding shipments |
| Auto-Detect Carrier | Enabled | Automatically identify carrier from tracking number format |
| Auto-Complete Orders | Enabled | Mark orders complete when shipment is delivered |
| Polling Interval | 3600s | How often to check carriers for tracking updates |
| Data Retention | 1095 days | How long to keep completed shipment data |
Email Notifications
The Email Templates tab lets you customize HTML email notifications sent at each shipment status change. Use the built-in email designer to preview and test templates.
Features
- Shipment Tracking - Automatic polling of UPS and USPS APIs via OAuth 2.0
- Order Integration - Add tracking numbers directly from the WooCommerce order edit screen
- Customer Portal - Tracking info displayed on the My Account > Orders page
- Email Notifications - Branded HTML emails sent on status changes
- Analytics Dashboard - KPIs and 30-day shipment charts
- Migration Tool - Import shipments from Advanced Shipment Tracking (AST) or TrackShip
- Auto-Updates - Receive plugin updates directly from GitHub releases
- HPOS Compatible - Supports WooCommerce High-Performance Order Storage
REST API
The plugin exposes REST endpoints under the fst/v1 namespace:
| Endpoint | Method | Description |
|---|---|---|
/fst/v1/shipments |
GET | List shipments (admin) |
/fst/v1/shipments |
POST | Create a shipment (admin) |
/fst/v1/shipments/{id} |
DELETE | Remove a shipment (admin) |
/fst/v1/shipments/{id}/recheck |
POST | Force a tracking update (admin) |
/fst/v1/track |
POST | Track a shipment (public) |
Development
File Structure
fishotel-shiptracker/
├── fishotel-shiptracker.php # Main plugin entry point
├── admin/
│ ├── css/admin.css # Admin styles
│ ├── js/admin.js # Admin JavaScript
│ └── views/ # Admin page templates
├── includes/
│ ├── class-fst-activator.php # Database setup
│ ├── class-fst-deactivator.php # Cleanup on deactivation
│ ├── class-fst-email.php # Email notification system
│ ├── class-fst-migrator.php # AST/TrackShip migration
│ ├── class-fst-myaccount.php # Customer account pages
│ ├── class-fst-order.php # Order meta box integration
│ ├── class-fst-rest-api.php # REST API endpoints
│ ├── class-fst-settings.php # Settings page
│ ├── class-fst-shipment.php # Shipment data model
│ ├── class-fst-tracker.php # Polling engine
│ ├── class-fst-updater.php # GitHub auto-updater
│ └── carriers/
│ ├── class-fst-carrier.php # Abstract carrier base
│ ├── class-fst-carrier-ups.php # UPS API integration
│ └── class-fst-carrier-usps.php # USPS API integration
└── assets/
└── css/frontend.css # Customer-facing stylesLicense
This software is proprietary. Copyright (C) 2024-2026 FisHotel. All rights reserved. See the LICENSE file for details.
Releases
Newest 25 of 51 recorded releases. Each count is every asset in that release; expand a row for the breakdown.