Logo de Rose Perl Technology

Rose Perl Technologie

Guide de configuration du localisateur RP

Ajoutez le widget RP Locator à votre localisateur de magasin ou site web existant, aidez vos clients à installer l'application mobile et permettez-leur d'enregistrer votre localisateur de magasin ou de produit en un seul balayage rapide.

Ajoutez votre localisateur Télécharger l'application Scanner pour configurer Toutes les options

Commencez en 3 étapes faciles

Offrez aux clients un moyen simple d'accéder à un localisateur enregistré dans l'application RP Locator directement depuis votre site web.

1. Ajouter et personnaliser le widget

Ajoutez le widget à votre page de localisation de magasin existante ou à votre site Web. Définissez l'URL de votre site Web ou de votre localisateur, le nom du localisateur (tel que le nom de votre magasin), un message personnalisé concernant votre magasin, et indiquez s'il s'agit d'un localisateur de magasin ou de produit. Vous pouvez également ajouter votre logo et personnaliser le style du widget pour qu'il corresponde à votre thème de couleurs.

<!-- 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. Scannez le code QR

Une fois l'application installée, scannez le code QR du widget pour configurer et enregistrer le nouveau localisateur dans l'application. Le localisateur sera alors prêt chaque fois que vous voudrez trouver des magasins à proximité ou des produits favoris.

Créer une collection de localisateurs plus utile

Ouvrez RP Locator et accédez à vos localisateurs enregistrés chaque fois que vous en avez besoin. Plus vous ajoutez de localisateurs de magasins et de produits, plus votre collection personnelle de localisateurs devient utile.

Exemples de configuration de production

Ces exemples en direct utilisent des options prises en charge par le widget de production.

Widget de marque destiné aux clients

Un widget soigné pour votre page de localisation de magasins ou de produits, à vos couleurs et doté d'un code QR prêt à être scanné par vos clients.

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

Formulaire interactif + Aperçu

Utilisez cette version lorsque le personnel ou les clients doivent pouvoir saisir les détails du localisateur et télécharger ou copier le code QR généré.

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

Initialisation automatique avec des attributs de données

Utilisez des attributs de données pour les paramètres d'affichage et de style lorsque vous préférez une initialisation basée sur le balisage.

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

Personnalisez les liens de téléchargement de votre application

Les paramètres de production par défaut pointent vers RP Locator dans l'App Store d'Apple et Google Play. Vous pouvez également personnaliser RP Locator pour en faire votre propre application aux couleurs de votre marque, la publier dans les boutiques d'applications et mettre à jour ces liens pour envoyer les clients directement vers votre application personnalisée. En savoir plus sur créer une application personnalisée avec 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"
});

Toutes les options de widgets

Transsez ces options à QrWidget.init({...}). Seulement cible identifie où le widget est monté ; toutes les autres options personnalisent son contenu, son comportement ou son apparence.

Options de positionnement et de montage

OptionValeurs / défautBut
cibleSélecteur CSS ou élément ; par défaut nulÉlément qui contiendra le widget. Utilisez une cible unique pour chaque instance.
site webChaîne URL ; vide par défautL'URL de votre localisateur de magasins, de votre localisateur de produits ou de votre site Web. Le code QR généré ouvre cette URL.
nomTexte ; vide par défautNom du localisateur, tel qu'un nom de magasin ou un nom de recherche de produits.
sur mesureTexte ; vide par défautValeur personnalisée ou message destiné au client enregistré avec le localisateur.
application"Magasin" ou "Produit"; déduit lorsqu'omisDéfinit le type de localisateur. Les valeurs inconnues ou manquantes reviennent à la détection d'URL, puis à Store.
remplissage automatiqueBooléen ; par défaut vraiLit les paramètres d'URL de page pris en charge et génère le QR automatiquement lorsque toutes les valeurs requises sont disponibles.

Options de mise en page et d'apparence

OptionValeurs / défautBut
thème"lumière", "sombre", ou "marque"; par défaut "lumière"Sélectionne la palette de couleurs du widget.
couleurCouleur CSS ; par défaut #A4118DDéfinit la couleur d'accentuation utilisée par les contrôles et les surbrillances.
logoURL de l'image ; image RP par défautAffiche votre logo dans l'en-tête. Lorsqu'il est fourni, il devient également la source de l'image d'en-tête.
Étiquette du logoTexte par défaut "Scanner pour configurer"Libellé affiché sous le logo.
afficherEn-têteBooléen ; par défaut vraiAffiche ou masque la zone d'en-tête complète.
afficherFormulaireBooléen ; par défaut fauxAffiche ou masque le formulaire de localisation modifiable.
afficherAperçuQRBooléen ; par défaut fauxAffiche ou masque la grande carte d'aperçu du QR code sous l'en-tête.
activerLeTéléchargementBooléen ; par défaut fauxAjoute un bouton pour télécharger l'image QR générée.
activerLaCopieBooléen ; par défaut fauxAjoute un bouton pour copier l'URL du sélecteur généré.
mode"plein" ou "compact"; par défaut "plein"Paramètre de disposition réservé. Le moteur de rendu de production actuel n'applique pas de différence de mode visuel.

