Logótipo Rose Perl Technology

Tecnologia Rose Perl

Guia de Configuração do RP Locator

Adicione o widget RP Locator ao seu localizador de lojas ou sítio Web existente, ajude os clientes a instalar a aplicação móvel e permita-lhes guardar o seu localizador de lojas ou produtos com uma leitura rápida.

Adicionar o seu localizador Descarregar a aplicação Digitalizar para configurar Todas as opções

Comece em 3 passos fáceis

Faculte aos clientes um caminho simples a partir do seu website para um localizador guardado na aplicação RP Locator.

1. Adicionar e Personalizar o Widget

Adicione o widget à sua página de localização de lojas ou site existente. Defina o URL do seu site ou localizador, o nome do localizador (como o nome da sua loja), uma mensagem personalizada sobre a sua loja e se é um localizador de Lojas ou de Produtos. Também pode adicionar o seu logotipo e estilizar o widget para condizer com o seu tema de cores.

<!-- Copy and paste this where you want the widget to appear. -->
<div id="my-qr-widget"></div>

<script src="https://cdn.roseperl.com/widgets/rp-qr/RP-QR-Widget-Prod.js"></script>
<script>
  document.addEventListener("DOMContentLoaded", function () {
    QrWidget.init({
      target: "#my-qr-widget",

      // Update these four settings for your locator.
      website: "https://your-site.com/store-locator",
      name: "Your Store Name",
      custom: "Find our products near you",
      app: "Store", // Use "Store" or "Product".

      // Optional branding and display settings.
      logo: "https://your-site.com/your-logo.png",
      logoLabel: "Your Brand Name",
      theme: "brand", // Use "light", "dark", or "brand".
      color: "#A4118D",
      showHeader: true,
      showForm: false,
      showQRPreview: false
    });
  });
</script>

3. Ler o código QR

Assim que a aplicação estiver instalada, faça a leitura do código QR do widget para configurar e guardar o novo localizador na aplicação. O localizador ficará então pronto a ser utilizado sempre que quiser encontrar lojas próximas ou produtos favoritos.

Construir uma Coleção de Localizadores Mais Útil

Abra o RP Locator e aceda aos seus locadores guardados sempre que precisar deles. Quanto mais locadores de lojas e produtos adicionar, mais útil se torna a sua coleção de locadores pessoais.

Exemplos de Configuração de Produção

Estes exemplos em direto utilizam opções suportadas pelo "widget" de produção.

Widget de Marca Orientado para o Cliente

Um widget refinado para a sua página de localizador de lojas ou de produtos, com a sua marca e um código QR pronto para os clientes lerem.

QrWidget.init({
  target: "#widget-header-only",
  theme: "brand",
  color: "#A4118D",
  logo: "https://roseperl.com/.../rp-svg-black-2.webp",
  logoLabel: "Rose Perl Technology",
  headerGeneratedQrLabel: "Digitalize para instalar",
  website: "https://example.com/store-locator",
  name: "Loja principal da Rose Perl",
  custom: "roseperl-demo",
  app: "Loja",
  showHeader: true,
  showForm: false,
  showQRPreview: false
});

Formulário Interativo + Pré-visualização

Utilize esta versão quando os funcionários ou clientes devem conseguir introduzir os detalhes do localizador e descarregar ou copiar o código QR gerado.

QrWidget.init({
  target: "#widget-full-ui",
  showHeader: true,
  showForm: true,
  showQRPreview: true,
  enableCopy: true,
  enableDownload: true
});

Inicialização Automática com Atributos de Dados

Utilize atributos de dados para definições de apresentação e estilo quando preferir uma inicialização baseada em marcação.

<div
  data-qr-widget
 data-qr-title="Rose Perl Auto Init Example"
  data-qr-theme="brand"
  data-qr-color="#A4118D"
  data-qr-logo="https://roseperl.com/.../rp-svg-black-2.webp"
  data-qr-show-header="true"
  data-qr-show-form="false"
  data-qr-show-display="false">
</div>

Personalize as Suas Ligações de Descarga da Aplicação

As predefinições de produção apontam para o RP Locator na Apple App Store e no Google Play. Também pode personalizar o RP Locator como a sua própria aplicação com marca, publicá-la nas lojas de aplicações e atualizar estes links para enviar os clientes diretamente para a sua aplicação com marca. Saiba mais acerca de criar uma aplicação personalizada com o Rose Perl.

