> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# CEA- (Verbinden externer Konten)

> Die Tags für verbundene externe Konten: dem Käufer zeigen, welche Social-Logins mit seinem Kundenkonto verknüpft sind, und ihm erlauben, eine Verknüpfung wieder zu lösen.

Wer sich im Shop über ein externes Konto anmeldet, verknüpft damit dieses Konto mit seinem Kundenkonto. Dieselbe Person kann mehrere solcher Verknüpfungen haben.

Die Tags mit dem Präfix `CEA-` machen diese Verknüpfungen sichtbar und lösbar. Sie verteilen sich auf zwei Templates: die Kundenkontoübersicht mit dem Einstieg und die Übersichtsseite der verbundenen Konten mit der eigentlichen Liste.

Wegweiser: Externes Login

## Zwei Voraussetzungen

> [!WARNING]
>
> Alle Tags dieser Gruppe sind nur für einen angemeldeten Käufer verfügbar. Ohne Anmeldung sind sie ungültig und liefern nichts, auch nicht als negatives Bereichs-Tag.
>
> `CEA-Data` läuft zusätzlich nur über eine verschlüsselte Verbindung. Auf einer Seite ohne HTTPS ist das Tag ungültig, und die Liste bleibt leer. Alle Links, die diese Gruppe erzeugt, sind vollständige HTTPS-Adressen.

## Der Einstieg im Kundenkonto

Auf der Kundenkontoübersichtsseite (`ws_user_account.htm`) steht nur der Hinweis, dass es Verknüpfungen gibt, samt Link auf die Liste.

### CEA-Overview

Greift, wenn mindestens ein externes Konto verbunden ist.

### CEA-OverviewLink

Liefert die Adresse der Übersichtsseite. Ein reines Einzel-Tag.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CEA-Overview}
   <a href="~CEA-OverviewLink~">Verbundene Konten ansehen</a>
{/CEA-Overview}

{!CEA-Overview}
   Es ist kein externes Konto mit Ihrem Kundenkonto verbunden.
{/!CEA-Overview}
```

Der negative Bereich lohnt sich. Ein Käufer, der sich nur mit E-Mail-Adresse und Passwort anmeldet, soll nicht auf eine leere Seite geschickt werden.

## Die Übersicht der verbundenen Konten

Die Liste steht auf einem eigenen Template (`ws_connected_externaccounts.htm`).

### CEA-Data

Das zentrale Tag, in drei Rollen.

| Verwendung | Ergebnis |
| - | - |
| Einzel-Tag | die Anzahl der verbundenen Konten |
| Bereichs-Tag | greift, wenn mindestens eines verbunden ist |
| Schleifen-Tag | läuft über die verbundenen Konten |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CEA-Data}
   Mit Ihrem Kundenkonto sind ~CEA-Data~ externe Konten verbunden.

   <table>
      {@CEA-Data}
         <tr>
            <td>~CEA-LoginType~</td>
            <td>{CEA-AdditionalInfo}~CEA-AdditionalInfo~{/CEA-AdditionalInfo}</td>
            <td><a href="~CEA-DeleteLink~">Verbindung lösen</a></td>
         </tr>
      {/@CEA-Data}
   </table>
{/CEA-Data}

{!CEA-Data}
   Es ist kein externes Konto mit Ihrem Kundenkonto verbunden.
{/!CEA-Data}
```

### Die Angaben je Verknüpfung

| Tag | Liefert |
| - | - |
| `CEA-LoginType()` | die Art des externen Kontos |
| `CEA-AdditionalInfo` | die E-Mail-Adresse, mit der das externe Konto eingerichtet wurde |
| `CEA-ID` | den eindeutigen Bezeichner der Verknüpfung |

> [!WARNING]
>
> Diese drei Tags gelten nur innerhalb der Schleife `{@CEA-Data}`. Außerhalb sind sie ungültig, weil ihnen der Bezug zur einzelnen Verknüpfung fehlt.

`CEA-AdditionalInfo` kann leer sein. Wer sein externes Konto mit einer Telefonnummer statt einer E-Mail-Adresse eingerichtet hat, liefert hier nichts. Klammern Sie das Feld deshalb, statt eine leere Tabellenzelle stehen zu lassen.

`CEA-ID` ist für den Käufer ohne Bedeutung und gehört nicht in die Anzeige. Nützlich ist die Kennung als Haken für CSS und JavaScript, beispielsweise um eine Zeile gezielt anzusprechen.

### Nach der Art des Kontos unterscheiden

