Amadast Shipping

افزونه آمادست یک راهکار حرفه‌ای برای محاسبه آنلاین هزینه ارسال در ووکامرس است که به فروشگاه شما امکان می‌دهد هزینه ارسال سفارشات را به‌صورت لحظه‌ای و هوشمند محاسبه کرده و در اختیار مشتریان قرار دهد.

با استفاده از آمادست می‌توانید روش‌های مختلف ارسال را مدیریت کرده، هزینه ارسال را بر اساس وزن، ارزش کالا، شهر مبدا و مقصد محاسبه کنید و تجربه خرید بهتری برای مشتریان خود فراهم نمایید.

ویژگی‌های اصلی افزونه:

• محاسبه آنلاین و لحظه‌ای هزینه ارسال
• لیست داینامیک سرویس‌دهندگان از API آمادست (همراه با پیک و تحویل حضوری)
• نمایش هزینه ارسال در صفحه سبد خرید و تسویه حساب
• امکان تعریف روش‌های ارسال سفارشی
• محدودیت وزن برای هر سرویس ارسال
• اولویت‌بندی نمایش روش‌های ارسال
• پشتیبانی از پرداخت در محل (COD)
• تخمین هوشمند هزینه ارسال در صورت عدم دسترسی سرویس اصلی
• تشخیص هوشمند نوع بسته‌بندی با استفاده از هوش مصنوعی
• تست هزینه حمل‌ونقل در پنل مدیریت (چند محصول و مقایسه شهرها)
• ارسال رایگان بر اساس مبلغ سبد یا شهرهای خاص
• غیرفعال‌سازی سرویس‌دهنده برای شهرهای مشخص
• آیکون سرویس‌دهندگان در پنل و (اختیاری) در صفحه پرداخت
• انتخاب موقعیت مکانی مشتری روی نقشه
• سازگاری کامل با ووکامرس و نسخه‌های جدید وردپرس
• ابزارهای مدیریتی، لاگ فعالیت و سوالات متداول

آمادست مناسب فروشگاه‌هایی است که می‌خواهند هزینه ارسال را به‌صورت دقیق، خودکار و بدون نیاز به محاسبات دستی مدیریت کنند.

External services

این افزونه برای ارائه برخی قابلیت‌ها به سرویس‌های آمادست و سرویس‌های شخص ثالث متصل می‌شود. اطلاعات تنها هنگام استفاده از قابلیت مربوطه ارسال خواهند شد.

Amadast Shipping Calculator API

این سرویس برای محاسبه آنلاین هزینه ارسال در صفحه سبد خرید و تسویه حساب استفاده می‌شود.

اطلاعات ارسالی:

• شهر مبدا و مقصد
• وزن، ارزش و نوع بسته
• سرویس‌های حمل‌ونقل انتخاب‌شده
• نسخه افزونه
• آدرس سایت، نام سایت، توضیحات سایت و ایمیل مدیر
• تنظیمات مرتبط افزونه

در صورت عدم پاسخ‌گویی سرویس، افزونه می‌تواند از قیمت‌های جایگزین تعریف‌شده استفاده کند.

Service provider: Amadast
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

Amadast Couriers List API

این سرویس برای دریافت لیست به‌روز سرویس‌دهندگان حمل‌ونقل قابل‌استفاده در تنظیمات و محاسبه هزینه ارسال استفاده می‌شود.

اطلاعات ارسالی:

• درخواست خواندن لیست سرویس‌دهندگان (بدون داده شخصی مشتری)

Service provider: Amadast (api.amadast.com)
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

Amadast Account API (OTP authentication)

این سرویس برای ورود مدیر فروشگاه به حساب آمادست از طریق رمز یکبارمصرف استفاده می‌شود.

اطلاعات ارسالی:

• شماره موبایل
• کد تایید یکبارمصرف
• اطلاعات ورود و آدرس سایت

Service provider: Amadast
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

Amadast Package Detection API

این سرویس برای تشخیص هوشمند نوع بسته‌بندی موردنیاز سفارش استفاده می‌شود.

اطلاعات ارسالی:

• ابعاد محصولات
• وزن محصولات
• تعداد کالاها
• اطلاعات موردنیاز برای تخمین بسته‌بندی

Service provider: Amadast (shop-integration.amadast.com)
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

Amadast AI Shipping Price Prediction

در صورت عدم دسترسی به سرویس اصلی محاسبه هزینه ارسال، این سرویس برای تخمین هوشمند هزینه ارسال مورد استفاده قرار می‌گیرد.

