Hay shortcodes disponibles tanto para WC Vendors Marketplace como para WC Vendors Pro. Algunos de estos shortcodes son necesarios para que nuestros plugins funcionen, mientras que otros están disponibles para usar en tu marketplace si los necesitas.
Antes de empezar
Estos shortcodes funcionan directamente una vez que WC Vendors Marketplace (y, cuando se indica, WC Vendors Pro) está activo. No necesitas configurar nada más primero, pero los ejemplos de cada shortcode a continuación usan VENDOR-LOGIN-NAME como marcador de posición para el nombre de usuario de un vendedor real, así que tenlo a mano antes de agregar un shortcode a una página o publicación.
Shortcodes de WC Vendors Marketplace
Los siguientes shortcodes son necesarios para que WC Vendors Marketplace funcione. Cuando actives el plugin y ejecutes el asistente de configuración, también se crearán las páginas requeridas. Si no es así, deberás crear las páginas, asignar los shortcodes y luego configurar las páginas en la configuración de WC Vendors.
Shortcodes requeridos para WC Vendors
Los siguientes shortcodes son necesarios para asegurar el funcionamiento de WC Vendors Marketplace. No coloques estos shortcodes en ninguna otra página, incluidas las páginas de WooCommerce.
Página del panel del vendedor
Muestra el panel del vendedor en el frontend.
[wcv_vendor_dashboard]Shortcodes generales
Vendidos por
Este es un shortcode que se puede usar en tu tema o constructor de temas para mover dónde se muestra la información 'vendido por' en la página de producto individual.
[wcv_sold_by]Otros shortcodes
La siguiente lista de shortcodes te permite personalizar la apariencia de tu sitio y se basa en los shortcodes de WooCommerce con la misma funcionalidad y filtrado de vendedores añadido. Donde dice VENDOR-LOGIN-NAME reemplaza esto con el nombre de usuario del vendedor que deseas mostrar.
Productos Recientes
Para mostrar los productos recientes de un vendedor específico, puedes usar el siguiente shortcode. Las opciones disponibles incluyen las siguientes
- vendor – el vendedor del que deseas mostrar los productos recientes
- per_page – el número de productos por página. El valor predeterminado es 12.
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
[wcv_recent_products vendor="VENDOR-LOGIN-NAME" per_page=3 category="yes"]Productos del Vendedor
Para mostrar todos los productos de un vendedor específico, por ejemplo en una entrada de blog, puedes usar el siguiente shortcode. Las opciones disponibles incluyen los siguientes parámetros.
- vendor – el vendedor del que deseas mostrar los productos
- columns – cuántas columnas de productos mostrar por fila. El valor predeterminado es 4.
- orderby – el campo por el cual ordenar los productos. El valor predeterminado es 'title'.
- order – la dirección de ordenación, asc o desc. El valor predeterminado es 'asc'.
- limit – el número de productos a mostrar. Deja este campo en blanco para mostrar todos los productos del vendedor.
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
Aquí tienes un ejemplo que muestra los productos de un vendedor en 3 columnas, los más recientes primero, con las categorías mostradas debajo del título de cada producto. 'orderby' solo acepta campos de consulta estándar de WordPress (title, date, ID, rand, menu_order), no el precio del producto.
[wcv_products vendor="VENDOR-LOGIN-NAME" columns="3" orderby="date" order="desc" category="yes"]Shortcode de Productos Destacados
Si has habilitado los productos destacados para tus vendedores, el siguiente shortcode te permitirá mostrar los productos destacados de un vendedor específico. Las opciones disponibles incluyen las siguientes:
- vendor – el vendedor del que deseas mostrar los productos destacados
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
[wcv_featured_products vendor="VENDOR-LOGIN-NAME" category="yes"]Productos en Oferta
Si deseas mostrar los productos en oferta de un vendedor específico, por ejemplo en una noticia o promoción, usa el siguiente shortcode. Las opciones disponibles incluyen las siguientes
- vendor – el vendedor del que deseas mostrar los productos en oferta
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
[wcv_sale_products vendor="VENDOR-LOGIN-NAME" category="yes"]Productos Mejor Valorados en Oferta
Si deseas mostrar los productos mejor valorados de un vendedor utilizando el sistema de reseñas integrado de WooCommerce, utiliza el siguiente shortcode. Las opciones disponibles incluyen los siguientes parámetros.
- vendor – el vendedor del que deseas mostrar los productos mejor valorados
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
[wcv_top_rated_products vendor="VENDOR-LOGIN-NAME" category="yes"]Productos más vendidos en oferta
Para mostrar una lista de los productos más vendidos en oferta de un proveedor específico, puede usar el siguiente shortcode. Las opciones disponibles incluyen los siguientes parámetros.
- vendor – el proveedor del que desea mostrar los productos más vendidos en oferta
- category – establece a 'yes' para mostrar las categorías de cada producto debajo de su título. El valor predeterminado es 'no'.
- category_separator – el texto utilizado entre los nombres de las categorías cuando un producto tiene más de una. El valor predeterminado es ', '.
[wcv_best_selling_products vendor="VENDOR-LOGIN-NAME" category="yes"]Categoría de producto y vendedor
Si desea mostrar los productos de un proveedor en una categoría específica, puede usar el siguiente shortcode. Las opciones disponibles incluyen los siguientes parámetros.
- vendor – el proveedor de cuyos productos desea mostrar
- category – el slug de la categoría que desea mostrar
[wcv_product_category category="category-slug" vendor="VENDOR-LOGIN-NAME"]Directorio de proveedores
Si desea mostrar una página con todos sus proveedores, puede usar el siguiente shortcode. Esto también se puede personalizar con la plantilla vendors-list.php que se encuentra en la siguiente ubicación.
/templates/front/vendor-list.php
Esto se sobrescribiría al copiarlo a la carpeta de su tema en la posición adecuada.
Las opciones disponibles incluyen las siguientes
- order by – el orden en el que desea mostrar los proveedores. La lista completa de opciones de ordenación está disponible en el Codex de WordPress.org. El valor predeterminado es 'registered'.
- order – el orden en el que desea que se muestren los proveedores, puede ser ascendente (ASC) o descendente (DESC). Ascendente (ASC) es el valor predeterminado.
- per_page – cuántos proveedores por página, esto debe ser un número. El valor predeterminado es 12 proveedores a mostrar.
- has_products – 'yes' mostrará los proveedores que tienen productos publicados. Si lo establece en 'no', incluirá a los proveedores sin productos publicados. El valor predeterminado es yes
[wcv_vendorslist orderby="registered" order="ASC" per_page="12" has_products="yes"]Tenga en cuenta: Si los proveedores no han establecido el nombre de su tienda, no aparecerán en los resultados de búsqueda, incluso si establece has_products en "no".
Shortcodes de WC Vendors Pro
Los siguientes shortcodes son necesarios para que WC Vendors Pro funcione. Las páginas de los shortcodes deberían haberse creado y configurado cuando instaló y activó WC Vendors Pro y ejecutó el asistente de configuración. Si necesita estos shortcodes nuevamente por algún motivo, son los siguientes.
Shortcodes requeridos para WC Vendors Pro
Panel Pro
El panel de WC Vendors Pro es una página completamente nueva que introduce una interfaz frontal completa para sus vendedores. Esta página debe configurarse además de la página del panel de vendedores de WC Vendors. Este es el shortcode para esta página.
[wcv_pro_dashboard]Página de valoraciones
En WC Vendors Pro, existe un sistema de valoraciones de proveedores que permite a los clientes valorar los productos de los proveedores dándoles una calificación de estrellas y proporcionando un comentario. Si tiene esto habilitado, también necesitará tener configurada la página y el shortcode relacionados. Esta página debe ser una subpágina de la página WooCommerce > Mi cuenta, luego agregue el shortcode a continuación
[wcv_feedback_form]Navegación del panel Pro
Desde la versión 1.3.3 de WC Vendors Pro, hay un nuevo shortcode disponible que le permite colocar la barra de navegación del panel en otras páginas. Esto es útil si ha agregado páginas personalizadas a la navegación y necesita asegurarse de que su interfaz sea la misma en todas partes. Para habilitar la navegación en otra página, use este shortcode.
[wcv_pro_dashboard_nav]Si desea mostrar las estrellas de valoración del proveedor con un enlace a la página de valoraciones de la tienda del proveedor. Esto toma un argumento, que es el vendor_id al que desea enlazar. El ID del proveedor también es su ID de usuario.
[wcv_feedback vendor="VENDORID"]Directorio de proveedores (Pro)
Si desea mostrar una página con todos sus vendedores, puede usar el siguiente shortcode. Esto también se puede personalizar con la plantilla pro-vendors-list.php que se encuentra en la siguiente ubicación.
/templates/front/pro-vendors-list.php
Esto se sobrescribiría al copiarlo a la carpeta de su tema en la posición adecuada.
Las opciones disponibles incluyen las siguientes
- orderby – el orden en que desea mostrar los vendedores. La lista completa de opciones de ordenación está disponible en el Codex de WordPress.org. El valor predeterminado es 'registered'.
- order – el orden en el que desea que se muestren los proveedores, puede ser ascendente (ASC) o descendente (DESC). Ascendente (ASC) es el valor predeterminado.
- per_page – cuántos proveedores por página, esto debe ser un número. El valor predeterminado es 12 proveedores a mostrar.
- has_products – 'yes' mostrará los proveedores que tienen productos publicados. Si lo establece en 'no', incluirá a los proveedores sin productos publicados. El valor predeterminado es yes
Tenga en cuenta: Los vendedores deben tener toda la información de su tienda configurada para que aparezcan en el directorio. Si no tienen el nombre de su tienda u otra información configurada, se omitirán de la lista.
[wcv_pro_vendorslist orderby="registered" order="ASC" per_page="12" has_products="yes" ]Detalles del Vendedor
Este shortcode se introdujo en la versión 1.7.5 de WC Vendors Pro
Si desea recuperar los detalles de un vendedor en particular que tenemos, puede usar el siguiente shortcode.
Si conoce el ID de usuario de los vendedores, puede usar el vendor_id para determinar el vendedor.
[wcv_vendor vendor_id="VENDORUSERID" vendor_detail="DETAIL" ]Si conoce el nombre de usuario del vendedor, puede usarlo para determinar el vendedor.
[wcv_vendor username="VENDORUSERNAME" vendor_detail="DETAIL"]Si el shortcode se utiliza en una página de tienda de vendedor (individual o storefront), el vendedor se detecta automáticamente.
Los siguientes detalles del vendedor están disponibles para su uso
- store_name – El nombre de la tienda del vendedor
- paypal_address – La dirección de correo electrónico de PayPal del vendedor
- seller_info – La información del vendedor
- store_description – La descripción de la tienda del vendedor
- store_banner_id – El ID de publicación del banner de la tienda del vendedor
- store_banner_url – La URL del banner de la tienda del vendedor
- store_icon_id – El ID de publicación del icono de la tienda del vendedor
- store_icon_url – La URL del icono de la tienda del vendedor
- address1 – La dirección1 de la tienda del vendedor
- latitude – La latitud de la dirección del vendedor
- longitude – La longitud de la dirección del vendedor
- city – La ciudad de la dirección del vendedor
- state – El estado de la dirección del vendedor
- country – El país de la dirección del vendedor
- postcode – El código postal de la dirección del vendedor
- company_url – La URL de la empresa de la dirección del vendedor
- sold_by – El enlace 'vendido por' del vendedor
- view_store – El enlace para que el vendedor vea su tienda
- ratings_stars – Las estrellas de calificación del vendedor (sin enlace)
- ratings_link – Las estrellas de calificación del vendedor con enlace
- social_icons – Los iconos de redes sociales del vendedor con enlaces
Para resumir, querrá reemplazar la sección Details con uno de los atributos disponibles, como se ve en el ejemplo a continuación, si conoce el ID del vendedor.
[wcv_vendor vendor_id="4" vendor_detail="store_name,store_phone,store_description"]Sin embargo, también puede usar el siguiente shortcode si conoce el nombre de usuario del vendedor,
[wcv_vendor username="awesome_vendor" vendor_detail="store_name,store_phone,store_description"]Ahora, si está llamando al shortcode en, digamos, la página de un producto individual o en su página de inicio/tienda, simplemente puede agregar el shortcode a continuación.
[wcv_vendor vendor_detail="store_name,store_phone,store_description"]Solución de problemas
Las categorías no se muestran después de agregar category="yes"
Si agrega category="yes" a un shortcode de listado de productos y no aparece nada, verifique que los productos que se muestran estén realmente asignados a una categoría de WooCommerce. El shortcode solo muestra las categorías que un producto ya tiene, no las crea ni las asigna.
Si tu tema utiliza una plantilla de bucle de productos muy personalizada, es posible que las categorías tampoco aparezcan porque la plantilla omite el hook estándar de WooCommerce woocommerce_shop_loop_item_title en el que se basan estos shortcodes para insertar la lista de categorías. Cambiar temporalmente a un tema predeterminado de WooCommerce puede ayudar a confirmar si esta es la causa.
Preguntas frecuentes
¿Qué shortcodes admiten la opción de visualización de categorías?
Productos recientes, Productos del vendedor, Shortcode de productos destacados, Productos en oferta, Productos mejor valorados en oferta y Productos más vendidos en oferta admiten los atributos category y category_separator con el mismo comportamiento y valores predeterminados.
¿Cómo funciona category_separator si un producto tiene más de una categoría?
Establece category_separator en cualquier texto que desees que aparezca entre los nombres de las categorías, por ejemplo category_separator=" | ". Solo tiene un efecto visible cuando un producto pertenece a dos o más categorías, ya que una sola categoría no tiene nada que separar.
¿Necesitas ayuda?
- Usuarios premium: Abrir un ticket de soporte
- Usuarios gratuitos: Visita nuestro foro de la comunidad