Advertisement
  1. Code
  2. WordPress

La guía de Tuts+ sobre las etiquetas de plantilla: octavo lote

by
Read Time:12 minsLanguages:
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: Seventh Batch
The Tuts+ Guide to Template Tags: Series Finale

Spanish (Español) translation by Eva Collados Pascual (you can also view the original English article)

En la octava parte de la serie, pasamos por el séptimo lote de etiquetas de plantilla de WordPress. En esta novena parte, vamos a revisar el último lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, veremos etiquetas de plantilla sobre marcadores y otras etiquetas de plantilla "misceláneas".

Advertencia sobre los marcadores: A partir de WordPress 3.5,de forma predeterminada, los "marcadores" están ocultos desde el panel de administración. Para trabajar con los marcadores, debes instalar el plugin Link Manager.

Obtener y mostrar una lista de marcadores: wp_list_bookmarks()

Esta etiqueta de plantilla devuelve o se hace eco de una lista de marcadores, una antigua característica de WordPress.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

  • $args (opcional: matriz):Una matriz de los siguientes argumentos:
    • 'orderby' (cadena): Cómo ordenar los marcadores. Acepta 'name', 'link_id', 'url', 'target', 'description', 'owner' (el usuario que añadió el marcador), 'rating', 'updated' (fechas de actualización), 'rel' (relación XFN de marcador), 'notes', 'rss', 'length' (longitud del nombre del marcador), 'rand' (aleatorio).(Predeterminado: 'nombre')
    • 'order' (cadena): Si se deben pedir artículos en orden ascendente ('ASC') o descendente ('DESC').(Predeterminado: 'ASC')
    • 'limit' (entero): Número de elementos que se mostrarán.(Predeterminado: -1 que significa todos los marcadores)
    • 'category' (cadena): ID de categoría separados por comas para obtener elementos.(Predeterminado: ' ' lo que significa todas las categorías)
    • 'exclude_category' (cadena): identificadores de categorías de marcadores a excluir.(Predeterminado: ' ')
    • 'category_name' (cadena): Un nombre de categoría desde la que mostrar marcadores (reemplaza 'category').(Predeterminado: ' ')
    • 'hide_invisible' (entero): Si deseas ocultar enlaces invisibles o mostrarlos.(Predeterminado: 1)
    • 'show_updated' (entero): Si se debe mostrar o no la última marca de tiempo actualizada.(Predeterminado: 0)
    • 'echo' (entero): Si deseas hacer eco de la salida (1) o devolverla (0).(Predeterminado: 1)
    • 'categorize' (entero): Si se deben agrupar marcadores por sus categorías (1) o no (0).(Predeterminado: 1)
    • 'title_li' (cadena): Envuelve la salida con una etiqueta <li> y muestra un título antes de la lista de marcadores. Probablemente desearas establecer esto en una cadena vacía y deshabilitar la envoltura.(Predeterminado: 'Marcadores')
    • 'title_before' (cadena): Código HTML a añadir antes de cada título.(Predeterminado: '<h2>')
    • 'title_after' (cadena): Código HTML para añadir después de cada título.(Predeterminado: '</h2>')
    • 'class' (cadena): Nombres de clase CSS a añadir a cada categoría.(Predeterminado: 'linkcat')
    • 'category_before' (cadena): Código HTML a añadir antes de cada categoría.(Predeterminado: '<li id=%id class=%class>')
    • 'category_after' (cadena): Código HTML a añadir después de cada categoría.(Predeterminado: '</li>')
    • 'category_orderby' (cadena): Cómo ordenar las categorías. Acepta 'name', 'id', 'slug' y 'count'.(Predeterminado: 'name')
    • 'category_order' (cadena): Si se deben ordenar categorías en orden ascendente ('ASC') o descendente ('DESC').(Predeterminado: 'ASC')

Uso

Obtener una matriz de todos los marcadores: get_bookmarks()

Esta etiqueta de plantilla devuelve una matriz de tus marcadores de WordPress.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

  • $args (opcional: matriz):Matriz de los siguientes argumentos:
    • 'orderby' (cadena): Cómo ordenar los enlaces. Acepta campos de post como 'name', 'ID', 'title', 'date', etc.(Predeterminado: 'name')
    • 'order' (cadena): Si se deben ordenar los elementos en orden ascendente ('ASC') o descendente ('DESC').(Predeterminado: 'ASC')
    • 'limit' (entero): Número de elementos que se mostrarán.(Predeterminado: -1 lo que significa todo)
    • 'category' (cadena): ID de categorías separados por comas para obtener elementos.(Predeterminado: Vacío)
    • 'category_name' (cadena): Nombre de la categoría de la que obtener elementos.(Predeterminado: Vacío)
    • 'hide_invisible' (entero o booleano): Si se debe mostrar u ocultar vinculado marcado como "invisible".(Predeterminado: 1|TRUE)
    • 'show_updated' (entero o booleano): si deseas mostrar la hora en la que se actualizó por última vez el marcador.(Predeterminado: 0|FALSE)
    • 'include' (cadena): Lista de ID separados por comas a incluir.(Predeterminado: Vacío)
    • 'exclude' (cadena): Lista de ID separados por comas que se van a excluir.(Predeterminado: Vacío)

