[woot]
Shortcode principal de la tabla de productos de WooCommerce. Dibuja la tabla de productos. Se puede usar sin atributos, con los valores predeterminados. Con el atributo 'id' (ID de la tabla) se muestran las tablas creadas en el backend del plugin. ¡Todos los atributos tienen mayor prioridad que los ajustes del backend!
Atributos:
- id: atributo principal; es el ID de la tabla creada en el backend. Puede crear una tabla y sobrescribir algunos de sus parámetros con los atributos siguientes.
- columns: define las columnas de la tabla. Ejemplo: [woot columns='id,thumbnail,title,price,sku,gallery,add_to_cart']. Todas las claves de columnas posibles las encontrará en la página de administración del plugin-> pestaña Ajustes (Settings) -> botón "Todas las claves de columnas posibles (All possible columns keys)", en la parte inferior de la tabla de ajustes.
- cells_width: define el ancho de las columnas según su orden en la tabla: [woot cells_width='1px,200px,20%,auto']
- per_page: define el número de productos por página
- per_page_sel_pp: define los valores de productos por página, por ejemplo: [woot per_page_sel_pp='5,15,25']
- per_page_position: define la posición de la paginación. Ejemplo: [woot per_page_position='t']
- t - arriba
- b - abajo
- tb - arriba y abajo
- none - no mostrar esta lista desplegable
- per_page_sel_position: define la posición de la lista desplegable de productos por página. Ejemplo: [woot per_page_sel_position='t']
- t - arriba
- b - abajo
- tb - arriba y abajo
- none - no mostrar esta lista desplegable
- order_by: clave por la que se ordenan los productos tras cargar la página. Todas las claves posibles las encontrará en la página de administración del plugin-> pestaña Ajustes -> botón "Claves de ordenación (Order by keys)", en la parte inferior de la tabla de ajustes; consulte "Claves de ordenación" en la ventana emergente que aparece. Claves para un shortcode personalizado:
- popularity - Ordenar por popularidad
- rating - Ordenar por valoración media
- date - Ordenar por novedad
- price - Ordenar por precio: de menor a mayor
- price-desc - Ordenar por precio: de mayor a menor
- title - Ordenar por nombre A-Z
- title-desc - Ordenar por nombre Z-A
- sku - SKU: ascendente
- sku-desc - SKU: descendente
- stock - Cantidad en stock: ascendente
- stock-desc - Cantidad en stock: descendente
- sales - Ventas totales: ascendente
- sales-desc - Ventas totales: descendente
- comments - Número de comentarios: ascendente
- comments-desc - Número de comentarios: descendente
- modified - Fecha de última modificación: de la más antigua a la más reciente
- modified-desc - Fecha de última modificación: de la más reciente a la más antigua
- menu_order - Ordenar por orden de menú
- on_sales - Primero los productos en oferta
- on_stock - Ordenar por disponibilidad
- rand - Ordenar al azar
- id - Ordenar por ID de producto: ascendente
- id-desc - Ordenar por ID de producto: descendente
- order: dirección de ordenación de los productos; hay 2 valores posibles: asc O desc
- hide_text_search: cada shortcode [woot] incluye encima un campo de búsqueda por título de producto; si es necesario, indique 1 para ocultarlo
- text_search_min_symbols: aquí puede definir el número mínimo de caracteres a partir del cual se activa la búsqueda por título de producto
- text_search_placeholder: texto de ejemplo (placeholder) del campo de búsqueda por título de producto
- filter_form: añade un formulario de filtro encima de la tabla. Ejemplo: [woot filter_form='price,pa_color']. Todas las claves posibles las encontrará en la página de administración del plugin-> pestaña Ajustes -> botón "Todas las claves de columnas posibles", en la parte inferior de la tabla de ajustes; consulte "Claves de ordenación" en la ventana emergente que aparece.
- hide_filter_form: si se indica 1, en lugar del formulario de filtro aparecerá un botón; al hacer clic en él se mostrará el formulario de filtro
- disable_filter_form: desactiva por completo (hide) el formulario de filtro, si existe
- use_load_more: si se indica 1, en lugar de la paginación aparecerá en la parte inferior de la tabla el botón "Cargar más (Load More)".
- table_html_id: Ejemplo: 'my_great_table' - para CSS o para programación
- post_status: con este atributo se pueden mostrar productos que no tengan solo el estado 'publish'. Ejemplo: 'publish,draft'
- orderby_select_fields: si se indican valores aquí, aparece una lista desplegable de ordenación. Todas las claves posibles las encontrará en la página de administración del plugin-> pestaña Ajustes -> botón "Todas las claves de columnas posibles", en la parte inferior de la tabla de ajustes; consulte "Claves de ordenación" en la ventana emergente que aparece.
- compact_view_width: para dispositivos móviles pequeños. Aquí puede definir el ancho de ventana por debajo del cual la tabla se mostrará en modo compacto. Ejemplo: 500
- hide_on_mobile: define las columnas que quizá quiera ocultar en dispositivos móviles
- show_cart: si se indica 1, el carrito de la compra se mostrará en la parte superior de la tabla
- cart_position: 0 - carrito a la derecha, lista de ordenación a la izquierda; 1 - carrito a la izquierda, lista de ordenación a la derecha
- show_print_btn: muestra el botón de imprimir en la esquina superior izquierda de la tabla
- display_cell_info: muestra la información de la celda al pasar el ratón por encima
- skin: skin de la tabla actual; más información sobre los skins aquí
- current_page: página inicial tras cargar la tabla. Ejemplo: 4
Además, con datos GET se puede indicar el número de página mediante un enlace, ejemplo: https://demo.products-tables.com/?current_page=7 - fíjese en el campo 'current_page' del enlace - use_flow_header: encabezado flotante al desplazar la tabla. Activado de forma predeterminada.
- predefinition: solo en formato JSON; no se recomienda usarlo de esta forma, ya que es posible cometer errores; es mejor hacerlo con las herramientas de la tabla -> pestaña "Predefinición (Predefinition)", aunque también puede hacerlo así, por ejemplo: [woot predefinition='{"ids":"13287,12851,12843", "author":2, "on_sale_only":1, "in_stock_only":1, "featured_only":1, "bestsellers":4, "newest":2, "by_taxonomy":"product_cat:25,26|pa_color:19|rel:AND","sku":"sku-abc,sku-yes,sku-green-l","ids_exclude":"13552","not_by_taxonomy":"pa_color:19|pa_size:21|rel:or"}']
- author: obtiene los productos por el ID de su autor. Se puede usar con plugins de membresía.
- mode: valores posibles: 'ajax', 'to_json', 'json'. El modo Ajax está siempre activo si este atributo no lo redefine. El modo 'to_json' permite almacenar en caché los datos de las entradas sobre la marcha, y el usuario puede navegar por ellos en la tabla sin peticiones al servidor, con búsqueda solo por el título de la entrada (¡los filtros funcionan únicamente con la base de datos!) El modo 'json' no obtiene las entradas por Ajax, sino que muestra en la página la tabla completa en caché justo después de cargarla. Como el modo 'json' se usa en el backend, en el frontend con este modo debe aplicarse el atributo de shortcode is_front=1. Si se establece el modo 'json' o 'to_json', 'orderby_select_fields' se desactivará. Consulte la demo aquí.
- filter_provider: atributo especial que permite sincronizar las consultas a la base de datos de WOOT con distintos plugins de filtros de productos para WooCommerce, por ejemplo: woof, mdtf. Algunos ejemplos de uso, aquí. Lea la información para desarrolladores aquí.
- woot_text_search_by: atributo especial para el campo de texto 'Buscar por título', que de forma predeterminada busca los productos solo por su título. Con este atributo puede ampliar la búsqueda a los campos siguientes: post_title (predeterminado), post_content, post_excerpt. Además, si utiliza el campo de texto por título del constructor de filtros, este atributo también permite buscar con un único campo de texto.
- css_classes: cualquier clase CSS para el contenedor de la tabla
- no_found_text: texto personalizado cuando no se encuentran productos
- table_view: aquí solo es posible un valor: 'separated', que separa las celdas de la tabla de productos. Consulte las páginas de demostración para entenderlo:
- post_title_as_text - desactiva/activa el enlace en el título del producto (1/0)
- disable_link_on_thumb - desactiva/activa el enlace en la miniatura del producto (1/0)
Algunos ejemplos de uso combinado:
- [woot id=25 columns='id,title,product_cat,pa_color,pa_size' cells_width='1,80%,auto,150']
- [woot id=14 columns='id,title' filter_form='price']
- [woot id=13280 table_html_id='tt13280aa' post_status='draft' orderby_select_fields='price,price-desc']
- [woot_upsells id=49 columns='id,title,price,hmeta_1,add_to_cart' compact_view_width=800]
- [woot columns="id,post_title,cars_model" per_page=4 per_page_sel_pp="2,4,6,8" per_page_position='t' per_page_sel_position='t' order_by='post_title' order='asc']