Apps
Apps im Backend
In Apps werden optionale Shop-Funktionen nach Bereichen angezeigt, aktiviert, deaktiviert, gebucht oder einmalig getestet.
Aufbau der App-Verwaltung
Die App-Verwaltung ist nur sichtbar, wenn das Backend-Recht fuer die Modulverwaltung vorhanden ist. Die Seite erzeugt oben eine Bereichsnavigation aus den Modulgruppen und zeigt darunter die Apps des gewaehlten Bereichs als Kartenraster.
- Administration: Apps fuer Backend-Funktionen, Benutzer, Unterseiten oder Schnittstellen.
- Produkte: Apps fuer Produktdaten, Varianten, Merkmale, Staffelpreise und produktbezogene Erweiterungen.
- Im- und Export: Apps fuer Produkt-, Kunden- oder Bestelldatenexporte und Importe.
- Marketing: Apps fuer Aktionen, Bewertungen, Gratisprodukte und verwandte Verkaufsfunktionen.
- Marktplaetze: Apps fuer Marktplatz- und Kanal-Anbindungen.
- Rechtssicherheit: Apps fuer Rechtstexte, Siegel und Alterspruefung.
- SEO, Versand, Zahlung und Warenwirtschaft: Apps fuer technische Erweiterungen in diesen Funktionsbereichen.
Einige technisch vorhandene Apps sind bewusst ausgeblendet. Diese IDs stehen in der Nicht-Anzeigen-Liste und erscheinen nicht als Karte, obwohl das Modul intern vorhanden sein kann.
App-Karten lesen
Die Apps werden nicht als Tabelle angezeigt, sondern als responsives Kartenraster. Deshalb gibt es kein Spalten-Setup und kein Tabellen-Snippet.
| Kartenteil | Quelle | Bedeutung |
|---|---|---|
| Name | ShopModul::getName | Ueberschrift der App-Karte. |
| Beschreibung | ShopModul::getBeschreibung | Beschreibt, welche Funktion die App freischaltet. |
| Bild | ShopModul::getImg | Optionales App-Bild, wenn ein Bildname hinterlegt ist. |
| Statusbereich | showStatus | Wird nach dem Laden der Seite je App per Ajax nachgeladen. |
| Aktionen | setStatus, setTest | Aktivieren, Deaktivieren, Buchen oder Test starten, je nach aktuellem Status. |
Status und Aktionen
Der Statusbereich unterscheidet aktive Apps, inaktive Apps und Testphasen. Nach einer Aktion wird nur die betroffene Karte neu geladen.
- Aktiv: Die App ist eingeschaltet. Die Karte zeigt ein Aktiv-Symbol und bietet Deaktivieren an.
- Inaktiv: Die App ist ausgeschaltet. Die Karte zeigt ein Inaktiv-Symbol und bietet Aktivieren an.
- Buchen: Wird bei inaktiven Apps angezeigt. Ist kein Buchungslink hinterlegt, bleibt der Button deaktiviert.
- 30 Tage testen: Wird angezeigt, wenn die App inaktiv ist und noch keine Testphase verbraucht wurde.
- Testzeitraum aktiv: Die Karte zeigt das errechnete Enddatum der laufenden Testphase.
- Testzeitraum abgelaufen: Die Karte weist darauf hin, dass der einmalige Test bereits genutzt wurde.
Aktivieren und Deaktivieren
Beim Aktivieren sendet die Karte die Modul-ID, den Zielstatus und ein Pruefflag an das Backend. Das Backend fuehrt vor der Aktivierung eine Lizenzpruefung fuer den aktuellen Shop aus.
- Bereich in der Navigation oeffnen.
- In der App-Karte Aktivieren waehlen.
- Das Backend prueft die App-Freigabe fuer den aktuellen Shop.
- Bei erfolgreicher Pruefung wird der Status am App-Datensatz gespeichert.
- Der Statusbereich der Karte wird neu geladen.
Beim Deaktivieren wird der Status auf inaktiv gesetzt. Fachbereiche, die diese App voraussetzen, zeigen danach keine App-Funktionen mehr oder melden die fehlende Aktivierung.
30-Tage-Test
Der Testmodus ist einmalig pro App vorgesehen. Beim Start setzt das Backend die App aktiv, setzt den Testmodus auf laufend und speichert den Startzeitpunkt.
| Testmodus | Bedeutung | Wirkung |
|---|---|---|
0 | Noch nicht getestet. | Der Button 30 Tage testen kann angezeigt werden. |
1 | Testphase laeuft. | Die App ist aktiv und die Karte zeigt das Enddatum. |
2 | Testphase abgelaufen. | Ein erneuter Teststart wird nicht zugelassen. |
3 | Test ausgeschlossen. | Fuer diese App wird kein Testbutton angeboten. |
Eine Hintergrundpruefung laeuft stuendlich und beendet Testphasen nach 30 Tagen automatisch. Dabei wird der Testmodus auf abgelaufen gesetzt und die App deaktiviert.
Installierte und sichtbare Apps
Die App-Liste basiert auf den installierten ShopModul-Datensaetzen. Beim Installieren einer Shop-Version legt der ModulManager fehlende Apps aus der Default-Liste an und setzt Paketstatus, Gruppe, Beschreibung, Bild, Buchungslink und Testmodus.
- Apps ohne installierten Datensatz erscheinen nicht in der Kartenliste.
- Apps aus der Nicht-Anzeigen-Liste bleiben trotz Datensatz unsichtbar.
- Gruppen entstehen aus den Default-Modulgruppen und werden alphabetisch sortiert.
- Viele Fachbereiche pruefen den App-Status, bevor Menuepunkte, Formulare, Aktionen oder Schnittstellen sichtbar werden.
Pruefschritte nach Aenderungen
- Passenden App-Bereich oeffnen.
- Status der gewuenschten App in der Karte pruefen.
- Bei Aktivierung auf Rueckmeldung der Lizenzpruefung achten.
- Nach Aktivierung den betroffenen Fachbereich neu oeffnen.
- Bei Testmodus das angezeigte Enddatum und nach Ablauf die automatische Deaktivierung beachten.