JCWT Order Timeline for WooCommerce

Lightweight, HPOS-Compatible Order Tracking Timeline for WooCommerce

Version 1.0.0

About JCWT Order Timeline for WooCommerce

JCWT Order Timeline for WooCommerce is a premium WordPress plugin designed to enhance your WooCommerce store with a beautiful, intuitive visual timeline that helps customers track their order status from placement to delivery. Built with performance and compatibility in mind, it seamlessly integrates with WooCommerce's latest High-Performance Order Storage (HPOS) system.

Developed by JC Web Technologies
Established in 2015, JC Web Technologies is a leading web design, hosting & bulk SMS company providing industry-leading, trustworthy, and reliable website services.

Key Features

✅ HPOS Compatible

Fully supports WooCommerce's High-Performance Order Storage for optimal database performance.

🎨 Customizable Design

Adjust colors, text, and styling to perfectly match your brand identity.

⚡ Performance Optimized

Built-in caching with Redis/Memcached support for lightning-fast load times.

📱 Mobile Responsive

Beautiful timeline display that looks great on all devices and screen sizes.

🌍 Translation Ready

Fully translatable with .pot file included for international stores.

🔒 Secure Code

Follows WordPress coding standards with security best practices.

Installation Guide

Automatic Installation

  1. Log in to your WordPress admin dashboard
  2. Navigate to Plugins → Add New
  3. Search for "JCWT Order Timeline for WooCommerce"
  4. Click Install Now and then Activate
  5. Go to Order Timeline → Settings to configure

Manual Installation

  1. Download the plugin zip file
  2. Upload to /wp-content/plugins/jcwt-order-timeline-for-woocommerce/ directory
  3. Activate the plugin through the Plugins screen in WordPress
  4. Navigate to Order Timeline → Settings to configure
💡 Pro Tip: After installation, customize the brand color and text messages to match your store's theme for a seamless customer experience.

Configuration Options

Setting Description Default
Brand Color Primary color for timeline elements #667eea
Show on Account Page Display timeline on My Account order view Enabled
Show on Tracking Page Display timeline on order tracking page Enabled
Enable ETA Show estimated delivery time Enabled
ETA Range Minimum and maximum days for delivery estimate 5-7 days
Cache Duration How long to cache timeline data (hours) 6 hours

Frequently Asked Questions

Is this compatible with WooCommerce HPOS?
Yes! JCWT Order Timeline for WooCommerce is fully compatible with WooCommerce's High-Performance Order Storage (HPOS). It automatically detects whether HPOS is enabled and uses the appropriate database tables.
Does it work with caching plugins?
Absolutely! The plugin has built-in intelligent caching that works alongside WordPress caching plugins. It supports Redis and Memcached for optimal performance on high-traffic stores.
Can I customize the timeline appearance?
Yes! You can customize the brand color, all text messages for different order statuses, and control where the timeline appears. The settings page provides easy customization options.
Will this slow down my site?
No, the plugin is performance-optimized with intelligent caching. It only loads assets on relevant pages and uses minimal resources. Timeline data is cached to reduce database queries.
How do I translate the plugin?
The plugin is translation-ready. You can use the Loco Translate plugin or create .po/.mo files in the /languages/ directory. All strings are properly internationalized.
Does it work with my theme?
Yes! The timeline uses standard WooCommerce hooks and is designed to work with any properly coded WordPress theme. It integrates seamlessly with WooCommerce templates.
Can I use shortcodes to display the timeline?
Yes! The plugin automatically integrates with WooCommerce order tracking shortcodes. The timeline will appear on any page where order tracking is displayed.
What happens when I uninstall the plugin?
When you uninstall the plugin, all settings and cached data are automatically removed from your database. No trace of the plugin remains, keeping your database clean.

Developer Documentation

Hooks & Filters

JCWT Order Timeline for WooCommerce provides several hooks and filters for developers to customize functionality:

// Filter timeline data before display add_filter( 'jcwtot_timeline_data', function( $timeline, $order_id ) { // Modify timeline data return $timeline; }, 10, 2 ); // Filter cache duration dynamically add_filter( 'jcwtot_cache_duration', function( $duration, $order_id ) { return 12 * HOUR_IN_SECONDS; // 12 hours }, 10, 2 ); // Action after timeline render add_action( 'jcwtot_after_timeline', function( $order_id ) { // Your custom code }, 10, 1 );

