W celu poprawnej instalacji modułu wymagane są:

• php >= 5.6
• composer

1. Pobierz repozytorium i skopiuj jego zawartość do katalogu domowego swojego Prestashop
2. Sprawdz czy moduł znajduje się na liście dostępnych modułów w Panelu Admina
3. Zainstaluj moduł z poziomu Panelu Admina
4. Skonfiguruj mododuł, dodaj swój klucz API w poli API Key. Znajdziesz go w zakładce Integracja panelu bliskapaczka.pl
5. Następnie ustal wymiary i wagę standardowej paczki w polach Fixed parce type size X, Fixed parce type size Y, Fixed parce type size Z, Fixed parce type weight
6. Sprawdź czy na liście dostępnych metod dostawy pojawiła się nowa metoda wysyłki "Bliskapaczka", skonfiguruj ją

Tryb testowy, czli komunikacja z testową wersją znajdującą się pod adresem sandbox-bliskapaczka.pl można uruchomić przełączają w ustwieniach modułu opcję Test mode enabled na Yes.

Dostępni przewoźnicy oraz koszty przesyłki dla poszczególnych punktów dostawy są ustawiani po stronie konfiguracji serwisu blikskapaczka.pl. Konfiguracja znajduje się w zakładce "Narzędzia" -> "Integracja".

Moduł bliskapaczka.pl korzysta ze standardowych ustawień VAT dla metod dostawy w PrestaShop. Standardowo moduł nie ustawia stawki VAT dla dostawy bliskapaczka.pl, cena wyświetlana klientowi sklepu jest ceną zawierającą VAT, która została ustawiona w konfiguracji serwisu blikskapaczka.pl. Ustawienie stawki VAT dla dostawy bliskapaczka.pl powoduje przeniesienie wyliczania kosztu dostawy na PrestaShop, w takim przypadku moduł bliskapaczka.pl bierze cenę netto z ustawień w konfiguracji serwisu blikskapaczka.pl i dodaje do tej ceny VAT ustawiony w konfiguracji modułu.

Wybór przewoźnika DPD lub FedEx dla zleceń D2D z usługą pobrania może wiązać się z dodatkową opłatą podczas wyceny w serwisie bliskapaczka.pl ze względu na obowiązkowe ubezpieczenie, którego wymaga przewoźnika. Kwota pobrania wolna od dodatkowych opłat uwzględniona jest w cenniku na naszej stronie internetowej bliskapaczka.pl/cennik

docker-compose up

Front PrestaShop jest dostępny po wpisaniu w przeglądarcę adresu http://127.0.0.1:8080.

Panel admina jest dostępny pod adresem http://127.0.0.1:8080/admin6666ukv7e, dane dostępowe to [email protected]/0123456789. Moduł należy zainstalować i skonfigurować według instrukcji powyżej.

Jeśli masz już plik composer.json musisz zmergować zawartość pliku modułu do własnego. Plik musi zawierać:

"repositories": [
    ...
    {
        "type": "vcs",
        "url": "https://github.com/bliskapaczkapl/bliskapaczka-api-client.git"
    }
],
"require": {
    ...
    "bliskapaczka/bliskapaczka-api-client": "^1.0"
}

Następnie zainstaluj zależności composerem. Uruchom poniższą komendę w katalogu domowym Prestashop

composer install --dev

W celu developmentu można uruchomić docker-compose prze komendę:

docker-compose -f docker-compose.yml -f dev/docker/docker-compose.dev.yml up

cd modules/bliskapaczka
php ./vendor/bin/phpunit --bootstrap tests/bootstrap.php tests/unit/

Moduł bliskapaczka.pl dziedziczy po niektórych elementach PrestaShop przez co może powodować konflikty jeśli w aplikacji są zainstalowane inne moduły dziedziczące po tych samych klasach. Poniżej znajduje się informacja po jakich klasach, kontrolerach i widokach dziedziczy moduł bliskapazka.pl

Klasu:

• OrderCore
• CartCore

Kontrolery:

• OrderControllerCore

Widoki:

• order-carrier.tpl