Personalizar ou eliminar un Botón de compra, unha colección integrada ou un carro integrado

Podes cambiar o aspecto ou o comportamento dun Botón de compra, unha colección integrada ou un carro integrado se editas o seu código de inserción no HTML de orixe da páxina web. Tamén podes eliminar un elemento integrado quitando o código da páxina.

Un Botón de compra mostra un produto cun botón de compra. Unha colección integrada mostra varios produtos. Un carro integrado mostra un carro de compras independente que a clientela pode usar nas diferentes páxinas.

O código de inserción é o fragmento de código que copiaches do administrador de Shopify e que pegaches no HTML da páxina web cando creaches o Botón de compra ou o carro. O código de inserción está escrito en JavaScript, a linguaxe de programación que se utiliza para engadir funcionalidades interactivas ás páxinas web.

Comprender o código de inserción do Botón de compra

Cada Botón de compra constrúese a partir de partes separadas chamadas compoñentes. Un compoñente é unha sección con nome do código de inserción que controla unha parte da experiencia do Botón de compra. Por exemplo, cando engades un produto cun carro á túa páxina web, o código de inserción xera os seguintes compoñentes:

  • un compoñente product, que mostra a información do produto e o botón de compra
  • un compoñente cart, que mostra o contido do carro
  • un compoñente toggle do carro, que mostra a icona que abre o carro

Se o teu compoñente do produto abre unha ventá emerxente de detalles do produto, entón o código de inserción xera dous compoñentes adicionais: un compoñente modal para a propia ventá emerxente e un compoñente modalProduct para a información do produto dentro da ventá emerxente.

No seguinte fragmento de código, hai compoñentes separados para o product e o 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'
          }
        }
      }
    }
  });
});

Cada compoñente configúrase a través dun obxecto de configuración no código de inserción. Un obxecto é un grupo estruturado de opcións de configuración, con formato de lista de pares clave-valor:

  • Unha clave é o nome dunha opción de configuración, como buttonDestination.
  • Un valor é o valor que se lle asigna á opción, como 'cart'.

Un obxecto é similar a unha folla de cálculo: cada clave correspóndese co nome dunha columna e cada valor correspóndese co contido dunha cela. Para cambiar a aparencia ou o comportamento dos teus Botóns de compra, edita as claves e os valores dentro dos obxectos de configuración.

Cada compoñente ten moitas claves editables. Para obter unha lista completa das claves editables, consulta a documentación para desenvolvedores. Para configurar unha clave que aínda non está no teu código de inserción, engádea ao obxecto apropiado. Para ver un exemplo, consulta Cambiar o deseño dun produto integrado.

Personalizar os estilos dos compoñentes

Cada compoñente ten un obxecto de configuración styles aniñado que controla a aparencia do compoñente. Un obxecto aniñado é un obxecto situado dentro doutro obxecto.

O obxecto styles utiliza CSS, a linguaxe usada para describir como se aplica o estilo visual aos elementos das páxinas web. Cada clave de nivel superior no obxecto styles representa un elemento do compoñente, como o título ou o botón. Dentro desa clave, cada clave aniñada é unha propiedade CSS (por exemplo, background-color ou border) e o valor é un valor CSS.

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

Pódese engadir calquera propiedade CSS válida a styles. Asegúrate de que os nomes de propiedade con guións estean entre comiñas.

Para obter máis información sobre a personalización de CSS, consulta a documentación para desenvolvedores.

Compoñentes da colección integrada

As coleccións integradas utilizan os mesmos obxectos de configuración que os Botóns de compra. Para editar o deseño ou outras propiedades dos produtos da colección, busca o obxecto de configuración product e edítao do mesmo xeito que editarías un produto integrado. Para editar as propiedades da propia colección, como o texto do botón Páxina seguinte, edita no seu lugar o obxecto de configuración productSet.

Algunhas claves, como o texto dun compoñente, configúranse a través de obxectos aniñados. Por exemplo, o texto do botón Páxina seguinte está dentro do obxecto text do compoñente productSet:

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

Un modal de detalles do produto é unha ventá emerxente que mostra a información do produto. Para dirixir ao teu cliente a un modal de detalles do produto en lugar de ao carro, edita o código de inserción do teu Botón de compra no HTML de orixe da túa páxina web.

Pasos:

  1. Abre o HTML da páxina que contén o produto integrado que queres cambiar.
  2. Busca o obxecto de configuración product.
  3. Busca a clave buttonDestination no obxecto:
options: {
      product: {
        buttonDestination: 'cart'
      }
}
  1. Cambia o valor desa clave a 'modal', incluíndo as comiñas:
options: {
      product: {
        buttonDestination: 'modal'
      }
}
  1. Garda os cambios.

Cambiar o deseño dun produto integrado

O deseño horizontal do produto integrado coloca a imaxe xunto aos detalles do produto en vez de encima deles. Para cambiar a este deseño, edita o código de inserción do teu Botón de compra no HTML de orixe da túa páxina web.

Pasos:

  1. Abre o HTML da páxina que contén o produto integrado que queres cambiar.
  2. Busca o obxecto de configuración product.
  3. Engade unha clave layout e, a continuación, establece o valor en 'horizontal'. Asegúrate de que o valor inclúa as comiñas e de que a liña anterior remate cunha coma:
options: {
      product: {
        buttonDestination: 'modal',
        layout: 'horizontal'
      }
}
  1. Garda os cambios.

Cambiar a aparencia e o comportamento dun carro integrado

Para cambiar a aparencia ou o comportamento dun carro, edita o obxecto de configuración cart no teu código de inserción.

Pasos:

  1. Abre o HTML da páxina que contén o carro que queres editar.
  2. Busca o obxecto de configuración cart no teu código de inserción:
options: {
      cart: {
        startOpen: false
      }
}
  1. Edita unha clave existente ou engade unha nova para cambiar a aparencia ou o comportamento do carro. Para obter unha lista completa das claves configurables, consulta a documentación para desenvolvedores.
  2. Garda os cambios.

Eliminar un Botón de compra, unha colección integrada ou un carro integrado

Para eliminar un Botón de compra, unha colección integrada ou un carro integrado da túa páxina web, elimina o seu código de inserción do HTML de orixe.

Pasos:

  1. Abre o HTML de orixe da páxina web que contén o Botón de compra, a colección integrada ou o carro integrado.
  2. Elimina todo o código de inserción do HTML de orixe, comezando por <script data-shopify-buy-ui> e rematando por </script>. O seguinte é un exemplo do código de inserción dun Botón de compra:
<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. Garda os cambios.