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.
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>
2. Descarga la aplicación RP Locator
En tu teléfono o dispositivo móvil, haz clic en el enlace de App Store o Google Play que se muestra en el widget, luego instala la aplicación RP Locator.
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ón | Valores / predeterminado | Propósito |
objetivo | selector CSS o elemento; predeterminado nulo | Elemento que contendrá el widget. Utilice un destino único para cada instancia. |
sitio web | cadena URL; valor predeterminado vacío | Su localizador de tiendas, localizador de productos o URL del sitio web. El código QR generado abre esta URL. |
nombre | Texto; por defecto vacío | Nombre del localizador, como el nombre de una tienda o el nombre del buscador de productos. |
personalizado | Texto; por defecto vacío | Valor personalizado o mensaje dirigido al cliente guardado con el localizador. |
aplicación | "Tienda" o "Producto"; inferido cuando se omite | Establece el tipo de localizador. Los valores desconocidos o faltantes recurren a la detección de URL y luego a Store. |
autocompletar | Booleano; por defecto verdadero | Lee 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ón | Valores / predeterminado | Propósito |
tema | "luz", "oscuro", o "marca"; por defecto "luz" | Selecciona el esquema de colores del widget. |
color | color CSS; predeterminado #A4118D | Establece el color de acento utilizado por los controles y resaltados. |
logotipo | URL de la imagen; imagen de RP predeterminada | Muestra tu logotipo en el encabezado. Cuando se proporciona, también se convierte en la fuente de la imagen del encabezado. |
etiqueta del logotipo | predeterminado "Escanear para configurar" | Etiqueta que se muestra debajo del logotipo. |
mostrarCabecera | Booleano; por defecto verdadero | Muestra u oculta el área de cabecera completa. |
mostrarFormulario | Booleano; por defecto falso | Muestra u oculta el formulario de localizador editable. |
mostrarVistaPreviaQR | Booleano; por defecto falso | Muestra u oculta la tarjeta de vista previa del código QR más grande debajo del encabezado. |
habilitarDescarga | Booleano; por defecto falso | Añade un botón para descargar la imagen QR generada. |
habilitarCopia | Booleano; por defecto falso | Añ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ón | Predeterminado | Propósito |
Encabezado del encabezado | Escanee este código QR para configurar su localizador | Encabezado del widget principal. |
descripción del encabezado | Descripción de la descarga de RP Locator | Texto de apoyo debajo del encabezado. |
instrucciones de cabecera | Instrucciones de descarga y análisis | Instrucciones mostradas encima de los distintivos de la aplicación y el código QR. |
Etiqueta de código QR generada por el encabezado | Código QR generado | Etiqueta debajo del código QR de cabecera generado. |
cabeceraQrAlt | Código QR para descargar la aplicación | Texto alternativo para la imagen de cabecera inicial. |
imagenQrEncabezado | URL de la imagen predeterminada de RP | Imagen de cabecera predeterminada cuando no hay ninguna personalizada logotipo se suministra. |
Título del formulario | Generador de códigos QR | Encabezado encima del formulario editable. |
Subtítulo del formulario | Crea un código QR personalizado para tu configuración de localizador. | Texto de apoyo encima de los campos del formulario. |
Título de vista previa | Vista previa del código QR generado | Encabezado sobre la vista previa del código QR grande. |
Opciones de la tienda de aplicaciones
| Opción | Predeterminado | Propósito |
enlaceDeDescargaIos | Vacío | Anulación preferida para el destino de la insignia de Apple App Store. |
enlaceDeDescargaDeGooglePlay | Vacío | Anulación preferida para el destino del distintivo de Google Play. |
enlaceDeAppStore | Listado de la App Store de RP Locator | Destino predeterminado de la insignia de Apple cuando enlaceDeDescargaIos está vacío. |
enlaceDePlayStore | Ficha de Google Play de RP Locator | Destino de insignia de Android predeterminado cuando enlaceDeDescargaDeGooglePlay está vacío. |
Insignia de App Store | URL de la insignia de la App Store de RP | Reemplaza la imagen de la insignia de Apple mostrada. |
Insignia de Play Store | URL de la insignia de Google Play RP | Reemplaza 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.
| Atribuir | Opción equivalente / propósito |
data-qr-title | Encabezado del encabezado |
data-qr-autofill | autocompletar; usar "cierto" o "falso" |
data-qr-mode | modo; reservado para "completo" o "compacto" |
data-qr-theme | tema |
color-qr-de-datos | color |
data-qr-download | habilitarDescarga; usar "cierto" para habilitar |
data-qr-copy | habilitarCopia; usar "cierto" para habilitar |
data-qr-logo | logotipo |
data-qr-show-header | mostrarCabecera |
data-qr-show-form | mostrarFormulario |
data-qr-show-display | mostrarVistaPreviaQR |
data-qr-parent | Atributo de la etiqueta script que contiene un selector CSS para el elemento padre del montaje alternativo automático. |
data-qr-position | Uso 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"
});