---
title: "Cum adaug widget-uri personalizate în Magento 2?"
description: "Un widget este un bloc informațional sau funcțional (buton, banner, bară de căutare, bloc de text) care poate fi plasat pe paginile site-ului. Crearea unui widget personalizat necesită cod. Fragmentele de mai jos sunt exemple și trebuie adaptate. ### 1.…"
url: "https://www.hostx.ro/kb/cum-adaug-widget-uri-personalizate-in-magento-2/"
updated: "2026-07-26"
category: Programare / Aplicații / Magento
tags:
  - configurare
  - Magento 2
  - personalizare
  - Widget
---

# Cum adaug widget-uri personalizate în Magento 2?

Un widget este un bloc informațional sau funcțional (buton, banner, bară de căutare, bloc de text) care poate fi plasat pe paginile site-ului. Crearea unui widget personalizat necesită cod. Fragmentele de mai jos sunt exemple și trebuie adaptate.

### 1. Declararea widget-ului

În `etc/widget.xml`:

```
<widgets xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Widget:etc/widget.xsd">
    <widget class="VendorLearningBlockWidgetTest" id="vendor_test_widget">
        <label>My New Widget</label>
        <description>This is a test widget</description>
        <parameters>
            <parameter name="title" xsi:type="text" required="true" visible="true" sort_order="10">
                <label>Title</label>
            </parameter>
            <parameter name="size" xsi:type="select" visible="true" sort_order="20">
                <label translate="true">Size</label>
                <options>
                    <option name="s" value="S"><label>S</label></option>
                    <option name="m" value="M" selected="true"><label>M</label></option>
                    <option name="l" value="L"><label>L</label></option>
                </options>
            </parameter>
        </parameters>
    </widget>
</widgets>
```

Adaugă și dependența de `Magento_Widget` în `etc/module.xml` (secțiunea `<sequence>`).

### 2. Clasa de bloc

În `Vendor/Learning/Block/Widget/Test.php`:

```
namespace VendorLearningBlockWidget;
use MagentoFrameworkViewElementTemplate;
use MagentoWidgetBlockBlockInterface;
class Test extends Template implements BlockInterface {
    protected $_template = 'widget/test.phtml';
}
```

### 3. Șablonul

În `Vendor/Learning/view/frontend/templates/widget/test.phtml`:

```
<h3><?= $block->escapeHtml($block->getData('title')) ?></h3>
<p><?= $block->escapeHtml(__('Size:')) ?> <?= $block->escapeHtml($block->getData('size')) ?></p>
```

### 4. Aplicarea

```
php bin/magento module:enable Vendor_Learning
php bin/magento setup:upgrade
php bin/magento cache:clean
```

Widget-ul va fi disponibil în **Content → Elements → Widgets**. Detalii în [documentația oficială](https://experienceleague.adobe.com/en/docs/commerce-operations/frontend-development-guide/themes/add-widget).