Filial-/Beraterbilder und Reihenfolge

Diese Seite beschreibt die optionale Bildzuordnung und die manuelle
Reihenfolge für Filial- und Beraterkacheln im Buchungs-Wizard.

Status

Die Bildfunktion ist seit 2.3.0 Bestandteil der EDD-Mainline. Die manuelle
Reihenfolge für Filialen und Berater:innen wurde später ergänzt; in der
aktuellen Hauptversion 2.6.1 stehen außerdem Copy/Paste-Deep-Links pro
Filiale im selben Bereich zur Verfügung.

Wenn der Abschnitt Filialen & Berater in Ihrer Installation nicht sichtbar
ist, prüfen Sie zuerst den installierten WP2Amparex-Versionsstand und den
Update-Button unter Lizenz & Updates.

Zweck

WP2Amparex kann in den Filial- und Beraterkacheln eigene Bilder aus der
WordPress-Mediathek anzeigen und die Reihenfolge dieser Kacheln im Frontend
steuern.

Ohne Bildzuordnung bleibt das bisherige Verhalten erhalten: Das Plugin zeigt
das passende FontAwesome-Icon. Die Icons verwenden die im Tab Design
gewählte Akzentfarbe.

Wo wird die Zuordnung gepflegt?

Im WordPress-Backend:

  1. WP2Amparex → Amparex & Terminlogik öffnen.
  2. Zum Abschnitt Filialen & Berater scrollen.
  3. Optional: Einträge mit dem Griffsymbol per Drag & Drop sortieren oder mit
    Hoch / Runter verschieben.
  4. Optional: Bei einer Filiale oder Berater:in auf Bild auswählen Click.
  5. Bild aus der WordPress-Mediathek wählen.
  6. Einstellungen speichern.

Pro Eintrag zeigt das Plugin:

  • Name aus Amparex
  • bei Filialen die Adresse
  • bei Berater:innen die zugehörigen Filialen
  • Amparex-ID zur Wiedererkennung
  • Bildvorschau oder Icon-Fallback
  • Griffsymbol und Buttons für die Reihenfolge
  • Buttons zum Ändern oder Entfernen

Reihenfolge im Frontend

Die Reihenfolge wird getrennt für Filialen und Berater:innen gespeichert.

  • Die Filialreihenfolge steuert die Standortauswahl im ersten
    Buchungsschritt.
  • Die Beraterreihenfolge steuert die sichtbare Beraterauswahl, wenn
    Besucher:innen einen Wunschberater auswählen.
  • Neue Einträge aus Amparex, für die noch keine gespeicherte Position
    existiert, werden hinter den bereits sortierten Einträgen angezeigt.

Die Reihenfolge wird erst gespeichert, wenn ein Eintrag tatsächlich verschoben
wurde. Ein normales Speichern der Einstellungen überschreibt die vorhandene
Reihenfolge nicht unnötig.

Bilddarstellung

Im Adminbereich

Wenn kein Bild gewählt ist, erscheint ein FontAwesome-Icon:

  • Filialen: fas fa-store
  • Berater:innen: fas fa-user

Wenn ein Bild gewählt ist, verwendet die Vorschau eine eigene
WordPress-Zwischengröße:

  • Quelldatei: 200 × 200 px, hart zugeschnitten
  • sichtbare Admin-Vorschau: 96 × 72 px
  • Darstellung: object-fit: cover

Das sorgt dafür, dass die Vorschau auch auf hochauflösenden Displays nicht
unnötig unscharf wirkt.

Im Frontend

Im Buchungs-Wizard ersetzt das gewählte Bild das bisherige Icon in der
jeweiligen Kachel.

Wenn kein Bild gepflegt ist oder ein Bild im Browser nicht geladen werden
kann, zeigt das Plugin automatisch wieder das Standardicon. Die bisherigen
Icons bleiben also als Fallback erhalten.

Verhalten bei Mandanten- oder Zugangsdatenwechsel

Die Bildzuordnung ist an stabile Amparex-Entitäten gebunden:

  • Filialen werden über ihre Amparex-Filial-ID zugeordnet.
  • Berater:innen werden über ihre Amparex-Resource-ID zugeordnet.
  • Die Zuordnung wird zusätzlich pro verbundenem Mandanten getrennt gespeichert.

Der Mandanten-Namespace basiert nicht auf dem technischen Amparex-Benutzernamen.
Wenn ein Mandant neue technische Zugangsdaten oder einen neuen API-Benutzer
erhält, bleiben die Bildzuordnungen deshalb erhalten, solange dasselbe
Amparex-System mit derselben Mandantenkennung verbunden bleibt.

Für die Mandantenkennung nutzt WP2Amparex die stabilste verfügbare Information
aus den Amparex-Filialdaten:

  1. Umsatzsteuer-ID (vatNumber)
  2. Handelsregisterdaten
  3. Steuernummer
  4. Buchungsmandant (bookMandator)
  5. Firmenname (name1)
  6. ID der Hauptfiliale

Wenn ein wirklich anderer Mandant verbunden wird, erscheinen die bisherigen
Bildzuordnungen nicht in diesem Mandanten. Sie werden aber nicht automatisch
gelöscht.

Die übergreifende Verwaltung gespeicherter Amparex-Setups ist unter
Mandantenwechsel und Setups beschrieben.

Wegfallende Filialen oder Berater:innen

Die Adminliste wird aus den aktuell von Amparex gelieferten Filialen und
Ressourcen aufgebaut.

Wenn eine Filiale oder Berater:in nicht mehr in den Amparex-Daten erscheint:

  • Der Eintrag wird im Backend nicht mehr zur Auswahl angezeigt.
  • Im Frontend erscheint keine Kachel und damit auch kein Bild dafür.
  • Die gespeicherte Zuordnung bleibt intern erhalten.
  • Taucht dieselbe Amparex-ID später wieder auf, greifen Bildzuordnung und
    gespeicherte Reihenfolge wieder, soweit sie noch im Setup vorhanden sind.

Sicherheit und Datenquelle

Es werden nur WordPress-Attachment-IDs gespeichert, keine frei eingegebenen
externen Bild-URLs. Beim Speichern prüft WP2Amparex, ob die gewählte Datei ein
Bild aus der WordPress-Mediathek ist.

Technische Referenz