<!-- TITLE: Widgets - Dokumentacja modułu Magento 2-->
<!-- SUBTITLE: Autor: Aurora Creation -->
# Widgets - Dokumentacja modułu Magento 2
## Opis modułu
Moduł umożliwia dodanie widżetów z produkatmi na wybranej stronie w sklepie:
-listy bestseller'ów
-bestseller'ów z danej kategorii
-ostatnio zakupionych produktów
-nowych produktów
-ostatnio oglądanych produktów
## Zgodność modułu
Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.4**.
## Sposób działania
Widżet dodajemy jak standardowe widżety Magento.
## Demo
demo1.magecreation.com
### Dodawanie widżetu:
Kieruj się do Panelu Admina. Tam przejdź do **Content > Element > Widgets**.
Wybierz opję **Add Widget**.
Pojawi się widok dodawanie widgetu.
![Addwidget](/uploads/widget/addwidget.png "Addwidget")
**Type**- typ widżetu.
**Design Theme**- wybranie motywu.
Widżety dodane przez moduł zaczynają się od Catalog Product List.
![Widgets 2](/uploads/widget/widgets-2.png "Widgets 2")
**Po wybraniu typi i motywu przechodzimy do konfiguracji modułu:**
![Widget 3](/uploads/widget/widget-3.png "Widget 3")
**Widget Title** - nazwa widżetu w Panelu Administracyjnym.
**Assign to Store Views**- przypisanie do odpowiednich sklepów na których ma się wyświetlać
**Sort Order** - kolejność sortowania.
**Layout Updates** - określa gdzie (na jakich stronach i w jakim kontenerze) ma pojawić się widget.
Po konfiguracji tej zakładki możemy przejść do **Widget Options**
![Widgets 4](/uploads/widget/widgets-4.png "Widgets 4")
**Title** - wyświetlana nazwa widżetu
**Display Page Control**- czy wyświetlić sterowanie widżetem.
**Bestsellers range** - zakres bestseller'ów.
**Promoted products**- dodatkowe produkty które chcielibyśmy wyświetlić.
**Number of Products per Page**- liczba produktów na stronę.
**Number of Products to Display**- liczba produktów do wyświetlenia.
**Cache Lifetime (Seconds)** - czas życia cache.
Po konfiguracji należy wybrać opcję **Save**
Zapisany widżet pokaże się pod ścieżką **Content > Element > Widgets**.
## Instalacja modułu
### Instalacja przez Composer
1. Dodaj repozytorium do pliku composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:magento2/widgets.git"
}
...
],
```
2. Zmodyfikuj plik composer.json:
```text
"require": {
...
"aurora/widgets": "*"
...
},
```
3. W folderze głównym Magento wykonaj następujące polecenia:
```text
composer update aurora/widgets
php bin/magento module:enable Aurora_Widgets
php bin/magento setup:upgrade
```
### Instalacja manualna
1. Rozpakuj archiwum
2. Przenieś pliki modułu na serwer do lokalizacji:
```text
{Magento root}
└── app/
└── code
```
3. W folderze głównym Magento wykonaj następujące polecenia:
```text
php bin/magento module:enable Aurora_Widgets
php bin/magento setup:upgrade
```
## Dziennik zmian
### v2.0.9
* Poprawienie kompatybilności z Magento 2.4.5
### v2.0.8
* Dodanie przycisku "Dodaj do koszyka" na widżetach
### v2.0.7
* Poprawa działania "Promowanych produktów"
### v2.0.6
* Poprawa działania bestseller'ów
### v2.0.5
* Zmiany w liście produktów
### v2.0.4
* Poprawa działania bestseller'ów
### v2.0.3
* Poprawienie limitu ostatnio wyświetlanych produktów
### v2.0.2
* Poprawa w plikach JS
### v2.0.1
* Poprawa w JS
### Dziękujemy za zainteresowanie naszymi modułami!