اطلاعات ارسالی:

• شهر فرستنده
• شهر گیرنده
• وزن بسته
• ارزش بسته
• نوع بسته
• سرویس حمل‌ونقل انتخاب‌شده

Service provider: Amadast (predict.amadast.sabz.cloud)
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

Neshan Maps (optional)

در صورت فعال بودن قابلیت نقشه، اطلاعات موقعیت مکانی انتخاب‌شده توسط کاربر برای تبدیل مختصات به آدرس ارسال می‌شود.

اطلاعات ارسالی:

• طول و عرض جغرافیایی
• کلید API نشان

Service provider: Neshan (neshan.org)
Terms of service: https://platform.neshan.org/terms
Privacy policy: https://platform.neshan.org/privacy

Amadast media CDN (admin landing page only)

برای نمایش ویدئوهای آموزشی و معرفی در پنل مدیریت ممکن است فایل‌های چندرسانه‌ای از سرورهای آمادست بارگذاری شوند.

اطلاعات ارسالی:

• IP کاربر
• User Agent مرورگر
• آدرس فایل درخواستی

Service provider: Amadast (amadast-file.storage.iran.liara.space)
Terms of service: https://amadast.com/terms
Privacy policy: https://amadast.com/terms

نصب از طریق پیشخوان وردپرس

1. وارد بخش افزونه‌ها شوید.
2. روی «افزودن افزونه» کلیک کنید.
3. عبارت Amadast را جستجو کنید.
4. افزونه را نصب و فعال نمایید.

نصب از طریق فایل ZIP

1. وارد بخش افزونه‌ها شوید.
2. روی «بارگذاری افزونه» کلیک کنید.
3. فایل amadast-shipping-wp.zip را انتخاب نمایید.
4. روی «نصب» کلیک کنید.
5. افزونه را فعال نمایید.

1. 

   صفحه تنظیمات افزونه

2. 

   نمایش هزینه ارسال در صفحه سبد خرید

3. 

   نمایش هزینه ارسال در صفحه تسویه حساب

3.3.4 – 2026-10-06

• New: Calculator initial request always sends is_plugin: true.
• New: Each courier shipping method is a separate admin/checkout option (toggle methods independently on the same courier).
• Enhancement: Calculator logs list enabled, returned, and missing shipping method IDs.
• Enhancement: Migration enables sibling shipping methods when a courier’s first method was already enabled.
• Fix: Current API methods titled like “پست پیشتاز” are no longer treated as legacy and hidden.
• Fix: AI prediction and COD rates use per-method IDs consistently.

3.3.3 – 2026-09-05

• New: Dynamic shipping providers list from Amadast couriers API (with cache/fallback); Peyk, in-person pickup, and custom methods remain available.
• New: Admin shipping cost tester — search/select multiple products, destination city, packaging detection source, rates table, and compare with another city.
• New: Free shipping by minimum order amount and related WooCommerce general shipping rules.
• New: Disable specific providers for selected cities.
• New: Provider icons in admin lists; optional icon display on cart/checkout.
• New: Expanded Support & FAQ tab with practical troubleshooting answers.
• New: Duplicate-install guard — if multiple Amadast Shipping copies are active (even with different folder names), the newest version stays active and older copies are auto-deactivated.
• Enhancement: Checkout waits for a complete calculator response before showing rates; clearer logging for missing providers.
• Enhancement: Activity logs now show meaningful events only (settings save, calculator/packaging requests, auth, errors).
• Fix: Mixed carts with free-shipping and paid products no longer force free shipping for the whole cart.
• Fix: Legacy providers (e.g. regular/express post) and duplicate provider rows no longer appear after migrating to the dynamic list.
• Fix: Provider city-selection modal now closes correctly after confirm.
• Fix: Admin test prices formatted in plain currency text (no broken IRT HTML entities).
• Fix: Duplicate provider names on checkout when icons are enabled (empty image alt text).

3.3.2 – 2026-08-31

• Enhancement: Redesigned admin settings with a right-side sidebar navigation and per-page headers.
• Enhancement: Calculator API wait time is now fixed between 60–120 seconds; the manual setting was removed to prevent misconfiguration.
• Enhancement: Shipping method is created automatically on install/update; a warning banner appears only if auto-creation fails.
• Fix: Only Amadast-related admin notices are shown on plugin settings pages.

3.3.1 – 2026-06-28

