<!-- TITLE: Carriers - Dokumentacja modułu Magento 2-->
<!-- SUBTITLE: Autor: Aurora Creation -->
# Carriers - Dokumentacja modułu Magento 2
## Opis modułu
Moduł dodaje nowe metody płatności, oraz umożliwia dodanie logo metody dostawy w sklepie, oraz wprowadza zależności między metodą płatności a dostawy.
Pozwala to na określenie które metody dostawy są dostępne dla poszczególnych metod płatności, a także pozwala na dostęp do danych przesyłek poprzez API zamówienia.
## Zgodność modułu
Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.4**.
## Sposób działania
Moduł konfigurujemy z **Stores -> Configuration -> Sales -> Delivery Methods**.
W karcie tej widoczne są nowe metody płatności, wszystkie poprzedzone są dopiskiem Aurora.
Po ich konfiguracji metody dostępne są przy finalizowaniu zakupu.
### Dodawanie metody dostawy:
Należy przejść do **Stores -> Configuration -> Sales -> Delivery Methods** gdzie mamy dostęp do metod dostawy:
![Carriers 1](/uploads/carriers/carriers-1.png "Carriers 1")
Następnie musimy rozwinąć interesującą Nas metodę i odpowiednio ją skonfigurować:
![Carrierss 2](/uploads/carriers/carrierss-2.png "Carrierss 2")
**Enabled** - określamy czy metoda jest włączona
**Title** - ustawiamy nazwę z jaką metoda wysyłki ma się wyświetlać
**Method Name** - krótka nazwa metody wysyłki
**Price** - cena wysyłki
**Type** - metoda obliczania ceny wysyłki
**Select image** - pozwala wybrać obraz dla metody wysyłki
**Calculate Handling Fee** - pozwala określić czy naliczać dodatkową opłatę manipulacyjną
**Handling Fee** - wysokość dodatkowej opłaty manipulacyjnej
**Enable Free Shipping** - pozwala określić czy dla metody dostępna jest darmowa wysyłka
**Sort Order** - określa kolejność metody na liście
**Ship to Applicable Countries** - pozwala na wybranie gdzie przesyłka ma obowiązywać
**Shipd to Specific Countries** - pozwala na wybranie krajów w których metoda będzie dostępna
**Display Error Message** - pozwala na określenie informacji jaka się wyświetla w przypadku niedostępności metody wysyłki
Po konfiguracji należy nacisnąć **Save Config** i wyczyścich **cache**.
Na Naszej stronie po przejściu do podsumowania powinna być widoczna nowa metoda wysyłki:
![Carriers 3](/uploads/carriers/carriers-3.png "Carriers 3")
## Instalacja modułu
### Instalacja przez Composer
1. Dodaj repozytorium do pliku composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:magento2/carriers.git"
}
...
],
```
2. Zmodyfikuj plik composer.json:
```text
"require": {
...
"aurora/module-carriers": "*"
...
},
```
3. W folderze głównym Magento wykonaj następujące polecenia:
```text
composer update aurora/module-carriers
php bin/magento module:enable Aurora_Carriers
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_Carriers
php bin/magento setup:upgrade
```
## Dziennik zmian
### v1.9.0
* Naprawa składni kodu wg standardów
* Dodanie testów jednostkowych
### v1.8.0
* Dodanie walidacji przesyłek
### v1.7.12
* Poprawa działania mapy
### v1.7.11
* Naprawa konfiguracji PayPal
### v1.7.10
* Poprawa naliczania rabatów
### v1.7.9
* Dodanie kompatybilności z funkcją reorder z PA
### v1.7.8
* Poprawa formularza z checkout
### v1.7.7
* Poprawa wadliwej funkcji
### v1.7.6
* Naprawa działania z darmową wysyłką
### v1.7.5
* Poprawa wadliwej funkcji
### v1.7.4
* Poprawa wyświetlania metod dostawy
### v1.7.3
* Poprawa wyboru punktu dostawy
### v1.7.2
* Poprawa działania płatności przy odbiorze
### v1.7.1
* Poprawa wyglądu InPost
### v1.7.0
* Poprawa błędów
* Refaktoryzacja kodu
### Dziękujemy za zainteresowanie naszymi modułami!