Rolagem infinita

type aceita dois valores diferentes: scroll ou click. Isso controla o comportamento padrão da rolagem infinita. O scroll fará com que os posts sejam carregados automaticamente quando o visitante alcançar a parte inferior da lista de posts atual, enquanto click mostra um botão Carregar mais posts, que permite que o usuário controle quando mais posts serão carregados.

o padrão é o scroll, mas se um tema tiver widgets de rodapé, ele poderá ser substituído por click para que os widgets fiquem acessíveis.

O argumento footer_widgets aceita diversos valores e indica se um tema tem widgets de rodapé. Se os widgets de rodapé estiverem presentes, o tipo de rolagem será definido como click para que os widgets fiquem acessíveis.

Para simplificar, um valor booleano true ou false pode ser definido para sempre exibir o rodapé ou nunca o exibir, respectivamente.
Além disso, uma string representando uma ID de barra lateral ('sidebar-1', por exemplo) ou um array de IDs de barras laterais serão aceitos pelo argumento footer_widgets. O código da rolagem infinita verificará se as barras laterais contêm widgets e definirá o argumento footer_widgets de acordo.

É altamente recomendável que, sempre que possível, sejam fornecidas as IDs de barra lateral se um tema posicionar áreas de widget abaixo da lista de posts. Isso garantirá a melhor experiência para os usuários do tema ao determinar dinamicamente se o tipo de rolagem deve ser scroll ou click. Assim, se um tema especificar click como o tipo desde o início, o argumento footer_widgets poderá ser omitido com segurança.

Se todas essas opções não forem suficientes, o filtro infinite_scroll_has_footer_widgets está disponível para lógica avançada. O filtro deve retornar um valor booleano e pode ser usado para detectar a presença de menus de navegação ou um visitante que use um dispositivo móvel.

O comportamento do argumento wrapper é similar ao do footer_widgets, pois ele aceita alguns valores diferentes. Este argumento determina se cada conjunto de posts adicionais estará contido em um elemento div quando ele for anexado ao contêiner especificado no argumento anterior.
Se um valor booleano (true ou false) for especificado, talvez um div com a classe infinite-wrap seja colocado ao redor dos posts adicionais.

Para envolver os posts em um div com uma classe personalizada, defina o argumento wrapper como uma string que represente a classe personalizada.
Observe que o argumento wrapper aceita somente uma string sem espaço em branco.

Geralmente é recomendável envolver os posts anexados em um div, a menos que isso resulte em uma marcação inválida. Por exemplo, se um tema usar um elemento de lista (ol ou ul) para exibir posts, o wrapper deve ser desativado para que os elementos div não apareçam em lugares errados.

A rolagem infinita usa um loop padrão do WordPress para renderizar os posts adicionais anexados e utiliza partes de modelos no formulário content-{post format}.php. Se um tema incluir pelo menos content.php, o argumento render poderá ser omitido. Esta é a função de renderização padrão usada pela rolagem infinita:

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

Se uma personalização maior for necessária, ou se um tema não usar as partes do modelo content, um nome de função deverá ser especificado para o argumento render e essa função será usada para gerar a marcação da rolagem infinita. A função deve incluir a parte while() do loop do WordPress e pode utilizar as funções disponíveis para o tema quando os posts forem renderizados.

Por padrão, o argumento type controla quantos posts são carregados cada vez que a rolagem infinita é ativada. No tipo scroll, sete (7) posts são carregados cada vez que a rolagem infinita é ativada. No tipo click, o valor “As páginas do blog mostram no máximo” do site encontrado em Configurações → Leitura é usado.
Entretanto, se o layout de um tema contar com um determinado número de posts, o argumento posts_per_page substituirá os padrões mencionados no parágrafo anterior. Esse controle é útil, por exemplo, em um tema com um layout de três colunas no qual uma quantidade maior ou menor que três posts resultará em um layout irregular.

/**
 * Adicionar suporte ao tema na rolagem infinita.
 *
 * @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 os usuários que não estiverem familiarizados com o tema Twenty Twelve, ele usa partes do modelo content-{post format}.php e não tem área de widget abaixo dos posts; os argumentos footer_widgets e render foram omitidos. Na verdade, como o valor de container corresponde ao padrão, esse argumento também poderia ser omitido; ele foi deixado para clareza.

/**
 * Adicionar suporte ao tema na rolagem infinita.
 */
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' );

O Twenty Eleven tem áreas de widget de rodapé, que não poderiam ser alcançadas na rolagem para baixo, pois novos posts seriam adicionados sempre que a parte inferior fosse alcançada. Para solucionar isso, passamos um array com as IDs dessas áreas de widget para footer_widgets. Agora, se uma dessas barras laterais tem um widget, o plugin de rolagem infinita o detecta e troca para o tipo click automaticamente (no qual você clica para carregar mais posts sob demanda). Assim, o conteúdo do rodapé ainda pode ser acessado perfeitamente. Se o seu tema tiver widgets de rodapé, considere essa abordagem para melhorar de forma significativa a experiência dos seus usuários.

/**
 * Adicionar suporte ao tema na rolagem infinita
 */
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' );
/**
 * Definir o código a ser renderizado para chamar posts,
 * vinculados a partes do modelo, quando possível.
 *
 * Observação: deve definir um loop.
 *
function twenty_ten_infinite_scroll_render() {
 get_template_part( 'loop' );
}

O Twenty Ten usa uma estrutura de modelo ligeiramente diferente para renderizar posts, assim, precisamos determinar uma função de renderização personalizada para a rolagem infinita.

O seu tema tem widgets de rodapé? Se você tiver widgets na área de widgets de rodapé, a rolagem infinita passará a usar o botão “Posts mais antigos” automaticamente para garantir que os widgets de rodapé possam ser exibidos no seu site. Se você quiser que os posts sejam carregados enquanto rola para baixo na página, coloque os widgets em uma área alternativa, como a barra lateral. Se o seu tema tiver apenas áreas de widget de rodapé, você pode procurar um tema diferente com mais opções de área de widget.