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

# E-Search_ (Blättern und Treffer pro Seite)

> Die Blätterfunktion der FACT-Finder-Suchergebnisse aufbauen und den Besucher wählen lassen, wie viele Produkte auf einer Seite stehen.

> [!WARNING]
>
> Die FACT-Finder-Direktanbindung ist veraltet und wird nicht mehr unterstützt. Sie steht nur bis FactFinder-Version 6.9 zur Verfügung und wird von WEBSALE weder gepflegt noch weiterentwickelt. Neue Integrationen laufen ausschließlich über die FactFinder WebComponents. Diese Referenz dient dem Betrieb bestehender Shops.

Zwei Dinge gehören unter jede längere Trefferliste: die Seitennavigation und die Wahl, wie viele Produkte auf einer Seite stehen sollen. Beides liefert FACT-Finder, beides bauen Sie im Template aus Schleifen und Klammerungen zusammen.

Wegweiser: [FACT-Finder im Überblick](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md) · Referenz: E-Search\_ (Grundlagen und Ergebnisliste)

## Die Blätterfunktion

`E-Search_Paging` ist zugleich die Prüfung, ob es überhaupt mehr als eine Seite gibt, und die Schleife über die Seitenzahlen.

| Tag | Liefert |
| - | - |
| `E-Search_Paging` | die Prüfung und die Schleife über die Seiten |
| `E-Search_PagingPosition` | die Seitenzahl des aktuellen Schleifendurchlaufs |
| `E-Search_PagingLink` | den Link auf die jeweilige Seite |
| `E-Search_PagingActive` | greift bei der Seite, auf der der Besucher gerade steht |
| `E-Search_PagingCurrent` | die aktuelle Seitenzahl |
| `E-Search_PagingMax` | die höchste Seitenzahl |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!E-Search_Paging}
   <p>Seite 1 von 1</p>
{/!E-Search_Paging}

{E-Search_Paging}
   <p>Seite ~E-Search_PagingCurrent~ von ~E-Search_PagingMax~</p>

   <nav class="blaettern">
      {@E-Search_Paging}
         {E-Search_PagingActive}
            <strong>~E-Search_PagingPosition~</strong>
         {/E-Search_PagingActive}

         {!E-Search_PagingActive}
            <a href="~E-Search_PagingLink~">~E-Search_PagingPosition~</a>
         {/!E-Search_PagingActive}
      {/@E-Search_Paging}
   </nav>
{/E-Search_Paging}
```

Die aktuelle Seite bekommt keinen Link. Ein Link, der auf die Seite führt, auf der man schon steht, ist für Besucher irreführend und für Suchmaschinen ein unnötiger Selbstverweis.

> [!WARNING]
>
> `E-Search_PagingCurrent` und `E-Search_PagingMax` sind eigenständige Tags und haben mit der Schleife nichts zu tun. `E-Search_PagingPosition` dagegen liefert nur innerhalb der Schleife oder innerhalb einer der vier Sprung-Klammerungen einen sinnvollen Wert.

## Die Sprünge an den Rand

Vier Klammerungen liefern die Links auf die erste, die vorherige, die nächste und die letzte Seite. Sie greifen nur, wenn der Sprung überhaupt möglich ist.

| Tag | Greift, wenn |
| - | - |
| `E-Search_PagingFirst` | die aktuelle Seite nicht die erste ist |
| `E-Search_PagingPrev` | die aktuelle Seite nicht die erste ist |
| `E-Search_PagingNext` | die aktuelle Seite nicht die letzte ist |
| `E-Search_PagingLast` | die aktuelle Seite nicht die letzte ist |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Paging}
   <nav class="blaettern">
      {E-Search_PagingFirst}
         <a href="~E-Search_PagingLink~">Erste</a>
      {/E-Search_PagingFirst}

      {E-Search_PagingPrev}
         <a href="~E-Search_PagingLink~">Zurück</a>
      {/E-Search_PagingPrev}

      {@E-Search_Paging}
         {!E-Search_PagingActive}<a href="~E-Search_PagingLink~">{/!E-Search_PagingActive}
            ~E-Search_PagingPosition~
         {!E-Search_PagingActive}</a>{/!E-Search_PagingActive}
      {/@E-Search_Paging}

      {E-Search_PagingNext}
         <a href="~E-Search_PagingLink~">Weiter</a>
      {/E-Search_PagingNext}

      {E-Search_PagingLast}
         <a href="~E-Search_PagingLink~">Letzte</a>
      {/E-Search_PagingLast}
   </nav>
{/E-Search_Paging}
```

`E-Search_PagingLink` bezieht sich immer auf die Klammerung, in der es steht. Innerhalb von `E-Search_PagingNext` führt es auf die nächste Seite, innerhalb von `E-Search_PagingLast` auf die letzte, innerhalb der Schleife auf die gerade durchlaufene.

Die Schreibweise im mittleren Block, bei der nur das öffnende und das schließende `a`-Element geklammert werden, hält den Seitentext an einer Stelle. Das erspart es, die Zahl zweimal zu schreiben.

> [!WARNING]
>
> `E-Search_PagingFirst` und `E-Search_PagingPrev` greifen unter derselben Bedingung, ebenso `E-Search_PagingNext` und `E-Search_PagingLast`. Auf Seite 2 von 10 erscheinen "Erste" und "Zurück" also beide, obwohl sie dorthin führen. Blenden Sie bei kurzen Listen einen der beiden aus.

## Treffer pro Seite

Welche Anzahlen zur Wahl stehen, legt das FACT-Finder Management fest.

