<!-- 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

W gridzie możesz dodać nowy feed za pomocą przycisku **Dodaj**.

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.

**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"

Druga opcja pozwala stworzenie mapowań do kategorii. Po przejściu do Mapping Categories zostaniesz przekierowany do grida.

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.

Konfiguracja modułu znajduję się w **Sklepy -> Konfiguracja -> Katalog**.

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.

## 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!