WP Manifestindependent plugin directory
manifest / ecommerce / deks-tracking

DEKS Tracker - Dual Tracking System (MachShip + EFM Logistics)

Wordpress Plugin soley for DEKS Industries Pty Ltd Tracker - Dual Tracking System (MachShip + EFM Logistics)

by Marie Apellanes · github.com/dackzui/deks-tracking · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/dackzui/deks-tracking/archive/refs/heads/main.zip
Readme github.com/dackzui/deks-tracking ↗

Dual Tracking System (MachShip + EFM Logistics)

This WordPress plugin provides a comprehensive tracking solution that integrates both MachShip and EFM Logistics tracking systems.

Features

  • MachShip Tracking: Full API integration with MachShip for detailed consignment information and POD downloads
  • EFM Logistics Tracking: Embedded integration with EFM Logistics tracking tool (displays inline)
  • Smart Dual Tracking: Search both systems with intelligent fallback - shows EFM tracking only when MachShip finds no results
  • Secure POD Downloads: Download proof of delivery documents from MachShip
  • REST API: Full REST API endpoints for custom integrations

Shortcodes

MachShip Only

[machship_tracking_form]

Displays a form that searches only the MachShip system.

Dual Tracking (Recommended)

[dual_tracking_form]

Displays a form that searches both MachShip and EFM Logistics systems simultaneously.

API Endpoints

MachShip Tracking

  • POST /wp-json/machship/v1/track
  • Searches MachShip system only
  • Returns detailed consignment information and POD download links

EFM Logistics Tracking

  • POST /wp-json/machship/v1/track-efm
  • Returns EFM tracking URL for the provided consignment code

Dual Tracking

  • POST /wp-json/machship/v1/track-dual
  • Searches both systems simultaneously
  • Returns results from both MachShip and EFM Logistics

POD Download

  • GET /wp-json/machship/v1/pods/{consignmentId}
  • Downloads proof of delivery documents from MachShip

Setup

  1. Install and activate the plugin
  2. Go to Settings → MachShip Tracking in WordPress admin
  3. Enter your MachShip API token
  4. Use the shortcodes on any page or post

Smart Tracking Behavior

The dual tracking system uses intelligent fallback logic:

  1. MachShip Found: Shows detailed MachShip results, hides EFM tracking
  2. MachShip Not Found: Shows EFM tracking widget as fallback
  3. Neither Found: Shows "No Tracking Results Found" message

This prevents cluttering the interface with multiple tracking systems when one already has results.

Usage Examples

Basic Tracking Form

Add this to any page or post:

[dual_tracking_form]

API Usage

// Track both systems
fetch('/wp-json/machship/v1/track-dual', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({code: 'MS00123456'})
})
.then(response => response.json())
.then(data => {
  console.log('MachShip:', data.machship);
  console.log('EFM:', data.efm);
});

Supported Tracking Codes

  • MachShip: MS numbers (MS00123456), numeric IDs, carrier consignment IDs, Reference1, Reference2
  • EFM Logistics: Any consignment number that works with their tracking tool

Styling

The plugin includes inline CSS for basic styling. You can customize the appearance by adding CSS to your theme or using the WordPress Customizer.

Version History

  • 0.3.0: Added EFM Logistics integration and dual tracking functionality
  • 0.2.0: Original MachShip-only version