Scorrimento infinito

type accetta due valori differenti: scroll o click. Questi parametri regolano il comportamento predefinito di Scorrimento infinito. scroll carica automaticamente gli articoli nel momento in cui il visitatore raggiunge la fine dell’elenco corrente di articoli, mentre click mostra il pulsante Carica altri articoli, consentendo all’utente di regolare il caricamento di ulteriori articoli.

scroll è il valore predefinito, ma se un tema ha dei widget del piè di pagina, potrà essere sovrascritto dal valore click così da rendere i widget accessibili.

L’argomento footer_widgets accetta molteplici valori e indica se un tema ha dei widget del piè di pagina. Se sono presenti dei widget del piè di pagina, il tipo di scorrimento sarà impostato su click così da rendere i widget accessibili.

Nella sua forma più semplice, è possibile impostare un valore booleano true o false nel caso in cui il piè di pagina dovesse essere, rispettivamente, mostrato o meno.
Inoltre, una stringa che rappresenta un identificativo di una barra laterale ('sidebar-1', per esempio) e un array di identificativi delle barre laterali saranno entrambi accettati dall’argomento footer_widgets . Il codice di Scorrimento infinito controllerà se la barra laterale o le barre laterali contengono widget e imposterà l’argomento footer_widgets di conseguenza.

Ogniqualvolta possibile, raccomandiamo vivamente di fornire gli identificativi delle barre laterali nel caso in cui un tema collocasse l’area widget al di sotto dell’elenco di articoli. In questo modo viene garantita una migliore esperienza a chi utilizza i temi, in quanto è possibile impostare in modo dinamico il tipo di scorrimento, scegliendo tra l’opzione scroll o click. Detto questo, se un tema sin dall’inizio presenta come opzione click, allora l’argomento footer_widgets può essere omesso senza problemi.

Se tutte queste opzioni non sono sufficienti, è disponibile il filtro infinite_scroll_has_footer_widgets per una configurazione avanzata. Il filtro deve restituire un valore booleano e può essere utilizzato per rilevare la presenza di menu di navigazione oppure se il visitatore sta utilizzando un dispositivo mobile.

L’argomento wrapper funziona in modo simile a footer_widgets, in quanto accetta differenti valori. Questo argomento determina se ogni set di ulteriori articoli è contenuto o meno in un elemento div quando viene aggiunto al contenitore specificato nell’argomento che lo precede.
Se è specificato un valore booleano (true o false), gli articoli aggiuntivi vengono collocati o meno all’interno di un elemento div di classe infinite-wrap.

Per inserire gli articoli in un elemento div con la classe personalizzata, imposta l’argomento wrapper su una stringa che rappresenta la classe personalizzata.
L’argomento wrapper accetta solo una singola stringa senza spazi bianchi.

In generale, è buona pratica trasformare gli articoli aggiunti in div, a meno che ciò non comporti un markup non valido. Ad esempio, se un tema utilizza un elemento dell’elenco (ol, ul) per visualizzare gli articoli, il wrapper deve essere disabilitato in modo che gli elementi div non appaiano in posizioni a cui non appartengono.

Scorrimento infinito ricorre a un loop standard di WordPress per restituire gli articoli aggiuntivi e utilizza la forma content-{post format}.php per le parti del modello. Se un tema include almeno content.php, allora l’argomento render può essere omesso. Di seguito è riportata la funzione predefinita di render utilizzata da Scorrimento infinito:

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

Se hai bisogno di ulteriori personalizzazioni, oppure se un tema non utilizza le parti del modello content, occorre specificare un nome di funzione per l’argomento render e tale funzione sarà utilizzata per generare il codice per Scorrimento infinito. La funzione deve includere la porzione while() del loop di WordPress e può utilizzare qualsiasi opzione a disposizione del tema quando restituisce gli articoli.

Per impostazione predefinita, l’argomento type controlla quanti articoli vengono caricati ogni volta che Scorrimento infinito è in funzione. Per il tipo scroll, vengono caricati sette (7) articoli ogni volta che viene attivato Scorrimento infinito. Per il tipo click, viene utilizzato un valore “Le pagine del blog visualizzano al massimo” del sito trovato in Impostazioni → Lettura.
Tuttavia, se le impostazioni di un tema richiedono un certo numero di articoli, l’argomento posts_per_page sovrascriverà le impostazioni predefinite presentate nel precedente paragrafo. Questo controllo è utile, ad esempio, in un tema con la disposizione su tre colonne, dove un numero maggiore o minore di tre articoli causerebbe una disposizione irregolare.

/**
 * 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' );

Per chi non ha molta familiarità con il tema Twenty Twelve, occorre sapere che utilizza parti del modello content-{post format}.php e non ha aree widget al di sotto degli articoli, per cui gli argomenti footer_widgets e render sono stati omessi. In realtà, dal momento che il valore container corrisponde a quello predefinito, anche questo argomento può essere omesso; noi l’abbiamo tenuto per chiarezza.

/**
 * Add theme support for infinity 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' );

ll tema Twenty Eleven include aree widget che non si possono raggiungere con lo scorrimento, dato che nuovi articoli sono aggiunti ogni volta che si arriva a fondo pagina. Per risolvere questo problema, passiamo un array contenente gli identificativi di queste aree widget all’argomento footer_widgets. Così facendo, se in una di queste barre laterali è presente un widget, il nostro plugin Scorrimento infinito lo rileverà e passerà in automatico al tipo click (dove occorre fare clic per caricare ulteriori articoli su richiesta), in modo che il contenuto del tuo piè di pagina rimanga perfettamente accessibile. Se nel tuo tema sono presenti dei widget del piè di pagina, considera questo metodo per migliorare l’esperienza dei tuoi utenti.

/**
 * Add theme support for infinity 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' );
}

Twenty Ten utilizza un modello con una struttura leggermente differente per restituire gli articoli, per cui dobbiamo fornire per Scorrimento infinito una funzione specifica per la restituzione.

Nel tuo tema sono presenti widget del piè di pagina? Se hai dei widget nell’area dei widget del piè di pagina, Scorrimento infinito passerà automaticamente a utilizzare il pulsante “Articoli precedenti”, per garantire che i widget del piè di pagina possano essere visualizzati sul tuo sito. Se vuoi che gli articoli siano caricati mentre scorri la pagina, puoi posizionare i widget in un’area widget alternativa, come la barra laterale. Se il tuo tema ha solo aree widget a piè di pagina, probabilmente vorrai cercare un altro tema con più opzioni per le aree widget.