Cache Management

The plugin uses an intelligent caching system that supports multiple backends:

  • Redis/Memcached: Automatically used if available via WordPress object cache
  • Database Transients: Fallback for standard WordPress installations
  • Auto-Invalidation: Cache is automatically cleared when order status changes
// Manually clear cache for an order JCWTOT_Cache::clear_order_cache( $order_id ); // Clear all timeline caches JCWTOT_Cache::clear_all_cache(); // Get cache statistics $stats = JCWTOT_Cache::get_stats();

File Structure

jcwt-order-timeline-for-woocommerce/ ├── assets/ │ ├── css/ │ │ ├── admin.css # Admin interface styles │ │ └── timeline.css # Timeline display styles │ └── js/ │ └── admin.js # Admin functionality ├── includes/ │ ├── class-jcwtot-admin.php # Admin menu & pages │ ├── class-jcwtot-cache.php # Caching system │ ├── class-jcwtot-settings.php # Settings management │ └── class-jcwtot-timeline.php # Timeline rendering ├── templates/ │ └── timeline.php # Timeline template └── jcwt-order-timeline-for-woocommerce.php # Main plugin file

Database Schema

The plugin respects WooCommerce's database structure and doesn't create any custom tables:

  • HPOS Mode: Uses wp_wc_orders and wp_wc_orders_meta
  • Legacy Mode: Uses wp_posts and wp_postmeta
  • Settings: Stored in wp_options table with JCWTOT_ prefix
  • Cache: Stored via WordPress transient API or object cache
⚠️ Important: The plugin automatically detects HPOS status and uses appropriate queries. No manual configuration needed.

Performance Optimization Tips

1. Enable Object Caching

For best performance on high-traffic stores, install Redis or Memcached with a compatible WordPress object cache plugin.

2. Adjust Cache Duration

Increase cache duration for stores where order statuses don't change frequently. Navigate to settings and adjust the cache duration slider.

3. Use HPOS

Enable WooCommerce High-Performance Order Storage for better database performance, especially with large order volumes.

4. Monitor Cache Statistics

Check the diagnostics panel in settings to monitor cache hit rates and optimize accordingly.

✅ Best Practice: With Redis and HPOS enabled, the plugin can handle 10,000+ orders with minimal performance impact.

Troubleshooting

Timeline Not Displaying

  1. Verify WooCommerce is installed and activated
  2. Check that the display options are enabled in Settings
  3. Clear your site's cache (if using a caching plugin)
  4. Check for JavaScript errors in browser console

Styling Issues

  1. Clear browser cache and reload the page
  2. Check if your theme overrides WooCommerce templates
  3. Try disabling other plugins to identify conflicts
  4. Inspect CSS with browser developer tools

Performance Issues

  1. Enable object caching (Redis/Memcached)
  2. Increase cache duration in settings
  3. Check cache statistics in diagnostics panel
  4. Enable WooCommerce HPOS if not already active

Changelog

Version 1.0.0 - December 28, 2025

  • 🎉 Initial release
  • ✅ HPOS compatibility
  • ⚡ Caching system with Redis support
  • 🎨 Customizable colors and text
  • 📱 Mobile-responsive design
  • 📍 Multiple display locations
  • ⚙️ Admin settings interface
  • 🔧 Diagnostic tools

Support & Contact

Need help with the plugin? We're here to assist you!

📧 Email Support

Contact us at [email protected]

🌐 Website

Visit www.jcwebtechnologies.com

📚 Documentation

Check our support portal

💬 Feature Requests

Have an idea? Let us know!

Get Support

About JC Web Technologies

Established in 2015, JC Web Technologies (formerly known as Echo Web Designing) is a leading web design, hosting & bulk SMS company in Vijayawada, Guntur, Chennai, and Hyderabad. We offer industry-leading, trustworthy, and reliable website services to customers at very affordable prices.

Our Services

  • Website Services
    • Website Designing
    • Web Hosting
    • WordPress Development
    • WooCommerce Solutions
  • Bulk SMS
    • Promotional SMS
    • Transactional SMS
  • Plugin Development
    • Custom WordPress Plugins
    • WooCommerce Extensions
🎉 Celebrating 10 years of excellence! We're proud to serve hundreds of satisfied customers with 100% satisfaction guarantee.