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