Personalizar el sitio con el archivo functions php

Crear funciones sencillas en PHP

Agregar una función en WordPress se realiza de la misma manera que en PHP. Escriba las siguientes líneas en su archivo functions.php, a continuación de las funciones existentes:

<?php 
function mi_funcion(){ 
   //el código de mi función 
   return 'soy la función mi_funcion'; 
} 
?> 

Puede llamar a esta función en cualquier archivo de su tema, en uno o más lugares. Escriba esto en una plantilla de página del tema, por ejemplo en header.php, footer.php o index.php:

<?php echo mi_funcion(); ?> 

Si ya existe una función con el mismo nombre, recuerde verificar que la función existe antes de llamarla, esto evita mostrar un error en el sitio web. Para hacer esto, use la función PHP:

 function_exists('nombre_de_mi_funcion') 

Lo que da:

<?php if(function_exists('mi_funcion')){ echo mi_funcion(); } ?> 

<?php 
function mi_imagen(){ 
   return '<img src="rutademiimagen.jpg" alt="mi imagen" />'; 
} 
?> 

Crear una función rastro de migas simple

Un rastro de migas es una serie de enlaces que indican dónde se encuentra en un sitio web. Hay extensiones listas para usar, pero para entender cómo funciona WordPress y poner en práctica los conceptos vistos en el capítulo WordPress y PHP, creará su propia función en el archivo functions.php.

Para eso, necesita la global $post, marcadores condicionales, funciones PHP y funciones específicas de WordPress. Encontrará las funciones de WordPress utilizadas en este ejemplo en el capítulo WordPress y PHP.

Cree la función rastro_migas(), llame a la global $post, usando en la salida de la función un marcador PHP: return, que devuelve una variable: $rastro. $rastro devolverá el código HTML del rastro de migas:

<?php 
function rastro_migas(){ 
   global $post; 
 
   return $rastro; 
} 
?> 

Muestre el rastro de migas en todas las páginas, excepto en la página de inicio. Use el marcador condicional is_front_page().

if(!is_front_page()){} 

Esta línea de código verifica que no sea la página de inicio.

Luego, agregue a la variable $rastro:

Lo que da la siguiente función:

