dgtl-labs Shipping with GLS for WooCommerce
| 开发者 | danielpersdorf |
|---|---|
| 更新时间 | 2026年10月25日 23:04 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
dgtl-labs Shipping with GLS for WooCommerce connects a WooCommerce store to shipping with GLS: customers choose at checkout between delivery to their address and delivery to a GLS ParcelShop, and the store creates GLS shipping labels directly from the order and checks shipment status.
Supported country: Germany. Built against GLS Germany's ShipIT-Farm API (not MyGLS, the API used by GLS' other national subsidiaries) — addresses, ParcelShop search, and translations are all for the German market.
At checkout
- Works with the WooCommerce Cart and Checkout blocks (the default checkout since WooCommerce 8.3) — not the older shortcode checkout.
- Home delivery is the default. A customer who wants a ParcelShop instead clicks a button to search; the search starts from the shipping address ZIP code and shows the nearest shops on a map (OpenStreetMap) and in a list, with a full-screen picker (works on phones too) for the complete result.
- Once a ParcelShop is chosen, the choice is required to place the order — a missing shop is rejected in the browser and again on the server.
- Changing the delivery ZIP code after choosing a shop drops the choice if it's no longer nearby, with a clear notice.
- The chosen ParcelShop (name and address) appears on the order confirmation, in the customer's account, and in order e-mails.
- Create a GLS shipping label as an order action; the PDF is available for download from the order and from the order list.
- Tracking number on the order, in the order list, and in customer order e-mails, linked to GLS tracking.
- Check shipment status as an order action.
- Package weight is calculated from the order's line items; if an item has no weight, a configurable default package weight is used, or label creation stops with a clear message listing the items that need a weight — the plugin never reports a lower weight than the shipment actually has.
- FlexDeliveryService (GLS notifies the customer by e-mail before home delivery, with the option to reschedule or redirect) as an opt-in setting for home deliveries — only enable it if the service is booked in your GLS contract.
- Sandbox and live mode, switched with one setting; both sets of API endpoints stay saved so switching back and forth never means re-entering credentials.
- Test connection button that checks login and reachability against your saved settings and shows a clear result, instead of a silent failure.
- WordPress 6.4+ and WooCommerce 8.3+ with the block checkout (the WooCommerce default since 8.3). High-Performance Order Storage (HPOS) is supported.
- A GLS business shipping contract with access to the GLS ShipIT-Farm API. The FAQ explains how to request API credentials.
- Compatible with WooCommerce Germanized.
- Only the WooCommerce block checkout is supported, not the older shortcode checkout.
- Cancelling a shipment from the admin isn't available yet.
- Built and tested for the German market (addresses, ParcelShops, translation).
安装:
- In your WordPress admin, go to Plugins → Add New and search for "dgtl-labs Shipping with GLS for WooCommerce", or upload the plugin ZIP under Plugins → Add New → Upload Plugin.
- Activate the plugin. WooCommerce must be active — the plugin shows a notice and stays inactive otherwise.
- Go to WooCommerce → Settings → GLS Shipping and enter your GLS API credentials (see the FAQ for how to request them). The settings are pre-filled with the GLS sandbox endpoints so you can try the plugin before you have production credentials.
- Go to WooCommerce → Settings → Shipping, open a shipping zone, and add the "GLS Shipping" shipping method with a title and cost.
屏幕截图:
常见问题:
How do I get GLS API credentials?
You need a GLS business shipping contract with access to the ShipIT-Farm API:
- Register at the GLS Developer Portal with a team e-mail address.
- Create a new app there.
- Activate the Authentication API v2 and ShipIT-Farm API v1 APIs for that app.
- Contact GLS IT support (it-kundensupport@gls-germany.com) with your team e-mail address, app ID, GLS Contact ID, shipping system ("WooCommerce with this plugin"), and the APIs you activated.
- Once approved, GLS provides your Client ID and Client Secret for production, your Contact ID, and both live API endpoints.
Can I try the plugin without a GLS contract yet?
Partially. The settings page defaults to sandbox mode and comes pre-filled with GLS's sandbox endpoint URLs, so you don't need to look those up yourself — but a Client ID and Client Secret from GLS are still required before ParcelShop search, label creation or the connection test will work; there's no credential-free test mode. GLS has granted sandbox access to developers without an existing shipping contract on request before — contact GLS (see "How do I get GLS API credentials?" above) and ask specifically about sandbox/technology-partner access.
Does this work with the classic (shortcode) checkout?
No, only the WooCommerce Cart and Checkout blocks are supported.
Why wasn't a label created for my order?
The order notes and the "Create GLS shipping label" action show the reason — usually a missing item weight (set a product weight or a default package weight in the settings), missing API credentials, or GLS rejecting the shipment (the exact message from GLS is shown; check the address and, for optional services like FlexDelivery, whether it's booked in your GLS contract).
What data is shared with third parties?
The checkout map tiles are loaded from OpenStreetMap in the customer's browser, which sees the customer's IP address — this belongs in your store's privacy policy. The ParcelShop search itself runs through your server; only the ZIP code and country are sent to GLS. Creating a label sends the customer's delivery address, e-mail address and phone number to GLS, as with any shipping carrier.
Why does /build contain both index.js and index.unminified.js?
index.js is the minified file actually loaded in the browser. index.unminified.js is the same code, readable, included alongside it.
更新日志:
0.9.0
- Renamed the plugin to "dgtl-labs Shipping with GLS for WooCommerce" (was "dgtl-labs GLS Shipping for WooCommerce") following a WordPress.org review note about name similarity to an existing plugin.
- Added an explicit Sandbox/Live mode setting. Both sets of endpoints (API and OAuth token, sandbox and live) stay saved regardless of the active mode, so switching no longer means re-entering values.
- Selecting live mode before the live endpoints are filled in now shows a clear configuration message instead of failing silently.
- Added a "Test connection" button on the settings page that checks login and reachability against the saved settings.
- Fixed a cached-token bug where rotating only the client secret could keep using a token fetched under the old secret for up to 4 hours.
- The sender address on labels is now always resolved from your GLS Contact ID, GLS' recommended production path, instead of being overridden per shipment.
- Internal refactor for the WordPress.org release; no functional or user-facing change.
- Renamed the plugin to "dgtl-labs GLS Shipping for WooCommerce".
- Fixed: the sender address from the settings was never actually sent to GLS.
- Declared compatibility with High-Performance Order Storage (HPOS) and the Cart/Checkout blocks.
- Renamed the "Shipper ID" setting to "Contact ID", GLS' own name for the value.
- Added a full German translation.
- Added a full-screen ParcelShop picker with a large map, and a "Show all" option beyond the five nearest results.
- The checkout now keeps the chosen delivery mode and ParcelShop in the session as the single source of truth.
- Added a configurable default package weight, used when an order item has no weight.
- Fixed: shipments never carried a parcel weight, so GLS rejected every real shipment.
- The chosen ParcelShop is now shown on the order confirmation, in My Account, and in order e-mails.
- Fixed several checkout display issues found in the first browser test of the ParcelShop map (broken marker icons, no visible selection feedback).
- Added a label PDF download link on the order screen and order list.
- Fixed label creation, which failed against the live GLS sandbox due to a missing required field.
- Fixed: the customer e-mail field name didn't match what GLS actually expects, so every label request failed.
- Added GLS FlexDeliveryService as an opt-in setting.
- Fixed: the chosen ParcelShop wasn't actually sent to GLS, so parcel-shop orders went to the customer's home address instead.
- Initial development version: GLS API client, label generation, tracking, ParcelShop selector, Germanized integration.