| Tag | Liefert |
| - | - |
| `E-Search_ResultPerPage_SelectName` | den Feldnamen der Auswahlliste |
| `E-Search_ResultPerPage_Option` | die Schleife über die Anzahlen, als Einzel-Tag die jeweilige Zahl |
| `E-Search_ResultPerPage_Active` | greift bei der gerade gewählten Anzahl |
| `E-Search_ResultPerPage_Link` | den Link, der diese Anzahl setzt |
| `E-Search_ResultPerPage_Params` | nur die Link-Parameter für eine SEO-Adresse |

Als Auswahlliste:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<label>
   Produkte je Seite
   <select name="~E-Search_ResultPerPage_SelectName~" onchange="this.form.submit()">
      {@E-Search_ResultPerPage_Option}
         <option value="~E-Search_ResultPerPage_Option~"
                 {E-Search_ResultPerPage_Active}selected{/E-Search_ResultPerPage_Active}>
            ~E-Search_ResultPerPage_Option~
         </option>
      {/@E-Search_ResultPerPage_Option}
   </select>
</label>
```

Als Linkliste:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<p class="treffer_pro_seite">
   Produkte je Seite:
   {@E-Search_ResultPerPage_Option}
      <a href="~E-Search_ResultPerPage_Link~"
         class="{E-Search_ResultPerPage_Active}aktiv{/E-Search_ResultPerPage_Active}">
         ~E-Search_ResultPerPage_Option~
      </a>
   {/@E-Search_ResultPerPage_Option}
</p>
```

`E-Search_ResultPerPage_Option` ist Schleife und Wert in einem. Innerhalb der Schleife gibt das Einzel-Tag die Anzahl des aktuellen Durchlaufs aus, die deshalb sowohl im `value` als auch als Beschriftung stehen kann.

> [!WARNING]
>
> Die Linkvariante braucht kein Formular und funktioniert deshalb auch ohne JavaScript. Die Auswahlliste mit `onchange` braucht für diesen Fall einen Absendeknopf daneben.

## Links für SEO-Adressen

Zu `E-Search_PagingLink` und `E-Search_ResultPerPage_Link` gibt es je eine Params-Variante, die nur die Parameter liefert.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Paging}
   {@E-Search_Paging}
      {E-Search_PagingActive}
         <strong>~E-Search_PagingPosition~</strong>
      {/E-Search_PagingActive}

      {!E-Search_PagingActive}
         ~DC-FPFactFinderLink_reset~
         ~DC-FPFactFinderLink_set($CAT-Link$)~

         {E-Search_PagingParams}
            {DC-FPFactFinderLink_contains(?)}
               ~DC-FPFactFinderLink_append(&)~
            {/DC-FPFactFinderLink_contains(?)}
            {!DC-FPFactFinderLink_contains(?)}
               ~DC-FPFactFinderLink_append(?)~
            {/!DC-FPFactFinderLink_contains(?)}
         {/E-Search_PagingParams}

         ~WS-DisableXSSProtectionOnce~
         <a href="~DC-FPFactFinderLink~~E-Search_PagingParams~">
            ~E-Search_PagingPosition~
         </a>
      {/!E-Search_PagingActive}
   {/@E-Search_Paging}
{/E-Search_Paging}
```

> [!WARNING]
>
> Der Aufruf von `DC-FPFactFinderLink_reset` muss innerhalb der Schleife stehen, nicht davor. Sonst hängt jeder Durchlauf seine Parameter an die Adresse des vorherigen an.

Wegweiser: SEO-Erweiterung von Links · Referenz: [DC- (Parameter)](https://dokumentation.websale.de/v8s/referenz/tags/dc/cookie-daten.md)

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-Search_Paging` | – | ja | ja | ja |
| `E-Search_PagingPosition` | ja | – | – | – |
| `E-Search_PagingLink` | ja | – | – | – |
| `E-Search_PagingParams` | ja | ja | ja | – |
| `E-Search_PagingActive` | – | ja | ja | – |
| `E-Search_PagingCurrent` | ja | – | – | – |
| `E-Search_PagingMax` | ja | – | – | – |
| `E-Search_PagingFirst` | – | ja | ja | – |
| `E-Search_PagingPrev` | – | ja | ja | – |
| `E-Search_PagingNext` | – | ja | ja | – |
| `E-Search_PagingLast` | – | ja | ja | – |
| `E-Search_ResultPerPage_Option` | ja | – | – | ja |
| `E-Search_ResultPerPage_SelectName` | ja | – | – | – |
| `E-Search_ResultPerPage_Active` | – | ja | ja | – |
| `E-Search_ResultPerPage_Link` | ja | – | – | – |
| `E-Search_ResultPerPage_Params` | ja | ja | ja | – |

Alle Tags dieser Seite gelten im Suchtemplate und im Kampagnen-Template. `E-Search_PagingPosition`, `E-Search_PagingLink` und `E-Search_PagingParams` nur innerhalb der `E-Search_Paging`-Schleife oder einer der vier Sprung-Klammerungen, die Treffer-pro-Seite-Tags nur innerhalb der `E-Search_ResultPerPage_Option`-Schleife.

## Verwandte Themen

* Wegweiser: FACT-Finder im Überblick
* Referenz: [E-Search\_ (Grundlagen und Ergebnisliste)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/grundlagen-und-ergebnisliste.md)
* Referenz: [E-Search\_ (Filter)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/filter.md)
* Referenz: [E-Search\_ (Sortierung)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/sortierung.md)


## Related topics

- [E-Search_ (Filter)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/filter.md)
- [E-Search_ (Sortierung)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/sortierung.md)
- [E-Search_ (Grundlagen und Ergebnisliste)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/grundlagen-und-ergebnisliste.md)
- [Suche, Listen und Blättern](https://dokumentation.websale.de/v8s/referenz/tags/ws/suche-listen-und-blaettern.md)
- [Erweiterte Suche](https://dokumentation.websale.de/v8s/suche/erweiterte-suche.md)


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