Uso

Obtención de datos de marcadores: get_bookmark()

Esta etiqueta de plantilla devuelve todos los datos de un marcador determinado.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

  • $bookmark (obligatorio: mixto):El identificador u objeto del marcador.(Predeterminado: NULL)
  • $output (opcional: cadena):Constante OBJECT, ARRAY_N o ARRAY_A.(Predeterminado: OBJECT)
  • $filter (opcional: cadena):Si deseas escapar la salida o no. Si deseas filtrar la salida, establécelo en 'display'.(Predeterminado: 'raw')

Uso

Obtención de datos de un único marcador: get_bookmark_field()

Esta etiqueta de plantilla te permite obtener los datos del campo de un único marcador.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

  • $field (obligatorio: cadena):El nombre del campo.(Predeterminado: NULL)
  • $bookmark (obligatorio: entero):El identificador del marcador.(Predeterminado: NULL)
  • $context (opcional: cadena):Cómo filtrar el valor del campo, ya sea 'raw', 'edit', 'attribute', 'js', 'db' o 'display'.(Predeterminado: 'display')

Uso

Obtener y mostrar el enlace "Editar marcador": get_edit_bookmark_link() y edit_bookmark_link()

Estas etiquetas de plantilla te permiten obtener o hacer eco de un enlace "editar este marcador" para usarlo en tus plantillas.

Parámetros

get_edit_bookmark_link() solo acepta un parámetro:

  • $bookmark_id (obligatorio: entero):El identificador del marcador.(Predeterminado: 0)

Y edit_bookmark_link() acepta cuatro parámetros:

  • $text (opcional: cadena):Texto para mostrar el enlace.(Predeterminado: 'Editar esto')
  • $before (opcional: cadena):El texto o el código HTML que se va a mostrar antes de la salida.(Predeterminado: Vacío)
  • $after (opcional: cadena):El texto o el código HTML que se mostrará después de la salida.(Predeterminado: Vacío)
  • $bookmark_id (obligatorio: entero):El identificador del marcador.(Predeterminado: NULL)

Uso

Cómo obtener y mostrar la información de tu sitio: get_bloginfo() y bloginfo()

Estas etiquetas de plantilla extremadamente populares devuelven y muestran la información general de tu sitio.

Parámetros

get_ bloginfo() acepta dos parámetros:

  • $show (opcional: cadena):El fragmento de información a buscar. Uno de los siguientes valores:
    • 'url' (cadena): La URL de inicio.
    • 'wpurl' (cadena): La URL donde está instalado WordPress.
    • 'description' (cadena): Descripción del sitio.
    • 'rdf_url' (cadena): La URL del feed RDF/RSS 1.0.
    • 'rss_url' (cadena): La URL del feed RSS 0.92.
    • 'rss2_url' (cadena): La URL del feed RSS 2.0.
    • 'atom_url' (cadena): La URL del feed Atom.
    • 'comments_rss2_url' (cadena): La URL del feed RSS 2.0 para los comentarios.
    • 'comments_atom_url' (cadena): La URL del feed Atom para los comentarios.
    • 'pingback_url' (cadena): La dirección URL del archivo XML-RPC de pingback.
    • 'stylesheet_url' (cadena): La URL del archivo CSS principal del tema.
    • 'stylesheet_directory' (cadena): La URL del directorio principal del archivo CSS del tema.
    • 'template_directory' o 'template_url' (cadena): La dirección URL del directorio del tema activo.
    • 'admin_email' (cadena): La dirección de correo electrónico introducida cuando se instaló WordPress.
    • 'charset' (cadena): Juego de caracteres del sitio.
    • 'html_type' (cadena): El tipo de contenido de las páginas HTML de WordPress.
    • 'version' (cadena): Versión de WordPress.
    • 'language' (cadena): Idioma de la instalación de WordPress.
    • 'text_direction' (cadena): Dirección del texto del idioma.
    • 'name' (cadena): Nombre del sitio.
    (Predeterminado: 'name')
  • $filter (opcional: cadena):Establécelo en 'filter' para filtrar la dirección URL devuelta de esta etiqueta de plantilla.(Predeterminado: 'raw')

