Cómo obtener el directorio y URL del tema en WordPress WordPress

Esta función devuelve la URL del directorio del template asociado al tema activo. La URL devuelta no lleva trailing slash (barra diagonal al final) y utiliza protocolo HTTP o HTTPS si es necesario.

Por ejemplo, tanto si el tema activo es Twenty Fifteen como si es un tema hijo de Twenty Fifteen, y hacemos:

echo get_template_directory_uri();

Obtendremos:

http://misitio.com/wp-content/themes/twentyfifteen

Es útil cuándo es necesario obtener la URL del tema de referencia, tanto si es el activo como si es el tema padre. Por ejemplo, si tenemos un child theme y queremos añadir un script que está en el tema padre:

add_action( 'wp_enqueue_scripts', function() {
    wp_enqueue_script(
        'some_script',
        get_template_directory_uri() . '/js/some_script.js',
        array('jquery')
    );
} );

Referencia: get_template_directory_uri(). Aplica el filtro template_directory_uri.

Es similar a get_template_directory_uri() pero devuelve la ruta en el sistema de archivos del servidor en lugar de la URL. Por ejemplo, si el tema activo es Twenty Fifteen o un tema hijo, obtendríamos algo así:

/home/user/public_html/wordpress/wp-content/themes/twentyfifteen

Es útil, en otros, para incluir scripts PHP que están localizados en un tema y que queremos que se incluyan incluso si se activa un tema hijo:

include( get_template_directory() . '/inc/template-tags.php' );

Referencia: get_template_directory(). Aplica el filtro template_directory.

Es similar a get_template_directory_uri(), se obtiene la URL que apunta al directorio del tema activo con la diferencia de que si estamos en un tema hijo, get_stylesheet_directory_uri() devuelve la URL hacia el tema hijo y no hacia el tema padre como hacia get_template_directory_uri().

Por ejemplo, si el tema activo es Twenty Fifteen y hacemos:

echo get_stylesheet_directory_uri();

Obtendremos:

http://misitio.com/wp-content/themes/twentyfifteen

Pero si el tema activo es un tema hijo de Twenty Fifteen, el resultado ya es diferente. Por ejemplo, si el tema hijo está en el directorio themes/mitema, obtendremos:

http://misitio.com/wp-content/themes/mitema

Referencia: get_stylesheet_directory_uri(). Aplica el filtro stylesheet_directory_uri.

Igual a get_stylesheet_directory_uri() pero devuelve el path físico en lugar de la URL.

Referencia: get_stylesheet_directory(). Aplica el filtro stylesheet_directory.

Esta función devuelve la URL del archivo style.css del tema activo.

echo get_stylesheet_uri();
// Sería algo equivalente a
// echo get_stylesheet_directory_uri() . '/style.css';

Referencia: get_stylesheet_uri(). Utiliza el filtro stylesheet_uri.

Con esta función se obtiene la URL de un archivo localizado en el theme. Si el tema activo es un child theme, primero se busca en el child theme y luego en el padre. Utilizar esta función para cargar CSS y JavaScripts en los temas permite que puedan ser sobreescritos fácilmente en temas hijos; basta copiar los archivos del tema padre al tema hijo manteniendo la misma ruta relativa.

echo get_theme_file_uri( '/assets/css/colors-dark.css' );

Referencia: get_theme_file_uri(). Utiliza el filtro theme_file_uri.

Esta función devuelve la URL del archivo CSS especifico por idioma. En un tema para WordPress puedes tener el stylesheet general style.css y otros adicionales específicos por idioma. Estos archivos han de estar en el directorio principal del tema y su nombre ha de ser el código de idioma; por ejemplo, es_ES.css.

Además, si la dirección del texto en el idioma activo es right-to-left se buscará el archivo rtl.css; si es left-to-right se buscará el archivo ltr.css. De esta forma se estandariza la carga de hojas de estilo específicas según las características del idioma utilizado; muy útil en webs multiidioma.

Referencia: get_locale_stylesheet_uri(). Utiliza el filtro locale_stylesheet_uri.

Esta función devuelve la URL del directorio dónde está instalado el tema activo. Si en una instalación WordPress estándar hacemos:

echo get_theme_root_uri();

Obtendríamos algo así:

http://misitio.com/wp-content/themes

Si queremos obtener la URL al directorio raíz de otro tema diferente al tema activo, podemos pasar el nombre del tema. Por ejemplo:

echo get_theme_root_uri( 'oro-tema' );

Cómo en la mayoría de instalaciones de WordPress todos los temas están bajo el mismo directorio raíz, obtendríamos el mismo resultado que antes. Este uso sería útil en instalaciones dónde puede haber varios directorios de instalación de temas.

Referencia: get_theme_root_uri(). Utiliza el filtro theme_root_uri.

Esta función devuelve la ruta en el sistema de archivos del servidor del directorio de temas. Si en una instalación WordPress estándar hacemos:

echo get_theme_root();

Obtendríamos algo así:

/home/user/public_html/wp-content/themes

Al igual que con get_theme_root_uri(), si queremos calcular el path del directorio raíz de un tema específico, podemos pasar su nombre a la función. Útil en instalaciones en las que no todos los temas comparten el mismo directorio raíz:

echo get_theme_root( 'otro-tema' );

Referencia: get_theme_root(). Utiliza el filtro theme_root.

Esta función devuelve el nombre (no la ruta) del directorio raíz de temas. En una instalación normal de WrodPress en la que todos los temas comparten el mismo directorio raíz, si hacemos:

echo get_theme_roots();

Obtendremos:

/themes

Pero si hay temas instalados en diferentes directorios, es decir, si no todos los temas comparten el mismo directorio raíz, get_theme_roots() devuelve un array con cada tema y su directorio raíz correspondiente.

Referencia: get_theme_roots().