Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress

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

by
Difficulty:BeginnerLength:MediumLanguages:
This post is part of a series called The Tuts+ Guide to Template Tags.
The Tuts+ Guide to Template Tags: Third Batch
The Tuts+ Guide to Template Tags: Fifth Batch

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

En la cuarta parte de la serie, revisamos el tercer lote de etiquetas de plantilla de WordPress. En esta quinta parte, vamos a ver el cuarto lote de las casi 200 etiquetas de plantilla. A lo largo del tutorial, volveremos a ver etiquetas de plantilla sobre comentarios, al igual que el lote anterior.

Cómo obtener y mostrar un enlace a la sección "Comentarios": get_comments_link() y comments_link()

Estas etiquetas de plantilla devuelven y muestran el enlace a la sección "Comentarios" de la entrada.

Parámetros

comments_link() no acepta ningún parámetro, pero get_comments_link() acepta uno:

  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)

Uso

Cómo obtener y mostrar la lista de comentarios: wp_list_comments()

Esta popular etiqueta de plantilla enumera los comentarios que han sido enviados a una entrada.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

  • $args (opcional, matriz):Matriz de los argumentos siguientes:
    • 'walker' (objeto): Instancia de una clase Walker para enumerar comentarios.(Predeterminado: NULL)
    • 'max_depth' (entero): La profundidad máxima de los comentarios.(Predeterminado: Vacío)
    • 'style' (cadena): El estilo de orden de lista ('ul' o 'ol').(Predeterminado: 'ul')
    • 'callback' (cadena): Función de devolución de llamada que se va a utilizar.(Predeterminado: NULL)
    • 'end-callback' (cadena): Función de devolución de llamada que se usará al final.(Predeterminado: NULL)
    • 'type' (cadena): Tipo de comentarios a enumerar ('all', 'comment', 'pingback', 'trackback' o 'pings').(Predeterminado: 'all')
    • 'page' (entero): ID de página para el que enumerar los comentarios.(Predeterminado: Vacío)
    • 'per_page' (entero): Número de comentarios que se pueden enumerar por página.(Predeterminado: Vacío)
    • 'avatar_size' (entero): Dimensiones de las imágenes de avatar.(Predeterminado: 32)
    • 'reverse_top_level' (cadena): Ordenación de los comentarios enumerados ('desc' o 'asc').(Predeterminado: NULL)
    • 'reverse_children' (booleano): Si deseas invertir los comentarios secundarios en la lista.(Predeterminado: Vacío)
    • 'format' (cadena): Cómo formatear la lista de comentarios.(Predeterminado: 'html5' si el tema admite el marcado HTML5, de lo contrario 'xhtml')
    • 'short_ping' (booleano): Si se da salida a los pings cortos.(Predeterminado: FALSE)
    • 'echo' (booleano): Si deseas hacer eco de la salida (TRUE) o devolverla (FALSE).(Predeterminado: TRUE)
  • $comments (opcional, matriz):Matriz de objetos de comentario.(Predeterminado: Todos los comentarios del post actual)

Uso

Cómo obtener y mostrar el número de comentarios: get_comments_number() y comments_number()

Estas etiquetas de plantilla obtienen y muestran cuántos comentarios se publican en el post.

Parámetros

get_comments_number() solo acepta un parámetro:

  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)

Y comments_number() acepta tres parámetros:

  • $zero (opcional, cadena):Texto a mostrar si no hay comentarios.(Predeterminado: 'Sin comentarios')
  • $one (opcional, cadena):Texto a mostrar si solo hay un comentario.(Predeterminado: '1 Comentario')
  • $more (opcional, cadena):Texto a mostrar si hay más de un comentario.(Predeterminado: '% Comentarios')

Uso

Cómo obtener y mostrar clases automáticas para cada comentario: get_comment_class() y comment_class()

Estas etiquetas de plantilla te permiten añadir clases semánticas generadas en donde quieras en el bucle de comentarios.

Parámetros

get_comment_class() acepta tres parámetros:

  • $class (opcional, cadena o matriz):Nombres de clase adicionales para añadir.(Predeterminado: Vacío)
  • $comment_ID (opcional, entero):El ID del comentario con el que trabajar.(Predeterminado: ID del comentario actual)
  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)

Y comment_class() acepta cuatro parámetros:

  • $class (opcional, cadena o matriz):Nombres de clase adicionales a añadir.(Predeterminado: Vacío)
  • $comment_ID (opcional, entero):El ID del comentario con el que trabajar.(Predeterminado: ID del comentario actual)
  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)
  • $echo (opcional, booleano):Si hacer echo (TRUE) o devolver (FALSE) la etiqueta.(Predeterminado: TRUE)

Uso

Mostrar el formulario de comentarios: comment_form()

