Pomoc
Zaloguj

Dostosowywanie lub usuwanie przycisku zakupu, osadzonej kolekcji lub osadzonego koszyka

Możesz zmienić wygląd lub zachowanie przycisku zakupu, osadzonej kolekcji lub osadzonego koszyka, edytując jego kod osadzania w źródłowym kodzie HTML swojej strony WWW. Możesz również usunąć osadzony element, usuwając jego kod ze strony WWW.

Przycisk zakupu wyświetla produkt z przyciskiem umożliwiającym zakup. Osadzona kolekcja wyświetla wiele produktów. Osadzony koszyk wyświetla odrębny koszyk, z którego klienci mogą korzystać na wielu stronach.

Kod osadzania to fragment kodu skopiowany z panelu administracyjnego Shopify i wklejony do kodu HTML strony WWW podczas tworzenia przycisku zakupu lub koszyka. Kod osadzania jest napisany w języku JavaScript — języku programowania używanym do dodawania interaktywnych funkcji na stronach WWW.

Na tej stronie

Informacje o kodzie osadzania przycisku zakupu

Każdy przycisk zakupu składa się z oddzielnych części zwanych elementami. Element to nazwana sekcja kodu osadzania, która kontroluje jedną z części interfejsu przycisku zakupu. Na przykład, gdy dodasz do strony WWW produkt z koszykiem, kod osadzania generuje następujące elementy:

  • element product, który wyświetla informacje o produkcie oraz przycisk umożliwiający zakup
  • element cart, który wyświetla zawartość koszyka
  • element toggle koszyka, który wyświetla ikonę otwierającą koszyk

Jeśli element produktu otwiera okno pop-up ze szczegółami produktu, kod osadzania generuje dwa dodatkowe elementy: element modal dla samego okna pop-up i element modalProduct dla informacji o produkcie wewnątrz okna.

W poniższym fragmencie kodu znajdują się oddzielne elementy dla product i cart:

ShopifyBuy.UI.onReady(client).then(function (ui) {
  ui.createComponent('product', {
    id: 12345,
    options: {
      product: {
        buttonDestination: 'cart',
        contents: {
          description: true
        },
        text: {
          button: 'Add to Cart'
        },
        styles: {
          button: {
            'background-color': 'blue'
          }
        }
      },
      cart: {
        styles: {
          button: {
            'background-color': 'orange'
          }
        }
      }
    }
  });
});

Każdy element jest konfigurowany za pomocą obiektu konfiguracji w kodzie osadzania. Obiekt to ustrukturyzowana grupa ustawień, sformatowana jako lista par klucz-wartość:

  • Klucz to nazwa ustawienia, np. buttonDestination.
  • Wartość określa stan danego ustawienia, np. 'cart'.

Obiekt przypomina arkusz kalkulacyjny: każdy klucz odpowiada nazwie kolumny, a każda wartość odpowiada zawartości komórki. Aby zmienić wygląd lub zachowanie przycisków zakupu, zmodyfikuj klucze i wartości w obiektach konfiguracji.

Każdy element ma wiele edytowalnych kluczy. Pełna lista edytowalnych kluczy znajduje się w dokumentacji dla deweloperów. Aby skonfigurować klucz, którego nie ma jeszcze w kodzie osadzania, dodaj go do odpowiedniego obiektu. Przykład znajdziesz w sekcji Zmiana układu osadzonego produktu.

Dostosowywanie stylów elementów

Każdy element ma zagnieżdżony obiekt konfiguracji styles, który kontroluje jego wygląd. Zagnieżdżony obiekt to obiekt umieszczony wewnątrz innego obiektu.

Obiekt styles wykorzystuje język CSS służący do opisywania sposobu formatowania elementów stron WWW. Każdy klucz najwyższego poziomu w obiekcie styles reprezentuje składnik elementu głównego, taki jak tytuł lub przycisk. Wewnątrz takiego klucza każdy zagnieżdżony klucz jest właściwością CSS (na przykład background-color lub border), a wartością jest wartość CSS.

options: {
  product: {
    styles: {
      button: {
        'background-color': 'red',
        'border-radius': '5px'
      }
    }
  }
}

Do obiektu styles można dodać każdą prawidłową właściwość CSS. Upewnij się, że nazwy właściwości z myślnikami są ujęte w cudzysłów.

Aby uzyskać więcej informacji na temat dostosowywania CSS, zapoznaj się z dokumentacją dla deweloperów.

Elementy osadzonej kolekcji

