Está en la página 1de 27

Bienvenido al manual de wordpress 2014

Antes de continuar… Este manual ha sido creado de manera personal y para su uso personal como manual de referencias. Este contiene términos redactados con lenguaje personal y no profesional. Así que, pueden existir términos mal redactados o clausulas erróneas.

La estructura básica de una plantilla de wordpress, está compuesta por cuatro archivos que son indispensables:

header.php

index.php

sidebar.php

footer.php

archivos que son indispensables: header.php index.php sidebar.php footer.php HEADER CONTENT (INDEX) FOOTER
HEADER
HEADER
archivos que son indispensables: header.php index.php sidebar.php footer.php HEADER CONTENT (INDEX) FOOTER
CONTENT (INDEX) FOOTER
CONTENT (INDEX)
FOOTER
archivos que son indispensables: header.php index.php sidebar.php footer.php HEADER CONTENT (INDEX) FOOTER

HEADER.PHP

(Funciones que encontraras dentro del archivo “header.php”):

language_attributes()

Muestra atributos HTML acerca del idioma/región como la dirección del texto y el lenguaje que la constituyen (por ejemplo: lang=”es-ES”, dir=”ltr”).

Se encuentra en: wp-includes/general-template.php

Ejemplo:

<html <?php language_attributes(); ?>> // mostraria en el navegador lo siguiente:

<html lang=”ES-es” dir=”ltr”>

HTML:

Regularmente va en la etiqueta <html>

wp_title()

Separa el nombre del sitio con el titulo de la pagina actual, puede ser una entrada (post), una pagina o una pagina de archivo, mediante la cadena proporcionada.

Se encuentra en: wp-includes/general-template.php.

Su valor por default es: » (&raquo;)

Parametros:

Parametro1: (opcional) (tipo: cadena de texto) texto, por Ejemplo: | - / << >> . =

Parametro2: (opcional) (tipo: boleanos) Especificar si se mostrara (true o false)

Parametro3: (opcional) (tipo: cadena texto) especifica la dirección (right o left)

Ejemplo:

wp_title(“|”, true, “right”); // mostrara algo como “titulo del post | titulo PRINCIPAL sitio”

Ejemplo II:

wp_title(“<<”, true, “left”); // mostrara algo como “<< titulo del post titulo PRINCIPAL sitio”

HTML:

en el archivo “header.php” lo encontraras dentro del <title></title>.

bloginfo()

Muestra información acerca del sitio, podría considerar usar la función get_bloginfo().

A diferencia, get_bloginfo(), extrae los valores en preformato PHP podiendo almacenarlos

en alguna variable, mientras que bloginfo(), los muestra en pantalla

se encuentra en: wp-includes/general-template.php

Parametros:

<?php bloginfo( $parametro ); ?>

Lo posibles valores para $parametro son: (por default es name)

-name: Muestra el titulo del sitio, su valor se encuentra en la BD, tabla “wp_options”, en

el campo “blogname”.

-description: Muestra la descripción del sitio, su valor se encuentra en la BD, tabla

“wp_options” en el campo “blogdescription”.

-wpurl: Muestra la dirección URL de wordpress, el valor se encuentra en la BD, tabla “wp_options”, en el campo “siteurl”, puede considerar usar “site_url()”. -url: Muestra la dirección URL del sitio, el valor se encuentra en la BD, tabla “wp_options”, en el campo “home”, puede considerar usar “home_url()”. -admin-email: Muestra el correo electrónico del administrador, su valor se encuentra en

la BD, tabla “wp_options”, en el campo ”admin_email”.

-Mas posibles valores:

charset version html_type text_direction [ función: is_rtl() ] language

stylesheet_url [ función: get_stylesheet_uri() ] stylesheet_directory [ función: get_stylesheet_directory_uri() ] template_url template_directory [ funciones: get_theme_root(), get_template(), ssssssssssssssss get_bloginfo(“template_url”), get_template_directory_uri() ] pingback_url atom_url rdf_url rss_url

rss2_url

comments_atom_url

comments_rss2_url

siteurl (parámetro obsoleto, use funciones) [ función: home_url(), bloginfo(“url”) ] home (parámetro obsoleto, use funciones) [ función: home_url(), bloginfo(“url”) ]

HTML:

Regularmente va en las etiquetas <meta>, <title>, y otros elementos de la cabecera.

is_home() / is_front_page()

