<!-- TITLE: Feed - Dokumentacja modułu Magento 2 -->
<!-- SUBTITLE: Autor: Łukasz Paliwoda -->
# Moduł Feed
## Opis modułu
Moduł dodaje funkcję generowania plików z produktami.
## Zgodność modułu
Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.2**, **2.3** i **2.4**.
## Sposób działania
Po zainstalowaniu modułu, znajdziesz go w menu w zakładce **Katalog**, gdzie pierwsza opcja Feed Listing przekieruje Cie do grida
![Product Feeds Image 1](/uploads/product-feeds/product-feeds-image-1.png "Product Feeds Image 1")
W gridzie możesz dodać nowy feed za pomocą przycisku **Dodaj**.
![Product Feeds Image 2](/uploads/product-feeds/product-feeds-image-2.png "Product Feeds Image 2")
Aby utworzyć feed należy wypełnić podstawowe pola konfiguracyjne takie jak nazwa, nazwa pliku, częstotliwość generacji i szablon. Można również zdefiniować dodatkowe warunki na podstawi których będą wybierane produkty.
![Product Feeds Image 3](/uploads/product-feeds/product-feeds-image-3.png "Product Feeds Image 3")
**Po zapisaniu** feed'u można wygenerować go ręcznie wybierając opcję **Generuj** w górnej części formularza albo poczekać na automatyczne wygenerowanie zgodnie z ustawioną częstotliwością.
**UWAGA!** W celu wygenerawania poprawnej zawartości pliku konieczne jest zapisanie go przed wybraniem opcji "Generuj"
![Product Feeds Image 4](/uploads/product-feeds/product-feeds-image-4.png "Product Feeds Image 4")
Druga opcja pozwala stworzenie mapowań do kategorii. Po przejściu do Mapping Categories zostaniesz przekierowany do grida.
![Product Feeds Image 7](/uploads/product-feeds/product-feeds-image-7.png "Product Feeds Image 7")
Aby utworzyć mapeowanie należy wypełnić podstawowe pola konfiguracyjne takie jak code, nazwa oraz możemy wykluczyć wybrane kategorie z mapowania. Po stworzeniu rekordu, możesz przejść do jego edycji, by dodać nazwy mapowania.
![Product Feeds Image 8](/uploads/product-feeds/product-feeds-image-8.png "Product Feeds Image 8")
Konfiguracja modułu znajduję się w **Sklepy -> Konfiguracja -> Katalog**.
![Product Feeds Image 5](/uploads/product-feeds/product-feeds-image-5.png "Product Feeds Image 5")
Konfiguracja pozwala na ustawienie podstawowych funkcji takich jak włączenie/wyłączenie modułu, określenie katalogu docelowego, czy częstotliwości uruchamiania generatora automatycznego.
![Product Feeds Image 6](/uploads/product-feeds/product-feeds-image-6.png "Product Feeds Image 6")
## Demo
demo1.magecreation.com
## Instalacja modułu
### Instalacja przez Composer
* Dodać repozytorium do composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:magento2/feed.git"
}
...
],
```
* Dodać pakiet do composer.json:
```text
"require": {
...
"aurora/feed": "~1.5"
...
},
```
* Wykonać polecenia w katalogu głównym Magento:
```text
$ composer update aurora/feed
$ php bin/magento module:enable Aurora_Feed
$ 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_Feed
php bin/magento setup:upgrade
```
## Dziennik zmian
### v2.0.0
* Zmodyfikowano proces generowania feedu
* Przeniesiono przycisk ręcznego generowania podawania do formularza
* Dodano wyświetlanie paska postępu w czasie ręcznego generowania
* Dodano pole konfiguracji - ilość produktów na stronę w czasie ręcznego generowania feed'u
* Zmodyfikowano szablon pliku danych - szablon został podzielony na 3 części - nagłówek, treść i stopka
### v1.10.0
* Refaktoryzacja kodu
### v1.9.2
* Poprawa kodu dla Magento 2.4.5
### v1.9.1
* Wyłączenie z filtra nieaktywnych kategorii
### v1.8.23
* Dodanie wyświetlania opisu bez tagów
### v1.8.22
* Zmiana dostępów do niektórych funkcji
### v1.8.21
* Zmiana sposobu tworzenia ścieżki do kategorii
### v1.8.20
* Poprawa tworzenia URL
### v1.8.19
* Poprawa błędu w przypadku pustych tablic
### v1.8.18
* Zmiany w ProdcutAdapter
### v1.8.17
* Naprawa problematycznej metody
### v1.8.15
* Stworzenie nowej metody do wyświetlania galerii
### v1.8.14
* Dodanie domyślnego motywu
### v1.8.13
* Poprawa mapowania kategorii
### v1.8.12
* Poprawa działania mapowania
### v1.8.11
* Poprawa błędów
### v1.8.10
* Dodanie możliwości wyboru kolorów dla nazw
### v1.8.9
* Poprawa błędów
### v1.8.8
* Poprawa błędów
### v1.8.7
* Poprawa działania rejestru
### v1.8.6
* Poprawa działania rejestru
### v1.8.5
* Poprawa działania niektórych przycisków
### v1.8.4
* Refaktoryzacja kodu
### v1.8.3
* Poprawa schematu bazy danych
### v1.8.2
* Poprawa błędów
### v1.8.1
* Poprawa błędów
### Dziękujemy za zainteresowanie naszymi modułami!