Rose Perl Technologie Logo

Rose Perl Technologie

RP-Locator-Einrichtungsanleitung

Fügen Sie das RP-Locator-Widget in Ihren bestehenden Store Locator oder Ihre Website ein, helfen Sie Kunden bei der Installation der mobilen App und lassen Sie sie Ihren Store oder Produkt-Locator mit einem schnellen Scan speichern.

Fügen Sie Ihren Standort hinzu Laden Sie die App herunter Zum Einrichten scannen Alle Optionen

In 3 einfachen Schritten loslegen

Bieten Sie Ihren Kunden einen einfachen Weg von Ihrer Website zu einem gespeicherten Standort in der RP Locator App.

1. Widget hinzufügen und anpassen

Fügen Sie das Widget zu Ihrer bestehenden Store-Locator-Seite oder Website hinzu. Legen Sie Ihre Website- oder Locator-URL, den Locator-Namen (wie Ihren Store-Namen), eine benutzerdefinierte Nachricht über Ihr Geschäft und fest, ob es sich um einen Store- oder Produkt-Locator handelt. Sie können auch Ihr Logo hinzufügen und das Widget an Ihr Farbschema anpassen.

<!-- 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. Scannen Sie den QR-Code

Sobald die App installiert ist, scannen Sie den QR-Code des Widgets, um den neuen Locator einzurichten und in der App zu speichern. Der Locator steht Ihnen dann jederzeit zur Verfügung, wenn Sie Filialen in der Nähe oder Lieblingsprodukte finden möchten.

Erstellen Sie eine nützlichere Locator-Sammlung

Öffnen Sie den RP Locator und gehen Sie zu Ihren gespeicherten Locators, wann immer Sie sie brauchen. Je mehr Store- und Product-Locators Sie hinzufügen, desto nützlicher wird Ihre persönliche Locator-Sammlung.

Produktionskonfigurationsbeispiele

Diese Live-Beispiele verwenden Optionen, die vom Produktions-Widget unterstützt werden.

Kundenorientiertes gebrandetes Widget

Ein elegantes Widget für Ihre Filial- oder Produktsuchseite, in Ihrem Branding und mit einem QR-Code, den Kunden sofort scannen können.

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

Interaktives Formular + Vorschau

Verwenden Sie diese Version, wenn Mitarbeiter oder Kunden Standortdetails eingeben und den generierten QR-Code herunterladen oder kopieren können sollen.

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

Automatische Initialisierung mit Daten-Attributen

Verwenden Sie Datenattribute für Anzeige- und Styling-Einstellungen, wenn Sie eineMarkup-basierte Initialisierung bevorzugen.

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

Passen Sie Ihre App-Download-Links an

Die Standardeinstellungen für die Produktion verweisen auf RP Locator im Apple App Store und bei Google Play. Sie können RP Locator auch als Ihre eigene gebrandete App anpassen, in den App-Stores veröffentlichen und diese Links aktualisieren, um Kunden direkt zu Ihrer gebrandeten App zu leiten. Erfahren Sie mehr über Erstellen einer benutzerdefinierten App mit 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"
});

Alle Widget-Optionen

Geben Sie diese Optionen weiter an QrWidget.init({...}). Nur Ziel identifiziert, wo das Widget platziert ist; alle anderen Optionen passen seinen Inhalt, sein Verhalten oder sein Erscheinungsbild an.

Ortungs- und Montageoptionen

OptionWerte / StandardZweck
ZielCSS-Selektor oder Element; Standard nullElement, das das Widget enthalten wird. Verwenden Sie für jede Instanz ein einziges eindeutiges Ziel.
WebsiteURL-Zeichenfolge; Standardwert leerIhr Store Locator, Produkt Locator oder Ihre Website-URL. Der generierte QR-Code öffnet diese URL.
NameText; Standard leerName des Standorts, wie z. B. ein Filialname oder Name des Produktsuchers.
benutzerdefiniertText; Standard leerBenutzerdefinierter Wert oder kundenorientierte Nachricht, die mit dem Locator gespeichert wurde.
App"Geschäft" oder "Produkt"; wird bei Weglassen abgeleitetLegt den Suchhaustyp fest. Unbekannte oder fehlende Werte greifen auf die URL-Erkennung und anschließend auf den Store zurück.
AutofillBoolesch; Standardwert wahrLiest unterstützte Seiten-URL-Parameter und generiert den QR-Code automatisch, sobald alle erforderlichen Werte verfügbar sind.

Layout- und Anzeigeeinstellungen

OptionWerte / StandardZweck
Thema"Licht", "dunkel", oder "Marke"; Standardwert "Licht"Wählt das Farbschema des Widgets aus.
FarbeCSS-Farbe; Standard #A4118DLegt die Akzentfarbe fest, die von Steuerelementen und Hervorhebungen verwendet wird.
LogoBild-URL; Standard-RP-BildZeigt Ihr Logo im Kopfbereich an. Wenn angegeben, wird es auch zur Quelle des Header-Bildes.
Logo-BeschriftungStandard "Scannen zum Einrichten"Unter dem Logo angezeigte Beschriftung.
Header anzeigenBoolesch; Standardwert wahrBlendet den gesamten Kopfbereich ein oder aus.
Formular anzeigenBoolesch; Standardwert falschZeigt das bearbeitbare Suchformular an oder blendet es aus.
QR-Vorschau anzeigenBoolesch; Standardwert falschZeigt die größere QR-Vorschaukarte unter der Kopfzeile an oder blendet sie aus.
Download aktivierenBoolesch; Standardwert falschFügt eine Schaltfläche zum Herunterladen des generierten QR-Bildes hinzu.
Kopieren erlaubenBoolesch; Standardwert falschFügt eine Schaltfläche zum Kopieren der generierten Locator-URL hinzu.
Modus"voll" oder "kompakt"; Standardwert "voll"Reservierte Layout-Einstellung. Der aktuelle Produktions-Renderer wendet keinen visuellen Modusunterschied an.