Esta función checa si se muestra la pagina principal, no admite parámetros y devolverá true o false, según se cumpla la condición. También puedes ver is_front_page(), esta al igual que is_home() devolverá true, la ventaja de is_fron_page(), también aplica cuando en Ajustes Lectura, tienes seleccionado “Ultimas entradas (post)”, o igual, si tienes seleccionado “pagina estatica” y una “pagina principal”.

Se encuentra en: wp-includes/query.php

Ejemplo:

<?php if( is_home() or is_front_page() ) :

//this is my principal page. endif; ?>

is_singular()

Es una etiqueta condicional que checa si se está mostrando una entrada en singular, como seria, si se muestra una entrada (post), una pagina, o una pagina de archivos adjuntos, como lo son estas funciones: is_single(), is_attachment() or is_page(), esto devolverá un bolneado, (true), si se cumple al menos una función de las ya mencionadas. Si se especificara un parámetro, la consulta checará si alguno de los parámetros se cumple.

Se encuentra: wp-includes/query.php

Ejemplo:

Mostrar un anuncio en la pagina de contacto que de titulo le hemos puesto “Contact”.

if(is_singular(“contact”)) { // code for show a adv 1

}

Ejemplo II.

Mostrar una imagen solamente en todas las entradas (post), en las paginas no.

if(is_singular(“post”)) { //otros valores: page, attachment, revision, nav_menu_item <div id=”flotante”><img src=”uploads/2014/01/miimage.jpg” alt=”anuncio” /></div>

}

HTML:

No tiene posición alguna, en el “header.php” lo encontraremos al final de <head></head>

get_option()

Una forma segura de obtener los valores del parámetro que deseemos. Los valores para el parámetro son los nombres de los campos de la tabla “wp_options” dentro de nuestra BD, como por ejemplo: admin_email.

Se encuentra en: wp-includes/option.php

Parametros:

<?php echo get_option( $parametro ); ?>

Los posibles valores para $parametro son los nombres de los campos de la tabla “wp_options”, por ejemplo:

admin_email, blog_charset, blogdescription, siteurl, blogname, start_of_week, etc.

HTML:

No tiene ubicación específica dentro de la estructura.

wp_enqueue_script()

Vincula los scripts previamente registrados a la pagina generada en el momento (pagina actual). Si su script aún no ha sido vinculado, usted puede agregarlo mediante un manejador, usando la función wp_register_script.

Se encuentra en: wp-includes/functions.wp-scripts.php

valor por defecto, ninguno.

Parametros:

wp_enqueue_script($parametro1, $parametro2, $paramet3, $paramet4, $paramet5);

$parametro1: (obligatorio)(Tipo: cadena de texto) Nombre utilizado como

manipulador del script. $parametro2: (opcional) (Tipo: cadena de texto) URL del script, puede utilizar la

función plugins_url() para obtener las URLs en local par scripts y get_template_directory_uri() para temas. $paramet3: (opcional) (Tipo: Array) Array de todos los manipuladores del cual

depende el scripts antes de ser cargado. Si el scripts no tiene dependencias, arrojara falso. Este parámetro solo es necesario cuando no se ha registrado el script con la función wp_register_script(). $paramet4: (opcional) (Tipo: cadena de texto) versión del scripts, si no se especifica,

wordpress automáticamente añadirá por defecto la versión de wordpress sobre el que se trabaja. $paramet5: (opcional) (Tipo: boleano) Si se especifica “true”, el scripts se colocara antes del cierre del elemento “body”, es decir, antes de </body>, y para ello es necesario que el tema tenga una “etiqueta de pie” , usando la función wp_footer(), que está dentro del archivo wp-contents/themes/NOMBRE-TEMA/footer.php

Los scripts registrados por wordpress, puede encontrarlos en:

wp-includes/script-loader.php

NOTA:

Para ver la lista de todos los scripts registrados por default de wordpress puede visitar este link:

http://codex.wordpress.org/Function_Reference/wp_enqueue_script#Default_Scripts_Inc

luded_and_Registered_by_WordPress

Ejemplo I:

wp_enqueue_script(“comment-reply”); //Solamente especificamos el parámetro obligatorio.

Ejemplo II:

Agregar el scripts de jQuery desde la URL de la api de google.

//paso 1, registramos el nombre del manipulador del script. wp_register_script(“jqueryapi”, “http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js”); //paso 2, lo llamamos si estamos en una pagina. if(is_page()) :