`CEA-LoginType()` nimmt als Parameter eine Kontoart entgegen und wird damit zum Bereichs-Tag: Der Bereich greift, wenn die Verknüpfung von dieser Art ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@CEA-Data}
   {CEA-LoginType(facebook)}
      <img src="images/web/facebook.png" alt="Facebook">
   {/CEA-LoginType(facebook)}

   {!CEA-LoginType(facebook)}
      ~CEA-LoginType~
   {/!CEA-LoginType(facebook)}
{/@CEA-Data}
```

Ohne Parameter gibt das Tag die Art als Text aus. Mit Parameter vergleicht es und gibt selbst nichts aus. So lässt sich je Anbieter ein eigenes Logo setzen, ohne die Namen aus der Datenbank direkt anzuzeigen.

> [!WARNING]
>
> Der Shop vergleicht den Parameter mit der gespeicherten Kontoart, und es gibt weitere Anbieter für das externe Login. Welche Werte in Ihrem Shop vorkommen, klären Sie mit Ihrem WEBSALE-Ansprechpartner, bevor Sie darauf abfragen.

## Eine Verbindung lösen

### CEA-DeleteLink

Liefert die Adresse, über die der Käufer die Verknüpfung löst. Ein reines Einzel-Tag und nur innerhalb der Schleife gültig.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@CEA-Data}
   ~CEA-LoginType~
   <a href="~CEA-DeleteLink~">Verbindung lösen</a>
{/@CEA-Data}
```

> [!WARNING]
>
> Der Link löst die Verbindung ohne Rückfrage. Bauen Sie die Rückfrage selbst, entweder als eigene Seite oder per JavaScript, sonst kostet ein Fehlklick dem Käufer seinen Anmeldeweg.

Die Adresse enthält einen verschlüsselten Parameter, in dem Kontoart und Kennung stecken. Sie lässt sich nicht von Hand zusammenbauen, und ein veränderter Link wird abgewiesen. Verwenden Sie deshalb immer das Tag.

### Die Rückmeldung

Nach dem Lösen kehrt der Käufer auf die Übersichtsseite zurück. Zwei Bereiche melden dort das Ergebnis.

| Tag | Greift |
| - | - |
| `CEA-Delete_success` | wenn die Verknüpfung gelöst wurde |
| `CEA-Delete_error` | wenn dabei ein Fehler auftrat |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CEA-Delete_success}
   <p class="hinweis">Die Verbindung wurde gelöst.</p>
{/CEA-Delete_success}

{CEA-Delete_error}
   <p class="fehler">Die Verbindung konnte nicht gelöst werden.</p>
{/CEA-Delete_error}
```

Beide Bereiche gehören über die Liste und nicht darunter. Der Käufer soll die Rückmeldung sehen, bevor er die veränderte Liste liest.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `CEA-Overview` | – | ja | ja | – |
| `CEA-OverviewLink` | ja | – | – | – |
| `CEA-Data` | ja | ja | ja | ja |
| `CEA-LoginType()` | ja | ja | ja | – |
| `CEA-AdditionalInfo` | ja | ja | ja | – |
| `CEA-ID` | ja | ja | ja | – |
| `CEA-DeleteLink` | ja | – | – | – |
| `CEA-Delete_success` | – | ja | ja | – |
| `CEA-Delete_error` | – | ja | ja | – |

### Wo die Tags hingehören

| Tag | Template |
| - | - |
| `CEA-Overview`, `CEA-OverviewLink` | Kundenkontoübersichtsseite (`ws_user_account.htm`) |
| `CEA-Data`, `CEA-Delete_success`, `CEA-Delete_error` | Übersicht der verbundenen externen Konten (`ws_connected_externaccounts.htm`) |
| `CEA-LoginType()`, `CEA-AdditionalInfo`, `CEA-ID`, `CEA-DeleteLink` | Übersicht der verbundenen externen Konten, innerhalb der Schleife `{@CEA-Data}` |

## Verwandte Themen

* Wegweiser: Externes Login
* Wegweiser: [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
* Referenz: [Schaltflächen für Kundenkonto und Anmeldung](https://dokumentation.websale.de/v8s/referenz/tags/bt/kundenkonto-und-anmeldung.md)
* Wegweiser: [Kundenkonto](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/kundenkonto.md)


## Related topics

- [Kunde, Anmeldung und Kundenkonto](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/kunde-anmeldung-und-kundenkonto.md)
- [Anmeldung und Registrierung](https://dokumentation.websale.de/v8s/kundenkonto/anmeldung-registrierung.md)
- [Externer Download](https://dokumentation.websale.de/v8s/schnittstellen/produkte-und-kategorien/externer-download.md)
- [FORM- (Formulare)](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare.md)
- [Session-Verwaltung](https://dokumentation.websale.de/v8s/einstellungen/session-verwaltung.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.