Integracje własne - czyli zewnętrzny kod w oprogramowaniu sklepu

Integracje własne polegają na połączeniu oprogramowania sklepu z innym kodem, takim jak narzędzia analityczne czy narzędzia marketingowe. Celem tego typu integracji jest umożliwienie systemom zewnętrznym działanie w ramach oprogramowania sklepu internetowego. Przy dodawaniu do sklepu kodu zewnętrznego należy zachować maksymalną ostrożność. Musisz być w 100% pewien, że dodawany kod jest prawidłowy i nie zawiera w sobie elementów, które mogą wyrządzić u klientów sklepu szkody. Dodawaj do sklepu tylko kod sprawdzony, którego jesteś całkowicie pewien.

Kod zewnętrzny może być dodawany do sklepu internetowego w różnych celach i sytuacjach, poniżej przedstawiamy kilka przykładów:

• integracja z systemami komunikacji - tzw. livechat - dodanie kodu pozwala umieścić na stronie komunikator do rozmów z klientami
• analiza danych - kod zewnętrzny pozwala na zintegrowanie sklepu z narzędziami analitycznymi, takimi jak Google Analytics, co umożliwia zbieranie i analizę danych dotyczących ruchu na stronie, zachowań użytkowników i efektywności marketingowej (jeżeli właściciel sklepu nie chce korzystać z integracji wbudowanej w sklep, która sama generuje kod dla Google)
• marketing automation - kod zewnętrzny pozwala na połączenie sklepu z narzędziami do automatyzacji marketingu
• wtyczki - kod zewnętrzny pozwala na dodanie dodatkowych funkcjonalności do sklepu, np. wtyczki do rekomendacji produktów - zbierające informacje o zamówieniach na potrzeby wystawiania ocen produktów i sklepu

Najczęściej stosowany i możliwy do dodania jest kod napisany w języku programowania JavaScript. Żeby dodać taki zewnętrzny kod do oprogramowania shopGold można skorzystać z dwóch możliwości.
 

Modyfikacja plików sklepu - rozwiązanie niezalecane

Pierwszą z nich jest edycja pliku głównego szablonu o nazwie "strona_glowna.tp", który znajduje się w katalogu z domyślnym szablonem (ścieżka: /szablony/nazwa_uzywanego/szablonu). Plik ten zawiera w sobie cały układ wyglądu sklepu w tym część HEAD i BODY dokumentu HTML sklepu - gdzie można dodać zewnętrzny kod. Żeby dodać kod trzeba wyedytować ten plik - np. poprzez połączenie z serwerem FTP i wstawić kod w wybrane miejsce.

Jest to rozwiązanie, które nie jest zalecane. Wymaga ono modyfikacji plików, korzystania z programów FTP itd. Nie każdy użytkownik posiada stosowną wiedzę aby to wykonać - a błędna modyfikacja pliku może spowodować problemy z działaniem sklepu. Ponadto w przypadku aktualizacji sklepu ten plik może zostać nadpisany przez aktualizację i zmiany, które były w nim wprowadzone zostaną usunięte. Zmiany wprowadzone w pliku szablonu będą widoczne tylko dla konkretnego szablonu w którym znajduje się plik. Po zmianie szablonu, kod nie będzie już wyświetlany w sklepie.
 

Dodanie kodu zewnętrznego w panelu zarządzania sklepu

Dodawanie kodu zewnętrznego bezpośrednio w panelu zarządzania sklepu internetowego jest najbardziej polecanym rozwiązaniem. Aby dodać zewnętrzny kod do sklepu trzeba skorzystać z menu Integracje / Integracje własne, które jest dostępne w panelu zarządzania sklepu. Tym menu można wstawić zewnętrzny kod, który może być wyświetlany zarówno w sekcji HEAD jak i BODY dokumentu HTML strony sklepu. Dodany w tym miejscu kod będzie wyświetlany zawsze - niezależnie od ustawionego jako domyślny szablonu.

Dodany w w/w menu kod będzie wyświetlany na każdej podstronie sklepu. Jako opcja dodatkowa w tym menu dostępna jest możliwość dodania kodu, który będzie wyświetlany tylko na podstronie podsumowania zamówienia. Jest to opcja stosowana w wielu rozwiązaniach zewnętrznych firm do analityki sprzedaży - gdzie konieczne jest umieszczenie krótkiego kodu na stronie z podsumowaniem zamówienia. Dodatkowo często do takiego kodu trzeba podstawić określone dane, np. numer zamówienia czy wartość zamówienia. Do tego można wykorzystać znaczniki, które można użyć wewnątrz kodu. Poniżej zamieszczamy przykładowy kod z użyciem znaczników.

<script>
var wartosc_zamowienia = '{WARTOSC_ZAMOWIENIA}';
var nr_zamowienia = '{NUMER_ZAMOWIENIA}';
var email_kupujacego = '{EMAIL_KUPUJACEGO}';
</script>

W miejsce znaczników wstawione będą określone wartości zamówienia. Z przykładowych zmiennych zewnętrzny kod będzie mógł pobrać dane i je odpowiednio przetworzyć.
 

Problemy przy dodawaniu kodu zewnętrznego do programu sklepu

Błędny kod może spowodować błędne działanie sklepu w całości lub części jego funkcji. Dodając zewnętrzny kod trzeba być pewnym, że nie spowoduje on szkód zarówno w sklepie jak i u użytkowników sklepu. Pamiętaj, że kod może być szkodliwy i może np. wyłudzać od klientów informacje - co spowoduje, że Twój sklep zostanie potraktowany jako strona wyrządzająca szkody i zablokowany. Przed dodaniem kodu upewnij się u jego autora czy nie będzie on miał negatywnego wpływu na działanie sklepu.

Innym problemem przy dodawaniu kodu zewnętrznego w panelu zarządzania sklepu może być problem z zapisem. Jeżeli dodajesz kod zewnętrzny w menu Integracje / Integracje własne i po zatwierdzeniu zapisu dane się nie zapisują - a Ty jest przenoszony na stronę sklepu albo otrzymujesz błąd 403 (dostęp zabroniony) lub 406 - oznacza to, że zapis kodu uniemożliwiają zabezpieczenia serwera. Kod który dodajesz serwer traktuje jako potencjalnie niebezpieczny i nie pozwana na jego zapis. W takim przypadku trzeba się skontaktować z administratorem serwera i przedstawić mu problem. Najczęściej administrator serwera dodaje do zabezpieczeń serwera dodatkowe reguły, które umożliwią zapisanie takiego kodu.