wp_enqueue_script(“jqueryapi”);

endif;

Ejemplo III:

Agregar el scripts de un slider que dependa del scripts jquery de google.

//primero lo registramos wp_register_script(“micarousel”, get_template_directory_uri().”js/micarousel.js”,” jqueyapi”); //lo mandamos a llamar con la función wp_enqueue_script, y si no se carga el script de jqueryapi, entonces //este script tampoco se cargara y evitaremos una PETICION tonta. wp_enqueue_script(“micarousel”,);

Ejemplo IV:

Agregar un script que dependa de “jqueryapi” sin usar wp_register_script.

wp_enqueue_script(“miscript”

get_template_directory_uri().”js/miscript.js”

“jqueryapi”);

NOTA:

Los ejemplos no son 100% completos, a partir de esta página no recomiendo llevarlo a la práctica, aún falta entender otras funciones como wp_enqueue_scripts() y add_action().

HTML:

No tiene lugar especifico, dentro del archivo “header.php”, lo encontraremos realizando la función de agregar un script para activar los comentarios aninados, se encuenta a final del elemento head </head>.

wp_head()

Esta función se activa dentro y al final del <head></head>, de la plantilla, y su principal acción es activar las funciones requeridas en el momento, para asi evitar cargar funciones que no se necesitaran y ahorrar peticiones al servidor.

Se encuentra en: wp-includes/general-template.php

Ejemplo:

Creando una función y activarla

//paso 1, creamos una funcion function sendMail($post_ID) {

mail(“mail@example.com”, “the mail asunt”, “the content”); return $post_ID;

}

//paso 2, agregamos en “wp_head” la función que hemos creado (sendMail). <?php add_action(“wp_head”, “sendMail”); ?>

//paso 3, en el <head></head>, mandamos a llamar las funciones (incluida la que hemos creado). <?php wp_head(); ?>

HTML:

Se ubica al final de las etiquetas <head></head>

body_class()

Esta función proporciona al elemento <body> diferentes clases, que nos serán útiles a la hora de agregar estilos.

Se encuentra en: wp-includes/post-template.php

Su valor por default es null, (no tiene valores adicionales, solo los actuales).

Ejemplo I:

<body <?php body_class(); ?>> //imprimirá algo como:

<body class=” page page-id-2 page-parent page-template-default logged-in”>

*Para agregar clases opcionales, basta con colocar un array, o el texto directamente separado por un simple espacio. Ejemplo II:

<body <?php body_class(“myclass claseParaTexto claseFocus claseHover”); ?>> <!-- o bien, con un array: --> $miarray = array(“myclass”, “claseParaTexto”, “claseFocus”, “claseHover”); <!-- y dentro del <body> quedaría: --> <body <?php body_class($miarray); ?>> <!-- Posteriormente damos nuestros estilos CSS: --> .myclass {color:black; Font-size:12px;} .claseFocus {text-decoration:none; font-family:’arial’;}

HTML:

Se encuentra en “header.php” dentro de la etiqueta de apertura <body>.

dentro de la etiqueta de apertura <body>. ANTES DE SEGUIR… Hablemos de las clases para nuestros

ANTES DE SEGUIR…

Hablemos de las clases para nuestros estilos CSS.

Podemos omitir la función body_class() y crear nuestros estilos 100% personalizados, pero ya tenemos tarea ahorrada, aquí las clases que existen dentro de las plantillas:

Pagina de Inicio

Pagina Principal: home

Si la pagina principal muestra las entradas del blog: home, blog.

Si la pagina principal muestra una pagina estatica: home, page.

Entradas de Inicio

Entradas del blog: blog

Si las entradas del blog se muestran sobre la pagina de inicio: home, blog

Si las entradas del blog se muestran sobre una pagina estatica: page, blog

Entrada/Post
Entrada/Post

Pagina de entrada: single, postid-{ID}

blog Entrada/Post Pagina de entrada: single, postid-{ID} Pagina de una entrada : single-post Pagina de una

Pagina de una entrada: single-post

Pagina de una entrada personalizada/tipo: single-{posttype}

*Formatos de entradas (Si soporta):

Entrada con formato asignado: single-format-{format}

Entrada con formato no asignado: single-format-standard

Pagina Fija: attachment, single-attachment, attachmentid-{ID}, attachment-mime-type

Archivos
Archivos

Pagina de archivos: archive

