Logotipo de Rose Perl Technology

Tecnología Rose Perl

Guía de configuración de RP Locator

Añade el widget RP Locator a tu localizador de tiendas o sitio web existente, ayuda a los clientes a instalar la aplicación móvil y permíteles guardar tu localizador de tiendas o productos con un rápido escaneo.

Añade tu localizador Descarga La Aplicación Escanear para configurar Todas las opciones

Comience en 3 sencillos pasos

Ofrezca a los clientes un camino sencillo desde su sitio web hasta un localizador guardado en la aplicación RP Locator.

1. Añadir y personalizar el widget

Agrega el widget a tu página de localizador de tiendas o sitio web existente. Configura la URL de tu sitio web o localizador, el nombre del localizador (como el nombre de tu tienda), un mensaje personalizado sobre tu tienda y si es un localizador de tiendas o de productos. También puedes agregar tu logo y dar estilo al widget para que coincida con tu tema de color.

<!-- 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. Escanea el código QR

Una vez instalada la aplicación, escanea el código QR del widget para configurar y guardar el nuevo localizador en la aplicación. El localizador estará listo cuando quieras encontrar tiendas cercanas o productos favoritos.

Construya una colección de localizadores más útil

Abre RP Locator y ve a tus localizadores guardados siempre que los necesites. Cuantos más localizadores de tiendas y productos agregues, más útil será tu colección de localizadores personales.

Ejemplos de configuración de producción

Estos ejemplos en vivo usan opciones compatibles con el widget de producción.

Widget con marca visible para el cliente

Un widget elegante para tu página de localizador de tiendas o de productos, con tu imagen de marca y un código QR listo para que los clientes lo escaneen.

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

Formulario interactivo + Vista previa

Use esta versión cuando el personal o los clientes deban poder introducir los datos del localizador y descargar o copiar el código QR generado.

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

Inicialización automática con atributos de datos

Utilice los atributos de datos para la configuración de visualización y estilo cuando prefiera la inicialización basada en marcado.

<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>

Personaliza los enlaces de descarga de tu aplicación

Los valores predeterminados de producción apuntan a RP Locator en Apple App Store y Google Play. También puede personalizar RP Locator como su propia aplicación de marca, publicarla en las tiendas de aplicaciones y actualizar estos enlaces para enviar a los clientes directamente a su aplicación de marca. Obtenga más información sobre creando una aplicación personalizada con 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 las opciones de widgets

Pasa estas opciones a QrWidget.init({...}). Solo objetivo identifica dónde está montado el widget; todas las demás opciones personalizan su contenido, comportamiento o apariencia.

Opciones de localizador y montaje

OpciónValores / predeterminadoPropósito
objetivoselector CSS o elemento; predeterminado nuloElemento que contendrá el widget. Utilice un destino único para cada instancia.
sitio webcadena URL; valor predeterminado vacíoSu localizador de tiendas, localizador de productos o URL del sitio web. El código QR generado abre esta URL.
nombreTexto; por defecto vacíoNombre del localizador, como el nombre de una tienda o el nombre del buscador de productos.
personalizadoTexto; por defecto vacíoValor personalizado o mensaje dirigido al cliente guardado con el localizador.
aplicación"Tienda" o "Producto"; inferido cuando se omiteEstablece el tipo de localizador. Los valores desconocidos o faltantes recurren a la detección de URL y luego a Store.
autocompletarBooleano; por defecto verdaderoLee los parámetros de la URL de la página admitidos y genera el código QR automáticamente cuando todos los valores requeridos están disponibles.

Opciones de diseño y apariencia

OpciónValores / predeterminadoPropósito
tema"luz", "oscuro", o "marca"; por defecto "luz"Selecciona el esquema de colores del widget.
colorcolor CSS; predeterminado #A4118DEstablece el color de acento utilizado por los controles y resaltados.
logotipoURL de la imagen; imagen de RP predeterminadaMuestra tu logotipo en el encabezado. Cuando se proporciona, también se convierte en la fuente de la imagen del encabezado.
etiqueta del logotipopredeterminado "Escanear para configurar"Etiqueta que se muestra debajo del logotipo.
mostrarCabeceraBooleano; por defecto verdaderoMuestra u oculta el área de cabecera completa.
mostrarFormularioBooleano; por defecto falsoMuestra u oculta el formulario de localizador editable.
mostrarVistaPreviaQRBooleano; por defecto falsoMuestra u oculta la tarjeta de vista previa del código QR más grande debajo del encabezado.
habilitarDescargaBooleano; por defecto falsoAñade un botón para descargar la imagen QR generada.
habilitarCopiaBooleano; por defecto falsoAñade un botón para copiar la URL del localizador generado.
modo"completo" o "compacto"; por defecto "completo"Configuración de diseño reservada. El renderizador de producción actual no aplica una diferencia de modo visual.

