Logo di Rose Perl Technology

Rose Perl Tecnologia

Guida all'installazione di RP Locator

Aggiungi il widget RP Locator al tuo store locator esistente o al tuo sito web, aiuta i clienti a installare l'applicazione mobile e consenti loro di salvare il tuo store o product locator con una rapida scansione.

Aggiungi il tuo localizzatore Scarica l'app Scansiona per configurare Tutte le opzioni

Inizia in 3 semplici passaggi

Offri ai clienti un percorso semplice dal tuo sito web a un localizzatore salvato nell'app RP Locator.

1. Aggiungi e personalizza il widget

Aggiungi il widget alla tua pagina o al tuo sito web di localizzatore di punti vendita esistente. Imposta l'URL del tuo sito web o del localizzatore, il nome del localizzatore (come il nome del tuo negozio), un messaggio personalizzato sul tuo negozio e se si tratta di un localizzatore di Negozi o di Prodotti. Puoi anche aggiungere il tuo logo e personalizzare lo stile del widget per adattarlo alla tua gamma di colori.

<!-- 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. Scansiona il codice QR

Una volta installata l'app, scansiona il codice QR del widget per configurare e salvare il nuovo localizzatore nell'app. Il localizzatore sarà quindi pronto ogni volta che vorrai trovare negozi vicini o prodotti preferiti.

Crea una collezione di localizzatori più utile

Apri RP Locator e vai ai tuoi localizzatori salvati ogni volta che ne hai bisogno. Più localizzatori di negozi e prodotti aggiungi, più utile diventa la tua raccolta di localizzatori personali.

Esempi di configurazione per la produzione

Questi esempi dal vivo utilizzano opzioni supportate dal widget di produzione.

Widget con marchio per i clienti

Un widget rifinito per la tua pagina di localizzazione negozi o prodotti, con il tuo marchio e un codice QR pronto per essere scansionato dai clienti.

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

Modulo Interattivo + Anteprima

Utilizzare questa versione quando il personale o i clienti devono poter inserire i dettagli del localizzatore e scaricare o copiare il codice QR generato.

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

Inizializzazione automatica con attributi di dati

Usa gli attributi di dati per le impostazioni di visualizzazione e stile quando preferisci un'inizializzazione basata su markup.

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

Personalizza i link di download della tua app

I valori predefiniti di produzione puntano a RP Locator nell'Apple App Store e in Google Play. Puoi anche personalizzare RP Locator come la tua app con marchio, pubblicarla negli app store e aggiornare questi link per indirizzare i clienti direttamente alla tua app con marchio. Scopri di più su creazione di un'app personalizzata 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"
});

Tutte le opzioni dei widget

Passa queste opzioni a QrWidget.init({...}). Solo obiettivo identifica dove è montato il widget; tutte le altre opzioni ne personalizzano il contenuto, il comportamento o l'aspetto.

Opzioni di posizionamento e montaggio

OpzioneValori / predefinitoScopo
obiettivoSelettore CSS o elemento; predefinito nulloElemento che conterrà il widget. Usa una destinazione univoca per ogni istanza.
sito webstringa URL; predefinito vuotoIl tuo localizzatore di negozi, localizzatore di prodotti o URL del sito web. Il codice QR generato apre questo URL.
nomeTesto; predefinito vuotoNome del localizzatore, come il nome di un negozio o il nome del cercatore di prodotti.
su misuraTesto; predefinito vuotoValore personalizzato o messaggio rivolto al cliente salvato con il localizzatore.
app"Negozio" o "Prodotto"; dedotto se omessoImposta il tipo di localizzatore. Valori sconosciuti o mancanti ripiegano sul rilevamento dell'URL e successivamente su Store.
compilazione automaticaBooleano; predefinito veroLegge i parametri URL della pagina supportati e genera automaticamente il codice QR quando tutti i valori richiesti sono disponibili.

Opzioni di layout e aspetto

OpzioneValori / predefinitoScopo
tema"luce", "buio", o "marchio"; predefinito "luce"Seleziona la combinazione di colori del widget.
colorecolore CSS; predefinito #A4118DImposta il colore di accento utilizzato dai controlli e dagli elementi evidenziati.
logoURL dell'immagine; immagine RP predefinitaMostra il tuo logo nell'intestazione. Quando fornito, diventa anche la fonte dell'immagine dell'intestazione.
etichettaLogopredefinito "Scansiona per configurare"Etichetta visualizzata sotto il logo.
mostraIntestazioneBooleano; predefinito veroMostra o nasconde l'area dell'intestazione completa.
mostraModuloBooleano; predefinito falsoMostra o nasconde il modulo di localizzazione modificabile.
mostraAnteprimaQRBooleano; predefinito falsoMostra o nasconde la scheda di anteprima del QR più grande sotto l'intestazione.
abilitaDownloadBooleano; predefinito falsoAggiunge un pulsante per scaricare l'immagine QR generata.
abilitaCopiaBooleano; predefinito falsoAggiunge un pulsante per copiare l'URL del localizzatore generato.
modalità"pieno" o "compatto"; predefinito "pieno"Impostazione del layout riservato. Il renderer di produzione corrente non applica alcuna differenza di modalità visiva.