Pagina de archivos por fecha: date

Pagina de archivos personalizada: post-type-archive, post-type-archive-{posttype}

Pagina del autor del archivo: archive, author, author-user_nicename

Pagina de categoria del archivo: archive, category, category-slug

Pagina del tag del archivo: archive, tag, tag-slug

Pagina de la taxonomia del archivo: tax-{taxonomy}, term-{term}, term-{ID}

Pagina del format del archivo: tax-post_format, term-post-format-{format}, term-{ID}

Paginas
Paginas

Pagina estatica: page, page-id-{ID}

Pagina jerárquica

Pagina padre: page-parent

Pagina hijo: page-child parent-pageid-{ID}

Pagina de la plantilla

page-template page-template-{directory}{filename}_php, Si se asigna una plantilla a la pagina personalizada, o page-template-default si no es asignada.

Buscador

Pagina del buscador de resultados: search

Resultados: search-results

No resultados: search-no-results

Multipaginas y Pagina de Entradas

Multipagina de paginas y entradas: paged, y cuando hay mas de 2 paginas paged-n.

Entrada de blog: single-paged-n

Pagina estatica: page-paged-n

Categoria del archivo: category-paged-n

Tag del archivo: tag-paged-n

Fecha del archivo: date-paged-n

Autor del archivo: author-paged-n

Pagina de buscador de resultados: search-paged-n

Archivos personalizados: post-type-paged-n

Pagina de error 404

Pagina de error 404: error404

Logged-in
Logged-in

Si el usuario esta logueado: logged-in

Direccion del texto

Si la direccion del texto es de derecha a izquierda "right-to-left": rtl

Background/Fondo personalizado

El selector de la clase para usar una imagen de fondo o color personalizada es:} custom-background

Barra de herramientas del Administrador /Toolbar Admin

Cuando el admin ingresa y se muestra la barra de herramientas: admin-bar, no-customize-support

esc_url()

