Veja a documentação em Inglês aqui.
O plugin Trustvox VTEX IO é uma solução de integração entre a plataforma de e-commerce VTEX IO e a plataforma de avaliações RA Trustvox. Ele permite que lojistas exibam widgets de avaliação de produtos e o selo de confiança diretamente em suas páginas, enriquecendo a experiência do usuário e aumentando a credibilidade da loja.
Para instalar o plugin da trustvox para VTEX IO siga os seguintes passos:
- Para clonar o projeto, rode o seguinte comando:
git clone https://github.com/trustvox/trustvox-vtex-io-plugin.git
- No arquivo manifest.json, altere o valor de
vendor
com o nome da conta vtex que está realizando a instalação.
OBS: O nome da conta está presente na URL myvtex, Exemplo:https://{account}.myvtex.com
- Abra o terminal na pasta deste projeto, e siga os seguintes passos:
- Execute o seguinte comando para fazer login na conta VTEX:
vtex login {account}
Substitua o {account}
- Execute o seguinte comando para publicar o aplicativo no repositório de aplicativos da VTEX:
vtex publish
- Execute o seguinte comando para instalar o aplicativo:
vtex install
Após isso você deve ser capaz de encontrar o aplicativo RA Trustvox na sessão de Gerenciamento de aplicativos
no seu painel da VTEX.
- Agora é necessário configurar o aplicativo RA Trustvox no painel administrativo da VTEX. Para isso siga os seguintes passos:
- Na sessão de
Gerenciamento de aplicativos
do painel da VTEX, selecione o aplicativo RA Trustvox, você deve visualizar a seguinte tela:
- Preencha o campo
Store ID
com o ID da sua loja. Você pode encontrar seu ID menu preferências no Painel administrativo da Trustvox, na página da empresa:
⚠️ Caso seja necessário a validação no ambiente de homologação é necessário ativar a opção Habilitar ambiente de testes
e informar o ID da loja de do ambiente de testes da trustvox.
- Após a instalação, vá até o projeto da sua loja (store-theme) e edite o arquivo
manifest.json
, nas dependências do projeto adicione a dependência do aplicativo da trustvox.
{
...
"dependencies": {
...
"{account}.trustvox": "0.x",
...
}
...
}
Substitua o {account}
pela sua conta vtex.
Suba as alterações para sua loja, após isso, você irá conseguir adicionar os blocos do aplicativo RA Trustvox.
- Localize e selecione o aplicativo RA Trustvox. A tela de configuração do aplicativo será exibida como mostrado abaixo:
-
Marque a caixa de seleção Habilitar Espelhamento de Reviews para ativar o agrupamento de produtos.
-
Clique no botão Salvar para aplicar as alterações.
Este aplicativo disponibiliza substitui os blocos de Reviews de produto e também disponibiliza outros blocos.
Após a instalação você poderá adicionar os seguintes blocos as suas páginas:
Este bloco pode ser adicionado nas prateleiras de produtos. Ele renderiza o widget que lista as média de avaliações por estrela quantidade de comentários para o produto que está sendo visualizado.
Este bloco pode ser adicionado à página do produto (store.product
). Ele renderiza o widget que lista média de avaliações por estrela e a quantidade de comentários para o produto que está sendo visualizado.
Este bloco pode ser adicionado à página do produto (store.product
) e renderiza o widget principal que lista quaisquer comentários ou perguntas respondidas para o produto que está sendo visualizado, bem como um formulário para fazer uma nova pergunta, se o produto não tiver a pergunta ou review, ele será exibido como visto na loja.
Este bloco renderiza o widget de certificado de Reviews Verdadeiros, você pode ver mais sobre aqui.
Este bloco renderiza o widget de Carrossel de opiniões, você pode ver mais sobre aqui.
Este aplicativo fornece algumas classes CSS como uma API para personalização de estilo.
Para usar esta API CSS, você deve adicionar o styles
builder e criar um arquivo CSS de estilo de aplicativo e adicionar {account}.trustvox
ao seu tema dependencies
.
- Adicione o
styles
builder ao seumanifest.json
:
"builders": {
"styles": "1.x"
}
- Adicione
{account}.trustvox
aodependencies
no seumanifest.json
:
"dependencies": {
"{account}.trustvox": "0.x"
}
- Crie um arquivo chamado
{account}.trustvox.css
dentro da pastastyles/css
. Adicione seus estilos personalizados:
.container {
margin-top: 10px;
}
Após realizar os testes de integração com a plataforma RA Trustvox, abra o terminal na pasta deste projeto e execute o seguinte comando para disponibilizar o aplicativo da trustvox para poder ser usado em produção:
vtex deploy
Requisitos e primeiros passos - Plataforma VTEX / VTEX IO
Acessos necessários para integração na plataforma VTEX
Como exibir as opiniões da RA Trustvox na plataforma VTEX IO