wp_get_tags: listar etiquetas
Lista términos de etiqueta. Idéntico a wp_get_categories con la taxonomía fijada a post_tag.
Argumentos
| Argumento | Predeterminado | Significado |
|---|---|---|
per_page |
20 | Número de términos, limitado a 1–100 |
search |
— | Filtra por término de búsqueda |
hide_empty |
false | Excluye los términos sin entradas |
Permisos
mcp:read y wp:content:read. No se requiere ninguna capacidad de WordPress.
Qué devuelve
Solo items, con cada término portando id, taxonomy, name, slug, description y count. No hay total — usa wp_count_terms.
Las etiquetas son planas, y normalmente caóticas
La diferencia con las categorías no es mecánica, es práctica. Las etiquetas no son jerárquicas, no están moderadas y se acumulan: la mayoría de los sitios tienen muchas más etiquetas que categorías, además de una larga cola de etiquetas usadas una sola vez.
Eso determina cómo se usa esta herramienta. Donde un listado de categorías suele caber en una página, un listado de etiquetas con frecuencia no — y las etiquetas que importan son una minoría de lo que existe.
Empieza por averiguar la escala:
Cuenta las etiquetas, luego lista las primeras 50 con su número de entradas, y detente.
La cola de un solo uso
Las etiquetas con un count de uno son el problema característico: erratas, casi sinónimos y términos inventados una vez y nunca reutilizados.
Vale la pena revisarlas, y también son la razón por la que una instrucción de limpieza sin límites es peligrosa. «Elimina las etiquetas no usadas» suena razonable; una etiqueta con una entrada no está sin usar, y eliminarla quita la clasificación de esa entrada de forma permanente.
Lee los recuentos antes de decidir nada, y nombra los IDs en lugar de criterios. Consulta wp_delete_term.
Evitar nuevos duplicados
La misma regla que con las categorías, y aquí importa más porque las etiquetas se multiplican más rápido:
Lista primero las etiquetas existentes. Usa solo etiquetas que ya existan. Si crees que hace falta una nueva, dime el nombre y espera.
Sin ese límite, un asistente que etiquete veinte entradas crea una docena de casi duplicados de etiquetas que ya estaban allí con otra grafía o en plural.
search es el filtro práctico
En un sitio con cientos de etiquetas, listar no es la forma de encontrar una. Buscar sí lo es:
Busca en las etiquetas «mantenimiento» y muéstrame los IDs y los recuentos.
Esta es también la comprobación que hay que ejecutar antes de permitir que cualquier cosa cree una etiqueta — si existe una coincidencia cercana, úsala.
Sin jerarquía, sin elemento superior
Las etiquetas no pueden anidarse, así que, a diferencia de las categorías, no hay información de elemento superior que falte y de la que preocuparse. Pasar parent a una operación de etiquetas no tiene sentido.
Cómo usarla bien
Lista las etiquetas con recuentos, ordenadas tal como se devuelven.
Busca en las etiquetas «primavera».
¿Cuántas etiquetas tienen solo una entrada?
Esa última pregunta necesita los recuentos, que el listado proporciona — pero recuerda que solo puede responder dentro de la página que has obtenido.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Muchas menos etiquetas de las que tiene el sitio | per_page se limita a 100, y no hay total |
| Faltan etiquetas vacías | Se pasó hide_empty |
| Etiquetas que parecen duplicadas | Creadas sin leer la lista existente |
| Falta una etiqueta que esperabas | Prueba search; el listado es solo una página |