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>
2. Téléchargez l'application RP Locator
Sur votre téléphone ou appareil mobile, cliquez sur le lien App Store ou Google Play affiché dans le widget, puis installez l'application RP Locator.
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
| Option | Valeurs / défaut | But |
cible | Sélecteur CSS ou élément ; par défaut nul | Élément qui contiendra le widget. Utilisez une cible unique pour chaque instance. |
site web | Chaîne URL ; vide par défaut | L'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. |
nom | Texte ; vide par défaut | Nom du localisateur, tel qu'un nom de magasin ou un nom de recherche de produits. |
sur mesure | Texte ; vide par défaut | Valeur personnalisée ou message destiné au client enregistré avec le localisateur. |
application | "Magasin" ou "Produit"; déduit lorsqu'omis | Définit le type de localisateur. Les valeurs inconnues ou manquantes reviennent à la détection d'URL, puis à Store. |
remplissage automatique | Booléen ; par défaut vrai | Lit 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
| Option | Valeurs / défaut | But |
thème | "lumière", "sombre", ou "marque"; par défaut "lumière" | Sélectionne la palette de couleurs du widget. |
couleur | Couleur CSS ; par défaut #A4118D | Définit la couleur d'accentuation utilisée par les contrôles et les surbrillances. |
logo | URL de l'image ; image RP par défaut | Affiche 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 logo | Texte par défaut "Scanner pour configurer" | Libellé affiché sous le logo. |
afficherEn-tête | Booléen ; par défaut vrai | Affiche ou masque la zone d'en-tête complète. |
afficherFormulaire | Booléen ; par défaut faux | Affiche ou masque le formulaire de localisation modifiable. |
afficherAperçuQR | Booléen ; par défaut faux | Affiche ou masque la grande carte d'aperçu du QR code sous l'en-tête. |
activerLeTéléchargement | Booléen ; par défaut faux | Ajoute un bouton pour télécharger l'image QR générée. |
activerLaCopie | Booléen ; par défaut faux | Ajoute 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
| Option | Par défaut | But |
En-tête de section | Scannez ce code QR pour configurer votre balise | Titre du widget principal. |
Description de l'en-tête | Description du téléchargement de RP Locator | Texte d'accompagnement sous le titre. |
instructionsD'en-tête | Instructions de téléchargement et d'analyse | Instructions affichées au-dessus des badges de l'application et du code QR. |
en-têteÉtiquetteQrGénérée | Code QR généré | Étiquette sous le code QR d'en-tête généré. |
en-têteQrAlt | Code QR pour télécharger l'application | Texte alternatif pour l'image d'en-tête initiale. |
imageQrEnTete | URL de l'image par défaut du RP | Image d'en-tête de repli lorsqu'il n'y en a pas de personnalisée logo est fourni. |
Titre du formulaire | Générateur de code QR | En-tête au-dessus du formulaire modifiable. |
Sous-titre du formulaire | Créez un code QR personnalisé pour votre configuration de localisateur. | Texte d'accompagnement au-dessus des champs du formulaire. |
Titre de l'aperçu | Aperçu du QR généré | En-tête au-dessus du grand aperçu du QR code. |
Options de l'App Store
| Option | Par défaut | But |
lienTéléchargementIos | Vide | Remplacement privilégié pour la destination du badge Apple App Store. |
lienDeTelechargementGooglePlay | Vide | Remplacement privilégié pour la destination du badge Google Play. |
lienVersAppStore | Fiche de l'App Store de RP Locator | Destination par défaut du badge Apple lorsque lienTéléchargementIos est vide. |
lienPlayStore | Fiche Google Play de RP Locator | Destination de badge Android par défaut lorsque lienDeTelechargementGooglePlay est vide. |
badge App Store | URL de l'image du badge App Store RP | Remplace l'image du badge Apple affichée. |
Badge Google Play | URL de l'image du badge Google Play | Remplace 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.
| Attribuer | Option équivalente / finalité |
data-qr-title | En-tête de section |
data-qr-autofill | remplissage automatique; utiliser "vrai" ou "faux" |
data-qr-mode | mode; réservé à "plein" ou "compact" |
data-qr-theme | thème |
data-qr-color | couleur |
data-qr-download | activerLeTéléchargement; utiliser "vrai" activer |
data-qr-copy | activerLaCopie; utiliser "vrai" activer |
data-qr-logo | logo |
data-qr-show-header | afficherEn-tête |
data-qr-show-form | afficherFormulaire |
data-qr-show-display | afficherAperçuQR |
data-qr-parent | Attribut de balise script contenant un sélecteur CSS pour le parent du montage de repli automatique. |
data-qr-position | Utilisation 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"
});