A micro-plugin for tracking shipments via the Torrestir carrier. It fetches the tracking page for a given tracking ID, parses the HTML response to extract the latest event, and caches the result using WordPress transients for efficient repeated lookups.
- Upload the
torrestir-trackingfolder to the/wp-content/plugins/directory. - Activate the plugin through the Plugins menu in WordPress.
Updates are delivered automatically from GitHub Releases using the bundled Plugin Update Checker library.
Call tt_get_last_event( $tracking_id ) from within the NakedCatPlugins\TorrestirTracking namespace (or use the fully-qualified name) with a valid Torrestir tracking ID. The function returns an associative array of event fields on success, or a WP_Error on failure.
use function NakedCatPlugins\TorrestirTracking\tt_get_last_event;
$event = tt_get_last_event( 'M0010005E00344451499' );
if ( is_wp_error( $event ) ) {
echo 'Error: ' . $event->get_error_message();
} else {
print_r( $event ); // e.g. [ 'Description' => 'Entregue', ... ]
}All functions live in the NakedCatPlugins\TorrestirTracking namespace.
| Function | Description |
|---|---|
tt_get_last_event( $tracking_id ) |
Fetches and returns the last tracking event for the given ID. Results are cached via WordPress transients: 1 hour for in-transit shipments, 1 week for delivered shipments (Description = "Delivered" or "Entregue"). Returns array or WP_Error. |
tt_parse_last_event( $html ) |
Parses the raw HTML from the Torrestir tracking page and returns the last table row's event data as an associative array, or a WP_Error if no rows are found. |
tt_get_tracking_link( $tracking_id ) |
Returns the full tracking URL for the given ID: https://tracking.torrestir.com/?lang=pt&id={tracking_id}. |
Results are stored in WordPress transients under the key torrestir_tracking_{tracking_id}:
- Delivered (
"Delivered"/"Entregue"): cached for 1 week. - All other statuses: cached for 1 hour.
- WordPress 5.9 or higher
- PHP 7.2 or higher
Naked Cat Plugins (by Webdados) — nakedcatplugins.com
This plugin is licensed under the GPLv3 or later.
This README was written by AI based on the plugin source code.