Reemplaza a la obsoleta función clear_url(). Utilize siempre esta función para sanear y limpiar las url. Rechaza las urls que no cuentan con protocolos de lista blanca como ftp, http, https, ftps, mailto, irc. Esta función codifica los caracteres como entidades html, los caracteres de “hacking” como son los de unión y de valores ( ampersand y comillas simples, & ‘ ), los codifica a su entidad numérica (&#038, &#039).

Se encuentra en: wp-includes/formatting.php

Parametros:

<?php esc_url( $parametro1, $parametro2, $parametro3); ?>

$parametro1: (Obligatorio) La url a limpiar.

valor por defecto ninguno. $parametro2: (Opcional) Un array de protocolos aceptables, por default son: http,

https, ftp, ftps, mailto, irc, news, gopher, nntp, feed, telnet, siempre y cuando no especifique ningún valor. $parametro3: (Opcional) Como se usara la url. valor por defecto “display”.

Ejemplo I:

<a href=”<?php esc_url( site_url() ); ?>” title=”titulo del sitio”>link de la url del sitio</a>

HTML:

Se encuentra en el primer apartado dentro del <body></body>, regularmente se instancia para crear el link y el titulo del blog. En temas básicos viene en body -> #page -> #branding -> hgroup -> h1

home_url()

Esta función recupera la URL actual del sitio, y opcionalmente agregar argumentos al final de la ruta, puede usar get_home_url().

Se encuentra en: wp-includes/link-template.php

Parametros:

$parametro1: (opcional)(Tipo: cadena de texto) Cadena de texto que se agregara al final de la URL obtenida.

Ejemplo:

<?php home_url(); ?> // mostrara algo como http://misitio.com

Ejemplo II:

$url = home_url(‘/css/’); echo $url; //imprimirá algo como http://misitio.com/css/

HTML:

No tiene ruta especifica, pero la encuentras como parámetro en la mayoría de casos dentro de la función anterior “esc_url()”.

esc_attr()

Codifica los caracteres de los valores que mostrara en los atributos como “alt, title, value”, etc; Para que nunca se repitan entidades html.

Se encuentra en: wp-includes/formatting.php

Parametros:

esc_attr( $parametro );

$parametro: (obligtorio) (Tipo: cadena texto) La cadena a codificar.

Ejemplo:

$valor = ‘<a title=”hola”>Contengo caracteres raros y solo soy un valor</a>’; echo ‘ <img src=”#” alt=”$valor” /> ‘; //El “echo” mostrara un HTML descompuesto, por lo que usaremos la función para //convertir los caracteres “comillas”, “mayor que”, “menor que”, estos: <>” echo ‘ <img src=”#” alt=” esc_attr($valor) ” /> ‘;

Y mostrara el siguiente HTML. Y así el resultado en el navegador será el deseado .

<img src=”#” alt=”‘&#000;a title=&#059;hola&#059;&#000;Contengo caracteres raros y solo soy un

valor&#000;/a&#059;&#000;/>

HTML:

Dentro de “header.php” lo encontraremos codificando el valor del attributo “title=” del elemento <a> que se encuentra en #page -> #branding -> hgrupo -> h1 -> span -> a

get_header_image()

Recupera la imagen de cabecera, cuando se establece un encabezado personalizado, si no hay cabecera seleccionada, retornara un valor vacio.

Se encuentra en: wp-includes/theme.php

Puede modificar el encabezado o bien seleccionar la opción de “remover encabezado”, en el panel de administración desde Apariencia Cabecera.

Ejemplo:

<?php $image = get_header_image(); ?>

<div id=”cabecera”><img src=”<?php echo $image; ?>” /></div>

HTML:

Generalmente lo encontraremos como parte de una condición “if”, en “header.php”.

has_post_thumbnail()

A su traducción al español “Tiene la entrada imagen miniatura”, esta función requiere de un parámetro opcional, y su función es chequear si alguna entrada (post), tiene una imagen principal/imagen destacada.

Se encuentra en: wp-includes/post-thumbnail-template.php

Su valor por default es: el ID de la entrada (post) actual.

Parametros:

$parametro1: (opcional)(Tipo: Entero) El ID del post al que hara la consulta, normalmente se usa la variable globlal $post, ejemplo $post -> ID.

Ejemplo:

if ( has_post_thumbnail($post->ID) ) { the_post_thumbnail(); // mostrara la imagen del post actual

}

HTML:

Lo encontraremos aun dentro del <header>, es parte de un algoritmo para mostrar la imagen de cabecera.

the_post_thumbnail()

Muestra la imagen miniatura de la entrada (post) en el que actualmente estamos. Puede considerar usar get_the_post_thumbnail().

Se encuentra en: wp-includes/post-thumbnail-template.php

Parametros:

the_post_thumbnail($tamano, $atributos);

$tamano: (opcional)(Tipo: cadena de texto o array) palabra clave para el tamaño de

imagen (thumbnail, medium, large, post-thumbnail, full), o palabra clave personalizada con add_image_size(), o bien un array de dos valores, que indican ancho y alto en pixeles, ejemplo: array(32,32). $atributos: (opcional)(tipo: array) Especificar un array detallado con atributo/valor, ejemplo: array(“src” => $url, “alt” => “textoalternativo”, “class” => “img-thumbnail”).

Ejemplo:

<?php the_post_thumbnail(“large”); ?>

HTML:

Se encuentra dentro del <header> en el archive “header.php”.

get_the_post_thumbnail()

Obtiene la foto principal o thumbnail de la entrada (post), devuelve el resultado envuelto en un elemento imagen de HTML <img>, de no haber ninguna imagen principal devolverá una cadena vacia “ ”.

Se encuentra en: wp-includes/post-thumbnail-template.php

Parametros:

get_the_post_thumbnail($id, $tamano, $atributos);

$id: (opcional) (tipo: Entero) El id del post que contiene la imagen principal.

$tamano: (opcional)(Tipo: cadena de texto o array) palabra clave para el tamaño

de imagen (thumbnail, medium, large, post-thumbnail, full), o palabra clave personalizada con add_image_size(), o bien un array de dos valores, que indican ancho y alto en pixeles, ejemplo: array(32,32). $atributos: (opcional)(tipo: array) Especificar un array detallado con atributo/valor, ejemplo: array(“src” => $url, “alt” => “textoalternativo”, “class” => “img-thumbnail”).

Ejemplo:

<?php get_the_post_thumbnail($post->ID); ?>

Ejemplo II:

<?php $pages = get_pages(array('child_of' => 1)); ?> <ul> <?php foreach ($pages as $page): ?> <li> <?php echo get_the_post_thumbnail($page->ID, 'thumbnail'); ?> <h1><?php echo $page->post_title; ?></h1> <?php echo $page->post_content; ?> </li> <?php endforeach; ?> </ul>

HTML:

Se encuentra dentro del <header> elemento de HTML 5.

wp_get_attachment_image_src()

Esta function devuelve un array con cuatro valores de la imagen (url, width, height, boleano), en este orden. El cuarto valor es un boleano, que devolverá true si la url es de una imagen redimencionada o false, si es de la original o no existe imagen.

Se encuentra en: wp-includes/media.php

Parametros:

wp_get_attachment_src($id, $tamano, $icono);

$id: (obligatorio)(tipo: entero) Id del post que adjunta los archivos.

$tamano: (opcional) (tipo:cadena texto o array) puede ser palabras claves como

(thumbnail, medium, large, post-thumbnail, full), o un array especificando ancho, alto. $icono: (opcional) (tipo: boleano) Especificar true o false para usar un icono para representar archivos adjuntos.

Ejemplo:

<?php

<img src="<?php echo $image[0];?>" width="<?php echo $image [1];?>" height="<?php echo $image[2];?>" />

$image = wp_get_attachment_image_src(16);

?>

HTML:

Se encuentra al igual que las anteriores funciones dentro de <header>.

get_post_thumbnail_id()

Devuelve el Id de la imagen asociada a la entrada (post), si no existe ningun thumbnail o imagen principal, esto devolvera una cadena vacia “ “. Y si no existe el Id de la entrada (post o mensaje) especificado, devolverá false.

Se encuentra en: wp-includes/post-thumbnail-templae.php

Por default es la entrada (post) actual.

Parametros:

get_post_thumbnail_id($id);

$id: (opcional) (tipo: entero) El id de la entrada (post).

Ejemplo:

Para extraer todos los archivos adjuntos de una entrada (pdf, video, audio, imágenes simples) usaremos get_posts()

$valores =array( “post_type”=> “attachment”, “post_parent” => $post->ID, “exclude” => get_post_thumbnail_id() //Aquí excluimos la imagen principal

);

$archivos = get_posts($valores);

NOTA:

Para saber mas acerca de la función get_posts(), visite este link:

http://codex.wordpress.org/Function_Reference/get_posts

HTML:

Se encuentra al igual que en las anteriores funciones dentro del <header>.

Constantes: HEADER_IMAGE_WIDTH / HEADER_IMAGE_HEIGHT

Constantes: HEADER_IMAGE_WIDTH

/

HEADER_IMAGE_HEIGHT

Las constantes son identificadores unicos para valores determinados o como su nombre lo dice “constantes” y no cambian durante la ejecucion del script o programa. Las constantes regularmente se escriben en MAYUSCULAS. Estas constantes especifican el ancho y el alto de la imagen de cabecera y las encontraremos dentro del archivo functions.php dentro de la ruta de nuestro tema, definidos mediante la función define().

Se encuentran en: wp-contents/themes/NOMBRE-TEMA/functions.php

Ejemplo:

define('HEADER_IMAGE_WIDTH', apply_filters('twentyeleven_header_image_width', 1000)); echo HEADER_IMAGE_WIDTH; //imprimira 1000

NOTA:

Para ver mas sobre este apartado de constantes de un tema personalizado y relacionados con thumbnails y headers, recomiendo ver mas sobre las funciones define(), apply_filters(), add_theme_support(), add_image_size(), set_post_thumbnail_size().

HTML:

No tiene ubicación especifica dentro de la estructura.

header_image()

Muestra la ruta de la imagen de cabecera y no tiene parámetros.

Se encuentra en: wp-includes/theme.php

Ejemplo:

<?php header_image(); ?>

HTML:

No tiene ubicación especifica en la estructura.

get_header_image()

Retorna una cadena con la URL de la imagen de cabecera, no admite parámetros. Retornara una cadena vacia si el tema no soporta imágenes de cabecera, o si el usuario ha seleccionado “Eliminar cabecera de imagen” en Apariencia cabecera.

Se encuentra en: wp-includes/theme.php

Ejemplo:

HTML:

No tiene ubicacion especifica en la estructura.

get_header_textcolor()

Retorna el valor del color del texto que esta sobre la cabecera, no admite parámetros.

Se encuentra en: wp-includes/theme.php

Ejemplo:

<?php echo get_header_textcolor(); ?>

HTML:

No tiene ubicación especifica dentro de la estructura.

get_search_form()

Muestra el formulario de búsqueda del archivo searchform.php de nuestro tema.

Se encuentra en: wp-includes/general-template.php

Ejemplo:

<?php get_search_form() ?>

NOTA:

Si el tema no contiene el archivo searchform.php, wordpress mostrara por default un formulario.

HTML:

Se encuentra a finales del archivo “header.php”.

wp_nav_menu()

Muestra un menú creado por el usuario en Apariencia menú. La función mostrara el menú que concuerde con el Id, o nombre, y que tenga al menos un ítem. De lo contrario, mostrara el primer menú que encuentre y que no esté vacio, en caso que no encuentre algún menú, el parámetro fallback_cb, llamara a la función wp_page_menu(), que es su valor por defecto, si ningun menu está asignado, se muestra el que contenga el ID mas bajo.

Se encuentra en: wp_includes/nav-menu-template.php

Parametros:

wp_nav_menu($array);

Ejemplo:

//Los valores que aparecen, son los valores por default. $array = array( 'theme_location' => '', => '', => 'div', 'container_class' => '',

'menu'

'container'

'container_id'

=> '',

'menu_class'

=> 'menu',

'menu_id'

=> '',

'echo'

=> true,

'fallback_cb'

=> 'wp_page_menu',

'before'

=> '',

'after'

=> '',

'link_before'

=> '',

'link_after'

=> '',

'items_wrap'

=> '<ul id="%1$s" class="%2$s">%3$s</ul>',

'depth'

=> 0,

'walker'

=> ''

);

