Schwellenwert-Auslöser

Ein Schwellenwert-Auslöser ist ein Leseprozentsatz (1 – 100), der, sobald er überschritten wird, eine vordefinierte Aktion auslöst. Verwenden Sie ihn, um ein Newsletter-Formular anzuzeigen, wenn Leser einen Artikel beenden, sie sanft nach oben zu scrollen oder Ihre eigene Logik über ein Browser-Event anzubinden.

Verfügbare Aktionen

1. Zurück nach oben scrollen

Scrollt den Leser sanft zum Seitenanfang, wenn er den Schwellenwert überschreitet. Ideal für sehr lange Artikel, bei denen der Leser unwahrscheinlich manuell nach oben scrollt — hält ihn nahe der Navigation, sobald er fertig ist.

2. Element anzeigen

Zeigt ein verstecktes CSS-Element an dem Moment an, in dem der Schwellenwert überschritten wird — ideal für Newsletter-Anmeldungen, Kommentareinladungen, Ähnliche-Artikel-Widgets oder Call-to-Action-Boxen, die erst erscheinen sollen, wenn der Leser engagiert ist.

Bereiten Sie das Zielelement mit einem initialen display: none und einem Übergang für ein Einblenden vor:

.mein-newsletter-cta {
  display: none;
  opacity: 0;
  transform: translateY(12px);
  transition: opacity 0.4s ease, transform 0.4s ease;
}
.mein-newsletter-cta.ist-sichtbar {
  display: block;
  opacity: 1;
  transform: translateY(0);
}

ReadNinja sendet auch ein DOM-Event, das Sie abhören können — nützlich, wenn Sie zusätzliche Logik neben der CSS-Enthüllung wollen:

document.addEventListener('rpb:threshold-reached', (e) => {
  const cta = document.querySelector('.mein-newsletter-cta')
  if (cta) cta.classList.add('ist-sichtbar')
  console.log('Leser hat', e.detail.percent, '% erreicht')
})

3. Benutzerdefinierter JavaScript-Callback

Führt eine JavaScript-Funktion Ihrer Wahl aus, wenn der Schwellenwert erreicht wird. In der Praxis hören Sie dasselbe rpb:threshold-reached-Event ab, das auf document dispatcht wird, und reagieren nach Belieben — senden Sie ein Analytics-Event, öffnen Sie ein Modal, rufen Sie Ihre eigene API auf.

document.addEventListener('rpb:threshold-reached', (event) => {
  // event.detail.percent = der konfigurierte Schwellenwert, z.B. 80
  if (typeof window.gtag === 'function') {
    window.gtag('event', 'lese_schwellenwert_erreicht', {
      event_category: 'engagement',
      value: event.detail.percent,
    })
  }
})

Das Event wird einmal pro Seitenaufruf ausgelöst, genau in dem Moment, in dem der Leser den konfigurierten Prozentsatz überschreitet — es wird nicht erneut ausgelöst, wenn der Leser hin- und herschrollt.

Beitragsüberschreibung

Wenn Sie den Schwellenwert-Auslöser auf einem bestimmten Beitrag deaktivieren müssen (z.B. ein sehr kurzer Artikel, bei dem 80% sofort erreicht werden), setzen Sie den Meta-Key _rpb_disable_threshold auf 1:

update_post_meta( $post_id, '_rpb_disable_threshold', 1 );

Diese Überschreibung ist für Entwickler gedacht — es gibt keinen Schalter in der Editor-Seitenleiste.