kvadro / post-core
Extends Post Core Module
1.0.5
2026-11-12 22:07 UTC
Requires
- php: ^8.2
- kvadro/pdfreader: ^1.0
- magento/framework: ^103.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Magento 2 module that extends Insign PostCore (Swiss Post barcode labels): reads tracking numbers from label PDFs, stores them on barcode records and Magento shipments, and provides admin logging.
Requirements
- PHP
^8.2 - Magento Framework
^103.0 Insign_PostCoreKvadro_Pdfreader(kvadro/pdfreader^1.0)
Installation
composer require kvadro/post-core bin/magento module:enable Kvadro_PostCore bin/magento setup:upgrade bin/magento cache:flush
For a local path repository, register the package in the Magento root composer.json, then run the commands above.
Features
- Prefers
Insign\PostCore\Helper\BarcodeHelperand, when a label file is saved, reads the tracking number from the PDF and creates a shipment track - CLI command to backfill tracking numbers from existing barcode labels
- Admin Tracking Log grid under Sales
- File log:
var/log/kvadro_postcore.log - Cron job cleans old tracking log rows by retention setting
Configuration
Stores → Configuration → Swiss Post Tracking (kvadro_postcore)
| Setting | Default | Description |
|---|---|---|
| Enable | Yes | When disabled, CLI processing stops |
| Batch pages size | 1 | Max collection pages processed per CLI run |
| Enable Logging | Yes | Write to Tracking Log grid and file log |
| Log Retention (days) | 30 | Delete log rows older than N days (0 = keep all) |
CLI
Read tracking numbers from Swiss Post barcode labels and create shipment tracks:
# Process all barcode labels that have a label file bin/magento kvadro:postcore:read-tracking-numbers # Process a single shipment bin/magento kvadro:postcore:read-tracking-numbers --shipment-id=123
Database
- Adds
tracking_numberoninsign_swiss_post_barcode - Creates
post_tracking_logfor admin/file activity logs
Cron
| Job | Schedule | Class |
|---|---|---|
kvadro_postcore_clean_tracking_log |
20 3 * * * |
Kvadro\PostCore\Cron\CleanTrackingLog |
Main components
| Component | Role |
|---|---|
Helper\BarcodeHelper |
Extends Insign helper; reads tracking on label save |
Service\TrackingNumberReader |
Reads codes from PDF via PdfReader |
Service\TrackConfigService |
Builds shipment track title from carrier/service options |
Service\ShipmentTrackSaver |
Saves Magento shipment track once per number |
Console\Command\ReadTrackingNumberCommand |
CLI backfill |
Logger\ModuleLogger |
File + DB logging |
Controller\Adminhtml\TrackingLog\Index |
Admin Tracking Log page |
License
Proprietary