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
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: » (»)
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;
?>
HTML:
Se encuentra dentro del <title></title> dentro de una condicional para mostrar la
descripción del blog en el titulo <title>, o no.
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(“[email protected]”, “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>.
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
Pagina de entrada: single, postid-{ID}
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
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
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
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 (&, ').
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=”‘�a title=;hola;�Contengo caracteres raros y solo soy un
valor�/a;�/>
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 $image = wp_get_attachment_image_src(16); ?>
<img src="<?php echo $image[0];?>" width="<?php echo $image [1];?>" height="<?php echo $image[2];?>" />
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
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:
<?php echo get_header_image(); ?>
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' => '',
'menu' => '',
'container' => 'div',
'container_class' => '',
'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,
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:
“<ul id=’%1$s’ class=’%2$s’>%3$s</ul>”.
� 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.