<?php 
function rastro_migas(){ 
   global $post; 
       if(!is_front_page())...

Crear una función para mostrar los artículos de una categoría con el objeto WP_Query

En esta función verá cómo realizar una solicitud sobre los artículos, para mostrar los artículos pertenecientes a una categoría específica. La categoría se debe crear previamente, en la página de administración Entradas - Categorías.

Página Entradas - Categorías - Añadir una nueva categoría

Para este ejemplo, llame a la categoría "Novedades" y recupere el identificador (consulte el capítulo WordPress y PHP, sección Los marcadores condicionales).

En este ejemplo, el identificador de la categoría es 3, pero probablemente sea diferente para usted.

Página Entradas - Categorías, el ID de la categoría creada es 3, porque la variable tag_ID que se pasa en la URL es igual a 3

Posteriormente asigne artículos a esta categoría. Una categoría sin artículos no arroja ningún resultado. Para hacer esto, cree artículos con un título, texto, una imagen destacada, un extracto, luego asígneles la categoría Novedades.

Página Entradas - Añadir una nueva entrada, marque la casilla Novedades en el bloque Categorías para unir el artículo con la categoría

Para recuperar los artículos, use el objeto WP_Query. Es posible recuperar artículos...

Añadir un enlace ”Leer más” a los resúmenes

Algunos temas usan la función de WordPress the_excerpt(). Esta función se utiliza para mostrar el contenido de la sección Extracto que se encuentra en la administración, en la columna Entrada, a la derecha de la página Entradas.

Sección Extracto

Para mostrar un enlace Leer más, que muestre a todo el artículo, al final del extracto, debe modificar la función básica de WordPress: the_excerpt().

Si toma el ejemplo anterior, deberá eliminar el código HTML del enlace Leer más en la función posts_novedad; de lo contrario, aparecerán dos enlaces.

Cree la función excerpt_new() en el archivo functions.php y obtenga el valor que devuelve the_excerpt(), gracias al argumento $outpout:

function excerpt_new($outpout){ 
   return $outpout ; 
} 

En este punto, la función excerpt_new() devuelve exactamente lo mismo que the_excerpt().

Ahora, obtenga la URL del artículo, gracias a la función get_permalink() de WordPress, para crear un enlace HTML que regrese a la página completa del artículo.

function excerpt_new($outpout){ 
   global $post; 
 
   return $outpout.' <a href="'.get_permalink($post->ID).'"> 
Leer más ...</a>'; 
} 

La función...

Añadir hojas de estilo y scripts

Cuando se crean sitios web, es necesario agregar hojas de estilo CSS o scripts JavaScript.

Con WordPress, puede agregar llamadas a archivos CSS/JavaScript directamente en el archivo header.php o en el archivo footer.php llamadas a archivos JavaScript, utilizando etiquetas HTML estándar.

Gracias a las funciones de WordPress, también es posible agregar algunas.

El uso de estas funciones le permite agregar archivos CSS y JavaScript a las funciones wp_head() y wp_footer() usando hooks.

WordPress también tiene una biblioteca de scripts fáciles de usar.

Es importante comprender completamente estas funciones, ya que son útiles y esenciales a la hora de crear extensiones.

<?php wp_register_style( $key, $src, $deps, $ver, $media ); ?> 
 
<?php wp_enqueue_style( $key, $src, $deps, $ver, $media ); ?> 

<?php wp_register_script( $key, $src, $deps, $ver, $footer ); ?> 
 
<?php wp_enqueue_script( $key, $src, $deps, $ver, $footer ); ?> 

Crear ubicaciones para los menús

En el capítulo de WordPress y PHP, vio la función wp_nav_menu(). Ahora verá cómo definir ubicaciones específicas para los menús, gracias a la función register_nav_menus() de WordPress.

Esta función agrega una pestaña adicional Gestionar ubicaciones, en el panel de administración Apariencia - Menús.

Algunos temas integran directamente esta función. Por ejemplo, los temas Twenty Twenty y Twenty Seventeen lo ofrecen. Esto significa que la función register_nav_menus() está presente en el archivo functions.php de estos temas.

Para el tema Twenty Twenty, tenemos el siguiente código, línea 252:

    function twentytwenty_menus() { 
 
    $locations = array( 
        'primary'  => __( 'Desktop Horizontal Menu', 'twentytwenty' ), 
        'expanded' => __( 'Desktop Expanded Menu', 'twentytwenty' ), 
        'mobile'   => __( 'Mobile Menu', 'twentytwenty' ), 
        'footer'   => __( 'Footer Menu', 'twentytwenty' ), 
        'social'   => __( 'Social Menu', 'twentytwenty' ), 
   ...

Crear barras laterales y zonas para ellas

Las barras laterales, o sidebars, se utilizan para mostrar widgets. La mayoría de las veces, la barra lateral es la columna lateral de un sitio web pero, dependiendo del tema, se puede encontrar en el pie de página, en el encabezado, en una página específica (como la página de inicio), etc. Las barras laterales están directamente vinculadas a los temas y puede cambiar de un tema a otro. Verá cómo crear sus propias barras laterales, así como su ubicación correspondiente. Para crear barras laterales, utilizará la función de WordPress register_sidebar().

Esta función le permite guardar y de esta manera crear barras laterales en la administración Apariencia - Widgets.

Algunos temas integran directamente esta función. Por ejemplo, el tema Twenty Seventeen lo ofrece. Significa que la función register_sidebar() está presente en el archivo functions.php de este tema. Se usa en la línea 351 en la función twentyseventeen_widgets_init(). De manera similar para el tema Twenty Twenty en la línea 348 del archivo functions.php, con la función twentytwenty_sidebar_registration().

En el tema Twenty Seventeen, esta función crea las sidebars Barra lateral del Blog, Pie de página 1 y Pie de página 2

Parte del archivo functions.php del tema Twenty Seventeen. Para crear las tres barras...

Personalizar un tema con add_theme_support()

La función add_theme_support() de WordPress le permite agregar funcionalidades al tema, como formatos para los artículos, un logotipo, encabezados de página, un background (fondo), etc. Pero también agregar funcionalidades al editor de bloques Gutenberg.

Muchos temas utilizan esta función, pero algunos no utilizan todas las posibilidades que ofrece la función.

Por ejemplo: el tema Twenty Seventeen usa algunas de estas funcionalidades básicas, en el archivo functions.php. Por lo tanto, en la administración de este tema encontrará la pestaña Cabecera, la sección de formatos de artículos, la activación del feed RSS, etc. En cuanto al tema Twenty Twenty, no existe la pestaña Cabecera, ni la sección formatos de artículo, pero hay un editor con paleta de colores, un editor para las fuentes de texto, etc.

La función add_theme_support() debe estar adjunta al hook de acción after_setup_theme, que ejecuta la función cuando se carga el tema.

Si algunos elementos no están presentes en su tema original, agregue esta función en el archivo functions.php, para activar estas opciones.

Aquí está el detalle de esta función:

<?php add_theme_support($custom, $arg ); ?> 

Añadir otros tipos de artículos

Por defecto, WordPress usa dos tipos de artículos: los artículos que se encuentran en la pestaña Entradas y las páginas que se encuentran en la pestaña Páginas, pero es posible agregar más tipos de artículos (post_type) como productos, archivos de clientes o un directorio, etc.

Estos tipos de artículos aparecen como pestañas en el menú de administración. Tienen la misma forma que los artículos y páginas básicos, con los mismos submenús básicos para ver la lista o agregar artículos. Es una especie de clon de las partes Entradas o Páginas, que puede configurar como quiera.

Para poder hacer esto, use la función:

<?php register_post_type( $post_type_name, $args ) ?> 

$args = array( 
   'label' =>'', 
   'labels' =>'', 
   'description ' =>'', 
   'public ' =>'', ...

Añadir taxonomías específicas

Para añadir su propia taxonomía, utilice la función WordPress:

<?php register_taxonomy($taxonomy_name, $post_type_name, $args ); ?> 

$args = array( 
   'label' =>'', 
   'labels' =>'', 
   'public ' =>'', 
   'show_ui ' =>'', 
   'show_in_nav_menus' =>'', 
   'show_tagcloud' =>'', 
   'meta_box_cb' =>'', 
   'show_admin_column' =>'', 
   'hierarchical' =>'', 
   'update_count_callback' =>'', 
   'query_var' =>'', 
   'rewrite' =>'', 
   'capabilities'...