Opciones del formulario de búsqueda
[web_event_search_form] acepta tres atributos, y el resto de su comportamiento proviene de los ajustes del Archivo.
Los atributos
| Atributo | Valores | Efecto |
|---|---|---|
hide_calendar |
yes |
Oculta la columna de filtros, incluido el selector de fecha, y deja que los resultados usen todo el ancho |
error_msg |
Cualquier texto | El mensaje que se muestra cuando un mes del calendario no tiene eventos |
el_class |
Una clase CSS | Una clase adicional en el contenedor, para el estilo |
Ejemplo:
[web_event_search_form hide_calendar="yes" error_msg="No events this month"]
Las mismas opciones están disponibles como campos en el elemento del constructor de páginas, así que rara vez necesitas escribir el shortcode a mano.
hide_calendar
Ajustarlo a yes elimina toda la columna izquierda — el selector de fecha y los filtros de tipo y categoría — y da a los resultados todo el ancho de la página.
Úsalo cuando quieras una simple lista cronológica de próximos eventos sin filtrado. Consulta Hide the search calendar para saber cuándo es la elección correcta.
error_msg
El texto que se muestra cuando el mes elegido en el calendario no contiene eventos. Si se deja sin definir, el valor predeterminado explica que no hay eventos para el mes elegido.
Escríbelo con la voz del sitio y mantenlo útil:
Nada programado este mes: prueba con otro o consulta el programa completo.
Esto es distinto del mensaje que se muestra cuando una búsqueda filtrada no devuelve nada, que proviene de los ajustes del Archivo. Consulta Empty results and error messages.
el_class
Una clase adicional en el contenedor para que un tema o una hoja de estilos personalizada pueda dirigirse a esta instancia. Útil cuando el mismo shortcode aparece en dos páginas con una presentación distinta.
Qué se configura en otro lugar
| Comportamiento | Dónde |
|---|---|
| Cuántos eventos por página | Archive → Posts per page |
| La imagen de carga | Archive → Events list loader |
| La imagen para los eventos sin imagen destacada | Archive → Events thumbnail placeholder |
| El mensaje de sin resultados para búsquedas filtradas | Archive → Error message |
| Si los elementos de la lista muestran fechas | Archive → Hide events date |
Estos se aplican a cada lista de eventos del sitio, no a una instancia concreta del shortcode.
Qué no se puede configurar
El shortcode no acepta atributos para:
- qué taxonomías se ofrecen como filtros;
- el orden;
- incluir eventos pasados;
- limitar la lista a una categoría o tipo;
- el diseño de un elemento de resultado.
Estos los fija el plugin. Para una lista restringida a una categoría, enlaza en su lugar el archivo de la categoría, o haz que un desarrollador ajuste la configuración de búsqueda mediante el filtro compatible — consulta Shortcodes.
Usarlo dos veces en una página
Es posible, y rara vez una buena idea: dos instancias comparten las mismas convenciones del área de resultados y competirán por la atención del visitante.
Si necesitas dos listados distintos, usa dos páginas.
Verifica
- Coloca el shortcode sin atributos y confirma el diseño predeterminado.
- Añade
hide_calendar="yes"y confirma que la columna de filtros desaparece y los resultados se ensanchan. - Ajusta
error_msgy confirma que aparece para un mes sin eventos. - Añade
el_classy confirma que la clase llega al contenedor. - Comprueba ambas variantes en un teléfono.