theme_location: (opcional)(Tipo:cadena texto) La ubicación en el tema,

“<ul id=’%1$s’ class=’%2$s’>%3$s</ul>”.

previamente debio ser registrado con la función register_nav_menu(). menu: (opcional)(Tipo: cadena texto) El menú que desea, acepta etiqueta, nombre

o id. container: (opcional)(Tipo: cadena texto) Contenedor para envolver el menú

<ul></ul>, admite las etiquetas <div> y <nav>, si no desea contenedores, declare ‘container’ => false. container_class: (opcional)(Tipo: cadena texto) La clase que se asignara al

contenedor, por default asigna “menu-{slug name}-container”. container_id: (opcional)(Tipo: cadena texto) El ID que se asignara al contenedor.

menu_class: (opcional)(Tipo:cadena texto) Clase que se le asignara a la etiqueta

<ul> que envuelve los ítems del menú, se pueden asignar multiples clases separadas con un espacio. menu_id: (opcional)(Tipo: cadena texto) Id que se asingara a la etiqueta <ul>, por

defecto asignar “#menu-{slug name}”, y si hay multiples menus, asigna “#menu- {slug name}-1”, “#menu-{slug name}-2” y asi sucesivamente. echo: (opcional)(Tipo: boleano) True para imprimir el menú o false para retornarlo.

