Dodatki HTML i Javascript

Dodatki HTML i JavaScript w panelu IdoSell służą do dodawania wszelkiego rodzaju kodów, takich jak kody weryfikacyjne, kody zewnętrznych systemów marketingowych czy inne skrypty (zwane również snippetami), bez konieczności modyfikacji szablonu sklepu. W znacznym stopniu podnosi to wygodę zarządzania niestandardowym kodem dodawanym do sklepu. Dodatek HTML/JS możesz dodać do sklepu w sekcji MODERACJA > Wygląd sklepu > Dodatki HTML i JavaScript.

Poniżej znajdziesz przykładowy opis konfiguracji dodatku mającego na celu weryfikację własności domeny dla Google Search Console.

Kampanie to grupy w ramach których są dodawane dodatki HTML/JS. Dzięki umieszczeniu kilku dodatków w jednej kampanii masz możliwość zarządzania kilkoma opcjami oferowanymi przez ustawienia kampanii. W ramach kampanii dodatków możesz grupowo zarządzać ich aktywnością (wyłączając kampanię) i decydować w których sklepach w panelu ma działać dana grupa dodatków.

Instrukcja konfiguracji kampanii:

1. Kliknij "Dodaj kampanię". W ramach jednej Kampanii będziesz mieć możliwość dodania dowolnej ilości dodatków HTML/JS. Konfiguracja kampanii pozwoli Ci ustalić, w których sklepach będą działać dodane przez ciebie snippety,

2. Nazwij kampanię i zmień status jej aktywności na "tak". Przypisz kampanię do wybranego sklepu dostępnego w Twoim panelu administracyjnym (możesz wybrać, aby dodatki dodane do danej kampanii działały w kilku sklepach jednocześnie),

3. Zapisz zmiany i wróć do listy kampanii. Znajdziesz tam utworzoną przez siebie kampanię.

1. Wybierz opcję "Edytuj dodatki",

2. Aby dodać nowy dodatek, kliknij przycisk "Dodaj dodatek".

Konfiguracja dodatków HTML/JS pozwala na dostosowanie wielu aspektów tego, w jaki sposób dodawany przez nas kod będzie zachowywał się na stronie. W tym kroku omówimy dostępne opcje konfiguracji:

1. Aktywność dodatku, automatyczna kontrola i wyłączanie — możesz zdefiniować czy dodatek ma być aktywny za pomocą zmiany statusu aktywności. Dzięki konfiguracji daty włączenia dodatku możesz sprawić, żeby dodatek automatycznie zmienił status na aktywny w wybranym przez Ciebie terminie. Ustawienie daty wyłączenia sprawi, że danego dnia dodatek zmieni status aktywności na "nie".

2. Typ dodatku — istnieją 3 typy dodatków HTML.

1. Dodatek HTML — Najczęściej spotykany typ dodatku. Konfigurując dodatek w kodzie HTML, upewnij się, że zachowujesz prawidłową strukturę kodu. Jeśli posiadasz kod dodatku, który musisz dodać do swojej strony w celu przeprowadzenia zewnętrznej integracji, jest to najprawdopodobniej kod HTML. Rozpoznasz go po obecnych znacznikach <script>, <style>, <div> itp.

2. Dodatek JavaScript — dodatek korzystający z czystego kodu JavaScript, system samodzielnie doda znaczniki <script> podczas implementacji dodatku na stronę.

3. Dodatek CGI — skrypty CGI (Common Gateway Interface) służą do tworzenia aplikacji internetowych, dynamicznie generujących treści na stronach internetowych np. poprzez kontakt z zewnętrzną bazą danych. Są najrzadziej spotykanym typem dodatków.

3. Konfiguracja ładowania dodatków na stronie — W tym miejscu możesz zdecydować czy dodatek ma wyświetlać się na wszystkich typach urządzeń, czy tylko na wybranych.

Opcja "Wczytaj dodatek na stronie" umożliwia wybór, w jaki sposób kod dodatku ma być ładowany na stronie sklepu:

1. Dopiero po całkowitym załadowaniu strony (AJAX) — skrypty wykonywane dopiero po całkowitym załadowaniu strony potrafią uruchamiać się w tle, bez konieczności przeładowywania całej strony sklepu. Jeśli tworzysz dodatek HTML, który będzie generować pliki cookies, skorzystaj z tej opcji, aby dodatki mogły być dynamicznie włączane/wyłączane w zależności od zgód wyrażonych przez użytkownika.