Osadzone kolekcje korzystają z tych samych obiektów konfiguracji co przyciski zakupu. Aby edytować układ lub inne właściwości produktów w kolekcji, znajdź obiekt konfiguracji product i edytuj go w taki sam sposób, jak w przypadku osadzonego produktu. Z kolei do edycji właściwości samej kolekcji, takich jak tekst przycisku Następna strona, użyj obiektu konfiguracji productSet.

Niektóre klucze, takie jak tekst elementu, są konfigurowane za pomocą obiektów zagnieżdżonych. Przykładowo tekst przycisku Następna strona znajduje się wewnątrz obiektu text w elemencie productSet:

options: {
  productSet: {
    text: {
      nextPageButton: 'Continue'
    }
  }
}

Okno modalne ze szczegółami produktu to okno pop-up wyświetlające informacje o produkcie. Aby skierować klienta do okna modalnego ze szczegółami produktu zamiast do koszyka, zmodyfikuj kod osadzania przycisku zakupu w źródłowym kodzie HTML swojej strony WWW.

Kroki:

  1. Otwórz kod HTML strony zawierającej osadzony produkt, który chcesz zmienić.
  2. Znajdź obiekt konfiguracyjny product.
  3. Znajdź klucz buttonDestination w obiekcie:
options: {
      product: {
        buttonDestination: 'cart'
      }
}
  1. Zmień wartość tego klucza na 'modal', łącznie ze znakami cudzysłowu:
options: {
      product: {
        buttonDestination: 'modal'
      }
}
  1. Zapisz zmiany.

Zmiana układu osadzonego produktu

Poziomy układ osadzonego produktu umieszcza zdjęcie obok szczegółów produktu, a nie nad nimi. Aby przełączyć na ten układ, zmodyfikuj kod osadzania przycisku zakupu w źródłowym kodzie HTML strony WWW.

Kroki:

  1. Otwórz kod HTML strony zawierającej osadzony produkt, który chcesz zmienić.
  2. Znajdź obiekt konfiguracyjny product.
  3. Dodaj klucz layout i ustaw jego wartość na 'horizontal'. Upewnij się, że wartość zawiera znaki cudzysłowu, a poprzedni wiersz kończy się przecinkiem:
options: {
      product: {
        buttonDestination: 'modal',
        layout: 'horizontal'
      }
}
  1. Zapisz zmiany.

Zmiana wyglądu i zachowania osadzonego koszyka

Aby zmienić wygląd lub zachowanie koszyka, edytuj obiekt konfiguracji cart w swoim kodzie osadzania.

Kroki:

  1. Otwórz kod HTML strony zawierającej koszyk, który chcesz edytować.
  2. Znajdź obiekt konfiguracyjny cart w kodzie osadzania:
options: {
      cart: {
        startOpen: false
      }
}
  1. Edytuj istniejący klucz lub dodaj nowy, aby zmienić wygląd albo zachowanie koszyka. Pełną listę konfigurowalnych kluczy znajdziesz w dokumentacji dla deweloperów.
  2. Zapisz zmiany.

Usuń przycisk zakupu, osadzoną kolekcję lub osadzony koszyk

Aby usunąć ze strony WWW przycisk zakupu, osadzoną kolekcję lub osadzony koszyk, usuń kod osadzania ze źródłowego kodu HTML.

Kroki:

  1. Otwórz źródłowy kod HTML strony WWW, która zawiera przycisk zakupu, osadzoną kolekcję lub osadzony koszyk.
  2. Usuń ze źródłowego kodu HTML cały kod osadzania — od tagu <script data-shopify-buy-ui> do tagu </script>. Poniżej znajduje się przykład kodu osadzania przycisku zakupu:
<script data-shopify-buy-ui>
   var scriptURL = "https://cndurl.com/buy-button-storefront.js";
    if (window.ShopifyBuy && window.ShopifyBuy.UI) {
      ShopifyBuyInit();
    } else {
      var script = document.createElement('script');
      script.async = true;
      script.src = scriptURL;
      (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(script);
      script.onload = ShopifyBuyInit;
    }

    function ShopifyBuyInit() {
      var client = ShopifyBuy.buildClient({
        apiKey: 'your-api-key',
        domain: 'your-store.myshopify.com',
        appId: '6'
      });

      ShopifyBuy.UI.onReady(client).then(function (ui) {
        ui.createComponent('product', {
          id: 12345,
          options: {
            product: {
              buttonDestination: 'cart',
              contents: {
                description: true
              },
              text: {
                button: 'Add to Cart'
              },
              styles: {
                button: {
                  'background-color': 'blue'
                }
              }
            },
            cart: {
              styles: {
                button: {
                  'background-color': 'orange'
                }
              }
            }
          }
        });
      });
    }
</script>
  1. Zapisz zmiany.