From 97e641de427db6a0f9caa4a513d9f283d572117b Mon Sep 17 00:00:00 2001
From: Kazem Alghasi <alghasi@live.com>
Date: Tue, 4 Aug 2026 11:38:36 +0330
Subject: [PATCH] feat(wp): add ifnex-bridge plugin for Laravel API integration

Implement a new WordPress plugin to bridge the frontend with the Laravel
logistics API. This includes:

- API client for secure shipment tracking via Bearer token
- Admin settings page for configuring API URL and Key
- Shortcodes for embedding tracking forms and status displays
- AJAX-based tracking form with real-time results and timeline view
---
 .../plugins/ifnex-bridge/ifnex-bridge.php     |  52 +++++
 .../ifnex-bridge/includes/api-client.php      |  54 +++++
 .../ifnex-bridge/includes/shortcodes.php      |  88 ++++++++
 .../ifnex-bridge/includes/tracking-form.php   | 206 ++++++++++++++++++
 4 files changed, 400 insertions(+)
 create mode 100644 03_WordPress/wp-content/plugins/ifnex-bridge/ifnex-bridge.php
 create mode 100644 03_WordPress/wp-content/plugins/ifnex-bridge/includes/api-client.php
 create mode 100644 03_WordPress/wp-content/plugins/ifnex-bridge/includes/shortcodes.php
 create mode 100644 03_WordPress/wp-content/plugins/ifnex-bridge/includes/tracking-form.php