2. Razem z treścią strony — Kod tego typu dodatku znajduje się bezpośrednio w kodzie strony, w wybranym przez Ciebie miejscu (początek sekcji head, początek sekcji body, koniec sekcji body).

Automatyczna kontrola i wyłączanie — funkcja ta pozwala zabezpieczyć Twój dodatek przed zbyt długim czasem otwierania plików oczekiwania na odpowiedź z zewnątrz. Po aktywowaniu tej funkcji dodatek będzie oczekiwał 2 sekundy na otwarcie niezbędnych plików, a kiedy to nie nastąpi, zostanie wyłączony. Informacja o wyłączeniu takiego dodatku trafi do Ciebie w postaci specjalnego komunikatu w BOK.

Pokazuj na urządzeniach — możesz dostosować czy dodatek ma być wyświetlany na wszystkich urządzeniach, czy tylko na wybranym typie urządzeń. Opcja ta jest uzależniona od sposobu wczytywania dodatku na stronie. W obu przypadkach możesz wybrać czy dodatek będzie wyświetlał się na komputerze (duży ekran), czy na telefonie (mały ekran). W przypadku ładowania dodatków za pomocą AJAX dostępna jest dodatkowa opcja: średni ekran (tablet).

4. Język edycji — Jeśli Twój sklep obsługuje kilka języków, a chcesz dodać dodatek HTML/JS do każdego z nich skorzystaj z opcji "Powiel we wszystkich językach" lub samodzielnie wklej kod dodatku do wybranych języków. Każda wersja językowa pozwala na dostosowanie jej zawartości, dzięki czemu możesz zadbać o prawidłowe linkowanie/język treści wyświetlanych w ramach dodatku. Wersje językowe współdzielą ustawienia konfiguracji wyświetlania dodatku.

5. Edycja treści dodatku — kod dodatku możesz umieścić na kilka sposobów:

1. Edycja (HTML) — Pole, w którym możesz dodać swój kod HTML. Dodany w tym miejscu kod zostanie dograny do kodu strony. Za pomocą tagów <script> i <style> w ramach edycji HTML możesz wprowadzić odpowiednio kod JavaScript jak i stylowanie CSS.

2. Wgraj plik — ta opcja pozwala na wgranie gotowego kodu w postaci pliku. Obsługiwane formaty to .txt i .html.

3. Edycja (WYSIWYG) — Edytor "What You See is What You Get" pozwala na utworzenie dodatku w edytorze tekstu, mimo łatwości dodawania treści w tym edytorze może nie być on wystarczający do niektórych zastosowań. Edytor w trybie WYSIWYG analizuje kod HTML i organizuje go według własnych reguł. W niektórych przypadkach może to oznaczać znaczną zmianę wyglądu kodu i jego rezultatu. Zalecamy tworzenie dodatków za pomocą Edytora (HTML).

6. Historia zmian — historia edycji dodatku zapisuje informacje o autorze (nazwa użytkownika w panelu) oraz dacie modyfikacji dodatku. Utworzenie dodatku nie jest zapisywane w historii zmian, historia będzie widoczna dopiero od pierwszej modyfikacji dodatku. Dzięki historii zmian możesz przywrócić wcześniejszą wersję dodatku lub podejrzeć jego zawartość klikając odpowiednie przyciski w sekcji "Operacji".

7. Zmienne i listy dodatkowe — w tym miejscu znajdziesz listę zmiennych, które znacznie ułatwią tworzenie dodatku, którego celem jest zbieranie/przekazywanie informacji o kliencie. Zmienne pozwalają uzyskać informacje takie jak: dane zalogowanego użytkownika (imię, e-mail, numer telefonu, itp.), dokładne informacje o obecnie przeglądanym produkcie, dane koszyka i inne.

8. Konfiguracja wyświetlania dodatków na stronie

1. Wyświetlaj w — opcja ta pozwala na ustalenie, w którym miejscu w kodzie strony ma zostać dodany kod dodatku. Dostępne opcje to: początek sekcji head, początek sekcji body i koniec sekcji body. Jeśli posiadasz gotowy kod HTML zewnętrznej integracji, instrukcja wdrożenia tego mechanizmu powinna zawierać informację, w którym miejscu w kodzie strony powinien znaleźć się dodatek.