Optionen für Kopfzeilen- und Formulartext

OptionStandardZweck
KopfzeilenüberschriftScannen Sie diesen QR-Code, um Ihren Ortungsgerät einzurichtenHaupt-Widget-Überschrift.
Header-BeschreibungRP Locator Download-BeschreibungBegleittext unter der Überschrift.
KopfzeilenAnweisungenDownload-und-Scan-AnleitungAnweisungen über den App-Badges und dem QR-Code.
headerGeneratedQrLabelGenerierter QR-CodeBeschriftung unter dem generierten Header-QR-Code.
QR-Code Kopfzeile AltQR-Code zum Herunterladen der AppAlternativtext für das anfängliche Header-Bild.
Header-QR-BildStandard-Bild-URL für RPFallback-Headerbild, wenn kein benutzerdefiniertes vorhanden ist Logo wird geliefert.
FormulartitelQR-Code-GeneratorÜberschrift über dem bearbeitbaren Formular.
FormulartitelErstellen Sie einen benutzerdefinierten QR-Code für Ihr Locator-Setup.Begleittext über den Formularen.
Vorschau-TitelGenerierte QR-VorschauÜberschrift über der großen QR-Vorschau.

App-Store-Optionen

OptionStandardZweck
iosDownloadLinkLeerBevorzugte Überschreibung für das Ziel des Apple App Store-Badges.
Google-Play-Download-LinkLeerBevorzugte Überschreibung für das Ziel des Google Play-Badges.
App-Store-LinkRP Locator App-Store-EintragStandard-Ziel für Apple-Badges, wenn iosDownloadLink ist leer.
PlayStoreLinkGoogle Play-Eintrag für den RP LocatorStandard-Android-Badge-Ziel, wenn Google-Play-Download-Link ist leer.
App Store-BadgeRP App Store Badge Bild-URLErsetzt das angezeigte Apple-Badge-Bild.
Play Store-BadgeRP Google Play-Badge-Bild-URLErsetzt das angezeigte Google Play-Badge-Bild.

HTML-Datenattribute

Verwende die Anzeigeattribute für ein Element mit data-qr-widget für die Markup-basierte automatische Initialisierung. Die Attribute „parent“ und „position“ gehören in das Skript-Tag des Widgets.

AttributÄquivalente Option / Zweck
data-qr-titleKopfzeilenüberschrift
data-qr-autofillAutofill; benutzen "wahr" oder "falsch"
data-qr-modeModus; reserviert für "voll" oder "kompakt"
data-qr-themeThema
data-qr-colorFarbe
data-qr-downloadDownload aktivieren; benutzen "wahr" aktivieren
data-qr-copyKopieren erlauben; benutzen "wahr" aktivieren
data-qr-logoLogo
data-qr-show-headerHeader anzeigen
data-qr-show-formFormular anzeigen
data-qr-show-displayQR-Vorschau anzeigen
data-qr-parentSkript-Tag-Attribut, das einen CSS-Selektor für das Elternelement des automatischen Fallback-Mounts enthält.
data-qr-positionVerwendung von Script-Tag-Attributen anhängen, voranstellen, vor, oder nach Platzierung für die Ersatzhalterung.

URL-Autofill-Parameter

Mit Automatisches Ausfüllen: aktiv, die Seitenabfrageparameter Website, Name, benutzerdefiniert, und App kann Locator-Werte liefern. Explizite JavaScript-Werte haben Vorrang. Verwenden App=Store oder App = Produkt.

Vollständiges JavaScript-Beispiel

QrWidget.init({
  target: "#my-qr-widget",
  website: "https://your-site.com/store-locator",
  name: "Name Ihres Geschäfts",
  custom: "Finden Sie unsere Produkte in Ihrer Nähe",
  app: "Store",
  autofill: true,
  theme: "brand",
  color: "#A4118D",
  logo: "https://your-site.com/your-logo.png",
  logoLabel: "Ihr Markenname",
  headerHeading: "Fügen Sie unseren Shop zum RP-Standortsucher hinzu",
  headerDescription: "Halten Sie unseren Standortsucher auf Ihrem Smartphone bereit.",
  headerInstructions: "Installieren Sie die App und scannen Sie dann diesen QR-Code.",
  headerGeneratedQrLabel: "Scannen, um diesen Locator hinzuzufügen",
  showHeader: true,
  showForm: false,
  showQRPreview: false,
  enableDownload: false,
  enableCopy: false,
  iosDownloadLink: "https://apps.apple.com/us/app/rp-locator/id6770829229",
  googlePlayDownloadLink: "https://play.google.com/store/apps/details?id=com.roseperl"
});