---
title: Filial-/Beraterbilder und Reihenfolge — isla Studio
url: https://isla-stud.io/docs/wp2amparex/filial-und-beraterbilder/
date: 2026-05-30
---

# Filial-/Beraterbilder und Reihenfolge

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** klicken.
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](https://isla-stud.io/docs/wp2amparex/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
-------------------