<!-- 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
![Api Gus 1](/uploads/api-gus/zrzut-ekranu-z-2022-12-15-12-42-57.png "Zrzut Ekranu Z 2022 12 15 12 42 57")
**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
![Api Gus 2](/uploads/api-gus/i-2.png "Api Gus 2")
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!