• Fix: OTP login page — mobile number field and form buttons now display and work correctly.
• Fix: Replaced inline auth scripts with enqueued assets/js/auth.js (wp_kses_post was outputting JavaScript as visible page text).

3.2.4 – 2026-06-11

• Compliance: Renamed plugin display name to remove “WP” per WordPress.org trademark guidelines.
• Compliance: Aligned Requires at least and Requires PHP between plugin header and readme.
• Compliance: Completed External services documentation for all remote endpoints used by the plugin.
• Compliance: Applied escaping and sanitization fixes across admin UI, wizard, auth, and settings screens.
• Compliance: Ensured nonce and server input sanitization follows WordPress security guidelines.

3.2.3 – 2026-06-06

• New: Per-provider display priority on checkout (lower number = shown first).
• New: Per-provider max cart weight limit in grams.
• New: Custom Amadast shipping methods with province/city/weight/price/product conditions, free or paid cost, and COD support.

3.2.2 – 2026-06-02

• Compliance: Set WordPress “Tested up to” to major version 7.0 (WordPress.org plugin guidelines).
• Compliance: Removed custom Plugin Update Checker; updates are delivered only via WordPress.org.

3.2.1 – 2026-05-28

• New: Configurable calculator API wait time on checkout (default 4 seconds) in calculator settings.
• Enhancement: On timeout, fallback to AI price estimation (1 second) when enabled, then fixed rate.
• Enhancement: Faster shipping price polling and deadline-aware HTTP timeouts on checkout.
• Enhancement: Fixed-rate shipping label on checkout shows as “هزینه ارسال:”; admin orders show “هزینه ثابت” as rate source.

3.2.0 – 2026-04-08

• Compatibility: Added broader compatibility improvements with newer WordPress/WooCommerce versions.
• Enhancement: Added automatic detection and auto-fix tools for city/state checkout fields, including an alternative loading method for improved reliability.
• Fix: Resolved an issue where Post and other courier services could intermittently not appear on the checkout page.
• Enhancement: Improved overall stability and compatibility with newer environments.
• New: AI-based shipping price estimation when Amadast/Post services are unavailable.
• New: Integrated a new AI-powered package type detection service (box_id + packing_id).
• New: Added Boxit shipping provider.
• New: Added in-person pickup option for local customers.
• New: Added advanced fallback customization when Amadast/Post APIs are unavailable (custom message or admin-defined fixed pricing).
• Enhancement: Improved plugin settings UX and added more customization options.
• Enhancement: Improved plugin logging (more structured, safer, and more actionable).
• Dev: In the WooCommerce wc-json order output, packing metadata can be identified via: box_id, packing_id, and source (ai / algo / manual).

2.1.2 – 2025-09-01

• Compatibility: Tested with WordPress 6.7.1 and WooCommerce 9.5.1. Requires PHP 8.0+ (compatible with 8.2+).
• Fix: Resolved PHP 8.2 deprecations by adding typed properties to AMDSP_Online_Method and removing dynamic property writes.
• Fix: Avoided deprecated intval() usage with null base; now properly handles defaults.
• Enhancement: Treat WooCommerce Cart/Checkout Blocks as compatible to remove false error notices.
• Enhancement: Fallback resolution from city name to city ID with Persian/Arabic character normalization for better Blocks support.
• Enhancement: Admin compatibility notices are now dismissible.
• Dev: Use AMDSP_VERSION for script versioning to improve cache-busting across releases.
• New: Completely redesigned settings panel UI with improved UX and Persian typography.
• New: OTP-based Amadast account authentication inside settings with account info view and logout.
• New: Logs tab with inline viewer (tail) and secure log download.
• New: Export/Import all plugin settings as JSON from the settings page.
• New: Advanced city picker for selecting free-shipping cities with search and multi-select.
• New: Auto-detect WooCommerce weight unit and normalize to grams; manual override option available.
• New: Default product dimensions (cm) setting to improve package-size detection when product dimensions are missing.
• New: Post-payment (pay-on-delivery) toggle with per-carrier options (Post, Tipax).
• New: Admin tool to ensure the Amadast shipping method exists in WooCommerce zones (with AJAX button).
• Change: Added extra-cost (fixed and percent) settings and “hide other methods when free shipping is available” toggle.
• Change: Added fallback shipping price when API is down (base + per-kilo extras) settings.
• Dev: Version upgrades include data migrations (2.1.2 to ensure shipping method; 2.1.3 to convert default dimensions from mm to cm when needed).