QrWidget.init({
  target: "#widget-store-links",
  iosDownloadLink: "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});

Todas as Opções de Widgets

Transmita estas opções para QrWidget.init({...}). Apenas alvo identifica onde o widget é montado; todas as outras opções personalizam o seu conteúdo, comportamento ou aspeto.

Opções de localização e montagem

OpçãoValores / predefiniçãoPropósito
alvoSeletor CSS ou elemento; predefinição nuloElemento que irá conter o widget. Utilize um destino único para cada instância.
sítio webcadeia de caracteres URL; predefinição vaziaO seu localizador de lojas, localizador de produtos ou URL do site. O código QR gerado abre este URL.
nomeTexto; vazio por defeitoNome do localizador, como o nome de uma loja ou de um localizador de produtos.
personalizadoTexto; vazio por defeitoValor personalizado ou mensagem visível para o cliente guardada com o localizador.
aplicação"Loja" ou "Produto"; inferido quando omitidoDefine o tipo de localizador. Valores desconhecidos ou em falta recorrem à deteção de URL e, em seguida, a Store.
preenchimento automáticoBooleano; predefinido verdadeiroLê os parâmetros de URL da página suportados e gera o QR automaticamente quando todos os valores necessários estão disponíveis.

Opções de aspeto e esquema

OpçãoValores / predefiniçãoPropósito
tema"luz", "escuro", ou "marca"; predefinição "luz"Seleciona o esquema de cores do widget.
corcor CSS; predefinição #A4118DDefine a cor de destaque utilizada pelos controlos e destaques.
logótipoURL da imagem; imagem RP predefinidaApresenta o seu logótipo no cabeçalho. Quando fornecido, também se torna a origem da imagem do cabeçalho.
LogótipoTexto; predefinido "Digitalizar para configurar"Legenda apresentada abaixo do logótipo.
mostrarCabeçalhoBooleano; predefinido verdadeiroMostra ou oculta a área do cabeçalho completa.
mostrarFormulárioBooleano; predefinido falsoMostra ou oculta o formulário de localização editável.
mostrarPré-visualizaçãoQRBooleano; predefinido falsoMostra ou oculta o cartão de pré-visualização do QR maior abaixo do cabeçalho.
ativarTransferênciaBooleano; predefinido falsoAdiciona um botão para descarregar a imagem QR gerada.
ativar CópiaBooleano; predefinido falsoAdiciona um botão para copiar o URL do localizador gerado.
modo"cheio" ou "compacto"; predefinição "cheio"Definição de layout reservado. O renderizador de produção atual não aplica uma diferença de modo visual.

Opções de cabeçalho e texto de formulário

OpçãoPredefiniçãoPropósito
cabeçalhoTítuloFaça a leitura deste código QR para configurar o seu localizadorTítulo do widget principal.
Descrição do cabeçalhoDescrição da transferência do RP LocatorTexto de apoio por baixo do título.
instruçõesDeCabeçalhoInstruções de transferência e análiseInstruções mostradas acima dos emblemas da aplicação e do código QR.
QR code gerado no cabeçalhoCódigo QR geradoLegenda por baixo do código QR do cabeçalho gerado.
cabeçalhoQrAltCódigo QR para transferir a aplicaçãoTexto alternativo para a imagem de cabeçalho inicial.
imagemQrCabecalhoURL da imagem predefinida do RPImagem de cabeçalho alternativa quando não existe nenhuma personalizada logótipo é fornecido.
Título do formulárioGerador de Código QRTítulo acima do formulário editável.
subtítulo do formulárioCrie um código QR personalizado para a sua configuração de localização.Texto de apoio acima dos campos do formulário.
Título de pré-visualizaçãoPré-visualização do QR GeradoCabeçalho por cima da pré-visualização grande do QR code.

Opções da App Store

OpçãoPredefiniçãoPropósito
linkTransferenciaIosVazioSubstituição preferencial para o destino do selo da Apple App Store.
linkDeTransfereciaDoGooglePlayVazioSubstituição preferencial para o destino do selo do Google Play.
linkDaAppStoreListagem da Loja de Aplicações RP LocatorDestino predefinido do crachá da Apple quando linkTransferenciaIos está vazio.
linkDaPlayStoreListagem do Google Play para RP LocatorDestino de emblema predefinido do Android quando linkDeTransfereciaDoGooglePlay está vazio.
Emblema da App StoreURL da imagem do crachá da App Store da RPSubstitui a imagem do crachá da Apple apresentada.
Distintivo da Play StoreURL da imagem do selo do Google PlaySubstitui a imagem do crachá do Google Play apresentada.

Atributos de dados HTML

Utilize os atributos de apresentação num elemento com data-qr-widget para a auto-inicialização baseada em marcação. Os atributos parent e position pertencem à etiqueta script do widget.

AtributoOpção equivalente / objetivo
data-qr-titlecabeçalhoTítulo
data-qr-autofillpreenchimento automático; utilizar "verdadeiro" ou "falso"
modo-qr-datamodo; reservado para "cheio" ou "compacto"
data-qr-themetema
data-qr-colorcor
data-qr-downloadativarTransferência; utilizar "verdadeiro" ativar
data-qr-copyativar Cópia; utilizar "verdadeiro" ativar
data-qr-logologótipo
data-qr-show-headermostrarCabeçalho
data-qr-show-formmostrarFormulário
data-qr-show-displaymostrarPré-visualizaçãoQR
data-qr-parentAtributo da tag script que contém um seletor CSS para o ascendente da montagem de recurso de alternativa automático.
data-qr-positionUtilização de atributos de script-tag adicionar, antepor, antes, ou depois colocação para o suporte de recurso.

parâmetros de preenchimento automático de URLs

Com preenchimento automático: verdadeiro, os parâmetros de consulta da página sítio web, nome, personalizado, e aplicação pode fornecer valores de localizador. Os valores explícitos de JavaScript têm prioridade. Use aplicação=Loja ou app=Produto.

Exemplo completo em JavaScript

QrWidget.init({
  target: "#my-qr-widget",
  website: "https://your-site.com/store-locator",
  name: "Nome da sua loja",
  custom: "Encontre os nossos produtos perto de si",
  app: "Loja",
  autofill: true,
  theme: "brand",
  color: "#A4118D",
  logo: "https://your-site.com/your-logo.png",
  logoLabel: "Nome da sua marca",
  headerHeading: "Adicione a nossa loja ao Localizador RP",
  headerDescription: "Mantenha o nosso localizador à mão no seu telemóvel.",
  instruçõesNoCabeçalho: "Instale a aplicação e, em seguida, digitalize este código QR.",
  rótuloQRgeradoNoCabeçalho: "Leia para adicionar este localizador",
  mostrarCabeçalho: true,
  mostrarFormulário: false,
  mostrarPré-visualizaçãoQR: false,
  ativarDownload: false,
  ativarCópia: false,
  ligaçãoDownloadiOS: "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});