Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

es:Formatos de Entrada

This page is marked as incomplete. You can help Codex by expanding it.

Intro

Formatos de Entrada es una Características para Temas introducida en la Version 3.1. Un formato de entrada es una pieza de meta-información que puede ser usada por un tema para personalizar la presentación de una entrada. La función de formatos de entrada proporciona una lista estandarizada de formatos que están disponibles para todos los temas que soportan esta característica. No es necesario que los temas soporten cada uno de los formatos de la lista. No se pueden introducir nuevos formatos a través de temas ni plugins. La estandarización de esta lista proporciona compatibilidad entre los numerosos temas, y una vía para que las herramientas externas de blogging puedan acceder a esta función de una manera coherente.

En resumen, con un tema que admite los formatos de entrada, un blogger puede cambiar la apariencia de cada entrada eligiendo un Formato de Entrada de la lista.

Usando Asides por ejemplo, anteriormente se creaba una categoría llamada Asides, las entradas se asignaban a esa categoría, y se mostraban de forma diferente basándose en reglas de estilo de post_class() o de in_category('asides'). Con Formatos de Entrada, este nuevo enfoque permite añadir soporte para Formatos de Entrada a un tema (p.e. add_theme_support('post-formats', array('aside'))), entonces el formato de entrada puede ser seleccionado en la pantalla de edición de la entrada. Luego, una llamada a la función get_post_format($post->ID) permite determinar el formato de la entrada, y en cualquier caso post_class() creará la clase "format-asides", para cambiar el estilo puramente por css.

Formatos Soportados

Los siguientes Formatos de Entrada están disponibles para elegir, si el tema activa soporte para ellos.

  • aside - Típicamente se muestra sin un título.
  • gallery - Una galería de imágenes. La entrada contendría un shortcode gallery e imágenes adjuntas.
  • link - Un enlace a otro sitio. Los temas pueden usar el primer tag <a href=””> en el contenido como enlace externo para ese artículo. Una forma diferente sería que el artículo consistiera de solo una URL (que sería dónde se enlaza), y el título (que sería el nombre del enlace).
  • image - Una sola imagen. El primer tag <img /> en la entrada podría ser considerada la imagen. Alternativamente, si la entrada consiste de una URL, esa podría ser la URL de la imagen, y el título de la entrada podría ser el título de la imagen.
  • quote - Una cita. Probablemente contenga un blockquote conteniendo la entrada. Alternativamente, la cita podría ser solo el contenido, siendo la fuente o el autor el título de la entrada.
  • status - Una pequeña actualización de estado, similar a una actualización de estado de Twitter.
  • video - Un vídeo. El primer tag <video /> o el primer object/embed en la entrada podría ser considerador el vídeo. De forma alternativa, si la entrada consiste solo de una URL, esa sería la URL del vídeo. Podría incluso contener el vídeo como un adjunto la entrada si existe soporte para vídeo en el blog.
  • audio - Un archivo de audio. Puede ser usado para Podcasting.
  • chat - Una trascripción de chat, como por ejemplo:
Juan: foo
María: bar
Juan: foo 2

Nota: Al escribir o editar una Entrada, Estándar se utiliza para indicar que no se especifica el formato de entrada. Además, si se especifica un formato que no es válido entonces estándar (sin formato) se utilizará.

Referencia de funciones

Main Functions
Other Functions

Añadiendo soporte al Tema

Los temas necesitan usar add_theme_support() en el archivo functions.php para indicar a WordPress qué formatos de entrada soporta, pasándole una lista de formatos, tal y como:

add_theme_support( 'post-formats', array( 'aside', 'gallery' ) );

Nota: ¡Debes llamar a esta función antes de que el gancho init sea llamado! Un buen gancho para usar es after_setup_theme.


Retrocompatibilidad

Si tu plugin o tema necesita ser compatible con versiones anteriores de WordPress, tendrás que añadir a la taxonomía "post-format" un elemento llamado $format. Por ejemplo:

wp_insert_term( 'post-format-aside', 'post_format' );

También tendrás que registrar la taxonomía post_format taxonomy con register_taxonomy().


Archivo fuente

Recursos Externos

Relacionado

Post Formats: set_post_format(), get_post_format(), has_post_format(), get_post_format_link(), get_post_format_string(), the_post_format_audio(), get_the_post_format_media(), get_content_audio(), the_post_format_chat(), get_the_post_format_chat(), get_content_chat(), add_chat_detection_format(), the_post_format_gallery(), get_content_galleries(), get_post_gallery_images(), the_post_format_image(), get_the_post_format_image(), get_content_images(), the_post_format_quote(), get_the_post_format_quote(), get_content_quote(), the_post_format_url(), get_the_post_format_url(), get_content_url(), the_post_format_video(), get_content_video(), the_remaining_content(), get_the_remaining_content(), get_post_format_meta(), post_format_content_class(), get_post_format_content_class(), post_formats_compat()

Theme Support: add_theme_support(), remove_theme_support(), current_theme_supports()
Theme Features: sidebar, menus, post-formats, title-tag, custom-background, custom-header, custom-logo, post-thumbnails, automatic-feed-links, html5, editor-style, content_width