Y bloginfo() solo acepta un parámetro:

  • $show (opcional: cadena):Los mismos detalles que los anteriores.(Predeterminado: 'blogname')

Uso

Obtener y mostrar clases de <body> automáticas: get_body_class() y body_class()

Estas populares etiquetas de plantilla generan clases semánticas y nos permiten hacer eco de las mismas o devolverlas. También nos permiten agregar nombres de clase adicionales.

Parámetros

Ambas etiquetas de plantilla aceptan únicamente un parámetro:

  • $class (opcional: cadena o matriz):Nombres de clase CSS adicionales para añadir.(Predeterminado: Vacío)

Uso

Obtener y mostrar un menú de navegación: wp_nav_menu()

Esta etiqueta de plantilla devuelve o muestra menús de navegación, una característica central de WordPress. Puedes ver esta etiqueta de plantilla en, probablemente, todos los nuevos temas de WordPress lanzados en 2013 y en adelante.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

  • $args (opcional: matriz):Matriz de los siguientes argumentos:
    • 'menu' (cadena): El ID, slug o nombre del menú.(Predeterminado: Vacío)
    • 'menu_class' (cadena): Clase CSS del elemento UL del menú.(Predeterminado: 'menu')
    • 'menu_id' (cadena): El ID del elemento UL del menú.(Predeterminado: Slug del menú, incrementado)
    • 'container' (cadena): Si se va a envolver el UL y con qué envolverlo.(Predeterminado: DIV)
    • 'container_class' (cadena): Clase CSS del elemento contenedor.(Predeterminado: 'menu-{slug del menu}-container')
    • 'container_id' (cadena): El identificador del elemento contenedor.(Predeterminado: Vacío)
    • 'fallback_cb' (llamada o booleano): Nombre de una función de reserva que se ejecutará si el menú no existe. Establécelo en false para que no exista función alternativa.(Predeterminado: 'wp_page_menu')
    • 'before' (cadena): Texto antes del texto del enlace.(Predeterminado: Vacío)
    • 'after' (cadena): Texto después del texto del enlace.(Predeterminado: Vacío)
    • 'link_before' (cadena): Texto antes del enlace.(Predeterminado: Vacío)
    • 'link_after' (cadena): Texto después del enlace.(Predeterminado: Vacío)
    • 'echo' (booleano): Si deseas hacer eco de la etiqueta de plantilla o no.(Predeterminado: TRUE)
    • 'depth' (entero): Cuántos niveles de jerarquía deben incluirse.(Predeterminado: 0, lo que significa todos los niveles)
    • 'walker' (objeto): Instancia de una clase de walker personalizado.(Predeterminado: Vacío)
    • 'theme_location' (cadena): Ubicación del tema que se va a utilizar. Debe estar registrado con register_nav_menu() para poder ser seleccionable por el usuario.(Predeterminado: Vacío)
    • 'items_wrap' (cadena): Cómo deben ajustarse los elementos de la lista.(Predeterminado: <ul id="%1$s" class="%2$s">%3$s</ul>)

Uso

Obtener y mostrar títulos de página: wp_title()

Esta etiqueta de plantilla devuelve o se hace eco del título de página de tus páginas.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

  • $sep (opcional: cadena):Texto que se utilizará como separador.(Predeterminado: '&raquo;')
  • $echo (opcional—booleano):Si se debe hacer eco (TRUE) o devolver (FALSE) la etiqueta.(Predeterminado: TRUE)
  • $seplocation (opcional: cadena):Posición del separador y dirección de la miga de pan. Establécelo en 'right' para invertir la miga de pan.(Predeterminado: Vacío)

Uso

Obtener y mostrar la URL de inicio: get_home_url() y home_url()

Estas etiquetas de plantilla simplemente devuelven la URL de inicio.

Parámetros

get_home_url() acepta tres parámetros:

  • $blog_id (opcional: entero):El ID del blog.(Predeterminado: NULL)
  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):Esquema para dar contexto a la url de inicio ('http', 'https' o 'relative').(Predeterminado: NULL)

Y home_url() acepta dos parámetros:

  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):Esquema para dar contexto a la url de inicio ('http', 'https' o 'relative').(Predeterminado: NULL)

No confundas estas dos funciones, ya que "una devuelve la salida y la otra la muestra", lo sé porque lo probé. La diferencia es un poco extraña: mientras la función get_home_url() devuelve la URL de inicio de un blog específico, la función home_url() devuelve la URL de inicio del sitio actual. Recuerda: ¡Ninguno de ellos se hace eco de nada!

Uso

Obtener y mostrar la URL del sitio: get_site_url() & site_url()

Estas etiquetas de plantilla obtienen y hacen eco de la "URL del sitio", la dirección donde está instalado WordPress.

Parámetros

