PHPackages                             granam/mautic-vocative-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. granam/mautic-vocative-bundle

Abandoned → [granam/mautic-czech-vocative-bundle](/?search=granam%2Fmautic-czech-vocative-bundle)Mautic-plugin[Utility & Helpers](/categories/utility)

granam/mautic-vocative-bundle
=============================

Modifier for first names to convert their base form to vocative in czech

4.0.1(3y ago)372[2 PRs](https://github.com/granam/mautic-czech-vocative/pulls)MITPHPPHP >=7.4

Since Mar 6Pushed 3y ago2 watchersCompare

[ Source](https://github.com/granam/mautic-czech-vocative)[ Packagist](https://packagist.org/packages/granam/mautic-vocative-bundle)[ RSS](/packages/granam-mautic-vocative-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (5)Versions (23)Used By (0)

Usage
=====

[](#usage)

In your Mautic insert into an email template this shortcode around *some name*`[some name|vocative]`

- for example `[Karel|vocative]`
- or better example `[{leadfield=firstname}|vocative]`
    hint: use `CTRL+SHIFT+V` to insert copied text without formatting, also check source code of your email template by [![Mautic source code icon](https://raw.githubusercontent.com/mautic/mautic/4.3.1/app/bundles/CoreBundle/Assets/js/libraries/ckeditor/plugins/sourcedialog/icons/sourcedialog.png)](https://raw.githubusercontent.com/mautic/mautic/4.3.1/app/bundles/CoreBundle/Assets/js/libraries/ckeditor/plugins/sourcedialog/icons/sourcedialog.png)button for unwanted formatting
- also foreign and non-human names are converted to czech form `[Cassandra|vocative]` = `Cassandro`, `[android|vocative]` = `Androide`
- you can use it even in Subject of your email (unlike other shortcodes).
- **always test your email before sending it to real people**

### Aliases

[](#aliases)

You can also set aliases to be used (and vocalized) instead of the name.

- `[{leadfield=firstname}|vocative(sirius,andromeda,fill your name plase!)]` leading into
    - if `firstname` is male, let's say Roman, the result is `Siriusi`
    - if `firstname` is female, for example Gloria, the result is `Andromedo`
    - if `firstname` is empty, or from white characters only respectively, the result is `Fill your name please!`
- if you omit one of gender-dependent alias, the original name is used
    - `[richard|vocative(,For gentlemen only!)]` = `Richarde`
    - `[monika|vocative(,For gentlemen only!)]` = `For gentlemen only!` (because of the trailing non-character the string is untouched)
    - `[  |vocative(Karel,Monika)]` = ``
    - `[  |vocative(Karel,Monika,Batman)]` = `Batmane`

### Dynamic Web Content support

[](#dynamic-web-content-support)

Thanks to [Zdeno Kuzmany](https://github.com/kuzmany/)the [Dynamic Web Content](https://mautic.org/docs/en/dwc/index.html) is also supported and processed by vocative.

Install
=======

[](#install)

1. Let it install by `composer require granam/mautic-czech-vocative-bundle`
2. Clear Mautic cache by `./app/console cache:clear` or just delete the `app/cache` dir.
    - note: In some cases, not yet fully understood, the cache is not rebuilt fully automatically. In case of fatal error because of expected but missing file in the cache, rebuilt it manually:
        - `./app/console cache:warmup --no-optional-warmers`
3. Log in to your Mautic as an admin, open cogwheel menu in the right top corner and choose *Plugins*
4. Click *Install/Upgrade Plugins*

If everything goes well, you got new plugin *GranamVocative*.

Compatibility
-------------

[](#compatibility)

### Mautic v4.\*

[](#mautic-v4)

- virtually tested with Mautic 4.\* up to 4.4

*Unknown, but possible compatibility with lower versions.*

Troubleshooting
---------------

[](#troubleshooting)

If any error happens, first of all, have you **cleared the cache**?

Otherwise, check the logs for what happened:

1. they are placed in app/logs dir in your Mautic, like `/var/www/mautic/app/logs/mautic_prod-2016-02-19.php`
2. or, if they are more fatal or just Mautic does not catch them (error 500), see your web-server logs, like `/var/log/apache2/error.log`

Credits
=======

[](#credits)

The plugin has been created thanks to sponsor [svetandroida.cz](https://www.svetandroida.cz/)and thanks to the author of free czech vocative library [`bigit/vokativ`](https://bitbucket.org/bigit/vokativ.git) Petr Joachim.

Additional thanks to [vietnamisa.cz](http://www.vietnamisa.cz/) for their help with bug-fixes and improvements.

Hint for mautic Twig plugin
===========================

[](#hint-for-mautic-twig-plugin)

If you are going to create a Mautic plugin for [Twig](https://twig.symfony.com/doc/2.x/), a good start can be [mautic-twig-plugin-skeleton](https://github.com/dongilbert/mautic-twig-plugin-skeleton).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Every ~113 days

Recently: every ~0 days

Total

22

Last Release

1343d ago

Major Versions

1.3.1 → 2.0.02017-11-28

1.3.x-dev → 2.0.12017-12-02

1.4.x-dev → 3.0.02022-09-05

3.0.x-dev → 4.0.02022-09-06

PHP version history (5 changes)1.1.0PHP ~5.4

1.2.0PHP >=5.4

1.3.1PHP >=7.0

3.0.0PHP >=7.3

4.0.1PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e35d11c9a75584084f0dc0ba1a3b6ff03355777809cbe8eabd20a88ac00f794?d=identicon)[jaroslavtyc](/maintainers/jaroslavtyc)

---

Top Contributors

[![jaroslavtyc](https://avatars.githubusercontent.com/u/2290225?v=4)](https://github.com/jaroslavtyc "jaroslavtyc (102 commits)")

---

Tags

pluginMauticintegrationczechsalutationvocative

###  Code Quality

TestsPHPUnit

Static AnalysisRector

### Embed Badge

![Health badge](/badges/granam-mautic-vocative-bundle/health.svg)

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

###  Alternatives

[mautic/grapes-js-builder-bundle

GrapesJS Builder with MJML support for Mautic

5684.1k4](/packages/mautic-grapes-js-builder-bundle)[acquia/mc-cs-plugin-custom-objects

This plugin adds custom objects feature.

4713.7k](/packages/acquia-mc-cs-plugin-custom-objects)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

522.0k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

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