Simple Connection for ChronoFresh
| 开发者 | tlloancy |
|---|---|
| 更新时间 | 2026年8月25日 21:53 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Supports Chrono Ambient Relais 13, Chrono Fresh 13, Chrono Fresh Relais 13, Chrono 13, Chrono Freeze 13, Chrono Relais 13.
- Fresh pickup points (code 6S) — deliver fresh products (0°C – 8°C) to Chronofresh pickup points (must be enabled on your contract).
- Dynamic pickup point map (Leaflet) with opening hours at checkout.
- Live parcel tracking via Chronopost TrackingService (same shipping credentials).
- Label cancellation directly from the order admin page.
- Bulk label generation from the orders list.
- Auto order status change after label generation (configurable).
- Per-product DLC (expiration date) field — mandatory for ChronoFresh compliance.
- Explicit Test / Production mode with a persistent admin banner while the sandbox account is in use.
- Connection health check — per-service diagnostics (SOAP extension, server reachability, credentials, and which pickup point product codes 86 / 5Q / 6S your contract accepts), with Chronopost's own error messages.
- Debug logs in
/wp-content/uploads/simple-connection-for-chronofresh-woocommerce/scc-debug.log. - Built-in Getting Started tab under WooCommerce → ChronoFresh.
- Step-by-step guides in
docs/USER-GUIDE.md(English) anddocs/MODE-DEMPLOI.md(French).
安装:
- Upload the
simple-connection-for-chronofresh-woocommercefolder to/wp-content/plugins/. - Activate the plugin via the WordPress 'Plugins' page.
- Open WooCommerce → ChronoFresh (not WooCommerce → Settings). Switch the Mode to Production and enter your Chronopost account number, password, and shipper phone. (Or keep Test mode to explore first — labels will not be real.)
- Run the connection health check, then add ChronoFresh methods in WooCommerce → Settings → Shipping for your zones.
常见问题:
What Chronofresh account / contract do I need?
A commercial Chronofresh contract from Chronopost (not a consumer Chronopost.fr login). Your sales rep gives you an account number and API password. Ask them to enable the product codes you will use (for example 2R home fresh, 6S fresh pickup points, 2S freeze). Until a code is on the contract, Chronopost returns errors such as 33 / 35.
What is Test mode? Can I ship with it?
No. Test mode signs every call with the official Chronopost sandbox pair from their Web Services documentation. It is only there so you can explore the plugin (map, labels, workflow) before you have a contract. Sandbox labels look real but no parcel is ever picked up. A warning banner stays visible in wp-admin until you switch to Production mode.
Where do I enter the credentials?
WooCommerce → ChronoFresh → Settings tab: switch the Mode to Production, then fill in the account number and password. Also set shipper phone (printed on the label), default DLC in days, max kg per parcel, and optional auto order status. Store address under WooCommerce → Settings → General is the shipper on the label.
The health check passes but label generation still fails.
The health check runs real calls on the pickup-point service, which lets it verify authentication and whether product codes 86 / 5Q / 6S are on your contract. It deliberately does not call the label service, because the only way to test that is to create a real label — the check will never do that behind your back. Generate a label on a test order: Chronopost errors (e.g. a home-delivery product code missing from your contract) are shown on the order screen and in the debug logs.
PHP SOAP?
Required. If the plugin shows that the extension is missing, ask your host to enable php-soap (WooCommerce → Status).
Where are debug logs?
/wp-content/uploads/simple-connection-for-chronofresh-woocommerce/scc-debug.log (enable Debug mode in the settings). Older docs mentioned /wp-content/uploads/chronofresh-logs/ — use the path above.
Is it secure?
Admin and AJAX actions use nonces. Inputs are sanitized and outputs escaped. Chronopost still receives order addresses when you search pickup points or generate labels (see External services).
更新日志:
- Added: explicit Test / Production mode setting. Test mode uses the public Chronopost sandbox account (nothing to type) and shows a persistent wp-admin warning banner, because sandbox labels are never actually shipped.
- Fixed: the sandbox credentials are no longer silent defaults. Installs that never configured real credentials used to generate sandbox labels that looked real; they now run in visible Test mode. In Production mode, missing credentials block label generation with a clear error instead of falling back to the sandbox.
- Added: connection health check replacing the old single "Test API connection" button. Per-service rows with live status: PHP SOAP extension, Chronopost server reachability, credentials, and real contract checks for pickup point product codes 86 / 5Q / 6S (Chronopost's own error message is shown, e.g. when 6S is not on your contract). The label service is deliberately not simulated — the panel says so honestly.
- Compat: Tested up to WordPress 7.1.
- Docs: readme FAQ rewritten for Test/Production mode and the health check;
docs/USER-GUIDE.md,docs/MODE-DEMPLOI.mdand the built-in Getting started tab updated to match. - Design: native WordPress admin CSS on WooCommerce → ChronoFresh (settings, Getting started table/callout, health check panel).
- Released on July 24, 2026:
- Updated: All plugin UI source strings switched to English so WordPress.org translations (GlotPress) use English originals.
- Updated: French remains available via the fr_FR translation file / translate.wordpress.org.
- Released on July 22, 2026:
- Added: New shipping method "Chrono Fresh Relais 13H" (product code 6S) — fresh delivery (0°C – 8°C) to pickup points, available at Chronofresh since the beginning of 2026.
- Added: Pickup point map, opening hours and selection at checkout now fully support the fresh pickup point service.
- Updated: Label generation maps fresh products to code 6S when a pickup point is selected (DLC/expiration date included as required by Chronofresh).
- Updated: Getting Started guide with the new 6S product code.
- Added: Bilingual user guide (English + French) shipped in the docs/ folder.
- Released on May 27, 2026:
- Added: Live parcel tracking via trackSkybillV2 (Chronopost TrackingService) directly in the order admin metabox.
- Added: Label cancellation via cancelListSkybill — cancel any label from the order page.
- Added: Bulk label generation from WooCommerce orders list.
- Added: Automatic order status change after label generation (configurable).
- Added: Per-product DLC (days until expiration) field — required by ChronoFresh for fresh/freeze shipments.
- Added: Global default DLC setting under WooCommerce → ChronoFresh.
- Added: Built-in Getting Started guide tab with step-by-step onboarding.
- Fixed: Compliance with ChronoFresh requirements — expirationDate now respects per-product or global DLC setting.
- Updated: Tested up to WordPress 7.0.
- Released on May 8, 2026:
- Added: Interactive Leaflet map for pickup point selection.
- Fixed: Compatibility issues with WooCommerce fragments and Stripe refreshes.
- Improved: Performance and stability by removing legacy code and unused templates.
- Improved: Better handling of AJAX race conditions at checkout.
- Added: Explicit select when no temperature is defined, which default to ambient for label generation, avoiding any unrecognized state for products linked to chronofresh via Expedition Class.
- Enhanced: Added support for mixed orders (ambient, fresh, freeze) with any shipping method, including custom methods like alg_wc_shipping.
- Fixed: Resolved fatal error when generating labels for orders with deleted or invalid products by safely handling null products.
- Improved: Updated label generation to rely on product temperature types (_temperature_type) instead of shipping method, ensuring accurate Chronopost codes (5M, 5Q, 2R, 2S).
- Updated: Default Chronopost test credentials to match provided API keys for seamless testing.
- Enhanced: Improved logging for skipped items and parcel splitting for better debugging.
- Boost your shipping with Premium features like real-time tracking and automated multi-label generation at deter-mi.net!
- Initial release with Chronofresh shipping and pickup point support.