fallback_cb: (opcional)(Tipo: cadena texto) Si el menú no existe, la función

asignada a este parámetro realizara la acción, por default es: wp_page_menu. before: (opcional)(Tipo: cadena texto) texto que se mostrara antes de la etiqueta

<a>. after: (opcional)(Tipo: cadena texto) texto que se mostrara después de la etiqueta

</a>. link_before: (opcional)(Tipo: cadena texto) Texto que se mostrara antes del link.

link_after: (opcional)(Tipo: cadena texto) Texto que se mostrara después del link.

items_wrap: (opcional)(Tipo: cadena texto) formato de los argumentos como la

expresión sprintf(). Incorpora los parámetros en el siguiente orden: %1$s para menú_id, %2$s para menu_class y %3$s para la lista de items. Su valor por defecto es la siguiente cadena:

depth: (opcional)(Tipo: entero) Los niveles jerárquicos que se mostraran, 0 es

todos, 1 es solo una plana. Por default es 0. walker: (opcional)(Tipo: objeto) Objeto personalizado a usar, por default es:

new walker_nav_menu.

Ejemplo II:

<?php wp_nav_menu(); ?>

Ejemplo III:

Especificando un menu.

<?php wp_nav_menu(arrar(‘menu’=>’nombreMenu’)); ?>

Ejemplo IV:

<? wp_nav_menu(array( 'container_class'=>'menu-header', 'theme_location'=>'primary')); ?>

HTML:

Se encuentra al final del archive “header.php”.

TALLER PRÁCTICO.

MODIFICANDO Y PERSONALIZANDO EL HEADER DE WORDPRESS.