Las funciones de inclusión en WordPress

En los antiguos temas, WordPress utilizaba las funciones include() propias de PHP, para llamar a otro archivo.

<?php include(TEMPLATEPATH."/mi-archivo.php");?>

En los temas más actuales, WordPress utiliza sus propias funciones de inclusión:

  • get_header(): para llamar al archivo header.php.

  • get_footer(): para llamar al archivo footer.php.

  • get_sidebar(): para llamar al archivo sidebar.php.

  • get_searchform(): para llamar al archivo searchform.php.

  • comments_template(): para llamar al archivo comments.php.

  • get_template_part(’slug’): para llamar al archivo slug.php.

  • get_template_part(’slug’,’nombre’): para llamar al archivo slug-nombre.php.

Ejemplos

<?php get_searchform();?>

La función get_searchform() llama al archivo searchform.php y muestra el formulario de búsqueda.

<?php get_template_part( ’template-parts/content’, ’page’ );?> 

La función get_template_part() del archivo página.php llama al archivo template-parts/content-page.php.

Según los temas y el uso de los formatos, en algunos temas, como por ejemplo en Twenty Fourteen, puede ver la siguiente función:

<?php get_template_part( ’content’, get_post_format() );?>

La función get-template_part() llama al archivo content-nombredelformato.php si los formatos se utilizan durante la edición de las entradas en el bloque Formato.

La función get_post_format() permite recuperar el nombre del formato.

Si está seleccionado Audio en el bloque Formato, la función get_template_part() llama al archivo content-audio.php. Los formatos se deben activar usando código PHP en el archivo functions.php, lo que depende por tanto de los temas. El uso de formatos puede ser diferente de un tema a otro.

Puede llamar al archivo content-audio.php utilizando el siguiente código:

<?php get_template_part( ’content’, ’audio’ );?>