PHPackages                             jalendport/craft-roman - 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. jalendport/craft-roman

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

jalendport/craft-roman
======================

Convert an integer into roman numerals and vice versa.

2.0.0(2y ago)1150[1 issues](https://github.com/jalendport/craft-roman/issues)MITPHP

Since Feb 7Pushed 2y ago1 watchersCompare

[ Source](https://github.com/jalendport/craft-roman)[ Packagist](https://packagist.org/packages/jalendport/craft-roman)[ Fund](https://www.paypal.me/jalenconner)[ GitHub Sponsors](https://github.com/jalendport)[ RSS](/packages/jalendport-craft-roman/feed)WikiDiscussions develop Synced today

READMEChangelog (1)Dependencies (1)Versions (5)Used By (0)

[![icon](src/icon.svg)](src/icon.svg)Roman
==========================================

[](#roman)

[![Craft CMS 4.0.0+](https://camo.githubusercontent.com/b277069d36e2fd3c1a2342cba9efdc8c91c1839062338db648507154dc775167/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4372616674253230434d532d342e302e302532422d7265642e737667)](https://craftcms.com/) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/7cab36d405ff50c4d52b7da81e1bbb3da47d90a438b19aeb6bbb30c9940e5f8d/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6a616c656e64706f72742f63726166742d726f6d616e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/jalendport/craft-roman/?branch=master)

*Convert an integer into roman numerals and vice versa.*

[![Roman banner](resources/img/banner.png)](resources/img/banner.png)

— Based on the Craft 2 version of the [Roman](https://github.com/bransinanderson/Craft-Roman) plugin by [Bransin Anderson](https://bransinanderson.com)

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

[](#installation)

### Requirements

[](#requirements)

This plugin requires Craft CMS 4.0.0 or later.

### Plugin Store

[](#plugin-store)

Log into your control panel and click on 'Plugin Store'. Search for 'Roman'.

### Composer

[](#composer)

1. Open your terminal and go to your Craft project:

```
cd /path/to/project
```

2. Then tell Composer to load the plugin:

```
composer require jalendport/craft-roman
```

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Roman.

Using Roman
-----------

[](#using-roman)

Roman provides several Twig methods for easy conversion between integers and roman numerals:

- You can pass an integer (or a string) into the `getRoman()` method to get roman numerals:

    ```
    {{ craft.roman.getRoman(298) }}     // Output: CCXCVIII
    {{ craft.roman.getRoman('539') }}   // Output: DXXXIX

    ```
- You can pass a string (of roman numerals) into the `getNumber()` method to get an integer:

    ```
    {{ craft.roman.getNumber('ML') }}   // Output: 1050

    ```
- Roman also includes a helper attribute to quickly get the current year in roman numeral form:

    ```
    {{ craft.roman.currentYear }}       // Output: MMXXIII

    ```

Found a Bug? Need Support?
--------------------------

[](#found-a-bug-need-support)

Please open an [issue](https://github.com/jalendport/craft-roman/issues) describing what's going wrong.

Roadmap
-------

[](#roadmap)

Some things to do, and ideas for potential features:

- Twig filter for converting all integers in a string of text to roman numerals.

If there's a feature you think should be added to Roman, please open an [issue](https://github.com/jalendport/craft-roman/issues). PRs are also welcome!

---

### Contributors

[](#contributors)

- Plugin development: [Jalen Davenport](jalendport.com) / @jalendport
- Craft 2 plugin development: [Bransin Anderson](https://github.com/bransinanderson/Craft-Roman)
- Icon: [nawaf falah](https://thenounproject.com/search/?q=roman%20helmet&i=1784074), via [The Noun Project](https://thenounproject.com)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

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 ~1582 days

Total

2

Last Release

1068d ago

Major Versions

1.0.0 → 2.0.02023-06-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6537823?v=4)[Jalen Davenport](/maintainers/jalendport)[@jalendport](https://github.com/jalendport)

---

Top Contributors

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

---

Tags

cmscraftcraft-plugincraftcmsnumbernumbersnumeralnumeralsromanroman-numeralscmsCraftcraftcmscraft-pluginnumbersnumberNumeralsromannumeralroman-numerals

### Embed Badge

![Health badge](/badges/jalendport-craft-roman/health.svg)

```
[![Health](https://phpackages.com/badges/jalendport-craft-roman/health.svg)](https://phpackages.com/packages/jalendport-craft-roman)
```

###  Alternatives

[verbb/navigation

Create navigation menus for your site.

90683.7k17](/packages/verbb-navigation)[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[verbb/comments

Add comments to your site.

13753.1k](/packages/verbb-comments)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[supercool/tablemaker

Create customizable and user-defined table fields.

40141.7k](/packages/supercool-tablemaker)[pennebaker/craft-architect

CraftCMS plugin to generate content models from JSON/YAML data.

72148.5k5](/packages/pennebaker-craft-architect)

PHPackages © 2026

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