La guía Tuts + de etiquetas de plantillas Octavo lote

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, los "marcadores" están ocultos del panel de administración de forma predeterminada. Para trabajar con marcadores, necesita instalar el complemento Administrador de enlaces.

Obtención y visualización de una lista de marcadores: wp_list_bookmarks ()

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

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

• $ args (opcional-array):
  Una matriz de los siguientes argumentos:
  • 'orderby' (cadena): Cómo ordenar los marcadores. Acepta 'nombre', 'link_id', 'url', 'target', 'description', 'owner' (el usuario que agregó el marcador), 'rating', 'updated' (actualizar fechas), 'rel' (XFN relación de marcador), 'notas', 'rss', 'longitud' (longitud del nombre del marcador), 'rand' (aleatorio).
    (Predeterminado: 'nombre')
  • 'orden' (cadena): si ordenar los artículos en orden ascendente ('ASC') o descendente ('DESC').
    (Valor predeterminado: 'ASC')
  • 'límite' (entero): Número de elementos para mostrar.
    (Predeterminado: -1 que significa todos los marcadores)
  • 'categoría' (cadena): ID de categorías separadas por comas para obtener elementos de.
    (Predeterminado: "que significa todas las categorías)
  • 'exclude_category' (cadena): ID de categorías de marcadores para excluir.
    (Defecto:")
  • 'nombre de la categoría' (cadena): un nombre de categoría para mostrar los marcadores de (anula la "categoría").
    (Defecto:")
  • 'hide_invisible' (entero): si ocultar enlaces invisibles o mostrarlos.
    (Predeterminado: 1)
  • 'show_updated' (entero): si la última marca de tiempo actualizada debe mostrarse o no.
    (Predeterminado: 0)
  • 'eco' (entero): si se hace eco de la salida (1) o se devuelve (0).
    (Predeterminado: 1)
  • 'clasificar por categorías' (entero): si agrupar marcadores por categorías (1) o no (0).
    (Predeterminado: 1)
  • 'title_li' (cadena): envuelve la salida con un
  • etiqueta y muestra un título antes de la lista de marcadores. Probablemente querrá establecer esto en una cadena vacía y deshabilitar el ajuste.
    (Predeterminado: 'Marcadores')
  • 'title_before' (cadena): código HTML para agregar antes de cada título.
    (Defecto: '

    ')

  • 'título_after' (cadena): código HTML para agregar después de cada título.
    (Defecto: '')
  • 'clase' (cadena): nombres de clase CSS para agregar a cada categoría.
    (Predeterminado: 'linkcat')
  • 'category_before' (cadena): código HTML para agregar antes de cada categoría.
    (Defecto: '
  • ')
  • 'category_after' (cadena): código HTML para agregar después de cada categoría.
    (Defecto: '
  ')
  • 'category_orderby' (cadena): Cómo ordenar las categorías. Acepta 'nombre', 'id', 'slug' y 'contar'.
    (Predeterminado: 'nombre')
  • 'category_order' (cadena): si ordenar categorías en orden ascendente ('ASC') o descendente ('DESC').
    (Valor predeterminado: 'ASC')

Uso

 'rand', // Lleva solo 5 marcadores. 'limit' => 5, // Tome los marcadores de una categoría específica. 'category_name' => 'Friends', // Don't echo. 'echo' => 0, // Clase personalizada. 'class' => 'friends-bookmark-list'); $ bookmarks_list = wp_list_bookmarks ($ args); ?>

Obtención de una matriz de todos los marcadores: get_bookmarks ()

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

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

• $ args (opcional-array):
  Una matriz de los siguientes argumentos:
  • 'orderby' (cadena): Cómo ordenar los enlaces. Acepta campos de publicación como 'nombre', 'ID', 'título', 'fecha', etc..
    (Predeterminado: 'nombre')
  • 'orden' (cadena): si ordenar los artículos en orden ascendente ('ASC') o descendente ('DESC').
    (Valor predeterminado: 'ASC')
  • 'límite' (entero): Número de elementos para mostrar.
    (Predeterminado: -1 que significa todos)
  • 'categoría' (cadena): ID de categorías separadas por comas para obtener elementos de.
    (Predeterminado: Vacío)
  • 'nombre de la categoría' (cadena): Nombre de categoría para obtener elementos de.
    (Predeterminado: Vacío)
  • 'hide_invisible' (entero o booleano): si se muestra u oculta el enlace marcado como "invisible".
    (Defecto: 1 | VERDADERO)
  • 'show_updated' (entero o booleano): si se muestra la hora en que se actualizó el marcador por última vez.
    (Defecto: 0 | FALSO)
  • 'incluir' (cadena): lista de identificadores separados por comas para incluir.
    (Predeterminado: Vacío)
  • 'excluir' (cadena): lista de identificadores separados por comas para excluir.
    (Predeterminado: Vacío)

Uso

 'título', 'orden' => 'ASC', 'límite' => 15, 'hide_invisible' => falso, 'excluir' => '12, 16,23 '); $ bookmarks_array = get_bookmarks ($ args); ?>

Obtención de datos de marcador: get_bookmark ()

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

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

• $ marcador (requerido-mezclado):
  El ID de marcador o el objeto.
  (Defecto: NULO)
• $ salida (cadena opcional):
  Ya sea OBJECT, ARRAY_N o ARRAY_A constant.
  (Defecto: OBJETO)
• $ filtro (cadena opcional):
  Ya sea para escapar de la salida o no. Si desea filtrar la salida, ajústelo a 'mostrar'.
  (Predeterminado: 'raw')

Uso

Obtención de los datos de un solo campo de marcador: get_bookmark_field ()

Esta etiqueta de plantilla le permite obtener los datos de un solo campo de marcadores.

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

• $ campo (string requerido):
  El nombre del campo.
  (Defecto: NULO)
• $ marcador (requerido-entero):
  El ID del marcador.
  (Defecto: NULO)
• $ contexto (cadena opcional):
  Cómo filtrar el valor del campo: 'en bruto', 'editar', 'atributo', 'js', 'db' o 'mostrar'.
  (Predeterminado: 'mostrar')

Uso

Obtención y visualización del enlace "Editar marcador": get_edit_bookmark_link () Y edit_bookmark_link ()

Estas etiquetas de plantillas le permiten obtener o hacer eco de un enlace "editar este marcador" para usar en sus plantillas.

Parámetros

get_edit_bookmark_link () acepta un solo parámetro:

• $ bookmark_id (requerido-entero):
  El ID del marcador.
  (Predeterminado: 0)

Y edit_bookmark_link () acepta cuatro parámetros:

• $ texto (cadena opcional):
  Texto para mostrar el enlace.
  (Predeterminado: 'Editar esto')
• $ antes (cadena opcional):
  El texto o código HTML a mostrar antes de la salida..
  (Predeterminado: Vacío)
• $ después (cadena opcional):
  El código de texto o HTML para mostrar después de la salida.
  (Predeterminado: Vacío)
• $ bookmark_id (requerido-entero):
  El ID del marcador.
  (Defecto: NULO)

Uso

',''); // Mostrar el enlace "editar marcador" de un marcador específico. edit_bookmark_link (__ ('Editar', 'traducción-dominio'), ",", 98); ?>

Obtención y visualización de la información de su sitio: get_bloginfo () Y bloginfo ()

Estas etiquetas de plantillas extremadamente populares devuelven y muestran la información general de su sitio.

Parámetros

get_ bloginfo () acepta dos parámetros:

• $ show (cadena opcional):
  El bit de información a buscar. Uno de los siguientes valores:
  • 'url' (cadena): la URL de inicio.
  • 'wpurl' (cadena): la URL donde está instalado WordPress.
  • 'descripción' (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 comentarios.
  • 'comments_atom_url' (cadena): La URL del feed Atom para comentarios.
  • 'pingback_url' (cadena): la URL del archivo XML-RPC pingback.
  • 'stylesheet_url' (cadena): la URL del archivo CSS principal del tema.
  • 'stylesheet_directory' (cadena): la URL del directorio del archivo CSS principal del tema.
  • 'plantilla_directorio' o 'template_url' (cadena): la URL del directorio del tema activo.
  • 'admin_email' (cadena): la dirección de correo electrónico ingresada cuando se instaló WordPress.
  • charset (cadena): conjunto de caracteres del sitio.
  • 'html_type' (cadena): El tipo de contenido de las páginas HTML de WordPress.
  • 'versión' (cadena): versión de WordPress.
  • 'idioma' (cadena): Idioma de la instalación de WordPress.
  • 'dirección del texto' (cadena): Dirección del texto del idioma..
  • 'nombre' (cadena): nombre del sitio.
  (Predeterminado: 'nombre')
• $ filtro (cadena opcional):
  Configurarlo para 'filtrar' para filtrar la URL devuelta desde esta etiqueta de plantilla.
  (Predeterminado: 'raw')

Y bloginfo () acepta un solo parámetro:

• $ show (cadena opcional):
  Los mismos detalles que arriba.
  (Valor predeterminado: 'blogname')

Uso

Obtención y visualización automática Clases: get_body_class () Y body_class ()

Estas etiquetas de plantillas muy populares generan clases semánticas y nos permiten repetirlas o devolverlas. También nos permiten agregar nombres de clase adicionales.

Parámetros

Ambas etiquetas de plantilla solo aceptan un parámetro:

• $ clase (opcional-string o array):
  Nombres de clases CSS adicionales para agregar.
  (Predeterminado: Vacío)

Uso

Obtención y visualización de un menú de navegación: wp_nav_menu ()

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

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

• $ args (opcional-array):
  Una matriz de los siguientes argumentos:
  • 'menú' (cadena): el ID, el slug o el nombre del menú.
    (Predeterminado: Vacío)
  • 'menu_class' (cadena): clase CSS de la UL elemento del menú.
    (Predeterminado: 'menú')
  • 'menu_id' (cadena): El ID de la UL elemento del menú.
    (Predeterminado: barra de menú, incrementado)
  • 'envase' (cadena): si envolver el UL, y con que envolverlo.
    (Defecto: Div)
  • 'container_class' (cadena): clase CSS del elemento contenedor.
    (Predeterminado: 'menu- menu slug -container')
  • 'container_id' (cadena): el ID del elemento contenedor.
    (Predeterminado: Vacío)
  • 'fallback_cb' (devolución de llamada o booleano): Nombre de una función de respaldo para ejecutar si el menú no existe. Establecer en falso para no retroceder.
    (Defecto: 'wp_page_menu')
  • 'antes de' (cadena): Texto antes del texto del enlace..
    (Predeterminado: Vacío)
  • 'después' (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)
  • 'eco' (booleano): si se hace eco de la etiqueta de la plantilla o no.
    (Defecto: CIERTO)
  • 'profundidad' (entero): Cuántos niveles de la jerarquía deben incluirse.
    (Predeterminado: 0, que significa todos los niveles)
  • 'caminante' (objeto): instancia de una clase de caminante personalizada.
    (Predeterminado: Vacío)
  • 'ubicación_tema' (cadena): Ubicación del tema a utilizar. Debe estar registrado con register_nav_menu () para que el usuario pueda seleccionarlo.
    (Predeterminado: Vacío)
  • 'items_wrap' (cadena): cómo se deben envolver los elementos de la lista.
    (Defecto:
    % 3 $ s
    )

Uso

 'primary-nav', 'link_before' => '',' ubicación_temática '=>' primario '); wp_nav_menu ($ args); ?>

Obtención y visualización de títulos de página: wp_title ()

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

Parámetros

Esta etiqueta de plantilla acepta tres parámetros:

• $ sep (cadena opcional):
  El texto a utilizar como separador..
  (Defecto: '"')
• $ eco (opcional-booleano):
  Si hacer eco (CIERTO) o devolver (FALSO) la etiqueta.
  (Defecto: CIERTO)
• $ seplocation (cadena opcional):
  Posición del separador y dirección de la miga de pan. Ajústelo a "derecha" para revertir la ruta de navegación.
  (Predeterminado: Vacío)

Uso

Obtención y visualización de 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):
  La identificación del blog..
  (Defecto: NULO)
• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  Esquema para dar el contexto de la URL de inicio ('http', 'https' o 'relativo').
  (Defecto: NULO)

Y home_url () acepta dos parámetros:

• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  Esquema para dar el contexto de la URL de inicio ('http', 'https' o 'relativo').
  (Defecto: NULO)

No confunda estas dos funciones ya que "una devuelve la salida y la otra la muestra", sé que lo hice. La diferencia es un poco rara: mientras que la get_home_url () función devuelve la URL de inicio de un blog específico, la home_url () función devuelve la URL de inicio de la sitio actual. Recuerda: ninguno de ellos hace eco de nada.!

Uso

Obtención y visualización de la URL del sitio: get_site_url () Y Sitio URL()

Estas etiquetas de plantilla obtienen y se 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):
  La identificación del blog..
  (Predeterminado: sitio actual)
• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  Esquema para dar el contexto de la URL de inicio ('http', 'https' o 'relativo').
  (Predeterminado: conexión normal o segura, dependiendo de is_ssl ())

Y Sitio URL() acepta dos parámetros:

• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  Esquema para dar el contexto de la URL de inicio ('http', 'https' o 'relativo').
  (Predeterminado: conexión normal o segura, dependiendo de is_ssl ())

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

Uso

Obteniendo la ID del sitio actual: get_current_blog_id ()

Esta etiqueta de plantilla simplemente devuelve el ID del sitio actual en una red de sitios múltiples.

Parámetros

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

Uso

Obtención y visualización de la URL del panel de administración: get_admin_url () Y admin_url ()

Estas etiquetas de plantilla devuelven y muestran una URL del Panel de su sitio web.

Parámetros

get_admin_url () acepta tres parámetros:

• $ blog_ID (opcional-entero):
  La identificación del blog..
  (Predeterminado: sitio actual)
• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  El esquema a utilizar. 'admin' respeta el esquema definido (con la is_ssl () Función) pero puede anularlo configurando este parámetro. Acepta 'http', 'https', 'admin', 'rpc', 'login' y 'login_post'.
  (Predeterminado: 'admin')

Y admin_url () acepta dos parámetros:

• $ camino (cadena opcional):
  Ruta opcional para adjuntar a la URL.
  (Predeterminado: Vacío)
• $ esquema (cadena opcional):
  El esquema a utilizar. 'admin' respeta el esquema definido (con la is_ssl () función) pero puede anularlo configurando este parámetro en 'http' o 'https'.
  (Predeterminado: 'admin')

Uso

Obtención y visualización del enlace permanente de un tipo de feed: get_feed_link () Y the_feed_link ()

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

Parámetros

get_feed_link () acepta un solo parámetro:

• $ feed_type (cadena opcional):
  Tipo de la alimentación.
  (Predeterminado: Tipo de feed predeterminado)

Y the_feed_link () acepta dos parámetros:

• $ ancla (string requerido):
  Texto a mostrar para el enlace..
  (Defecto: NULO)
• $ feed_type (cadena opcional):
  Tipo de la alimentación.
  (Predeterminado: Tipo de feed predeterminado)

Uso

Haciendo el final de la cadena con o sin una barra diagonal: user_trailingslashit ()

Esta etiqueta de plantilla comprueba tu estructura de enlace permanente, y agrega una barra diagonal final o elimina la barra diagonal final al final de la URL dada.

Parámetros

Esta etiqueta de plantilla acepta dos parámetros:

• $ cadena (string requerido):
  La URL con o sin una barra inclinada.
  (Defecto: NULO)
• $ type_of_url (cadena obsoleta):
  Esto no es técnicamente En desuso, pero no se usa en la función, por lo que no tiene ningún efecto..

Uso

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

Esta extraña etiqueta de plantilla recibe varios días desde el comienzo de la semana. Es básicamente una "operación de módulo".

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

Parámetros

Esta etiqueta de plantilla solo acepta un parámetro:

• $ numero (requerido-entero):
  Días desde el inicio de la semana..
  (Predeterminado: 0)

Uso

Obtención y visualización del 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:

• $ inicial (opcional-booleano):
  Utilice los nombres iniciales del calendario (CIERTO) o no (FALSO).
  (Defecto: CIERTO)
• $ eco (opcional-booleano):
  Si hacer eco (CIERTO) o devolver (FALSO) La salida.
  (Defecto: CIERTO)

Uso

Conclusión

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

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