Opzioni di intestazione e testo del modulo

OpzionePredefinitoScopo
Intestazione dell'intestazioneScansiona questo codice QR per configurare il tuo localizzatoreIntestazione del widget principale.
descrizione dell'intestazioneDescrizione del download di RP LocatorTesto di supporto sotto il titolo.
Istruzioni di intestazioneIstruzioni per il download e la scansioneIstruzioni mostrate sopra i badge delle app e il codice QR.
intestazioneGenerataEtichettaQrCodice QR generatoEtichetta sotto il codice QR dell'intestazione generata.
headerQrAltCodice QR per scaricare l'appTesto alternativo per l'immagine dell'intestazione iniziale.
immagineQrIntestazioneURL dell'immagine predefinita di RPImmagine di intestazione di riserva quando non è personalizzata logo è fornito.
Titolo del moduloGeneratore di Codici QRIntestazione sopra il modulo modificabile.
sottotitolo del moduloCrea un codice QR personalizzato per la tua configurazione del localizzatore.Testo di supporto sopra i campi del modulo.
Anteprima titoloAnteprima QR generataIntestazione sopra l'anteprima del grande codice QR.

Opzioni dell'App Store

OpzionePredefinitoScopo
linkPerDownloadIosVuotoDestinazione di override preferita per il badge dell'Apple App Store.
collegamentoDownloadGooglePlayVuotoOverride preferito per la destinazione del badge di Google Play.
linkdellappStoreScheda dell'App Store di RP LocatorDestinazione predefinita del badge Apple quando linkPerDownloadIos è vuoto.
link al Play StoreScheda Google Play di RP LocatorDestinazione badge Android predefinita quando collegamentoDownloadGooglePlay è vuoto.
distintivo dell'App StoreURL dell'immagine del badge dell'App Store per RPSostituisce l'immagine del badge Apple visualizzata.
badge di Google PlayURL dell'immagine del badge di Google PlaySostituisce l'immagine del badge di Google Play visualizzata.

attributi di dati HTML

Usa gli attributi di visualizzazione su un elemento con data-qr-widget per l'auto-inizializzazione basata su markup. Gli attributi parent e position appartengono al tag script del widget.

AttributoOpzione equivalente / Scopo
data-qr-titleIntestazione dell'intestazione
data-qr-autofillcompilazione automatica; usa "vero" o "falso"
data-qr-modemodalità; riservato a "pieno" o "compatto"
data-qr-themetema
data-qr-colorcolore
data-qr-downloadabilitaDownload; usa "vero" attivare
data-qr-copyabilitaCopia; usa "vero" attivare
logo-qr-datilogo
data-qr-show-headermostraIntestazione
data-qr-show-formmostraModulo
data-qr-show-displaymostraAnteprimaQR
data-qr-parentAttributo del tag script contenente un selettore CSS per il genitore del mount di fallback automatico.
data-qr-positionUtilizzo dell'attributo del tag script aggiungi, anteponi, prima, o dopo posizione per il supporto di riserva.

Parametri di compilazione automatica degli URL

Con compilazione_automatica: vero, i parametri di query della pagina sito web, nome, su misura, e app può fornire valori di localizzazione. I valori JavaScript espliciti hanno la priorità. Usa app=Store o applicazione=Prodotto.

Esempio JavaScript completo

QrWidget.init({
  target: "#my-qr-widget",
  website: "https://your-site.com/store-locator",
  name: "Nome del tuo negozio",
  custom: "Trova i nostri prodotti vicino a te",
  app: "Store",
  autofill: true,
  theme: "brand",
  color: "#A4118D",
  logo: "https://your-site.com/your-logo.png",
  logoLabel: "Il nome del tuo marchio",
  headerHeading: "Aggiungi il nostro negozio al localizzatore RP",
  headerDescription: "Tieni il nostro localizzatore a portata di mano sul tuo telefono.",
  headerInstructions: "Installa l’app, poi scansiona questo codice QR.",
  etichettaQrGenerata: "Scansiona per aggiungere questo localizzatore",
  mostraIntestazione: true,
  mostraModulo: false,
  mostraAnteprimaQR: false,
  abilitaDownload: false,
  abilitaCopia: false,
  linkDownloadiOS: "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});