<!-- TITLE: Api Gus - Dokumentacja modułu Magento 2-->
<!-- SUBTITLE: Autor: Paweł Wasiluk -->
# Api Gus - Dokumentacja modułu Magento 2
## Opis modułu
Modułu pozwala na pobieranie przy pomocy webapi danych firmy w procesie zakupowym.
## Zgodność modułu
Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.4**.
## Sposób działania
Po instalacji modułu przejdź do Panelu Admina w **Stores > Settings >Configuration > Aurora > Gus Api** jest możliwość konfiguracji modułu

**Gus Api** - Włączenie / wyłączenie modułu.
**Gus Api Key** - Miejsce na wpisanie klucza api, w przypadku gdy sklep działa w trybie produkcyjnym jest on wymagany.
**API Test environment** - Włączenie pozwala na korzystanie z api gus w wersji demo. Baza gus jest ograniczona, natomiast nie musimy podawać klucza api.
Po włączeniu modułu do procesu zakupowego została dodana funkcjonalność modułu

Po wpisaniu poprawnego numer nipu formularz zostanie uzupelniony danym.
## Demo
demo1.magecreation.com
## Instalacja modułu
### Instalacja przez Composer
1. Dodaj repozytorium do pliku composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:aurora-modules/apigus.git"
}
...
],
```
2. Zmodyfikuj plik composer.json:
```text
"require": {
...
"aurora/module-api-gus": "*"
...
},
```
3. W folderze głównym Magento wykonaj następujące polecenia:
```text
composer update aurora/module-api-gus
php bin/magento module:enable Aurora_ApiGus
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_ApiGus
php bin/magento setup:upgrade
```
4. Jeżeli nie masz zainstalowanej dedykowanej wtyczki od Gus przeznaczonej dla magento 2- zrób to za pomocą composer-a poprzez komendę "composer require gusapi/gusapi"
## Changelog
### v1.0.11
* Dodano testy (phpcs, phpunit, phpmd, phpstan) w pipelinach
### v1.0.10
* Poprawiono tłumaczenie i dodano informację o trybie testowym
### v1.0.9
* Poprawione ładowanie danych dla prawidłowego nipu
### v1.0.8
* fNaprawiono odpowiedź api
### v1.0.7
* Poprawki w module
### v1.0.6
* Update do M2.4
### v1.0.5
* Update README.md
### v1.0.4
* Moduł został zmieniony, aby uniknąć błędu, gdy nie jest w trybie produkcyjnym i nie przekazano klucza api.
### v1.0.3
* Naprawiono błąd ze złym interfejsem i złą nazwą stałej
### v1.0.2
* Poprawka dla walidacji danych i przekazywania nip do backendu
### v1.0.1
* Naprawiono błąd z domyślnym typem
### v1.0.0
* Dodano copyrights, testy, config przeniesiony do helpera
### Dziękujemy za zainteresowanie naszymi modułami!