Opciones de texto para encabezados y formularios

OpciónPredeterminadoPropósito
Encabezado del encabezadoEscanee este código QR para configurar su localizadorEncabezado del widget principal.
descripción del encabezadoDescripción de la descarga de RP LocatorTexto de apoyo debajo del encabezado.
instrucciones de cabeceraInstrucciones de descarga y análisisInstrucciones mostradas encima de los distintivos de la aplicación y el código QR.
Etiqueta de código QR generada por el encabezadoCódigo QR generadoEtiqueta debajo del código QR de cabecera generado.
cabeceraQrAltCódigo QR para descargar la aplicaciónTexto alternativo para la imagen de cabecera inicial.
imagenQrEncabezadoURL de la imagen predeterminada de RPImagen de cabecera predeterminada cuando no hay ninguna personalizada logotipo se suministra.
Título del formularioGenerador de códigos QREncabezado encima del formulario editable.
Subtítulo del formularioCrea un código QR personalizado para tu configuración de localizador.Texto de apoyo encima de los campos del formulario.
Título de vista previaVista previa del código QR generadoEncabezado sobre la vista previa del código QR grande.

Opciones de la tienda de aplicaciones

OpciónPredeterminadoPropósito
enlaceDeDescargaIosVacíoAnulación preferida para el destino de la insignia de Apple App Store.
enlaceDeDescargaDeGooglePlayVacíoAnulación preferida para el destino del distintivo de Google Play.
enlaceDeAppStoreListado de la App Store de RP LocatorDestino predeterminado de la insignia de Apple cuando enlaceDeDescargaIos está vacío.
enlaceDePlayStoreFicha de Google Play de RP LocatorDestino de insignia de Android predeterminado cuando enlaceDeDescargaDeGooglePlay está vacío.
Insignia de App StoreURL de la insignia de la App Store de RPReemplaza la imagen de la insignia de Apple mostrada.
Insignia de Play StoreURL de la insignia de Google Play RPReemplaza la imagen del distintivo de Google Play mostrada.

Atributos de datos HTML

Utilice los atributos de visualización en un elemento con data-qr-widget para la auto-inicialización basada en marcado. Los atributos parent y position pertenecen a la etiqueta de script del widget.

AtribuirOpción equivalente / propósito
data-qr-titleEncabezado del encabezado
data-qr-autofillautocompletar; usar "cierto" o "falso"
data-qr-modemodo; reservado para "completo" o "compacto"
data-qr-themetema
color-qr-de-datoscolor
data-qr-downloadhabilitarDescarga; usar "cierto" para habilitar
data-qr-copyhabilitarCopia; usar "cierto" para habilitar
data-qr-logologotipo
data-qr-show-headermostrarCabecera
data-qr-show-formmostrarFormulario
data-qr-show-displaymostrarVistaPreviaQR
data-qr-parentAtributo de la etiqueta script que contiene un selector CSS para el elemento padre del montaje alternativo automático.
data-qr-positionUso de atributos de etiquetas script adjuntar, anteponer, antes, o después de ubicación para el soporte alternativo.

Parámetros de autorrelleno de URL

Con autocompletar: true, los parámetros de consulta de la página sitio web, nombre, personalizado, y aplicación puede proporcionar valores de localizador. Los valores explícitos de JavaScript tienen prioridad. Usar aplicación=Tienda o app=Producto.

Ejemplo completo de JavaScript

QrWidget.init({
  target: "#my-qr-widget",
  website: "https://your-site.com/store-locator",
  name: "Nombre de tu tienda",
  custom: "Encuentra nuestros productos cerca de ti",
  app: "Tienda",
  autofill: true,
  theme: "brand",
  color: "#A4118D",
  logo: "https://your-site.com/your-logo.png",
  logoLabel: "Nombre de tu marca",
  headerHeading: "Añade nuestra tienda al localizador de RP",
  headerDescription: "Ten nuestro localizador a mano en tu móvil.",
  instrucciones del encabezado: "Instala la aplicación y, a continuación, escanea este código QR",
  etiquetaQRgenerada: "Escanea para añadir este localizador",
  mostrarencabezado: true,
  mostrarformulario: false,
  mostrarvista previa del QR: false,
  habilitar descarga: false,
  habilitar copia: false,
  enlace de descarga para iOS: "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});