bbloomberg/mautic-zipline-bundle

There is no license information available for the latest version (v1.0.0) of this package.

Zipline URL shortener for Mautic

Maintainers

Package info

github.com/bbloomberg/mautic-zipline-bundle

Type:mautic-plugin

pkg:composer/bbloomberg/mautic-zipline-bundle

Transparency log

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-07-06 14:49 UTC

Requires

Requires (Dev)

Unknown License cb32e02be0dba3201ca8d64502f6acc6dcfcb35f

pluginshortenerintegrationMauticzipline

Published on Packagist.org on 2026-07-06 15:53 UTC

This package is auto-updated.

Last update: 2026-07-06 15:55:02 UTC

README

Registers a self-hosted Zipline instance as a URL shortener in Mautic. Once configured and published, Mautic rewrites tracked links (emails, SMS, page redirects) into short links created through your Zipline instance.

Built to the same conventions as the Mautic Bitly bundle — it plugs into Mautic core's shortener extension point (mautic.shortener.service).

Requirements

  • Mautic 5 (mautic/core-lib ^5.0)
  • PHP 8.0+
  • A reachable Zipline instance and an API token

Installation

Install into your Mautic project with Composer:

composer require bbloomberg/mautic-zipline-bundle

The plugin installs to plugins/MauticZiplineBundle. Then clear the cache and reload plugins:

php bin/console cache:clear
php bin/console mautic:plugins:reload

Configuration

  1. In Mautic, go to Settings → Plugins → Zipline.
  2. Enter:
    • Zipline instance URL — e.g. https://zip.example.com
    • API token — from your Zipline dashboard (avatar → Copy token, or Settings → User).
  3. Publish the integration and save. The token/URL are validated against your instance on save.

With the integration published, Mautic automatically shortens links through Zipline. If Zipline is unreachable or the integration is unpublished, Mautic falls back to the original (unshortened) URL and logs the error — sends are never blocked.

How it works

  • Client\Connection calls POST {instanceUrl}/api/user/urls with {"destination": "<url>"} and the Authorization: <token> header (Zipline uses the raw token, no Bearer prefix).
  • Shortener\ZiplineService reads the short link from the url field of the JSON response.
  • Validation checks the credentials with GET {instanceUrl}/api/user.

Deployment

For full deploy, upgrade, rollback, and troubleshooting instructions, see DEPLOYMENT.md.

License

MIT — see LICENSE.