Esta etiqueta de plantilla muestra todo el formulario de comentarios.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

  • $args (opcional, matriz):Matriz de los argumentos siguientes:
    • 'fields' (array): Una matriz asociativa de códigos HTML de campos de comentario predeterminados ('autor', 'email' y 'url').(Predeterminado: Los tres)
    • 'comment_field' (cadena): Código HTML para el elemento TEXTAREA del comentario.
    • 'must_log_in' (cadena): Código HTML para el mensaje "debes iniciar sesión para comentar".
    • 'logged_in_as' (cadena): Código HTML para el mensaje "Sesión iniciada como...". (Utiliza %1$s para la dirección URL del perfil, %2$s para el nombre de usuario y %3$s para la dirección URL de cierre de sesión.)
    • 'comment_notes_before' (cadena): Código HTML para las notas mostradas antes del formulario de comentario.
    • 'comment_notes_after' (cadena): Código HTML para las notas que se muestran después del formulario de comentario.
    • 'id_form' (cadena): El identificador del elemento FORM del formulario de comentario.
    • 'id_submit' (cadena): El ID del botón de envío.
    • 'name_submit' (cadena): El parámetro NAME del botón de envío.
    • 'title_reply' (cadena): Etiqueta para el botón "Deja una respuesta".
    • 'title_reply_to' (cadena): Etiqueta para el botón "Dejar una respuesta a %s".
    • 'cancel_reply_link' (cadena): Texto del enlace "Cancelar respuesta".
    • 'label_submit' (cadena): Etiqueta para el botón "Publicar comentario".
    • 'format' (cadena): El formato del formulario de comentario ('xhtml' o 'html5', el valor predeterminado es 'xhtml').
  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)

Uso

Mostrar un título para el formulario de comentario: comment_form_title()

Esta etiqueta de plantilla se hace eco de un título dinámico para el formulario de comentario.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

  • $noreplytext (opcional, cadena):Texto del enlace si no es un enlace de "responder al comentario".(Predeterminado: 'Dejar una respuesta')
  • $replytext (opcional, cadena):Texto del enlace si se trata de un enlace de "responder al comentario".(Predeterminado: 'Dejar una respuesta a %s')
  • $linktoparent (opcional, booleano):Si vincular el nombre del comentarista a su comentario o no.(Predeterminado: TRUE)

Uso

Cómo mostrar el enlace "Responder al comentario": get_comment_reply_link() y comment_reply_link()

Estas etiquetas de plantilla te permiten devolver o mostrar un enlace de respuesta para el comentario dado.

Parámetros

Ambas etiquetas de plantilla aceptan tres parámetros:

  • $args (opcional, matriz):Matriz de los argumentos siguientes:
    • 'add_below' (cadena): La primera parte del selector utilizado para identificar el comentario que se va a responder a continuación. El valor resultante se pasa como el primer parámetro a addComment.moveForm(), concatenado como $add_below-$comment->comment_ID.(Predeterminado: 'comment')
    • 'respond_id' (cadena): Selector que identifica el comentario de respuesta. Se pasa como tercer parámetro a addComment.moveForm() y se anexa a la dirección URL del enlace como un valor hash.(Predeterminado: 'respond')
    • 'reply_text' (cadena): Texto del enlace 'Responder'.(Predeterminado: 'Responder')
    • 'login_text' (cadena): Texto del enlace para responder si se ha cerrado la sesión.(Predeterminado: 'Iniciar sesión para responder')
    • 'depth' (entero): Profundidad del nuevo comentario: debe ser mayor que 0 y menor que el valor de la opción 'thread_comments_depth' establecido en Ajustes > Comentarios.(Predeterminado: 0)
    • 'before' (cadena): Código HTML a añadir antes de la salida.(Predeterminado: Vacío)
    • 'after' (cadena): Código HTML a añadir después de la salida.(Predeterminado: Vacío)
  • $comment_ID (opcional, entero):El ID del comentario con el que trabajar.(Predeterminado: ID del comentario actual)
  • $post_ID (opcional, entero u objeto):El ID del post.(Predeterminado: Post actual)

Uso

Obtener y mostrar los campos ocultos del formulario "Responder al comentario": get_comment_id_fields() y comment_id_fields()

Estas etiquetas de plantilla hacen eco o devuelven los campos input ocultos y obligatorios de un enlace "respuesta al comentario".

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

  • $post_ID (opcional, entero):El ID del post.(Predeterminado: ID del post actual)

Uso

Cómo mostrar y mostrar el enlace "Cancelar respuesta": get_cancel_comment_reply_link() y cancel_comment_reply_link()

Estas etiquetas de plantilla devuelven o se hacen eco de un vínculo "Cancelar respuesta" para usar con el formulario de respuesta de comentario.

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

  • $text (opcional, cadena):Texto a mostrar en el enlace "cancelar respuesta".(Predeterminado: "Haz clic aquí para cancelar la respuesta.")

