Unendlich Scrollen

Der Parameter type akzeptiert zwei verschiedene Werte: scroll oder click. Damit wird das Verhalten von unendlichem Scrollen gesteuert. Durch den Parameter scroll werden Beiträge automatisch geladen, wenn ein Besucher das Ende der aktuellen Liste von Beiträgen erreicht. Im Gegensatz dazu wird durch den Parameter click der Button Weitere Beiträge laden angezeigt, sodass der Benutzer das Laden weiterer Beiträge selbst steuern kann.

Standardmäßig wird scroll verwendet, aber wenn ein Theme die Footer-Widgets nutzt, kann der Parameter mit click überschrieben werden, sodass die Widgets verfügbar sind.

Das Argument footer_widgets akzeptiert eine Vielzahl von Werten und gibt an, ob ein Theme Footer-Widgets besitzt. Wenn Footer-Widgets vorhanden sind, wird der Scroll-Typ auf click festgelegt, sodass die Widgets angezeigt werden.

Im einfachsten Fall kann mit den booleschen Werten true oder false festgelegt werden, ob der Footer stets bzw. niemals angezeigt werden sollte.
Außerdem akzeptiert das Argument footer_widgets eine Zeichenfolge, die eine Seitenleisten-ID darstellt (z. B. 'sidebar-1'), oder ein Array von Seitenleisten-IDs. Der Code für unendliches Scrollen überprüft, ob die Seitenleisten Widgets enthalten und legt das Argument footer_widgets entsprechend fest.

Sofern möglich, empfehlen wir die Bereitstellung von Seitenleisten-IDs, wenn ein Theme Widget-Bereiche unter der Beitragsliste platziert. Dadurch erhalten die Benutzer des Themes das beste Erlebnis, da dynamisch festgelegt wird, ob der Scroll-Typ scroll oder click sein sollte. Wenn jedoch ein Theme von Anfang an den Parameter click als Typ angibt, kann das Argument footer_widgets problemlos weggelassen werden.

Zusätzlich zu all diesen Optionen ist der Filter infinite_scroll_has_footer_widgets für erweiterte Logik verfügbar. Dieser Filter muss einen booleschen Wert zurückgeben und kann verwendet werden, um das Vorhandensein von Navigationsmenüs oder die Verwendung eines Mobilgeräts zu erkennen.

Das Argument wrapper akzeptiert ebenso wie footer_widgets einige unterschiedliche Werte. Dieses Argument legt fest, ob jeder Satz zusätzlicher Beiträge in einem div-Element eingeschlossen wird, wenn er an den Container angehängt wird, der im vorherigen Argument angegeben wurde.
Wenn der boolesche Wert true angegeben wird, wird ein div-Element mit der Klasse infinite-wrap um die zusätzlichen Beiträge herum eingefügt. Bei false ist das nicht der Fall.

Um die Beiträge in einem div-Element mit einer benutzerdefinierten Klasse einzuschließen, legst du für das Argument wrapper eine Zeichenfolge fest, die diese benutzerdefinierte Klasse darstellt.
Bitte beachte, dass das Argument wrapper nur eine einzige Zeichenfolge ohne Leerzeichen akzeptiert.

Es ist empfehlenswert, die angehängten Beiträge mit einem div-Element zu umschließen, es sei denn, dies würde ein fehlerhaftes Markup ergeben. Wenn ein Theme beispielsweise ein Listenelement nutzt (ol oder ul), um Beiträge anzuzeigen, sollte „wrapper“ deaktiviert werden, damit div-Elemente nur da angezeigt werden, wo sie benötigt werden.

Unendliches Scrollen nutzt eine standardmäßige WordPress-Schleife, um die angehängten zusätzlichen Beiträge darzustellen, und nutzt Vorlagenteile im Formular content-{post format}.php. Wenn ein Theme mindestens content.php umfasst, kann das Argument render weggelassen werden. Die folgende Darstellungsfunktion wird standardmäßig von unendlichem Scrollen verwendet:

while( have_posts() ) {
 the_post();
 get_template_part( 'content', get_post_format() );
}

Wenn eine größere Anpassung erforderlich ist oder wenn ein Theme die content-Vorlagenteile nicht verwendet, sollte ein Funktionsname für das Argument render angegeben werden. Diese Funktion wird anschließend zum Generieren des Markups für unendliches Scrollen verwendet. Die Funktion muss den Teil while() der WordPress-Schleife enthalten und kann jede für das Theme verfügbare Funktion nutzen, wenn sie Beiträge darstellt.

