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>
2. Scarica l'App RP Locator
Sul tuo telefono o dispositivo mobile, fai clic sul link dell'App Store o di Google Play mostrato nel widget, quindi installa l'app RP Locator.
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
| Opzione | Valori / predefinito | Scopo |
obiettivo | Selettore CSS o elemento; predefinito nullo | Elemento che conterrà il widget. Usa una destinazione univoca per ogni istanza. |
sito web | stringa URL; predefinito vuoto | Il tuo localizzatore di negozi, localizzatore di prodotti o URL del sito web. Il codice QR generato apre questo URL. |
nome | Testo; predefinito vuoto | Nome del localizzatore, come il nome di un negozio o il nome del cercatore di prodotti. |
su misura | Testo; predefinito vuoto | Valore personalizzato o messaggio rivolto al cliente salvato con il localizzatore. |
app | "Negozio" o "Prodotto"; dedotto se omesso | Imposta il tipo di localizzatore. Valori sconosciuti o mancanti ripiegano sul rilevamento dell'URL e successivamente su Store. |
compilazione automatica | Booleano; predefinito vero | Legge i parametri URL della pagina supportati e genera automaticamente il codice QR quando tutti i valori richiesti sono disponibili. |
Opzioni di layout e aspetto
| Opzione | Valori / predefinito | Scopo |
tema | "luce", "buio", o "marchio"; predefinito "luce" | Seleziona la combinazione di colori del widget. |
colore | colore CSS; predefinito #A4118D | Imposta il colore di accento utilizzato dai controlli e dagli elementi evidenziati. |
logo | URL dell'immagine; immagine RP predefinita | Mostra il tuo logo nell'intestazione. Quando fornito, diventa anche la fonte dell'immagine dell'intestazione. |
etichettaLogo | predefinito "Scansiona per configurare" | Etichetta visualizzata sotto il logo. |
mostraIntestazione | Booleano; predefinito vero | Mostra o nasconde l'area dell'intestazione completa. |
mostraModulo | Booleano; predefinito falso | Mostra o nasconde il modulo di localizzazione modificabile. |
mostraAnteprimaQR | Booleano; predefinito falso | Mostra o nasconde la scheda di anteprima del QR più grande sotto l'intestazione. |
abilitaDownload | Booleano; predefinito falso | Aggiunge un pulsante per scaricare l'immagine QR generata. |
abilitaCopia | Booleano; predefinito falso | Aggiunge 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
| Opzione | Predefinito | Scopo |
Intestazione dell'intestazione | Scansiona questo codice QR per configurare il tuo localizzatore | Intestazione del widget principale. |
descrizione dell'intestazione | Descrizione del download di RP Locator | Testo di supporto sotto il titolo. |
Istruzioni di intestazione | Istruzioni per il download e la scansione | Istruzioni mostrate sopra i badge delle app e il codice QR. |
intestazioneGenerataEtichettaQr | Codice QR generato | Etichetta sotto il codice QR dell'intestazione generata. |
headerQrAlt | Codice QR per scaricare l'app | Testo alternativo per l'immagine dell'intestazione iniziale. |
immagineQrIntestazione | URL dell'immagine predefinita di RP | Immagine di intestazione di riserva quando non è personalizzata logo è fornito. |
Titolo del modulo | Generatore di Codici QR | Intestazione sopra il modulo modificabile. |
sottotitolo del modulo | Crea un codice QR personalizzato per la tua configurazione del localizzatore. | Testo di supporto sopra i campi del modulo. |
Anteprima titolo | Anteprima QR generata | Intestazione sopra l'anteprima del grande codice QR. |
Opzioni dell'App Store
| Opzione | Predefinito | Scopo |
linkPerDownloadIos | Vuoto | Destinazione di override preferita per il badge dell'Apple App Store. |
collegamentoDownloadGooglePlay | Vuoto | Override preferito per la destinazione del badge di Google Play. |
linkdellappStore | Scheda dell'App Store di RP Locator | Destinazione predefinita del badge Apple quando linkPerDownloadIos è vuoto. |
link al Play Store | Scheda Google Play di RP Locator | Destinazione badge Android predefinita quando collegamentoDownloadGooglePlay è vuoto. |
distintivo dell'App Store | URL dell'immagine del badge dell'App Store per RP | Sostituisce l'immagine del badge Apple visualizzata. |
badge di Google Play | URL dell'immagine del badge di Google Play | Sostituisce 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.
| Attributo | Opzione equivalente / Scopo |
data-qr-title | Intestazione dell'intestazione |
data-qr-autofill | compilazione automatica; usa "vero" o "falso" |
data-qr-mode | modalità; riservato a "pieno" o "compatto" |
data-qr-theme | tema |
data-qr-color | colore |
data-qr-download | abilitaDownload; usa "vero" attivare |
data-qr-copy | abilitaCopia; usa "vero" attivare |
logo-qr-dati | logo |
data-qr-show-header | mostraIntestazione |
data-qr-show-form | mostraModulo |
data-qr-show-display | mostraAnteprimaQR |
data-qr-parent | Attributo del tag script contenente un selettore CSS per il genitore del mount di fallback automatico. |
data-qr-position | Utilizzo 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"
});