Uso

Obtener y mostrar el enlace para "Siguientes comentarios": get_next_comments_link() y next_comments_link()

Estas etiquetas de plantilla devuelven o imprimen el enlace "Siguientes comentarios" en la sección de Comentarios de tu tema.

Parámetros

Ambas etiquetas de plantilla aceptan dos parámetros:

  • $label (opcional, cadena):Texto que se mostrará para el enlace.(Predeterminado: 'Comentarios más recientes »')
  • $max_page (opcional, entero):Máximo numero de páginas.(Predeterminado: 0)

Uso

Obtener y mostrar el enlace para "Comentarios anteriores": get_previous_comments_link() y previous_comments_link()

Estas etiquetas de plantilla devuelven o imprimen el enlace "comentarios anteriores" en la sección de Comentarios de tu tema.

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

  • $label (opcional, cadena):Texto que se mostrará para el enlace.(Predeterminado: '« Comentarios más antiguos')

Uso

Obtener enlaces de paginación para los comentarios: paginate_comments_links()

Esta etiqueta de plantilla devuelve los enlaces de paginación de la sección Comentarios del tema.

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

  • $args (opcional, matriz):Matriz de los argumentos siguientes:
    • 'base' (cadena): URL base que se utilizará para crear los enlaces de la paginación.
    • 'format' (cadena): Argumento que se va a utilizar para reemplazar el número de página.
    • 'total' (entero): Número total de páginas.
    • 'current' (entero): Número de página actual.
    • 'echo' (booleano): Si deseas hacer eco de la etiqueta de plantilla o no.(Predeterminado: TRUE)
    • 'add_fragment' (cadena): Texto a anteponer a las URL de página.(Predeterminado: '#comments')

Uso

Cómo obtener y mostrar el enlace "Editar comentario": get_edit_comment_link() y edit_comment_link()

Estas etiquetas de plantilla devuelven o hacen eco de un enlace "editar este comentario" para que las uses en tus plantillas.

Parámetros

get_edit_comment_link() acepta un parámetro:

  • $comment_ID (opcional, entero):El ID del comentario con el que trabajar.(Predeterminado: ID del comentario actual)

Y edit_comment_link() acepta tres 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)

Uso

Cómo obtener y mostrar el enlace "Feed de comentarios": get_post_comments_feed_link() y post_comments_feed_link()

Estas etiquetas de plantilla devuelven o muestran un enlace para el feed de comentarios.

Parámetros

get_post_comments_feed_link() acepta dos parámetros:

  • $post_ID (opcional, entero):El ID del post.(Predeterminado: Post actual)
  • $feed (opcional, cadena):Tipo de feed.(Predeterminado: Tipo de feed predeterminado)

Y post_comments_feed_link() acepta tres parámetros:

  • $link_text (opcional, cadena):Texto que se mostrará para el enlace.(Predeterminado: "Feed de comentarios")
  • $post_ID (opcional, entero):El ID del post.(Predeterminado: Post actual)
  • $feed (opcional, cadena):Tipo del feed.(Predeterminado: Tipo de feed predeterminado)

Uso

Visualizar un enlace de la ventana emergente "Comentarios": comments_popup_link()

Esta etiqueta de plantilla muestra un enlace de la ventana emergente "Comentarios", en caso de que desee utilizar enlaces emergentes en las listas de mensajes.

Parámetros

Esta etiqueta de plantilla acepta cinco parámetros:

  • $zero (opcional, cadena):Texto para mostrar si no hay comentarios.(Predeterminado: 'Sin comentarios')
  • $one (opcional, cadena):Texto para mostrar si solo hay un comentario.(Predeterminado: '1 Comentario')
  • $more (opcional, cadena):Texto para mostrar si hay más de un comentario.(Predeterminado: '% Comentarios')
  • $css_class (opcional, string):Nombres de clase CSS adicionales para agregar.(Predeterminado: Vacío)
  • $none (opcional, cadena):Texto a mostrar si los comentarios están desactivados.(Predeterminado: 'Comentarios desactivados')

Uso

Visualización del script emergente "Comentarios": comments_popup_script()

Esta etiqueta de plantilla crea e imprime el script de la ventana emergente "Comentarios".

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

  • $width (opcional, entero):Anchura de la ventana emergente.(Predeterminado: 400)
  • $height (opcional, entero):Altura de la ventana emergente.(Predeterminado: 400)
  • $file (opcional, cadena):URL que se mostrará en la barra de direcciones de la ventana emergente.(Predeterminado: URL de inicio)

Uso

Conclusión

Espero que te haya gustado este cuarto lote de etiquetas de plantilla. Existen cuatro lotes más antes de finalizar, así que mantente atento para descubrir más etiquetas de plantilla!

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

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