2. Wyświetlaj na podstronach — dodatki mogą być wyświetlane na każdej stronie w sklepie, na wybranych adresach URL lub na konkretnych podstronach definiowanych dzięki opcji Wyświetlaj na podstronach -> Wybranych. Poniżej znajdziesz listę dostępnych stron, wraz z ich adresem w przeglądarce:

• Strona główna - /main.php

• Koszyk - /basketedit.php

• Dostawa i płatności - /order1.php

• Potwierdzenie danych - /order2.php

• Złożenie zamówienia - /order-newpayment.php (aktualnie jest to strona, która automatycznie przeładowuje się podczas zmiany formy płatności, której można dokonać na orderdetails.php)

• Szczegóły zamówienia - /orderdetails.php

• Strona nawigacji (Navigation) - /navigation.php

• Karta towaru - /projector.php

• Wyniki wyszukiwania - /search.php

• Po złożeniu zamówienia - /orderdetails.php (tylko po złożeniu zamówienia)

• Zapisanie do mailingu - rozpoznawane na podstawie sesji

• Strona powrotu z płatności zakończonej sukcesem - /return.php?status=payment_success

• Strona powrotu z płatności oczekującej - /return.php?status=payment_pending

• Strona powrotu z płatności zakończonej niepowodzeniem - /return.php?status=payment_error

9. Ustawienia grupy docelowej

Dzięki konfiguracji tej sekcji możesz ograniczyć dostępność dodatku poprzez wyświetlenie go grupie klientów pochodzącej z wybranego przez Ciebie źródła lub spełniającej ustalone warunki.

Domyślnym ustawieniem w tej sekcji jest opcja "wszyscy".

Zmiana typu odwiedzającego na klienta zalogowanego (detalista lub hurtowy) pozwala dokładniej określić grupę docelową klientów, umożliwiając filtrowanie na podstawie poniższych opcji:

• Zapisany do newslettera

• Robił do tej pory zakupy

• Wprowadził kod rabatowy

Ostatnia opcja "filtruj po źródle" pozwala na wyświetlenie dodatku tylko w przypadku kiedy klient odwiedza stronę z konkretnego źródła. Poniżej znajduje się przykładowa konfiguracja dodatku, który zostanie wyświetlony tylko zalogowanym klientom detalicznym, którzy przeszli na stronę z porównywarki cen "ceneo.pl" (źródło odwiedzin: porównywarka cen -> Ceneo.pl) i nie są jeszcze zapisani do newslettera (Zapisany do newslettera: nie). Po spełnieniu tych warunków kod dodatku zostanie wykonany na stronie.

Dodatki HTML i JavaScript mogą służyć integracji zewnętrznych narzędzi analitycznych i reklamowych. Tak rozbudowane skrypty, mające za zadanie zebranie informacji na temat odwiedzającego stronę i/lub przekazanie tych informacji dalej w celu analzy, mogą w tym celu tworzyć pliki cookies na komputerze użytkownika. Twoim obowiązkiem jest poinformowanie użytkownika o obecności tych ciasteczek i umożliwienie mu rezygnacji z udostępniania dodatkowych danych.

Dla dodatków ładowanych po pełnym załadowaniu strony (AJAX) możesz skonfigurować ciasteczko które zostanie wyświetlone na liście plików Cookies w aktywnej-zaawansowanej wersji zgody na cookies oraz będzie dostępne wraz z opisem na liście plików cookies w polityce prywatności Twojego sklepu.

Nowe ciasteczko reprezentujące kod Twojego dodatku możesz dodać poprzez kliknięcie opcji "Zdefiniuj nowy plik".

Edycja zdefiniowanego pliku cookies wymaga uzupełnienia informacji na temat:

• dostawcy pliku,

• kategorii pliku (analityczne/reklamowe/funkcjonalne),

• działania ciasteczka (dodany opis będzie widoczny w treści polityki prywatności).

Zaawansowane informacje o pliku cookies pozwalają na dokładniejsze zapoznanie klienta z działaniem ciasteczka. W ramach tej sekcji możesz uzupełnić informacje o:

• nazwie pliku cookie,

• czasie przechowywania ciasteczka (czas życia pliku),

• rodzaju pliku (cookie, pamięć lokalna, pixel śledzący).