FAQ (Frequently Asked Questions)

El módulo FAQ le permite crear y mostrar una sección de preguntas frecuentes en su tienda. Las preguntas se almacenan como un tipo de contenido independiente (CPT) con su propia taxonomía de categorías, lo que permite una gestión y visualización flexibles.

Activar el módulo

Vaya a Polski > Módulos y active FAQ (ID del módulo: faq).

Una vez activado, aparece un nuevo elemento FAQ en el menú de administración con subpáginas para gestionar preguntas y categorías.

Panel de administración

La gestión de las preguntas FAQ se realiza en FAQ (edit.php?post_type=polski_faq). La interfaz funciona exactamente igual que las entradas estándar de WordPress.

Añadir una pregunta

1. Vaya a FAQ > Añadir nueva
2. Introduzca el texto de la pregunta en el campo de título
3. Introduzca la respuesta en el editor (se admite el editor de bloques completo)
4. Asigne una categoría FAQ (opcional)
5. Establezca el orden de visualización en el campo Orden (menu_order)
6. Publique

Categorías FAQ

La taxonomía faq_category le permite agrupar las preguntas por tema. Gestione las categorías en FAQ > Categorías FAQ.

Categorías de ejemplo:

• Pedidos y pagos
• Envío y devoluciones
• Cuenta de cliente
• Productos

El shortcode [polski_faq]

Muestra una lista de preguntas FAQ en forma de acordeón CSS.

Parámetros

Parámetro	Tipo	Predeterminado	Descripción
category	string	(vacío)	El slug de la categoría FAQ que se mostrará
limit	int	-1	El número máximo de preguntas (-1 = todas)
orderby	string	menu_order	El campo de ordenación: menu_order, title, date
order	string	ASC	La dirección de ordenación: ASC o DESC

Ejemplos de uso

Mostrar todas las preguntas:

[polski_faq]

Mostrar preguntas de la categoría “dostawa”:

[polski_faq category="dostawa" limit="5"]

Mostrar las 10 preguntas más recientes:

[polski_faq limit="10" orderby="date" order="DESC"]

Uso en una plantilla PHP

echo do_shortcode('[polski_faq category="zamowienia" limit="10"]');

Acordeón CSS

Las preguntas se muestran como un acordeón, al hacer clic en una pregunta se despliega su respuesta. El acordeón funciona completamente con CSS (sin JavaScript), lo que garantiza el máximo rendimiento.

El mecanismo se basa en el elemento HTML <details> con <summary>:

<div class="polski-faq">
  <details class="polski-faq__item">
    <summary class="polski-faq__question">¿Cómo hago un pedido?</summary>
    <div class="polski-faq__answer">
      <p>Para hacer un pedido, añada productos al carrito...</p>
    </div>
  </details>
</div>

Clases CSS

• .polski-faq - el contenedor FAQ
• .polski-faq__item - una sola pregunta (el elemento <details>)
• .polski-faq__question - el texto de la pregunta (el elemento <summary>)
• .polski-faq__answer - el contenido de la respuesta
• .polski-faq__category - el encabezado de la categoría (cuando se muestra agrupado)

Personalizar el aspecto

/* Cambiar el color de fondo de la pregunta activa */
.polski-faq__item[open] .polski-faq__question {
    background-color: #f0f0f0;
}

/* Cambiar el icono de despliegue */
.polski-faq__question::marker {
    content: "+";
}

.polski-faq__item[open] .polski-faq__question::marker {
    content: "-";
}

Schema.org FAQPage

El módulo genera automáticamente el marcado Schema.org FAQPage en formato JSON-LD en las páginas que contienen el shortcode [polski_faq]:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Cómo hago un pedido?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Para hacer un pedido, añada productos al carrito..."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cuál es el plazo de entrega?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "El plazo de entrega estándar es de 2-3 días laborables..."
      }
    }
  ]
}

El marcado FAQPage permite a Google mostrar preguntas y respuestas directamente en los resultados de búsqueda (rich snippets).

Desactivar Schema.org:

add_filter('polski/faq/schema_enabled', '__return_false');

Hooks

Filtros

// Cambiar los argumentos de la consulta FAQ
add_filter('polski/faq/query_args', function (array $args): array {
    $args['posts_per_page'] = 20;
    return $args;
});

// Modificar el HTML de la respuesta antes de mostrarla
add_filter('polski/faq/answer_html', function (string $html, int $post_id): string {
    return wp_kses_post($html);
}, 10, 2);

Acciones

// Añadir un elemento personalizado antes de la sección FAQ
add_action('polski/faq/before', function (): void {
    echo '<h2>¿Tiene preguntas? Aquí están las respuestas:</h2>';
});

// Añadir un elemento personalizado después de la sección FAQ
add_action('polski/faq/after', function (): void {
    echo '<p>¿No ha encontrado una respuesta? <a href="/kontakt">Contáctenos</a>.</p>';
});

Resolución de problemas

El shortcode muestra un contenedor vacío - compruebe que ha publicado preguntas FAQ. Los borradores y las entradas programadas no se muestran.

El acordeón no funciona - asegúrese de que el tema no bloquee el elemento <details>. Algunas hojas de estilo de reinicio CSS pueden ocultar este elemento.

Schema.org no aparece - verifique el marcado con la Google Rich Results Test. Asegúrese de que el shortcode esté en la página (no en un widget de la barra lateral).

Notificar problemas: github.com/wppoland/polski/issues

Esta página tiene únicamente fines informativos y no constituye asesoramiento legal. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.