Priskribo
افزونه Amadast Shipping WP یک افزونه حملونقل پیشرفته برای ووکامرس است که هزینه ارسال مرسوله را بهصورت آنلاین و دقیق بر اساس شهر مبدا، شهر مقصد، وزن، ابعاد، نوع بستهبندی و سرویس حمل محاسبه میکند و به مشتریان امکان میدهد در صفحه تسویهحساب، روش ارسال دلخواه خود را انتخاب کنند. این افزونه بهطور کامل با سیستم مناطق حملونقل ووکامرس یکپارچه بوده و قابلیت استفاده از چندین سرویسدهنده ارسال را فراهم میکند.
Amadast Shipping WP is a powerful WooCommerce shipping plugin that calculates accurate and real‑time shipping costs based on the actual order details and allows customers to choose their preferred shipping method during checkout. The plugin is fully integrated with WooCommerce Shipping Zones and uses Amadast’s external API to retrieve up‑to‑date shipping prices from supported courier services.
امکانات اصلی افزونه / Key Features
- محاسبه آنلاین هزینه ارسال بر اساس اطلاعات واقعی سفارش / Real‑time shipping cost calculation
- یکپارچه با ووکامرس و مناطق حملونقل (Shipping Zones) / Full integration with WooCommerce Shipping Zones
- امکان انتخاب چند سرویس حملونقل (مانند پست پیشتاز، تیپاکس و سرویسهای فوروارد) / Support for multiple courier services (e.g. Post Pishtaz, Tipax, Forward services)
- تشخیص خودکار واحد وزن محصولات و تبدیل آن به گرم / Automatic detection and conversion of product weight units
- تعیین وزن پیشفرض برای محصولاتی که وزن ندارند / Default product weight for items without defined weight
- افزودن وزن بستهبندی به وزن کل سفارش / Additional packaging weight support
- استفاده از ابعاد پیشفرض برای تشخیص خودکار نوع بستهبندی / Default product dimensions for automatic package type detection
- امکان تعریف هزینههای اضافی بهصورت مبلغ ثابت یا درصدی / Fixed or percentage‑based extra shipping costs
- پشتیبانی از ارسال رایگان برای شهرهای انتخابشده / Free shipping support for selected cities
- قابلیت مخفیسازی سایر روشهای ارسال در صورت فعال بودن ارسال رایگان / Option to hide other shipping methods when free shipping is available
- پشتیبانی از پسکرایه (پرداخت هزینه حمل در زمان تحویل) / Cash on Delivery (Postage Due) shipping option
- تعریف هزینه پایه و هزینه هر کیلوگرم بهعنوان حالت جایگزین در زمان قطعی سرویس / Fallback shipping cost when the external API is unavailable
- سازگار با قالبها و افزونههای رایج ووکامرس / Compatible with most WooCommerce themes and plugins
مدیریت فیلدهای صفحه پرداخت ووکامرس / Checkout & WooCommerce Fields Management
افزونه Amadast امکان کنترل بهتر فرم تسویهحساب ووکامرس را فراهم میکند، از جمله:
Amadast Shipping WP provides better control over the WooCommerce checkout experience:
- بارگذاری لیست شهرها در صفحه پرداخت / Optional city list loading on the checkout page
- استفاده از فیلد پیشفرض شهر ووکامرس یا لیست اختصاصی شهرها / Ability to use WooCommerce default city field or Amadast city list
- مخفیسازی فیلدهای غیرضروری مانند نام شرکت، آدرس دوم، ایمیل (در صورت استفاده از شماره موبایل) / Option to hide unnecessary checkout fields such as company name, address line 2, email address (when mobile number is used instead)
تنظیمات ارسال / Shipping Settings
- تعریف عنوان اختصاصی برای روش «ارسال رایگان» / Custom title for the Free Shipping method
- انتخاب شهرهای دارای ارسال رایگان (با امکان جستجو و انتخاب چندگانه) / Select cities eligible for Free Shipping (with multi‑select and search)
- فعالسازی روش ارسال پسکرایه برای مشتریان / Enable Cash on Delivery (Postage Due) shipping method
سازگاری / Compatibility
- وردپرس / WordPress
- ووکامرس / WooCommerce
- مناطق حملونقل ووکامرس / WooCommerce Shipping Zones
External Service
سرویس خارجی
افزونه Amadast Shipping WP برای محاسبه آنلاین هزینه ارسال از API خارجی آمادست استفاده میکند. هزینهها بهصورت لحظهای و بر اساس شرایط واقعی مرسوله محاسبه میشوند.
This plugin uses an external API provided by Amadast to calculate shipping prices online. Shipping costs are calculated dynamically based on origin, destination, package weight, package type and package value.
These are links for more information:
– Amadast site
– Amadast terms
دادههای ارسالی به سرویس آمادست / Data Sent to Amadast API
دادههایی که برای محاسبه هزینه ارسال به سرویس آمادست ارسال میشوند:
The following data may be sent from your website to the Amadast service for shipping price calculation:
- شهر مبدا / Origin city
- شهر مقصد / Destination city
- وزن مرسوله (پس از اعمال وزن بستهبندی) / Package weight (including packaging weight)
- ابعاد بسته در صورت نیاز / Package dimensions (if required)
- سرویسهای حملونقل فعالشده / Selected courier services
- تنظیمات افزونه آمادست / Amadast plugin settings
- نسخه افزونه / Plugin version
- آدرس سایت / Website URL
- نام و توضیحات سایت / Website name and description
- ایمیل مدیر سایت (جهت ارتباط در صورت نیاز فنی) / Site administrator email (for technical communication only)
این دادهها صرفاً برای محاسبه و نمایش هزینه ارسال استفاده میشوند. در صورتی که API در دسترس نباشد، افزونه بهصورت خودکار از هزینههای پیشفرض تعریفشده در پنل مدیریت استفاده میکند.
These data are used only for shipping cost calculation and service availability checks. If the API is unavailable, the plugin automatically switches to predefined fallback shipping costs configured in the plugin settings.
Ekrankopioj
Instalo
افزونه آمادست را میتوانید از طریق داشبورد وردپرس یا آپلود فایل نصب کنید.
Using The WordPress Dashboard
- Navigate to the Add New in the plugins dashboard
- Search for Amadast
- Click Install Now
- Activate the plugin on the Plugin dashboard
نصب از طریق داشبورد وردپرس:
1. به بخش افزودن افزونه جدید در داشبورد وردپرس بروید
2. افزونه Amadast را جستجو کنید
3. روی دکمه نصب کلیک کنید
4. افزونه را در داشبورد افزونهها فعال کنید
Uploading in WordPress Dashboard
- Navigate to the Add New in the plugins dashboard
- Navigate to the Upload area
- Select amadast-shipping-wp.zip from your computer
- Click Install Now
- Activate the plugin in the Plugin dashboard
آپلود فایل در داشبورد وردپرس:
1. به بخش افزودن افزونه جدید در داشبورد وردپرس بروید
2. به بخش آپلود بروید
3. فایل amadast-shipping-wp.zip را از کامپیوتر خود انتخاب کنید
4. روی دکمه نصب کلیک کنید
5. افزونه را در داشبورد افزونهها فعال کنید
Pritaksoj
Kontribuantoj k. programistoj
“Amadast Shipping افزونه حمل و نقل |ماشین حساب ارسال پست و تیپاکس و چاپار | پس کرایه |تنظیمات ارسال رایگان” estas liberkoda programo. La sekvaj homoj kontribuis al la kromprogramo.
Kontribuantoj
Ĉu interesita en programado?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Ŝanĝprotokolo
تاریخچه تغییرات و بهروزرسانیهای افزونه آمادست:
3.0.4 – 2025-01-15
- Enhancement: Force-inject Amadast shipping rates even when WooCommerce zones are misconfigured or empty.
- Enhancement: Unified province/city field option for better user experience in checkout.
- Enhancement: Improved compatibility with wp-parsidate and persian-woocommerce plugins.
- Enhancement: City list caching system with localStorage and cookies for faster loading.
- Enhancement: Better API polling mechanism with improved error handling.
- Enhancement: Enhanced address resolution with fallback to billing address when shipping address is empty.
- Enhancement: Improved package type detection based on dimensions only (weight ignored).
- Fix: Better handling of city name to ID resolution for WooCommerce Blocks.
- Fix: Improved session data access with proper null checks.
- Dev: Updated to API v2.0 for better performance and reliability.
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).
