وضعیت سفارشات وب تنان

A lightweight and user-friendly WordPress plugin for WooCommerce that allows customers to check the status of their orders by entering their phone number and optional email address.

This plugin is designed to make order tracking simple, fast, and accessible for WooCommerce store customers without requiring them to log in to their account.

---

🚀 Overview

WebTanan WooCommerce Order Status provides a simple shortcode-based order tracking form for WooCommerce websites.

Customers can enter their billing phone number and, optionally, their email address to view related WooCommerce orders. The plugin displays useful order information such as order number, order status, order date, and total amount.

If an order does not have an email address registered, the plugin displays the message:

Email is not registered.

---

✨ Features

• 🔎 Check WooCommerce order status by phone number
• 📧 Optional email-based order filtering
• 📦 Display customer order list
• 🧾 Show order number, status, date, and total amount
• ⚠️ Display a proper message when no email is registered for an order
• 🧩 Easy shortcode integration
• ⚡ Lightweight and simple to use
• 🛒 Built specifically for WooCommerce
• 👤 No customer login required
• 📱 Suitable for mobile and desktop pages

---

🧩 Shortcode

Use the following shortcode on any WordPress page where you want to display the order status form:

[webtanan_order_status]

Example:

[webtanan_order_status]

After adding the shortcode, customers will be able to search and view their WooCommerce order status directly from that page.

---

📋 Displayed Order Information

The plugin can display the following order details:

Order Number
Order Status
Order Date
Order Total Amount
Customer Phone Number
Customer Email Status

If the email field is empty or not registered in the order, the plugin will show:

Email is not registered.

---

⚙️ Installation

Method 1: Install from WordPress Dashboard

1. Download the plugin folder.
2. Compress the folder named:

webtanan-order-status

3. Create a ZIP file from the plugin folder.
4. Go to your WordPress admin dashboard.
5. Navigate to:

Plugins > Add New > Upload Plugin

6. Upload the ZIP file.
7. Click Install Now.
8. Activate the plugin.

---

🛠️ Requirements

Before using this plugin, make sure the following requirements are met:

WordPress installed and running
WooCommerce installed and activated
PHP compatible with your WordPress version
A valid WooCommerce order database

Note: This plugin requires WooCommerce to be installed and activated in order to work correctly.

---

🧪 How It Works

1. The customer opens the order status page.
2. The customer enters their phone number.
3. The customer may optionally enter their email address.
4. The plugin searches WooCommerce orders based on the provided information.
5. Matching orders are displayed in a clean list.
6. If the order email is missing, the plugin displays a proper notice.

---

📌 Usage Example

Create a new WordPress page named:

Order Status

Then place this shortcode inside the page content:

[webtanan_order_status]

Publish the page and share the page link with your customers.

---

🖥️ Example Output

The customer can see a list of matching orders similar to:

Order Number: #1234
Status: Processing
Date: 2026-05-30
Total Amount: $120.00
Email: customer@example.com

If no email exists for the order:

Order Number: #1235
Status: Completed
Date: 2026-05-30
Total Amount: $85.00
Email: Email is not registered.

---

🔐 Privacy & Security

This plugin is designed to show order information based on customer-provided details.

Recommended security practices:

• Do not display sensitive customer data publicly.
• Use phone and email verification where needed.
• Keep WooCommerce and WordPress updated.
• Use HTTPS on your website.
• Limit displayed order details to necessary information only.

---

📁 Suggested Plugin Structure

webtanan-order-status/
├── webtanan-order-status.php
├── includes/
│   ├── class-order-status.php
│   └── helpers.php
├── assets/
│   ├── css/
│   │   └── style.css
│   └── js/
│       └── script.js
├── languages/
└── README.md

---

🗺️ Roadmap

• [ ] Add AJAX order search
• [ ] Add custom styling options
• [ ] Add Persian language support
• [ ] Add admin settings page
• [ ] Add order status color badges
• [ ] Add SMS verification before showing orders
• [ ] Add CAPTCHA protection
• [ ] Add export/search log for admin
• [ ] Add support for custom WooCommerce order statuses

---

❓ FAQ

Does this plugin require WooCommerce?

Yes. WooCommerce must be installed and activated for this plugin to work correctly.

Can customers check orders without logging in?

Yes. Customers can check their orders using their phone number and optional email address.

What happens if the order email is empty?

The plugin displays:

Email is not registered.

Can I place the form on any page?

Yes. You can place the shortcode on any page, post, or supported content area.

---

👨‍💻 Developer

Developed by WebTanan

Website: webtanan.com

---

📄 License

This plugin can be released under the GPL-2.0-or-later license, which is commonly used for WordPress plugins.

---

⭐ Support

If this plugin helps your WooCommerce store, consider supporting the project by giving it a star on GitHub.

Simple Order Tracking.
Better Customer Experience.
Built for WooCommerce.