PHPackages                             bbloomberg/mautic-zipline-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. bbloomberg/mautic-zipline-bundle

ActiveMautic-plugin[Utility & Helpers](/categories/utility)

bbloomberg/mautic-zipline-bundle
================================

Zipline URL shortener for Mautic

v1.0.0(1mo ago)00PHP >=8.0

Since Jul 6Compare

[ Source](https://github.com/bbloomberg/mautic-zipline-bundle)[ Packagist](https://packagist.org/packages/bbloomberg/mautic-zipline-bundle)[ RSS](/packages/bbloomberg-mautic-zipline-bundle/feed)WikiDiscussions Synced 1w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Mautic Zipline Bundle
=====================

[](#mautic-zipline-bundle)

Registers a self-hosted [Zipline](https://zipline.diced.sh) 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
------------

[](#requirements)

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

Installation
------------

[](#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
-------------

[](#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
------------

[](#how-it-works)

- `Client\Connection` calls `POST {instanceUrl}/api/user/urls` with `{"destination": ""}` and the `Authorization: ` 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
----------

[](#deployment)

For full deploy, upgrade, rollback, and troubleshooting instructions, see [DEPLOYMENT.md](DEPLOYMENT.md).

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

34

—

LowBetter than 74% of packages

Maintenance90

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dcc8b9a24d7281935082ef60ae423a8aabad2ff5db36f71a439abb3fe346b8ec?d=identicon)[bbloomberg](/maintainers/bbloomberg)

---

Tags

pluginMauticshortenerintegrationzipline

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bbloomberg-mautic-zipline-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/bbloomberg-mautic-zipline-bundle/health.svg)](https://phpackages.com/packages/bbloomberg-mautic-zipline-bundle)
```

###  Alternatives

[mautic/grapes-js-builder-bundle

GrapesJS Builder with MJML support for Mautic

5794.3k15](/packages/mautic-grapes-js-builder-bundle)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

595.0k](/packages/etailors-mautic-amazon-ses)[firemultimedia/mautic-multi-captcha-bundle

This plugin brings Google's reCAPTCHA, hCaptcha, and Cloudflare Turnstile integration to mautic.

151.4k](/packages/firemultimedia-mautic-multi-captcha-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)