Standardmäßig steuert das Argument type, wie viele Beiträge jedes Mal geladen werden, wenn unendliches Scrollen zum Einsatz kommt. Beim Typ scroll werden sieben (7) Beiträge jedes Mal geladen, wenn Unendlich Scrollen aktiviert wird. Beim Typ click wird der Wert „Blog pages show at most“ (Maximal angezeigte Blogseiten) einer Website verwendet, der unter Einstellungen → Lesen zu finden ist.
Wenn das Layout eines Themes jedoch eine bestimmte Anzahl an Beiträgen erwartet, überschreibt das Argument posts_per_page die im vorherigen Abschnitt genannten Standardwerte. Diese Kontrollmöglichkeit ist beispielsweise in einem Theme mit einem dreispaltigen Layout von Vorteil, wo mehr oder weniger als drei Beiträge ein ungerades Layout ergeben würden.

/**
 * Add theme support for infinite scroll.
 *
 * @uses add_theme_support
 * @return void
 */
function twenty_twelve_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 ) );
}
add_action( 'after_setup_theme', 'twenty_twelve_infinite_scroll_init' );

Falls du mit dem „Twenty Twelve“-Theme nicht vertraut bist: Es verwendet content-{post format}.php-Vorlagenteile und besitzt keinen Widget-Bereich unterhalb der Beiträge, weshalb wir die Argumente footer_widgets und render weggelassen haben. Da der Wert container dem Standardwert entspricht, hätte dieser ebenfalls weggelassen werden können. Zu Demonstrationszwecken haben wir diesen jedoch beibehalten.

/**
 * Add theme support for infinite scroll.
 */
function twenty_eleven_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 'footer_widgets' => array( 'sidebar-3', 'sidebar-4', 'sidebar-5', ),
 'footer' => 'page',
 ) );
}
add_action( 'after_setup_theme', 'twenty_eleven_infinite_scroll_init' );

Das „Twenty Eleven“-Theme besitzt Footer-Widget-Bereiche, die jedoch nicht erreichbar wären, da beim Herunterscrollen stets neue Beiträge geladen werden, bevor das Ende der Seite erreicht werden kann. Um dieses Problem zu lösen, übergeben wir ein Array mit den IDs dieser Widget-Bereiche an footer_widgets. Wenn nun eine dieser Seitenleisten ein Widget beinhaltet, wird dieses von unserem Unendlich Scrollen-Plugin erkannt und es findet ein automatischer Wechsel zum Typ click statt (dabei können mit einem Klick weitere Beiträge geladen werden), sodass der Inhalt deines Footers komplett zugänglich ist. Wenn dein Theme Footer-Widgets besitzt, solltest du diesen Ansatz in Erwägung ziehen, um die Benutzerfreundlichkeit zu erhöhen.

/**
 * Add theme support for infinite scroll
 */
function twenty_ten_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 'render' => 'twenty_ten_infinite_scroll_render',
 'footer' => 'wrapper',
 ) );
}
add_action( 'after_setup_theme', 'twenty_ten_infinite_scroll_init' );
/**
 * Set the code to be rendered on for calling posts,
 * hooked to template parts when possible.
 *
 * Note: must define a loop.
 *
function twenty_ten_infinite_scroll_render() {
 get_template_part( 'loop' );
}

Das „Twenty Ten“-Theme verwendet eine etwas andere Vorlagenstruktur zur Darstellung von Beiträgen. Um unendlich scrollen zu können, verwenden wir daher eine benutzerdefinierte Funktion zum Darstellen der Beiträge.

Besitzt dein Theme Footer-Widgets? Wenn im Footer-Widget-Bereich beliebige Widgets vorhanden sind, zeigt unendliches Scrollen automatisch den Button „Älterer Beitrag“ an, damit gewährleistet ist, dass die Footer-Widgets auf deiner Website angezeigt werden können. Wenn du möchtest, dass Beiträge beim Herunterscrollen geladen werden, kannst du die Widgets in einen anderen Widget-Bereich wie die Seitenleiste platzieren. Falls dein Theme nur Footer-Widget-Bereiche besitzt, solltest du dich nach einem anderen Theme umsehen, das mehr Optionen für Widget-Bereiche besitzt.