Options de texte pour l'en-tête et le formulaire

OptionPar défautBut
En-tête de sectionScannez ce code QR pour configurer votre baliseTitre du widget principal.
Description de l'en-têteDescription du téléchargement de RP LocatorTexte d'accompagnement sous le titre.
instructionsD'en-têteInstructions de téléchargement et d'analyseInstructions affichées au-dessus des badges de l'application et du code QR.
en-têteÉtiquetteQrGénéréeCode QR généréÉtiquette sous le code QR d'en-tête généré.
en-têteQrAltCode QR pour télécharger l'applicationTexte alternatif pour l'image d'en-tête initiale.
imageQrEnTeteURL de l'image par défaut du RPImage d'en-tête de repli lorsqu'il n'y en a pas de personnalisée logo est fourni.
Titre du formulaireGénérateur de code QREn-tête au-dessus du formulaire modifiable.
Sous-titre du formulaireCréez un code QR personnalisé pour votre configuration de localisateur.Texte d'accompagnement au-dessus des champs du formulaire.
Titre de l'aperçuAperçu du QR généréEn-tête au-dessus du grand aperçu du QR code.

Options de l'App Store

OptionPar défautBut
lienTéléchargementIosVideRemplacement privilégié pour la destination du badge Apple App Store.
lienDeTelechargementGooglePlayVideRemplacement privilégié pour la destination du badge Google Play.
lienVersAppStoreFiche de l'App Store de RP LocatorDestination par défaut du badge Apple lorsque lienTéléchargementIos est vide.
lienPlayStoreFiche Google Play de RP LocatorDestination de badge Android par défaut lorsque lienDeTelechargementGooglePlay est vide.
badge App StoreURL de l'image du badge App Store RPRemplace l'image du badge Apple affichée.
Badge Google PlayURL de l'image du badge Google PlayRemplace l'image du badge Google Play affichée.

attributs de données HTML

Utilisez les attributs d'affichage sur un élément avec data-qr-widget pour l'auto-initialisation basée sur le balisage. Les attributs parent et position doivent figurer sur la balise script du widget.

AttribuerOption équivalente / finalité
data-qr-titleEn-tête de section
data-qr-autofillremplissage automatique; utiliser "vrai" ou "faux"
data-qr-modemode; réservé à "plein" ou "compact"
data-qr-themethème
data-qr-colorcouleur
data-qr-downloadactiverLeTéléchargement; utiliser "vrai" activer
data-qr-copyactiverLaCopie; utiliser "vrai" activer
data-qr-logologo
data-qr-show-headerafficherEn-tête
data-qr-show-formafficherFormulaire
data-qr-show-displayafficherAperçuQR
data-qr-parentAttribut de balise script contenant un sélecteur CSS pour le parent du montage de repli automatique.
data-qr-positionUtilisation d'attributs de balise de script ajouter, ajouter au début, avant, ou après emplacement pour le support de secours.

Paramètres de saisie automatique d'URL

Avec saisie automatique : vrai, les paramètres de requête de la page site web, nom, sur mesure, et application peut fournir des valeurs de localisation. Les valeurs JavaScript explicites ont la priorité. Utiliser app=Boutique ou app=Produit.

Exemple JavaScript complet

QrWidget.init({
  target: "#my-qr-widget",
  website: "https://your-site.com/store-locator",
  name: "Nom de votre magasin",
  custom: "Retrouvez nos produits près de chez vous",
  app: "Store",
  autofill: true,
  theme: "brand",
  color: "#A4118D",
  logo: "https://your-site.com/your-logo.png",
  logoLabel: "Nom de votre marque",
  headerHeading: "Ajoutez notre boutique à RP Locator",
  headerDescription: "Gardez notre localisateur à portée de main sur votre téléphone.",
  instructions-en-tête : " Installez l’application, puis scannez ce code QR. ",
  libellé du QR code généré dans l’en-tête : " Scannez pour ajouter ce localisateur ",
  afficher l’en-tête : true,
  afficher le formulaire : false,
  afficher l’aperçu du QR code : false,
  autoriser le téléchargement : false,
  autoriser la copie : false,
  lien de téléchargement iOS : "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});