get_site_url() acepta tres parámetros:

  • $blog_id (opcional: entero):El ID del blog.(Predeterminado: sitio actual)
  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):Esquema para dar contexto a la url de inicio ('http', 'https' o 'relative').(Predeterminado: Conexión normal o segura, dependiendo de is_ssl())

Y site_url() acepta dos parámetros:

  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):Esquema para dar contexto a la url de inicio ('http', 'https' o 'relative').(Predeterminado: Conexión normal o segura, dependiendo de is_ssl())

Al igual que con home_url() y get_home_url(), no confundas estas dos funciones como "una devuelve la salida y la otra la muestra". Mientras que la función get_site_url() devuelve la dirección URL del sitio de un blog específico, la función site_url() devuelve la URL del sitio actual. Recuerda: ¡Ninguno de ellos hace eco de nada!

Uso

Obtención del ID del sitio actual: get_current_blog_id()

Esta etiqueta de plantilla simplemente devuelve el ID del sitio actual dentro de la red multisitio a la que pertenece.

Parámetros

Esta etiqueta de plantilla no acepta ningún parámetro.

Uso

Obtener y mostrar la URL del Panel de administración: get_admin_url() y admin_url()

Estas etiquetas de plantilla devuelven y muestran una dirección URL del Escritorio de tu sitio web.

Parámetros

get_admin_url() acepta tres parámetros:

  • $blog_ID (opcional: entero):El ID del blog.(Predeterminado: Current site)
  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):El esquema a utilizar. 'admin' respeta el esquema definido (con la función is_ssl()) pero puedes anularlo estableciendo este parámetro. Acepta 'http', 'https', 'admin', 'rpc', 'login' y 'login_post'.(Predeterminado: 'admin')

Y admin_url() acepta dos parámetros:

  • $path (opcional: cadena):Ruta de acceso opcional para anexar a la dirección URL.(Predeterminado: Vacío)
  • $scheme (opcional: cadena):El esquema a utilizar. 'admin' respeta el esquema definido (con la función is_ssl()) pero puedes anularlo estableciendo este parámetro en 'http' o 'https'.(Predeterminado: 'admin')

Uso

Obtener y mostrar el permalink de un tipo de feed: get_feed_link() y the_feed_link()

Estas etiquetas de plantilla devuelven y generan el enlace permanente de un feed.

Parámetros

get_feed_link() solo acepta un parámetro:

  • $feed_type (opcional: string):Tipo de feed.(Predeterminado: Tipo de feed predeterminado)

Y the_feed_link() acepta dos parámetros:

  • $anchor (obligatorio: cadena):Texto que se mostrará para el enlace.(Predeterminado: NULL)
  • $feed_type (opcional: string):Tipo de feed.(Predeterminado: Tipo de fuente predeterminada)

Uso

Hacer que la cadena termine con o sin una barra diagonal final: user_trailingslashit()

Esta etiqueta de plantilla comprueba tu estructura de permalinks y añade una barra diagonal final o quita la barra diagonal final existente al final de la dirección URL especificada.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

  • $string (obligatorio: cadena):La dirección URL con o sin una barra diagonal final.(Predeterminado: NULL)
  • $type_of_url (obsoleto: string):Esto no está técnicamente en desuso, pero no se utiliza en la función, por lo que no tiene ningún efecto.

Uso

Obtención del número de días desde el inicio de la semana: calendar_week_mod()

Esta extraña etiqueta de plantilla obtiene el número de días desde el comienzo de la semana. Es básicamente una "operación modulo".

Sinceramente, no sé cómo usar esto o por qué usarlo. Si sabes por qué existe esta etiqueta de plantilla, ¡lanza un comentario para informarme a mí y a nuestros lectores!

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

  • $number (obligatorio: entero):Días desde el comienzo de la semana.(Predeterminado: 0)

Uso

Obtener y mostrar el calendario: get_calendar()

¿Recuerdas los calendarios que solíamos colocar en las barras laterales de nuestros blogs? Esta etiqueta de plantilla hace exactamente eso: devuelve o muestra el calendario.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

  • $initial (opcional: booleano):Utiliza nombres de calendario iniciales (TRUE) o no (FALSE).(Predeterminado: TRUE)
  • $echo (opcional: booleano):Si se hace eco (TRUE) o devuelve (FALSE) la salida.(Predeterminado: TRUE)

Uso

Conclusión

Espero que te haya gustado este último lote de etiquetas de plantilla. En la siguiente parte, el final de la serie, vamos a revisar lo que aprendimos y terminaremos la serie.

Si tienes alguna pregunta, comentario o corrección, puedes compartir tus pensamientos con nosotros en la siguiente sección de comentarios. Y si te gustó el artículo, ¡no te olvides de compartirlo con tus amigos!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.