word press kurosaki 2014

27

Upload: johnkurosaki

Post on 31-Dec-2015

50 views

Category:

Documents


3 download

TRANSCRIPT

Page 1: Word Press Kurosaki 2014
Page 2: Word Press Kurosaki 2014

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

Page 3: Word Press Kurosaki 2014

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”

Page 4: Word Press Kurosaki 2014

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

Page 5: Word Press Kurosaki 2014

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.

Page 6: Word Press Kurosaki 2014

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

Page 7: Word Press Kurosaki 2014

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

Page 8: Word Press Kurosaki 2014

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”,);

Page 9: Word Press Kurosaki 2014

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”);

?>

Page 10: Word Press Kurosaki 2014

//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’;}

Page 11: Word Press Kurosaki 2014

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

Page 12: Word Press Kurosaki 2014

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.

Page 13: Word Press Kurosaki 2014

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

Page 14: Word Press Kurosaki 2014

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

Page 15: Word Press Kurosaki 2014

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.

Page 16: Word Press Kurosaki 2014

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”.

Page 17: Word Press Kurosaki 2014

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);

Page 18: Word Press Kurosaki 2014

� $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”).

Page 19: Word Press Kurosaki 2014

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.

Page 20: Word Press Kurosaki 2014

� $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

Page 21: Word Press Kurosaki 2014

);

$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

Page 22: Word Press Kurosaki 2014

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(); ?>

Page 23: Word Press Kurosaki 2014

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.

Page 24: Word Press Kurosaki 2014

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' => ''

);

Page 25: Word Press Kurosaki 2014

� 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.

Page 26: Word Press Kurosaki 2014

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”.

Page 27: Word Press Kurosaki 2014

TALLER PRÁCTICO.

MODIFICANDO Y PERSONALIZANDO EL HEADER DE WORDPRESS.