diff --git a/03_WordPress/wp-content/plugins/ifnex-bridge/ifnex-bridge.php b/03_WordPress/wp-content/plugins/ifnex-bridge/ifnex-bridge.php
new file mode 100644
index 0000000..e5638fb
--- /dev/null
+++ b/03_WordPress/wp-content/plugins/ifnex-bridge/ifnex-bridge.php
@@ -0,0 +1,52 @@
+<?php
+/**
+ * Plugin Name: IFNEX Logistics Bridge
+ * Description: اتصال فرانت‌اند سایت ایف‌نکس به API لاراول
+ * Version: 1.0
+ * Author: VernaSoft group (Kazem Alghasi)
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+    exit; 
+}
+
+// لود کردن فایل‌های پلاگین
+require_once plugin_dir_path( __FILE__ ) . 'includes/api-client.php';
+require_once plugin_dir_path( __FILE__ ) . 'includes/shortcodes.php';
+require_once plugin_dir_path( __FILE__ ) . 'includes/tracking-form.php';
+
+// اضافه کردن لینک به منوی پیشخوان وردپرس
+add_action( 'admin_menu', 'ifnex_plugin_setup_menu' );
+function ifnex_plugin_setup_menu() {
+    add_menu_page( 'تنظیمات IFNEX', 'IFNEX', 'manage_options', 'ifnex-settings', 'ifnex_settings_page_html', 'dashicons-location-alt', 30 );
+}
+
+function ifnex_settings_page_html() {
+    if (isset($_POST['ifnex_api_url']) && check_admin_referer('ifnex_settings_save')) {
+        update_option('ifnex_api_url', sanitize_url($_POST['ifnex_api_url']));
+        update_option('ifnex_api_key', sanitize_text_field($_POST['ifnex_api_key']));
+        echo '<div class="notice notice-success"><p>تنظیمات ذخیره شد.</p></div>';
+    }
+    
+    $api_url = get_option('ifnex_api_url', 'http://localhost:8000/api/v1');
+    $api_key = get_option('ifnex_api_key', '');
+    ?>
+    <div class="wrap">
+        <h1>تنظیمات IFNEX Logistics Bridge</h1>
+        <form method="post">
+            <?php wp_nonce_field('ifnex_settings_save'); ?>
+            <table class="form-table">
+                <tr>
+                    <th scope="row"><label for="ifnex_api_url">API URL</label></th>
+                    <td><input type="text" id="ifnex_api_url" name="ifnex_api_url" value="<?php echo esc_attr($api_url); ?>" class="regular-text" placeholder="http://localhost:8000/api/v1"></td>
+                </tr>
+                <tr>
+                    <th scope="row"><label for="ifnex_api_key">API Key</label></th>
+                    <td><input type="text" id="ifnex_api_key" name="ifnex_api_key" value="<?php echo esc_attr($api_key); ?>" class="regular-text"></td>
+                </tr>
+            </table>
+            <?php submit_button('ذخیره تنظیمات'); ?>
+        </form>
+    </div>
+    <?php
+}
diff --git a/03_WordPress/wp-content/plugins/ifnex-bridge/includes/api-client.php b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/api-client.php
new file mode 100644
index 0000000..bd94bb4
--- /dev/null
+++ b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/api-client.php
@@ -0,0 +1,54 @@
+<?php
+/**
+ * IFNEX API Client
+ * اتصال به API لاراول برای استعلام ترکینگ
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+    exit;
+}
+
+class IFNEX_API_Client {
+    private $api_url;
+    private $api_key;
+
+    public function __construct() {
+        $this->api_url = rtrim(get_option('ifnex_api_url', 'http://localhost:8000/api/v1'), '/');
+        $this->api_key = get_option('ifnex_api_key', '');
+    }
+
+    public function track_shipment($awb_no) {
+        if (empty($this->api_key)) {
+            return new WP_Error('no_api_key', 'API Key تنظیم نشده است.');
+        }
+
+        $url = $this->api_url . '/track/' . urlencode($awb_no);
+        
+        $args = array(
+            'headers' => array(
+                'Authorization' => 'Bearer ' . $this->api_key,
+                'Accept' => 'application/json',
+            ),
+            'timeout' => 30,
+        );
+
+        $response = wp_remote_get($url, $args);
+
+        if (is_wp_error($response)) {
+            return $response;
+        }
+
+        $body = wp_remote_retrieve_body($response);
+        $data = json_decode($body, true);
+
+        if ($response['response']['code'] === 404) {
+            return new WP_Error('not_found', 'مرسوله‌ای با این کد پیدا نشد.');
+        }
+
+        if ($response['response']['code'] !== 200) {
+            return new WP_Error('api_error', 'خطا در ارتباط با API: ' . ($data['message'] ?? 'Unknown error'));
+        }
+
+        return $data;
+    }
+}
diff --git a/03_WordPress/wp-content/plugins/ifnex-bridge/includes/shortcodes.php b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/shortcodes.php
new file mode 100644
index 0000000..d9f5651
--- /dev/null
+++ b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/shortcodes.php
@@ -0,0 +1,88 @@
+<?php
+/**
+ * IFNEX Shortcodes
+ * شورت‌کدهای پلاگین IFNEX Bridge
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+    exit;
+}
+
+// شورت‌کد فرم ترکینگ
+add_shortcode('ifnex_tracking_form', 'ifnex_tracking_form_shortcode');
+
+function ifnex_tracking_form_shortcode($atts) {
+    $atts = shortcode_atts(array(
+        'title' => 'رهگیری مرسوله',
+        'placeholder' => 'شماره بارنامه را وارد کنید',
+        'button_text' => 'رهگیری',
+    ), $atts);
+
+    ob_start();
+    ?>
+    <div class="ifnex-tracking-container">
+        <h2><?php echo esc_html($atts['title']); ?></h2>
+        <form id="ifnex-tracking-form" class="ifnex-tracking-form">
+            <div class="ifnex-form-group">
+                <input type="text" id="ifnex-awb-input" placeholder="<?php echo esc_attr($atts['placeholder']); ?>" required>
+                <button type="submit" id="ifnex-track-btn"><?php echo esc_html($atts['button_text']); ?></button>
+            </div>
+        </form>
+        <div id="ifnex-tracking-result" class="ifnex-tracking-result" style="display: none;"></div>
+    </div>
+    <?php
+    return ob_get_clean();
+}
+
+// شورت‌کد نمایش وضعیت مستقیم
+add_shortcode('ifnex_tracking_status', 'ifnex_tracking_status_shortcode');
+
+function ifnex_tracking_status_shortcode($atts) {
+    $atts = shortcode_atts(array(
+        'awb' => '',
+    ), $atts);
+
+    if (empty($atts['awb'])) {
+        return '<p>شماره بارنامه وارد نشده است.</p>';
+    }
+
+    $client = new IFNEX_API_Client();
+    $result = $client->track_shipment($atts['awb']);
+
+    if (is_wp_error($result)) {
+        return '<p class="ifnex-error">' . esc_html($result->get_error_message()) . '</p>';
+    }
+
+    ob_start();
+    ?>
+    <div class="ifnex-tracking-status">
+        <h3>وضعیت مرسوله <?php echo esc_html($result['awb_no'] ?? ''); ?></h3>
+        <div class="ifnex-status-badge">
+            <?php echo esc_html($result['status'] ?? 'نامشخص'); ?>
+        </div>
+        <div class="ifnex-details">
+            <p><strong>نوع:</strong> <?php echo esc_html($result['type'] ?? ''); ?></p>
+            <p><strong>جهت:</strong> <?php echo esc_html($result['direction'] ?? ''); ?></p>
+            <p><strong>فرستنده:</strong> <?php echo esc_html($result['sender']['name'] ?? ''); ?></p>
+            <p><strong>گیرنده:</strong> <?php echo esc_html($result['receiver']['name'] ?? ''); ?></p>
+        </div>
+        <?php if (!empty($result['timeline']) && is_array($result['timeline'])): ?>
+            <div class="ifnex-timeline">
+                <h4>تاریخچه رهگیری</h4>
+                <ul>
+                    <?php foreach ($result['timeline'] as $event): ?>
+                        <li>
+                            <strong><?php echo esc_html($event['event_date'] ?? ''); ?></strong>
+                            <span><?php echo esc_html($event['event_description'] ?? ''); ?></span>
+                            <?php if (!empty($event['location'])): ?>
+                                <small><?php echo esc_html($event['location']); ?></small>
+                            <?php endif; ?>
+                        </li>
+                    <?php endforeach; ?>
+                </ul>
+            </div>
+        <?php endif; ?>
+    </div>
+    <?php
+    return ob_get_clean();
+}
diff --git a/03_WordPress/wp-content/plugins/ifnex-bridge/includes/tracking-form.php b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/tracking-form.php
new file mode 100644
index 0000000..2651871
--- /dev/null
+++ b/03_WordPress/wp-content/plugins/ifnex-bridge/includes/tracking-form.php
@@ -0,0 +1,206 @@
+<?php
+/**
+ * IFNEX Tracking Form Handler
+ * JavaScript و منطق فرم رهگیری
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+    exit;
+}
+
+add_action('wp_footer', 'ifnex_tracking_form_scripts');
+
+function ifnex_tracking_form_scripts() {
+    // فقط اگر شورت‌کد در صفحه وجود دارد، اسکریپت را لود کن
+    global $post;
+    if (is_a($post, 'WP_Post') && has_shortcode($post->post_content, 'ifnex_tracking_form')) {
+        ?>
+        <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            var form = document.getElementById('ifnex-tracking-form');
+            if (!form) return;
+
+            form.addEventListener('submit', function(e) {
+                e.preventDefault();
+                
+                var input = document.getElementById('ifnex-awb-input');
+                var resultDiv = document.getElementById('ifnex-tracking-result');
+                var btn = document.getElementById('ifnex-track-btn');
+                var awb = input.value.trim();
+                
+                if (!awb) {
+                    resultDiv.innerHTML = '<p class="ifnex-error">لطفاً شماره بارنامه را وارد کنید.</p>';
+                    resultDiv.style.display = 'block';
+                    return;
+                }
+
+                btn.disabled = true;
+                btn.textContent = 'در حال جستجو...';
+                resultDiv.style.display = 'block';
+                resultDiv.innerHTML = '<p>در حال جستجو...</p>';
+
+                var xhr = new XMLHttpRequest();
+                xhr.open('POST', '<?php echo esc_url(admin_url('admin-ajax.php')); ?>', true);
+                xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
+                xhr.onload = function() {
+                    btn.disabled = false;
+                    btn.textContent = '<?php echo esc_js(__('رهگیری', 'ifnex-bridge')); ?>';
+                    
+                    if (xhr.status === 200) {
+                        var data = JSON.parse(xhr.responseText);
+                        if (data.success) {
+                            resultDiv.innerHTML = data.html;
+                        } else {
+                            resultDiv.innerHTML = '<p class="ifnex-error">' + data.message + '</p>';
+                        }
+                    } else {
+                        resultDiv.innerHTML = '<p class="ifnex-error">خطا در ارتباط با سرور.</p>';
+                    }
+                };
+                xhr.onerror = function() {
+                    btn.disabled = false;
+                    btn.textContent = '<?php echo esc_js(__('رهگیری', 'ifnex-bridge')); ?>';
+                    resultDiv.innerHTML = '<p class="ifnex-error">خطا در ارتباط با سرور.</p>';
+                };
+                xhr.send('action=ifnex_track_shipment&awb=' + encodeURIComponent(awb));
+            });
+        });
+        </script>
+        <style>
+        .ifnex-tracking-container {
+            max-width: 600px;
+            margin: 20px auto;
+            padding: 20px;
+            border: 1px solid #ddd;
+            border-radius: 8px;
+            font-family: inherit;
+        }
+        .ifnex-tracking-form {
+            margin-bottom: 20px;
+        }
+        .ifnex-form-group {
+            display: flex;
+            gap: 10px;
+        }
+        .ifnex-form-group input {
+            flex: 1;
+            padding: 10px;
+            border: 1px solid #ddd;
+            border-radius: 4px;
+            font-size: 16px;
+        }
+        .ifnex-form-group button {
+            padding: 10px 20px;
+            background: #0073aa;
+            color: white;
+            border: none;
+            border-radius: 4px;
+            cursor: pointer;
+            font-size: 16px;
+        }
+        .ifnex-form-group button:hover {
+            background: #005a87;
+        }
+        .ifnex-form-group button:disabled {
+            background: #ccc;
+            cursor: not-allowed;
+        }
+        .ifnex-tracking-result {
+            margin-top: 20px;
+            padding: 15px;
+            background: #f9f9f9;
+            border-radius: 4px;
+        }
+        .ifnex-error {
+            color: #dc3232;
+        }
+        .ifnex-tracking-status h3 {
+            margin-top: 0;
+        }
+        .ifnex-status-badge {
+            display: inline-block;
+            padding: 5px 10px;
+            background: #0073aa;
+            color: white;
+            border-radius: 4px;
+            margin-bottom: 10px;
+        }
+        .ifnex-timeline {
+            margin-top: 20px;
+        }
+        .ifnex-timeline ul {
+            list-style: none;
+            padding: 0;
+        }
+        .ifnex-timeline li {
+            padding: 10px;
+            border-bottom: 1px solid #eee;
+        }
+        .ifnex-timeline li:last-child {
+            border-bottom: none;
+        }
+        </style>
+        <?php
+    }
+}
+
+// AJAX Handler
+add_action('wp_ajax_ifnex_track_shipment', 'ifnex_track_shipment_ajax');
+add_action('wp_ajax_nopriv_ifnex_track_shipment', 'ifnex_track_shipment_ajax');
+
+function ifnex_track_shipment_ajax() {
+    $awb = isset($_POST['awb']) ? sanitize_text_field($_POST['awb']) : '';
+    
+    if (empty($awb)) {
+        wp_send_json(array('success' => false, 'message' => 'شماره بارنامه وارد نشده است.'));
+        return;
+    }
+
+    $client = new IFNEX_API_Client();
+    $result = $client->track_shipment($awb);
+
+    if (is_wp_error($result)) {
+        wp_send_json(array('success' => false, 'message' => $result->get_error_message()));
+        return;
+    }
+
+    // ساخت HTML نتیجه
+    ob_start();
+    ?>
+    <div class="ifnex-tracking-status">
+        <h3>وضعیت مرسوله <?php echo esc_html($result['awb_no'] ?? ''); ?></h3>
+        <div class="ifnex-status-badge">
+            <?php echo esc_html($result['status'] ?? 'نامشخص'); ?>
+        </div>
+        <div class="ifnex-details">
+            <p><strong>نوع:</strong> <?php echo esc_html($result['type'] ?? ''); ?></p>
+            <p><strong>جهت:</strong> <?php echo esc_html($result['direction'] ?? ''); ?></p>
+            <?php if (!empty($result['sender']['name'])): ?>
+                <p><strong>فرستنده:</strong> <?php echo esc_html($result['sender']['name']); ?></p>
+            <?php endif; ?>
+            <?php if (!empty($result['receiver']['name'])): ?>
+                <p><strong>گیرنده:</strong> <?php echo esc_html($result['receiver']['name']); ?></p>
+            <?php endif; ?>
+        </div>
+        <?php if (!empty($result['timeline']) && is_array($result['timeline'])): ?>
+            <div class="ifnex-timeline">
+                <h4>تاریخچه رهگیری</h4>
+                <ul>
+                    <?php foreach (array_reverse($result['timeline']) as $event): ?>
+                        <li>
+                            <strong><?php echo esc_html($event['event_date'] ?? ''); ?></strong>
+                            <span><?php echo esc_html($event['event_description'] ?? ''); ?></span>
+                            <?php if (!empty($event['location'])): ?>
+                                <small><?php echo esc_html($event['location']); ?></small>
+                            <?php endif; ?>
+                        </li>
+                    <?php endforeach; ?>
+                </ul>
+            </div>
+        <?php endif; ?>
+    </div>
+    <?php
+    $html = ob_get_clean();
+    
+    wp_send_json(array('success' => true, 'html' => $html));
+}