Scroll infinito

El parámetro type acepta dos valores distintos: scroll o click. Esta opción controla el comportamiento por defecto de Scroll infinito. El valor scroll hace que las entradas se carguen automáticamente cuando el visitante se acerca al final de la página, mientras que el valor click muestra el botón Cargar más entradas, que permite al usuario controlar cuándo se cargan más entradas.

Por defecto, se establece el valor scroll, pero si un tema tiene widgets de pie de página, puede sobrescribirse este valor con click para que los widgets sean accesibles.

El argumento footer_widgets acepta una variedad de valores e indica si un tema tiene widgets de pie de página. Si tiene, el tipo de scroll se establece en click para que los widgets sean accesibles.

La opción más sencilla es establecer un booleano true o false para indicar si el pie de página debe mostrarse siempre o nunca, respectivamente.
Además, el argumento footer_widgets también acepta una cadena que represente un ID de barra lateral (por ejemplo, 'sidebar-1') o una array de ID de barra lateral. El código de Scroll infinito comprueba si las barras laterales contienen widgets y define el argumento footer_widgets según estos datos.

Siempre que sea posible, te recomendamos encarecidamente que proporciones los ID de barra lateral si un tema coloca áreas de widgets debajo de la lista de entradas. Así, los usuarios pueden disfrutar de la mejor experiencia del tema al definir si el tipo de scroll debe ser scroll o click. Dicho esto, si un tema especifica el tipo click desde el principio, el argumento footer_widgets puede omitirse con total seguridad.

Y, por si estas opciones no fueran suficientes, el filtro infinite_scroll_has_footer_widgets está disponible por si quieres crear una lógica más compleja. El filtro debe devolver un valor booleano y se puede usar para detectar la presencia de menús de navegación o los visitantes que usan dispositivos móviles.

El argumento wrapper tiene un comportamiento similar al de footer_widgets, ya que acepta varios valores. Este argumento determina si cada conjunto de entradas adicionales se incluye dentro de un elemento div cuando se añade al contenedor especificado en el argumento precedente.
Si se especifica un valor booleano (true o false), se coloca el elemento div con la clase infinite-wrap entre las entradas adicionales o no se coloca, respectivamente.

Para encapsular las entradas en un elemento div con una clase personalizada, define el argumento wrapper en una cadena que represente la clase personalizada.
Ten en cuenta que el argumento wrapper solo acepta una única cadena sin ningún espacio en blanco.

En general, se recomienda encapsular las entradas añadidas en un elemento div, a menos que eso resulte en un marcado no válido. Por ejemplo, si un tema usa un elemento de lista (ol o ul) para mostrar entradas, el encapsulado debe desactivarse para evitar que los elementos div aparezcan donde no deben.

Scroll infinito utiliza un bucle estándar de WordPress para representar las entradas adicionales añadidas y usa partes de la plantilla en el formulario content-{post format}.php. Si un tema incluye al menos un elemento content.php, el argumento render se puede omitir. A continuación, se muestra la función de representación por defecto que se usa con Scroll infinito:

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

Si quieres personalizarlo aún más o bien un tema no usa las partes content de la plantilla, debes especificar un nombre de función para el argumento render, que se usará para generar el marcado de Scroll infinito. La función debe incluir la parte while() del bucle de WordPress y puede usar cualquier función disponible en el tema a la hora de representar entradas.

Por defecto, el argumento type controla cuántas entradas se cargan cada vez que se activa Scroll infinito. Con el tipo scroll se cargan siete (7) entradas cada vez que se activa Scroll infinito. Con el tipo click se usa el valor «Número máximo de entradas a mostrar en el sitio» que se encuentra en Ajustes → Lectura.
Sin embargo, si el diseño de un tema está pensado para un determinado número de entradas, el argumento posts_per_page sobrescribe los valores por defecto descritos en el parágrafo anterior. Este control puede ser útil, por ejemplo, en un tema con un diseño de tres columnas que puede quedar descompensado si se publican más o menos de tres entradas.

/**
 * Añade compatibilidad con scroll infinito al tema.
 *
 * @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' );

Para los que no están familiarizados con el tema Twenty Twelve, deben saber que utiliza las partes content-{post format}.php de la plantilla y que no tiene ninguna área de widgets debajo de las entradas, de modo que hemos omitido los argumentos footer_widgets y render. En realidad, como el valor container coincide con el valor por defecto, este argumento podría omitirse también, pero lo hemos dejado para evitar confusiones.

/**
 * Añade compatibilidad con scroll infinito al tema.
 */
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' );

Twenty Eleven incluye áreas de widgets de pie de página. Sin embargo, no se pueden llegar a ver, ya que siempre aparecen nuevas entradas al desplazarse hacia abajo. Para solucionarlo, definimos una array con los ID de las áreas de widgets en footer_widgets. Sin embargo, si una de estas barras laterales tiene un widget, nuestro plugin de Scroll infinito lo detectará y cambiará al tipo click automáticamente (con la que debes hacer clic para cargar más entradas siempre que quieras). Así, pues, se podrá acceder al contenido del pie de página perfectamente. Si tu tema tiene widgets de pie de página, esta es la opción recomendada, ya que te permite mejorar considerablemente la experiencia de los usuarios.

/**
 * Añade compatibilidad con scroll infinito al tema
 */
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' );
/**
 * Define el código para que se represente en las entradas de llamada
 * y enlazado a partes de la plantilla siempre que sea posible.
 *
 * Nota: Se debe definir un bucle.
 *
function twenty_ten_infinite_scroll_render() {
 get_template_part( 'loop' );
}

Twenty Ten utiliza una estructura de plantilla un poco distinta a la hora de representar entradas, así que necesitamos proporcionar una función de representación personalizada para el scroll infinito.

¿Tu tema tiene widgets de pie de página? Si tienes widgets en el área de widgets de pie de página, Scroll infinito se cambia automáticamente por el botón «Entradas antiguas» para que se muestren los widgets de pie de página en tu sitio. Si quieres que las entradas se carguen a medida que te desplazas hacia abajo, puedes colocar los widgets en otra área de widgets, como en la barra lateral. Si tu tema solo tiene áreas de widgets de pie de página, te recomendamos que busques un tema con más opciones para esto.