=== CargoHub – Kargo Takip Sistemi ===
Contributors: romitetcreative
Donate link: https://www.romitetcreative.us
Tags: woocommerce, shipping, tracking, kargo, takip
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.3
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Cargo tracking for WooCommerce: add carriers and tracking numbers, email customers, and show tracking on My Account.

== Description ==

CargoHub, WooCommerce mağazaları için tasarlanmıştır. Gönderi bilgilerini yönetmeyi kolaylaştırır ve müşterileri kargo durumu hakkında bilgilendirir.

**Key Features**
- Custom cargo carriers (add and manage via admin)
- Email notifications to customers when tracking is added
- WooCommerce order integration and My Account display
- Responsive design and accessibility-friendly styles
- Security-conscious implementation (sanitization, escaping, nonces)

This plugin does not require any external services. All processing happens locally in WordPress.

Optionally, a separate PRO offering (distributed outside WordPress.org) provides additional features such as SMS integrations. The free plugin hosted here remains fully functional by itself.

== Installation ==

1. Upload to `/wp-content/plugins/cargohub-kargo-takip` or install via the Plugins screen
2. Activate the plugin from Plugins
3. Ensure WooCommerce is active
4. Open the CargoHub menu in WordPress admin
5. Add your cargo carriers
6. Add tracking info to orders

== Frequently Asked Questions ==

= Is WooCommerce required? =
Yes. WooCommerce must be installed and active.

= How many cargo carriers can I add? =
You can add cargo carriers from the admin without any built-in limits.

= Does it send SMS? =
This free plugin sends email notifications. SMS features are available in a separate PRO offering outside WordPress.org.

= Is it compatible with Turkish cargo companies? =
Yes. It’s tailored for Turkish e-commerce and supports defining local carriers.

= Is it mobile-friendly? =
Yes. It includes responsive styles for common breakpoints.

== Screenshots ==
1. Admin panel overview
2. Cargo companies management
3. Order tracking interface
4. Customer My Account integration
5. Email notification example

== Changelog ==

= 1.3.0 =
Admin experience and notification enhancements:
- Added comprehensive step-by-step "How to Use" onboarding guide and SMTP configuration tips to the admin panel
- Added official WordPress plugin directory link with target blank to email notification footer for improved visibility and user acquisition

= 1.2.5 =
Shipment notification refinement:
- Sent the shipment email even when the optional tracking code is empty
- Displayed a dash instead of a fabricated tracking value and hid the tracking link when no code exists
- Removed carrier-specific tracking code format warnings and restrictions

= 1.2.4 =
Order synchronization fix:
- Made the tracking code optional while keeping the carrier mandatory for the "Kargoya Verildi" status
- Persisted carrier-only shipment records without sending a tracking email
- Delayed tracking emails until WooCommerce confirms the shipped order status
- Synchronized the saved WooCommerce status with an accepted shipment request

= 1.2.3 =
Compatibility hardening:
- Prevented CargoHub from initializing when WooCommerce is unavailable, avoiding frontend fatal errors

= 1.2.2 =
Secure logging release:
- Protected plugin logs with non-guessable paths and Apache, IIS and direct PHP access controls
- Added automatic redaction for common credentials and personal tracking data
- Captured fatal PHP errors only when they originate from CargoHub files
- Limited daily logs to 5 MB, total logs to 50 MB and automatically removed logs older than 30 days
- Moved legacy predictable log files into the protected log directory

= 1.2.1 =
Stability and data-safety release:
- Prevented site-wide cache flushing during normal requests
- Required CargoHub nonce validation when saving tracking information
- Prevented the "Kargoya Verildi" status when carrier data is unavailable or incomplete
- Preserved orders, carrier definitions and active tracking records during uninstall
- Migrated "Kargoya Verildi" orders to "Tamamlandı" safely when the plugin is deleted
- Removed only obsolete tracking tombstones and temporary plugin data

= 1.2.0 =
Major performance, security and compatibility release:
- Added full support for WooCommerce HPOS (High-Performance Order Storage) and modern order edit screens
- Optimized database queries to avoid redundant table checks on frontend requests
- Enhanced logger with atomic file write mechanism to prevent memory exhaustion
- Added explicit capability checks for carrier management actions
- Synchronized JavaScript event listeners for live tracking format validation and placeholder styling
- Cleaned up unused helper methods and legacy code

= 1.1.1 =
Minor fixes and housekeeping:
- Bump version and stable tag
- Rename main plugin file to `cargohub-kargo-takip.php`
- Replace visible "FREE" labels with "CargoHub"

= 1.1.0 =
Compliance and improvements:
- Removed any limits/locks from the free plugin
- Standardized text domain and slug to `cargohub-kargo-takip`
- Improved sanitization and escaping in admin flows
- Removed inline CSS from email template head
- Minor UI/UX and performance tweaks

= 1.0.0 =
Initial release
- Custom carriers
- Email notifications
- WooCommerce integration
- Admin and My Account interfaces

== Upgrade Notice ==

= 1.3.0 =
Added step-by-step onboarding guide and SMTP tips to the admin panel, and updated tracking email footer with official plugin repository link.

= 1.2.5 =
Shipment emails now support empty tracking codes, and tracking code format warnings have been removed.

= 1.2.4 =
Order consistency update: allows carrier-only shipments and prevents tracking emails before the shipped status is saved.

= 1.2.3 =
Compatibility update: prevents frontend errors if WooCommerce becomes unavailable.

= 1.2.2 =
Security update: protects diagnostic logs from public access, redacts sensitive data and limits disk usage.

= 1.2.1 =
Data-safety update: preserves WooCommerce orders and tracking records while safely migrating the CargoHub order status during uninstall.

== Developer Information ==

Developed by **RomiTeT Creative**

- Website: https://www.romitetcreative.us
- Support: WordPress.org support forums
- Documentation: Included in the plugin admin panel

== Technical Requirements ==

- WordPress 5.0 or higher
- WooCommerce 5.0 or higher
- PHP 7.3 or higher
- MySQL 5.6 or higher

== Privacy Policy ==

This plugin does not collect personal data. All tracking information is stored locally in your WordPress database.

== Support ==

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