PHPackages                             anubarak/craft-relabel - 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. anubarak/craft-relabel

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

anubarak/craft-relabel
======================

Relabel Plugin Craft

2.0.2(5y ago)2869.8k4[1 issues](https://github.com/Anubarak/craft-relabel/issues)MITPHPCI failing

Since Aug 14Pushed 5y ago2 watchersCompare

[ Source](https://github.com/Anubarak/craft-relabel)[ Packagist](https://packagist.org/packages/anubarak/craft-relabel)[ RSS](/packages/anubarak-craft-relabel/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (1)Versions (36)Used By (0)

Relabel Plugin for Craft CMS 3.x
================================

[](#relabel-plugin-for-craft-cms-3x)

[![drawing](resources/img/icon.svg)](resources/img/icon.svg)

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 3.0.0 or later. **Important**: if you are coming from Craft 2 - there is no migration currently so all your Relabels will be deleted. If you really need a migration feel free to contact me or backup the table and insert it on your own

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

[](#installation)

To install the plugin, follow these instructions.

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

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require anubarak/craft-relabel

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

Basic Hints
-----------

[](#basic-hints)

Relabel creates a custom Database table that stores the new labels. Default Craft fields are not touched in any way. The strings are replaced by JavaScript so you can remove/uninstall the plugin whenever you want without breaking changes in your Control Panel. Relabel is compatible with the Craft 3 project config so you only need to relabel your fields in your main environment and can sync all data.

Usage
-----

[](#usage)

Go to your field layout, click on the wheel icon and select "Relabel"

[![Screenshot](resources/img/Relabel.gif)](resources/img/Relabel.gif)

Your field layout will have a different label and description.

To receive error messages that contains your new relabel strings do

```
$errors = Relabel::getErrors($element);
```

Or in Twig

```
{% set errors = relabel.getErrors(element) %}
```

Register Relabel for custom element types
-----------------------------------------

[](#register-relabel-for-custom-element-types)

There is an event to register Relabel for a custom form,

```
use anubarak\relabel\services\RelabelService;

Event::on(
    RelabelService::class,
    RelabelService::EVENT_REGISTER_LABELS,
    function(RegisterLabelEvent $event) use($myCustomElement){
        $event->fieldLayoutId = $myCustomElement->fieldLayoutId;
    }
);
```

Register additional Relabels
----------------------------

[](#register-additional-relabels)

You can as well register additional Labels for every field layout within your Plugins `init` function as well. Important: you need to have the event there and not in certain Controllers because I need to pass those variables before the Controller action begins otherwise I'm not able to inject the required JavaScript to the request. This is an example how you could register custom nested field layouts

```
Event::on(
    RelabelService::class,
    RelabelService::EVENT_REGISTER_ADDITIONAL_LABELS,
    function(Event $event) {
        $layoutId = $event->fieldLayoutId;
        $fields = Craft::$app->getFields()->getFieldsByLayoutId($layoutId);
        $plugin = Craft::$app->getPlugins()->getPlugin('relabel');
        /** @var RelabelService $service */
        $service = $plugin->get('relabel');

        foreach ($fields as $field){
            if($field instanceof Field){
                $blocks = $field->getBlockTypes();
                foreach ($blocks as $block){
                    $layoutForBlock = (int)$block->fieldLayoutId;
                    $index = $field->handle . '.' . $block->handle;
                    $relabels = $service->getAllLabelsForLayout($layoutForBlock, $index);
                    foreach ($relabels as $relabel){
                        $event->labels[] = $relabel;
                    }
                }
            }
        }
    }
);
```

If Relabel does not support your HTML yet, feel free to contact me and we'll find a way to make it work

Currently supported Element Types are
-------------------------------------

[](#currently-supported-element-types-are)

- craft\\elements\\Entries
- craft\\elements\\Assets
- craft\\elements\\GlobalSets
- craft\\elements\\Categories
- craft\\elements\\Users
- verbb\\voucher\\elements\\Voucher
- verbb\\voucher\\elements\\Code
- craft\\commerce\\elements\\Order
- craft\\commerce\\elements\\Product
- craft\\commerce\\elements\\Variant
- Solspace\\Calendar\\elements\\Calendar

Register custom labels after Ajax requests
------------------------------------------

[](#register-custom-labels-after-ajax-requests)

Crafts entries are able to change the field layout by changing the entry type, if you want to be able to change the field layout for a custom element type via Javascript as well you need to include these lines

```
$labelsForLayout = Relabel::getService()->getAllLabelsForLayout($layout->id);
Craft::$app->getView()->registerJs('Craft.relabel.changeEntryType(' . json_encode($labelsForLayout) . ');');
```

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 54.1% 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 ~22 days

Recently: every ~11 days

Total

33

Last Release

2160d ago

Major Versions

1.4.0 → 2.0.02020-08-03

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6122122?v=4)[Robin Schambach](/maintainers/anubarak)[@Anubarak](https://github.com/Anubarak)

---

Top Contributors

[![RobinSecondred](https://avatars.githubusercontent.com/u/174421896?v=4)](https://github.com/RobinSecondred "RobinSecondred (33 commits)")[![Anubarak](https://avatars.githubusercontent.com/u/6122122?v=4)](https://github.com/Anubarak "Anubarak (26 commits)")[![bencroker](https://avatars.githubusercontent.com/u/57572400?v=4)](https://github.com/bencroker "bencroker (1 commits)")[![richardcalahan](https://avatars.githubusercontent.com/u/753757?v=4)](https://github.com/richardcalahan "richardcalahan (1 commits)")

---

Tags

craft-plugincraft3relabelcmsCraftcraftcmscraft-pluginrelabel

### Embed Badge

![Health badge](/badges/anubarak-craft-relabel/health.svg)

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

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

102393.6k70](/packages/verbb-formie)[verbb/comments

Add comments to your site.

13753.9k](/packages/verbb-comments)[verbb/navigation

Create navigation menus for your site.

92705.0k18](/packages/verbb-navigation)[verbb/vizy

A flexible visual editor field for Craft.

4250.4k](/packages/verbb-vizy)[verbb/hyper

A user-friendly links field for Craft.

24147.8k12](/packages/verbb-hyper)[verbb/workflow

Enforce multi-step review processes for creating entries.

138124.2k1](/packages/verbb-workflow)

PHPackages © 2026

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