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>
2. Descarregar a aplicação RP Locator
No seu telemóvel ou dispositivo móvel, clique na hiperligação da App Store ou do Google Play apresentada no "widget" e, em seguida, instale a aplicação RP Locator.
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ção | Valores / predefinição | Propósito |
alvo | Seletor CSS ou elemento; predefinição nulo | Elemento que irá conter o widget. Utilize um destino único para cada instância. |
sítio web | cadeia de caracteres URL; predefinição vazia | O seu localizador de lojas, localizador de produtos ou URL do site. O código QR gerado abre este URL. |
nome | Texto; vazio por defeito | Nome do localizador, como o nome de uma loja ou de um localizador de produtos. |
personalizado | Texto; vazio por defeito | Valor personalizado ou mensagem visível para o cliente guardada com o localizador. |
aplicação | "Loja" ou "Produto"; inferido quando omitido | Define o tipo de localizador. Valores desconhecidos ou em falta recorrem à deteção de URL e, em seguida, a Store. |
preenchimento automático | Booleano; predefinido verdadeiro | Lê 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ção | Valores / predefinição | Propósito |
tema | "luz", "escuro", ou "marca"; predefinição "luz" | Seleciona o esquema de cores do widget. |
cor | cor CSS; predefinição #A4118D | Define a cor de destaque utilizada pelos controlos e destaques. |
logótipo | URL da imagem; imagem RP predefinida | Apresenta o seu logótipo no cabeçalho. Quando fornecido, também se torna a origem da imagem do cabeçalho. |
Logótipo | Texto; predefinido "Digitalizar para configurar" | Legenda apresentada abaixo do logótipo. |
mostrarCabeçalho | Booleano; predefinido verdadeiro | Mostra ou oculta a área do cabeçalho completa. |
mostrarFormulário | Booleano; predefinido falso | Mostra ou oculta o formulário de localização editável. |
mostrarPré-visualizaçãoQR | Booleano; predefinido falso | Mostra ou oculta o cartão de pré-visualização do QR maior abaixo do cabeçalho. |
ativarTransferência | Booleano; predefinido falso | Adiciona um botão para descarregar a imagem QR gerada. |
ativar Cópia | Booleano; predefinido falso | Adiciona 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ção | Predefinição | Propósito |
cabeçalhoTítulo | Faça a leitura deste código QR para configurar o seu localizador | Título do widget principal. |
Descrição do cabeçalho | Descrição da transferência do RP Locator | Texto de apoio por baixo do título. |
instruçõesDeCabeçalho | Instruções de transferência e análise | Instruções mostradas acima dos emblemas da aplicação e do código QR. |
QR code gerado no cabeçalho | Código QR gerado | Legenda por baixo do código QR do cabeçalho gerado. |
cabeçalhoQrAlt | Código QR para transferir a aplicação | Texto alternativo para a imagem de cabeçalho inicial. |
imagemQrCabecalho | URL da imagem predefinida do RP | Imagem de cabeçalho alternativa quando não existe nenhuma personalizada logótipo é fornecido. |
Título do formulário | Gerador de Código QR | Título acima do formulário editável. |
subtítulo do formulário | Crie 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ção | Pré-visualização do QR Gerado | Cabeçalho por cima da pré-visualização grande do QR code. |
Opções da App Store
| Opção | Predefinição | Propósito |
linkTransferenciaIos | Vazio | Substituição preferencial para o destino do selo da Apple App Store. |
linkDeTransfereciaDoGooglePlay | Vazio | Substituição preferencial para o destino do selo do Google Play. |
linkDaAppStore | Listagem da Loja de Aplicações RP Locator | Destino predefinido do crachá da Apple quando linkTransferenciaIos está vazio. |
linkDaPlayStore | Listagem do Google Play para RP Locator | Destino de emblema predefinido do Android quando linkDeTransfereciaDoGooglePlay está vazio. |
Emblema da App Store | URL da imagem do crachá da App Store da RP | Substitui a imagem do crachá da Apple apresentada. |
Distintivo da Play Store | URL da imagem do selo do Google Play | Substitui 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.
| Atributo | Opção equivalente / objetivo |
data-qr-title | cabeçalhoTítulo |
data-qr-autofill | preenchimento automático; utilizar "verdadeiro" ou "falso" |
modo-qr-data | modo; reservado para "cheio" ou "compacto" |
data-qr-theme | tema |
data-qr-color | cor |
data-qr-download | ativarTransferência; utilizar "verdadeiro" ativar |
data-qr-copy | ativar Cópia; utilizar "verdadeiro" ativar |
data-qr-logo | logótipo |
data-qr-show-header | mostrarCabeçalho |
data-qr-show-form | mostrarFormulário |
data-qr-show-display | mostrarPré-visualizaçãoQR |
data-qr-parent | Atributo da tag script que contém um seletor CSS para o ascendente da montagem de recurso de alternativa automático. |
data-qr-position | Utilizaçã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"
});