Search by

kvadro / post-core

kwadro

Extends Post Core Module

Package info

github.com/kwadro/post-core

Type:magento2-module

pkg:composer/kvadro/post-core

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.5 2026-11-12 22:07 UTC

This package is auto-updated.

Last update: 2026-11-12 22:08:40 UTC


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_PostCore
  • Kvadro_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\BarcodeHelper and, 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_number on insign_swiss_post_barcode
  • Creates post_tracking_log for 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