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

ActiveCraft-plugin

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

Relabel Plugin Craft

2.0.2(5y ago)2869.7k4[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 1mo ago

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 87% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity73

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

2103d ago

Major Versions

1.4.0 → 2.0.02020-08-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/0ab525bd9be66927d2e3f3ced63d0cb284c3ade744ace71dab6f455589767239?d=identicon)[anubarak](/maintainers/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

[nystudio107/craft-seomatic

SEOmatic facilitates modern SEO best practices & implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible.

1741.4M46](/packages/nystudio107-craft-seomatic)[verbb/image-resizer

Resize assets when they are uploaded.

127269.1k7](/packages/verbb-image-resizer)[verbb/formie

The most user-friendly forms plugin for Craft.

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

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[wrav/oembed

A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles.

36205.0k3](/packages/wrav-oembed)[verbb/hyper

A user-friendly links field for Craft.

24130.9k9](/packages/verbb-hyper)

PHPackages © 2026

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