Como manipular as variações de produtos

Esse artigo tem por objetivo detalhar e exemplificar como é feita a manipulação de informações de variações nos servidores Tray.

Todas as informações das variações de um produto estão armazenadas no índice {{ product.variants }} e nesse índice são disponibilizadas diversas informações referentes a variação como id, product_id, price, stock, payment_option, sku, entre outras.

Abaixo um exemplo de retorno desse índice.

Array
(
    [sku] => Array
        (
            [Cor] => Array
                (
                    [Azul] => Array
                        (
                            [id] => 112
                            [ean] => 
                            [product_id] => 88
                            [price] => 80.00
                            [cost_price] => 0.00
                            [stock] => 10
                            [minimum_stock] => 
                            [reference] => 
                            [weight] => 100
                            [length] => 40
                            [width] => 25
                            [height] => 25
                            [start_promotion] => 
                            [end_promotion] => 
                            [payment_option] => R$ 72,00 à vista com desconto Boleto - TC ou 6x com juros de R$ 14,28
                            [payment_option_details] => Array
                                (
                                    [0] => Array
                                        (
                                            [display_name] => Boleto - TrayCheckout
                                            [plots] => 1
                                            [value] => 72.00
                                        )

                                    [1] => Array
                                        (
                                            [display_name] => Cartão Amex - TrayCheckout
                                            [plots] => 6
                                            [value] => 14.28
                                        )

                                )

                            [available] => 
                            [illustrative_image] => 
                            [color_id_1] => 2
                            [color_id_2] => 0
                            [cubic_weight] => 100
                            [payment] => [html pronto das formas de pagamento]
                            [images] => Array
                                (
                                    [0] => Array
                                        (
                                            [small] => https://images4.tcdn.com.br/img/img_prod/image.jpg
                                            [medium] => https://images3.tcdn.com.br/img/img_prod/image.jpg
                                            [large] => https://images3.tcdn.com.br/img/img_prod/image.jpg
                                            [full] => https://images1.tcdn.com.br/img/img_prod/image.jpg
                                        )

                                )

                            [calculated_price] => 80.00
                            [is_variant] => 1
                            [price_offer] => 0
                            [color_1] => Array
                                (
                                    [id] => 2
                                    [name] => Azul
                                    [image] => http://images3.tcdn.com.br/img/img_prod/xx/cor_2.png?20160622100723
                                    [image_secure] => https://images3.tcdn.com.br/img/img_prod/xx/cor_2.png?20160622100723
                                )

                        )

                    [Vermelho] => Array
                        (
                            [id] => 114
                            [ean] => 
                            [product_id] => 88
                            [price] => 80.00
                            [cost_price] => 0.00
                            [stock] => 10
                            [minimum_stock] => 
                            [reference] => 
                            [weight] => 100
                            [length] => 40
                            [width] => 25
                            [height] => 25
                            [start_promotion] => 
                            [end_promotion] => 
                            [payment_option] => R$ 72,00 à vista com desconto Boleto TC ou 6x com juros de R$ 14,28
                            [payment_option_details] => Array
                                (
                                    [0] => Array
                                        (
                                            [display_name] => Boleto - TrayCheckout
                                            [plots] => 1
                                            [value] => 72.00
                                        )

                                    [1] => Array
                                        (
                                            [display_name] => Cartão Amex - TrayCheckout
                                            [plots] => 6
                                            [value] => 14.28
                                        )

                                )

                            [available] => 
                            [illustrative_image] => 
                            [color_id_1] => 12
                            [color_id_2] => 0
                            [cubic_weight] => 100
                            [payment] => [html pronto das formas de pagamento]
                            [images] => Array
                                (
                                    [0] => Array
                                        (
                                            [small] => https://images.tcdn.com.br/img/img_prod/image.jpg
                                            [medium] => https://images.tcdn.com.br/img/img_prod/image.jpg
                                            [large] => https://images.tcdn.com.br/img/img_prod/image.jpg
                                            [full] => https://images4.tcdn.com.br/img/img_prod/image.jpg
                                        )

                                )

                            [calculated_price] => 80.00
                            [is_variant] => 1
                            [price_offer] => 0
                            [color_1] => Array
                                (
                                    [id] => 12
                                    [name] => Vermelho
                                    [image] => http://images3.tcdn.com.br/img/img_prod/xx/cor_12.png?20160622100723
                                    [image_secure] => https://images3.tcdn.com.br/img/img_prod/xx/cor_12.png?20160622100723
                                )

                        )

                )

        )

)

Indicamos que seja utilizada a chamada image_secure para exibir as imagens das variações pois a mesma tem o link com https, a chamada somente com image tem o link com http

Vamos de um exemplo prático para deixar mais claro a utilização do {{ product.variants }}

Como exibir as formas de pagamento das variações?

Para exibir essa informação há duas opções:

A primeira delas é utilizar o payment, essa chamada trás um bloco já pronto das informações de precificação:

Exemplo

{% for sku in product.variants %}
  {% for type in sku %}
    {% for value in type %}
      {{ value.payment }}
    {% endfor %}
  {% endfor %}
{% endfor %}   

Também é possível exibir as formas de pagamento de acordo com sua necessidade e para isso deve-se utilizar as informações do índice payment_option_details. Esse índice retorna as seguintes informações:

 [payment_option_details] => Array
        (
            [0] => Array
                (
                    [display_name] => Boleto - TrayCheckout
                    [plots] => 1
                    [value] => 72.00
                )

            [1] => Array
                (
                    [display_name] => Cartão Amex - TrayCheckout
                    [plots] => 6
                    [value] => 14.28
                )

        )

Exemplo:

{% for sku in product.variants %}
  {% for payment in sku.payment_option_details %}
    {% if payment.plots == 1 %}
    <h2 clas="PrecoPrincipal" >{{ settings.currency }} {{ payment.value }}</h2>
      <span> à vista no {{ payment.display_name }}</span>
    {% else %}
      {% if payment|length > 1 %}
       <br><span> ou </span>
      {% endif %}
      em <span>{{ payment.plots }} vezes de {{ settings.currency }} {{ payment.value }}
      no {{ payment.display_name }}</span>
    {% endif %}
  {% endfor %}
{% endfor %} 

Seguindo o mesmo principio é possível exibir diversas outras características de variações, como tipos de variações e imagens por exemplo.