Kargomucuz Shipping for WooCommerce
| 开发者 | xristal |
|---|---|
| 更新时间 | 2026年11月3日 11:47 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Kargomucuz Shipping for WooCommerce connects your store to the Kargomucuz shipping service (Turkey). Orders are sent to the carrier you choose with one click or automatically, and shipment status, tracking numbers and labels are kept in sync with WooCommerce.
Features
- Manual (single or bulk) and automatic order transfer. Automatic transfer runs in the background when an order becomes Processing and retries failed transfers.
- Choice of the carrier services that are active on your Kargomucuz account.
- Desi calculation from product dimensions and weight, with a fallback value and a per-order override.
- Cash on delivery (corporate Kargomucuz accounts only): the order total is collected by the carrier.
- Province, district and neighbourhood selection for Turkish addresses on the classic and block checkout.
- Shipment status sync every 15 minutes; delivered orders can be completed automatically and customers receive their tracking number by email.
- Printable shipping label with barcode, tracking links for customers and the "My account" page.
- Wallet balance and debt overview, with debt payment from the wallet balance.
- Compatible with WooCommerce High-Performance Order Storage and the checkout block.
- When an administrator connects an account, the API token is validated with the API and stored in the WordPress options table.
- When an order is transferred, the recipient name, address, telephone number, email address, package desi/weight and, for cash on delivery orders, the order total are sent to the API.
- The checkout page requests the district and neighbourhood lists for the selected province from the API through the site's own server; no customer data is sent with these requests.
- The plugin requests the account name, wallet balance, debt, active carrier services and shipment status, and submits a debt payment only when an administrator requests it.
- Carrier logos shown in the admin screens are loaded from the image addresses returned by the API, which may be hosted by the carriers themselves.
安装:
- Install and activate WooCommerce.
- Upload and activate this plugin.
- In your Kargomucuz account, open your profile photo, Account Settings, Developer Tools, API Token Management, then create a new token with the permissions needed for shipments, addresses, account and payments. Leave the expiry field blank if you want a token without an expiry.
- Open the Kargomucuz menu in WordPress and paste the token. The plugin verifies it before saving it.
- Save your sender address, choose a carrier and the transfer mode under Kargomucuz > Settings.
常见问题:
Is a Kargomucuz account required?
Yes. Shipment, label, wallet and debt operations are provided by the Kargomucuz service.
What happens when the wallet balance is lower than the debt?
The debt payment action submits the amount currently available in the wallet. Any remaining debt stays visible in the panel.
How often are shipment statuses checked?
Every 15 minutes with WP-Cron. If your server cannot run WP-Cron (for example when loopback requests are blocked), the plugin runs the check during admin page visits and the settings page shows a server cron command you can add.
Which payment methods are treated as cash on delivery?
WooCommerce's "Cash on delivery" method. Cash on delivery is available only for corporate Kargomucuz accounts. Other gateways can be added with the kargomucuz_cod_payment_methods filter.
更新日志:
2.6.1
- All admin scripts and styles are now enqueued; no inline script or style blocks.
- The checkout no longer contacts the Kargomucuz API until an administrator has connected an account.
- Moved the admin menu below the WooCommerce section.
- Removed unused settings registrations and an unused admin-post handler.
- Fixed a fatal error after the first transfer of a new order.
- Fixed shipment status sync: delivered, returned and cancelled shipments are no longer polled forever; delivered orders can be completed automatically.
- Fixed desi calculation: product dimensions and weights are converted to cm/kg, the "per order" fallback desi works, virtual and refunded items are skipped, and a per-order desi can be entered on the order screen.
- Automatic transfer now runs in the background when an order becomes Processing (or On hold when unpaid orders are allowed), never twice, and retries at most 3 times with an order note on failure.
- Cash on delivery orders are sent with the order total to be collected by the carrier (can be turned off).
- The shipping company list now shows the services active on your Kargomucuz account.
- Added a Kargomucuz box to the order screen: neighbourhood selection, desi, single-order transfer, status refresh and a printable label with barcode.
- Added the neighbourhood field and phone validation to the block checkout.
- Transfers no longer stop when the neighbourhood service is unavailable; the address is sent without it and an order note is added.
- Clear error messages from the Kargomucuz API are shown on the order and in bulk transfer.
- Declared compatibility with WooCommerce HPOS and checkout blocks.
- New admin design matching the Kargomucuz panel: card layout, order filters and search, sticky bulk transfer bar, responsive on mobile. The admin menu is now labelled "Kargomucuz".
- Shipment status sync now also runs when WordPress cron cannot reach the site (loopback blocked).
- Added district and neighbourhood selection to the checkout and My Account address forms for Turkish addresses.
- Added neighbourhood selection to the sender address settings.
- Sender and receiver addresses now send the selected neighbourhood to Kargomucuz, which is now required.
- Show the last automatic shipment check and the next scheduled check in plugin settings.
- Retry eligible failed orders even when no active shipments need status updates.
- Removed webhook registration guidance and the incoming webhook endpoint.
- Kept scheduled shipment status checks at 15-minute intervals.
- Replaced username and password sign-in with a validated Bearer API token.
- Removed stored legacy session credentials and switched all API calls to token authorization.
- Updated registration and contact links, and improved WordPress database query compatibility.
- Added wallet balance and debt display and administrator initiated debt payments.
- Added capability and nonce checks for administration actions.
- Removed sensitive request and response logging and external font loading.
- Fixed WooCommerce dependency metadata and scheduled status checks.