{"id":194325,"date":"2024-12-29T14:05:28","date_gmt":"2024-12-29T14:05:28","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/amadast-shipping-wp\/"},"modified":"2026-06-13T14:40:34","modified_gmt":"2026-06-13T14:40:34","slug":"amadast-shipping-wp","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/amadast-shipping-wp\/","author":21089703,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"3.2.5","stable_tag":"3.2.5","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Amadast Shipping","header_author":"amadast.com","header_description":"\u0627\u0641\u0632\u0648\u0646\u0647 \u0622\u0645\u0627\u062f\u0633\u062a\u060c \u0647\u0632\u06cc\u0646\u0647 \u0627\u0631\u0633\u0627\u0644 \u062f\u0642\u06cc\u0642 \u0631\u0627 \u0628\u0631 \u0627\u0633\u0627\u0633 \u0648\u0632\u0646 \u0648 \u0645\u0642\u0635\u062f \u0645\u0631\u0633\u0648\u0644\u0647 \u0645\u062d\u0627\u0633\u0628\u0647 \u0645\u06cc \u06a9\u0646\u062f \u0648 \u0628\u0647 \u0645\u0634\u062a\u0631\u06cc\u0627\u0646 \u0627\u062c\u0627\u0632\u0647 \u0645\u06cc\u062f\u0647\u062f \u0631\u0648\u0634 \u0627\u0631\u0633\u0627\u0644 \u062f\u0644\u062e\u0648\u0627\u0647 \u062e\u0648\u062f \u0631\u0627 \u0627\u0646\u062a\u062e\u0627\u0628 \u06a9\u0646\u0646\u062f.","assets_banners_color":"fdfbfa","last_updated":"2026-06-13 14:40:34","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/amadast.com\/product\/wordpress-plugin","header_author_uri":"https:\/\/amadast.com?utm_source=wp_plugin&utm_medium=plugin_page&utm_campaign=install_wp_plugin","rating":5,"author_block_rating":0,"active_installs":200,"downloads":5338,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"2.0.3":{"tag":"2.0.3","author":"amadast","date":"2024-12-29 14:05:00"},"2.1.0":{"tag":"2.1.0","author":"amadast","date":"2025-01-01 11:40:18"},"2.1.1":{"tag":"2.1.1","author":"amadast","date":"2025-01-04 11:52:01"},"3.0.0":{"tag":"3.0.0","author":"amadast","date":"2025-10-08 12:54:34"},"3.0.1":{"tag":"3.0.1","author":"amadast","date":"2025-10-08 15:32:47"},"3.0.2":{"tag":"3.0.2","author":"amadast","date":"2025-10-22 18:55:44"},"3.0.3":{"tag":"3.0.3","author":"amadast","date":"2025-12-29 15:56:48"},"3.0.4":{"tag":"3.0.4","author":"amadast","date":"2026-01-04 14:13:22"},"3.2.3":{"tag":"3.2.3","author":"amadast","date":"2026-06-10 10:18:08"},"3.2.5":{"tag":"3.2.5","author":"amadast","date":"2026-06-13 14:40:34"}},"upgrade_notice":{"3.2.3":"<p>New: shipping display priority, max weight limits per provider, and custom conditional shipping methods.\nRequired for WordPress.org repository compliance: security escaping, readme metadata, and external services documentation.<\/p>","3.2.2":"<p>Required for WordPress.org repository compliance: correct tested-up-to header and removal of external update checker.<\/p>","2.1.2":"<p>Major update: redesigned settings, OTP login, logs and settings import\/export, advanced city picker, weight unit auto-detect, post-payment, and admin shipping method tool. Also includes PHP 8.2 fixes and Blocks compatibility improvements. Update recommended.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3214440,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3214440,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3214440,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.0.3","2.1.0","2.1.1","3.0.0","3.0.1","3.0.2","3.0.3","3.0.4","3.2.3","3.2.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3214440,"resolution":"1","location":"assets","locale":"","width":2535,"height":1238},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3214440,"resolution":"2","location":"assets","locale":"","width":1403,"height":922},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3214440,"resolution":"3","location":"assets","locale":"","width":1391,"height":1005}},"screenshots":[]},"plugin_section":[],"plugin_tags":[13827,282,655,236223,3546],"plugin_category":[45],"plugin_contributors":[236225,236224],"plugin_business_model":[],"class_list":["post-194325","plugin","type-plugin","status-publish","hentry","plugin_tags-delivery","plugin_tags-ecommerce","plugin_tags-online-store","plugin_tags-online-shipping-calculation","plugin_tags-shipping","plugin_category-ecommerce","plugin_contributors-alih70442","plugin_contributors-amadast","plugin_committers-amadast"],"banners":{"banner":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/banner-772x250.png?rev=3214440","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/icon-128x128.png?rev=3214440","icon_2x":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/icon-256x256.png?rev=3214440","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/screenshot-1.png?rev=3214440","caption":""},{"src":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/screenshot-2.png?rev=3214440","caption":""},{"src":"https:\/\/ps.w.org\/amadast-shipping-wp\/assets\/screenshot-3.png?rev=3214440","caption":""}],"raw_content":"<!--section=description-->\n<p>Amadast Shipping connects your WooCommerce store to Amadast services to calculate live shipping rates, manage carriers, and offer checkout shipping options based on weight, destination, and package details.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to third-party and Amadast-hosted services. Data is sent only when the related feature is used (for example, during checkout, admin settings tests, OTP login, or when the map feature is enabled).<\/p>\n\n<h4>Amadast Shipping Calculator API<\/h4>\n\n<p>This service is used to calculate live shipping prices for supported carriers during cart and checkout.<\/p>\n\n<p>Data sent when rates are requested:\n- Origin and destination city\n- Package weight, value, and type\n- Selected couriers\n- Plugin version\n- Site URL, site name, site description, and admin email (for account\/support context)\n- Relevant Amadast plugin settings<\/p>\n\n<p>If the API does not respond, the plugin may use configured fallback pricing.<\/p>\n\n<p>Service provider: Amadast\nTerms of service: https:\/\/amadast.com\/terms\nPrivacy policy: https:\/\/amadast.com\/terms<\/p>\n\n<h4>Amadast Account API (OTP authentication)<\/h4>\n\n<p>This service is used when a store administrator signs in to their Amadast account inside the plugin settings.<\/p>\n\n<p>Data sent when OTP login is used:\n- Mobile phone number\n- OTP verification code\n- Site URL and login metadata<\/p>\n\n<p>Service provider: Amadast\nTerms of service: https:\/\/amadast.com\/terms\nPrivacy policy: https:\/\/amadast.com\/terms<\/p>\n\n<h4>Amadast Package Detection API<\/h4>\n\n<p>This service is used to suggest package\/box type for cart items when AI package detection is enabled.<\/p>\n\n<p>Data sent when package detection runs:\n- Cart item dimensions, weight, quantity, and product metadata needed for packing estimation<\/p>\n\n<p>Service provider: Amadast (shop-integration.amadast.com)\nTerms of service: https:\/\/amadast.com\/terms\nPrivacy policy: https:\/\/amadast.com\/terms<\/p>\n\n<h4>Amadast AI Shipping Price Prediction<\/h4>\n\n<p>This service is used as a fallback estimator when the main calculator API is unavailable or times out (if enabled in settings). It is also used from admin test tools.<\/p>\n\n<p>Data sent when prediction runs:\n- Sender and recipient city\n- Package weight, value, and type\n- Selected provider<\/p>\n\n<p>Service provider: Amadast (predict.amadast.sabz.cloud)\nTerms of service: https:\/\/amadast.com\/terms\nPrivacy policy: https:\/\/amadast.com\/terms<\/p>\n\n<h4>Neshan Maps (optional)<\/h4>\n\n<p>If the checkout map feature is enabled and a Neshan API key is configured, the plugin loads Neshan map assets and may call Neshan reverse-geocoding to convert map coordinates to an address.<\/p>\n\n<p>Data sent when the map feature is used:\n- Latitude and longitude selected on the map (reverse geocoding request)\n- Neshan API key configured in plugin settings<\/p>\n\n<p>Service provider: Neshan (neshan.org)\nTerms of service: https:\/\/platform.neshan.org\/terms\nPrivacy policy: https:\/\/platform.neshan.org\/privacy<\/p>\n\n<h4>Amadast media CDN (admin landing page only)<\/h4>\n\n<p>The plugin admin landing page may load a promotional intro video hosted on Amadast media storage.<\/p>\n\n<p>Data sent when the video is loaded:\n- Standard HTTP request metadata (IP address, browser user agent, requested file URL)<\/p>\n\n<p>Service provider: Amadast (amadast-file.storage.iran.liara.space)\nTerms of service: https:\/\/amadast.com\/terms\nPrivacy policy: https:\/\/amadast.com\/terms<\/p>\n\n<!--section=installation-->\n<h4>Using The WordPress Dashboard<\/h4>\n\n<ol>\n<li>Navigate to the Add New in the plugins dashboard<\/li>\n<li>Search for Amadast<\/li>\n<li>Click Install Now<\/li>\n<li>Activate the plugin on the Plugin dashboard<\/li>\n<\/ol>\n\n<h4>Uploading in WordPress Dashboard<\/h4>\n\n<ol>\n<li>Navigate to the Add New in the plugins dashboard<\/li>\n<li>Navigate to the Upload area<\/li>\n<li>Select amadast-shipping-wp.zip from your computer<\/li>\n<li>Click Install Now<\/li>\n<li>Activate the plugin in the Plugin dashboard<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>3.2.4 - 2026-06-11<\/h4>\n\n<ul>\n<li>Compliance: Renamed plugin display name to remove \"WP\" per WordPress.org trademark guidelines.<\/li>\n<li>Compliance: Aligned Requires at least and Requires PHP between plugin header and readme.<\/li>\n<li>Compliance: Completed External services documentation for all remote endpoints used by the plugin.<\/li>\n<li>Compliance: Applied escaping and sanitization fixes across admin UI, wizard, auth, and settings screens.<\/li>\n<li>Compliance: Ensured nonce and server input sanitization follows WordPress security guidelines.<\/li>\n<\/ul>\n\n<h4>3.2.3 - 2026-06-06<\/h4>\n\n<ul>\n<li>New: Per-provider display priority on checkout (lower number = shown first).<\/li>\n<li>New: Per-provider max cart weight limit in grams.<\/li>\n<li>New: Custom Amadast shipping methods with province\/city\/weight\/price\/product conditions, free or paid cost, and COD support.<\/li>\n<\/ul>\n\n<h4>3.2.2 - 2026-06-02<\/h4>\n\n<ul>\n<li>Compliance: Set WordPress \"Tested up to\" to major version 7.0 (WordPress.org plugin guidelines).<\/li>\n<li>Compliance: Removed custom Plugin Update Checker; updates are delivered only via WordPress.org.<\/li>\n<\/ul>\n\n<h4>3.2.1 - 2026-05-28<\/h4>\n\n<ul>\n<li>New: Configurable calculator API wait time on checkout (default 4 seconds) in calculator settings.<\/li>\n<li>Enhancement: On timeout, fallback to AI price estimation (1 second) when enabled, then fixed rate.<\/li>\n<li>Enhancement: Faster shipping price polling and deadline-aware HTTP timeouts on checkout.<\/li>\n<li>Enhancement: Fixed-rate shipping label on checkout shows as \"\u0647\u0632\u06cc\u0646\u0647 \u0627\u0631\u0633\u0627\u0644:\"; admin orders show \"\u0647\u0632\u06cc\u0646\u0647 \u062b\u0627\u0628\u062a\" as rate source.<\/li>\n<\/ul>\n\n<h4>3.2.0 - 2026-04-08<\/h4>\n\n<ul>\n<li>Compatibility: Added broader compatibility improvements with newer WordPress\/WooCommerce versions.<\/li>\n<li>Enhancement: Added automatic detection and auto-fix tools for city\/state checkout fields, including an alternative loading method for improved reliability.<\/li>\n<li>Fix: Resolved an issue where Post and other courier services could intermittently not appear on the checkout page.<\/li>\n<li>Enhancement: Improved overall stability and compatibility with newer environments.<\/li>\n<li>New: AI-based shipping price estimation when Amadast\/Post services are unavailable.<\/li>\n<li>New: Integrated a new AI-powered package type detection service (box_id + packing_id).<\/li>\n<li>New: Added Boxit shipping provider.<\/li>\n<li>New: Added in-person pickup option for local customers.<\/li>\n<li>New: Added advanced fallback customization when Amadast\/Post APIs are unavailable (custom message or admin-defined fixed pricing).<\/li>\n<li>Enhancement: Improved plugin settings UX and added more customization options.<\/li>\n<li>Enhancement: Improved plugin logging (more structured, safer, and more actionable).<\/li>\n<li>Dev: In the WooCommerce wc-json order output, packing metadata can be identified via: box_id, packing_id, and source (ai \/ algo \/ manual).<\/li>\n<\/ul>\n\n<h4>2.1.2 - 2025-09-01<\/h4>\n\n<ul>\n<li>Compatibility: Tested with WordPress 6.7.1 and WooCommerce 9.5.1. Requires PHP 8.0+ (compatible with 8.2+).<\/li>\n<li>Fix: Resolved PHP 8.2 deprecations by adding typed properties to AMDSP_Online_Method and removing dynamic property writes.<\/li>\n<li>Fix: Avoided deprecated intval() usage with null base; now properly handles defaults.<\/li>\n<li>Enhancement: Treat WooCommerce Cart\/Checkout Blocks as compatible to remove false error notices.<\/li>\n<li>Enhancement: Fallback resolution from city name to city ID with Persian\/Arabic character normalization for better Blocks support.<\/li>\n<li>Enhancement: Admin compatibility notices are now dismissible.<\/li>\n<li>Dev: Use AMDSP_VERSION for script versioning to improve cache-busting across releases.<\/li>\n<li>New: Completely redesigned settings panel UI with improved UX and Persian typography.<\/li>\n<li>New: OTP-based Amadast account authentication inside settings with account info view and logout.<\/li>\n<li>New: Logs tab with inline viewer (tail) and secure log download.<\/li>\n<li>New: Export\/Import all plugin settings as JSON from the settings page.<\/li>\n<li>New: Advanced city picker for selecting free-shipping cities with search and multi-select.<\/li>\n<li>New: Auto-detect WooCommerce weight unit and normalize to grams; manual override option available.<\/li>\n<li>New: Default product dimensions (cm) setting to improve package-size detection when product dimensions are missing.<\/li>\n<li>New: Post-payment (pay-on-delivery) toggle with per-carrier options (Post, Tipax).<\/li>\n<li>New: Admin tool to ensure the Amadast shipping method exists in WooCommerce zones (with AJAX button).<\/li>\n<li>Change: Added extra-cost (fixed and percent) settings and \"hide other methods when free shipping is available\" toggle.<\/li>\n<li>Change: Added fallback shipping price when API is down (base + per-kilo extras) settings.<\/li>\n<li>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).<\/li>\n<\/ul>","raw_excerpt":"A plugin that calculates shipping prices online with various sending methods.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/194325","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=194325"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/amadast"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=194325"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=194325"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=194325"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=194325"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=194325"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=194325"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}