Thenine Logistic

Descripcion

Thenine Logistic is a professional WordPress plugin that provides a complete Order Management System (OMS) integrated with WooCommerce. It features a modern admin dashboard, custom login page, and full WordPress authentication integration.

Key Features

• Order Management System (OMS) – Complete order management interface
• WooCommerce Integration – Seamlessly syncs with WooCommerce orders
• Modern Admin Dashboard – Clean and intuitive interface
• Custom Login Page – Professional login interface
• Package Management – Track and manage order packages
• Order Tracking – Built-in tracking shortcode for customers
• Client Management – Manage clients and their orders
• AJAX-powered – Fast, responsive interface without page reloads
• Translation Ready – Full i18n support
• Security First – Nonces, sanitization, and capability checks

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• WooCommerce plugin (required)

Development

Hooks & Filters

The plugin provides many hooks for extensibility:

Action Hooks:
* logistic_loaded – Fired when plugin is loaded
* logistic_activated – Fired when plugin is activated
* logistic_deactivated – Fired when plugin is deactivated
* logistic_uninstall – Fired when plugin is uninstalled

Filters:
* logistic_login_url – Filter login URL
* logistic_login_redirect – Filter redirect URL after login
* logistic_login_error – Filter error messages
* logistic_sanitize_settings – Filter settings when saving

Support

For support, please visit the WordPress.org support forums.

Additional Information

Database Structure

The plugin creates the following database tables (all prefixed with wp_logistic_):

• orders – Stores order information synced from WooCommerce
• order_items – Stores individual items within orders
• packages – Tracks packages associated with orders
• clients – Manages client/customer information
• fulfillment_orders – Handles fulfillment workflow
• pack_tasks – Package packing tasks
• pick_tasks – Inventory picking tasks
• pick_task_items – Items in picking tasks
• shipments – Shipping and tracking information
• inventory – Inventory management
• locations – Warehouse and storage locations
• warehouses – Warehouse information
• reservations – Inventory reservations
• audit_logs – Complete audit trail of all changes

All tables are automatically created during plugin activation and removed during uninstallation.

API & Integration

The plugin integrates seamlessly with WooCommerce:

• Automatic order synchronization from WooCommerce
• Real-time order status updates
• Package tracking integration
• Client management linked to WooCommerce customers

Shortcodes

• [thenlo_oms_tracking] – Displays order tracking form for customers. Supports manual entry and QR code scanning (when QR library is available).

User Capabilities

The plugin uses WordPress capabilities system:

• manage_logistic – Main capability to access Logistic features
• manage_logistic_orders – Manage orders
• manage_logistic_packages – Manage packages
• manage_logistic_clients – Manage clients

These capabilities are automatically assigned to administrators on plugin activation.

Performance Considerations

• Database queries are optimized with proper indexing
• AJAX-powered interface reduces page reloads
• Audit logs are stored efficiently with JSON metadata
• Caching-friendly architecture

Security Features

• All user inputs are sanitized and validated
• SQL queries use prepared statements
• Nonce verification for all form submissions
• Capability checks for all admin functions
• Output escaping for all displayed data

Compatibility

• WordPress: 5.0+
• PHP: 7.4+
• WooCommerce: Latest stable version
• MySQL: 5.6+ / MariaDB: 10.0+

Migration System

The plugin includes a robust migration system that automatically handles database schema updates. Migrations run automatically on plugin activation and updates.

Extensibility

The plugin is built with extensibility in mind:

• Action hooks for plugin lifecycle events
• Filters for customizing URLs, redirects, and error messages
• Repository pattern for easy data access
• Service layer for business logic
• Provider interface for shipping integrations

Development

For developers, the plugin follows WordPress coding standards:

• PSR-4 compatible autoloading structure
• Object-oriented architecture
• Comprehensive error handling
• Full WordPress Coding Standards compliance

External Services

This plugin optionally uses third-party shipping API services for shipping label generation and tracking.

Shippo API

• Service: Shippo (https://goshippo.com)
• Purpose: Generate shipping labels and track packages (optional feature)
• When used: Only when Shippo provider is configured and API key is provided in plugin settings
• Data sent: Shipping address, package dimensions, weight, carrier information
• Privacy Policy: https://goshippo.com/privacy/
• Terms of Service: https://goshippo.com/terms/
• Note: This is an optional integration. The plugin works fully without Shippo. Shippo integration requires a Shippo account and API key.

ShipStation API

• Service: ShipStation (https://www.shipstation.com)
• Purpose: Generate shipping labels and track packages (optional feature)
• When used: Only when ShipStation provider is configured and API credentials (API key and API secret) are provided in plugin settings
• Data sent: Shipping address, package dimensions, weight, carrier information, order details
• Privacy Policy: https://www.shipstation.com/privacy-policy/
• Terms of Service: https://www.shipstation.com/terms-of-service/
• Note: This is an optional integration. The plugin works fully without ShipStation. ShipStation integration requires a ShipStation account and API credentials.

Source Code for Minified Libraries

This plugin includes minified JavaScript libraries. The source code for these libraries is publicly available:

jQuery Vector Map (jvectormap)

• Library: jvectormap (jQuery Vector Map)
• Minified file: assets/libs/jvectormap/jquery-jvectormap.min.js
• Source code: Available at https://github.com/bjornd/jvectormap
• License: MIT License
• Note: This library is used for displaying interactive maps in the admin dashboard.

SimpleBar

• Library: SimpleBar (Custom scrollbar)
• Minified file: assets/libs/simplebar/dist/simplebar.min.js
• Source code: Available at https://github.com/grsmto/simplebar
• License: MIT License
• Note: This library is used for custom scrollbar styling in the admin interface.

Credits