Qual é o objetivo do arquivo paged.php?

10

No contexto do gráfico da hierarquia de modelos? Pelo que entendi, o arquivo paged.php tem algo a ver com um arquivo morto?

insira a descrição da imagem aqui

templates chrisjlee
fonte

Respostas:

8

Se observarmos template-loader.php, podemos ver as condições sob as quais paged.phpserá carregado:

if ( defined('WP_USE_THEMES') && WP_USE_THEMES ) :
    $template = false;
    if     ( is_404()            && $template = get_404_template()            ) :
    elseif ( is_search()         && $template = get_search_template()         ) :
    elseif ( is_tax()            && $template = get_taxonomy_template()       ) :
    elseif ( is_front_page()     && $template = get_front_page_template()     ) :
    elseif ( is_home()           && $template = get_home_template()           ) :
    elseif ( is_attachment()     && $template = get_attachment_template()     ) :
        remove_filter('the_content', 'prepend_attachment');
    elseif ( is_single()         && $template = get_single_template()         ) :
    elseif ( is_page()           && $template = get_page_template()           ) :
    elseif ( is_category()       && $template = get_category_template()       ) :
    elseif ( is_tag()            && $template = get_tag_template()            ) :
    elseif ( is_author()         && $template = get_author_template()         ) :
    elseif ( is_date()           && $template = get_date_template()           ) :
    elseif ( is_archive()        && $template = get_archive_template()        ) :
    elseif ( is_comments_popup() && $template = get_comments_popup_template() ) :
    elseif ( is_paged()          && $template = get_paged_template()          ) :
    else :
        $template = get_index_template();
    endif;
    if ( $template = apply_filters( 'template_include', $template ) )
        include( $template );
    return;
endif;

O último elseifé onde o modelo paginado é carregado, se existir:

elseif ( is_paged()          && $template = get_paged_template()          ) :

O que significa que todas as verificações acima precisam retornar false para que o paged.phpmodelo seja carregado, a consulta is_pagede nenhum outro modelo específico de conteúdo foi encontrado.

Milo
fonte
Eu acho que, paged.php pode ser usado para personalizar páginas paginados - page / 2 / etc core.trac.wordpress.org/ticket/14779#comment:4
Amit
2
sim, é isso que is_paged()significa, no entanto, se houver outro modelo mais específico disponível, esse modelo será chamado antes paged.php. por exemplo, se o seu tema tiver um archive.phpmodelo, paged.phpnunca será usado para qualquer tipo de conteúdo usado archive.php, independentemente do número da página.
Milo
2

Sim, se você tiver paged.phppresente no seu tema, esse modelo será usado para todos, exceto a primeira página do arquivo. Isso ocorre caso o estilo / marcação do seu arquivo seja drasticamente diferente entre a primeira página e as páginas subseqüentes.

Stephen Harris
fonte
11
isso não é totalmente exato, se um modelo mais específico como archive.phpou category.phpexistir, paged.phpnão será usado. somente se houver apenas um index.phpmodelo terá paged.phpprecedência.
Milo
Você está absolutamente certo - você para no primeiro modelo disponível no gráfico.
Stephen Harris