Barkoda Shipping for WooCommerce
| 开发者 | emreteymuroglu |
|---|---|
| 更新时间 | 2026年10月2日 22:49 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Order list with a "Ship" action, plus a WooCommerce bulk action
- Single-package shipments via
kabulEkle2 - Multi-package shipments via
kabulEkleParcaliBarkod, one barcode per package - Cancel a shipment PTT has not accepted yet, by barcode or by reference number
- Tracking by barcode or reference, with the parcel's movement history
- The PTT branch currently holding the parcel, with address, hours and a map link
- Courier pickup requests via
siparisIstekEkle2 - 80mm thermal labels rendered as HTML and Code128 SVG, so any 80mm printer works
- Bulk label printing: every selected order in one document with page breaks
- Per-order insurance toggle (Valuable Goods / DK service code)
- Cash on delivery mapped from your WooCommerce payment methods
- Optional separate return address
- Missing recipient data is detected before sending and can be filled in from a popup
- Weight and dimensions computed from your products, overridable per order
- Full request and response log for every SOAP call, with passwords masked
- WooCommerce HPOS compatible
AUTH_KEY, and is masked out of every log entry before it is written.
Disclaimer
This plugin is not developed, endorsed or supported by PTT. It is an independent client for the SOAP services PTT provides to contracted customers. PTT and PTT Kargo are trademarks of their respective owner.
安装:
- Upload the plugin folder to
/wp-content/plugins/, or install the ZIP through Plugins, then Add New, then Upload Plugin. - Activate the plugin. WooCommerce must be installed and active.
- Go to PTT Kargo, then Settings, and work through the tabs:
- PTT Connection - leave the environment on Test, then enter the customer number and password PTT issued. Use "Test Connection" to confirm they work.
- Barcode - enter the 8-digit prefix and the serial range PTT allocated. Prefix plus serial must total 12 digits; the 13th is calculated for you.
- Sender - your company name, address, phone and email. Add the Postal Cheque account number if you ship cash on delivery.
- Products & Filters, Shipment Defaults, Payment and Label are optional, with sensible defaults.
- Create a test shipment, then email the resulting barcode to
entegrasyon@ptt.gov.trfor approval. - Once PTT approves, switch the environment to Live.
屏幕截图:
常见问题:
Do I need a contract with PTT?
Yes. The plugin talks to the integration service PTT provides to contracted customers, and PTT issues the customer number, password and barcode range it needs. Contact your regional PTT directorate, or email entegrasyon@ptt.gov.tr, to start the process. Both corporate and individual integrations are possible.
Do I need a driver for my thermal printer?
No. The label is plain HTML and CSS sized for 80mm, printed through your browser's print dialog. Any 80mm printer your operating system already knows about will work.
Where is my PTT password stored?
Encrypted with AES-256-CBC in the barkoda_settings option. The key is derived from your site's AUTH_KEY, so the stored value is useless without your wp-config.php. The password is also masked in the plugin's log table and in order meta, so it never appears in a saved request.
What happens when the barcode range runs out?
Shipping fails with a clear error and no barcode is consumed. Ask PTT for a new range and enter it on the Barcode tab, which also shows how many numbers you have left.
A shipment failed. Did I lose a barcode?
No. The consumed number is stored against the order and reused on the next attempt, so a failing order does not eat through your allocation.
Can I cancel a shipment?
Only while PTT has not physically accepted it, which in practice means before the courier collects it. The plugin tries barkodVeriSil first and falls back to referansVeriSil. After cancelling, resending the order consumes a new barcode.
Why does tracking say the barcode is not found in the test environment?
PTT runs acceptance and tracking on separate databases in test, so a barcode accepted in the test environment is not visible to the test tracking service. This resolves once you switch to Live.
Is the plugin available in Turkish?
Yes. The Turkish translation is served through translate.wordpress.org, so WordPress fetches and applies it by itself on a site running in Turkish, and updates it whenever the translation improves. Corrections and other languages are welcome at https://translate.wordpress.org/projects/wp-plugins/barkoda-shipping-for-woocommerce/.
更新日志:
- Renamed to Barkoda Shipping for WooCommerce. The plugin is no longer named after a single carrier, which leaves room for other carriers later.
- Every option, order meta key, hook, constant and the log table moved onto a
barkodaprefix. Stored data is migrated automatically on upgrade; the stored PTT password carries over unchanged. - Fixed activation on sites upgrading from an earlier version, where the log table was created before the migration ran and the migration then discarded the existing log rows.
- The PHP version notice is now translatable instead of hardcoded Turkish.
- The plugin is now in English, with a Turkish translation bundled. Turkish sites see no change in wording.
- Renamed internal identifiers to a consistent prefix. Stored settings, order meta and the log table are migrated automatically on upgrade.
- The order status setting key no longer contains a non-ASCII character.
- Added translator comments to every string containing a placeholder.
- Codebase brought in line with the WordPress coding standards.
- Uninstall now removes order meta as well as options and the log table, under both the old and the new key names.
- Fixed the
siparisIstekEkle2courier envelope to match the WSDL: snake_case field names, lowercasegondericibilgiwrapper, alphabetical element order, andsonucKodu/sonucAciklamaresponse parsing. - Moved
gondericibilgito its correct position in thekabulEkle2andkabulEkleParcaliBarkodsequences. Axis2 enforces sequence order strictly and failed silently when it was wrong. - Added the
gonderici_soyadiandgonderici_smsfields, which the WSDL defines but the plugin never sent. - Fixed expired label links.
wp_nonce_url()HTML-escapes the separator, which dropped_wpnonceonce the URL passed through JSON into JavaScript. - Fixed the "Send to PTT Kargo" button on the order edit screen, which did not work because the admin script was not enqueued on every relevant screen.
- First public release: HPOS-compatible order list and bulk actions, barcoded shipments, multi-package support, cancellation, tracking, drop point lookup, courier pickup, 80mm thermal labels, bulk label printing, atomic barcode allocation, encrypted credentials, per-order insurance, cash on delivery mapping, separate return address, missing-data detection and a full integration log.