manifest / content / another-faq-plugin-wp

Another FAQ Plugin

Plugin WordPress de preguntas frecuentes (chilehalal.cl)

by Zumito · github.com/chilehalal-spa/another-faq-plugin-wp

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/chilehalal-spa/another-faq-plugin-wp/archive/refs/heads/main.zip

Updates itself. It ships its own updater, so new versions appear under Dashboard → Updates.

Readme github.com/chilehalal-spa/another-faq-plugin-wp ↗

Plugin de WordPress para preguntas frecuentes. Agrega el tipo de contenido FAQ (con categorías) y el shortcode [faq] para mostrarlas en acordeón.

Se usa en chilehalal.cl.

Instalación

Descarga another-faq-plugin.zip desde la última release. No uses el botón "Code → Download ZIP": ese zip trae otro nombre de carpeta.
En WordPress: Plugins → Añadir nuevo → Subir plugin, elige el zip y activa.

Requiere WordPress 5.8 o superior y PHP 7.4 o superior.

Uso

Crea las preguntas en Preguntas Frecuentes del menú de administración y agrúpalas en Categorías. Luego inserta el shortcode en cualquier página o entrada:

Shortcode	Muestra
`[faq]`	Todas las preguntas
`[faq categoria="slug"]`	Solo las de una categoría
`[faq id="123"]`	Una sola pregunta (la columna "Shortcode" del listado la entrega lista para copiar)

Otros atributos:

Atributo	Valores	Por defecto
`limite`	número máximo de preguntas	`-1` (todas)
`orden`	campo para ordenar (`menu_order`, `title`, `date`…)	`menu_order`
`direccion`	`ASC` o `DESC`	`ASC`
`exclusivo`	`si`: al abrir una pregunta se cierran las demás	`si`

Dos columnas con contacto

Con titulo, el FAQ se arma en dos columnas: a la izquierda etiqueta, título, texto y un botón de contacto; a la derecha las preguntas. En celular se apila.

[faq titulo="Resolvemos tus dudas sobre la certificación" whatsapp="si"]

Atributo	Valores	Por defecto
`titulo`	título de la columna izquierda; activa las dos columnas	vacío (solo acordeón)
`etiqueta`	texto pequeño sobre el título	`Preguntas frecuentes`
`texto`	párrafo bajo el título	`¿No encuentras tu respuesta? Nuestro equipo te responde directamente.`
`boton`	texto del botón	`Contacta con un profesional`
`whatsapp`	`si` (número del botón flotante del tema) o un número con código de país	vacío
`enlace`	cualquier URL para el botón; tiene prioridad sobre `whatsapp`	vacío

El botón solo aparece si hay enlace o whatsapp.

Aspecto y SEO

Cada pregunta es una tarjeta numerada; la abierta se destaca con fondo y borde.
Los colores salen de las variables del tema --color-primary y --color-danger si existen (si no, azul y rojo de ChileHalal).
Las preguntas son h3 y la página incluye el marcado FAQPage (JSON-LD) con todas las preguntas mostradas, para que Google pueda usarlas en los resultados.

Actualizaciones

El plugin se actualiza desde las releases de este repositorio, como cualquier plugin de wordpress.org: aparecen en Escritorio → Actualizaciones y se pueden dejar automáticas en Plugins → Activar actualizaciones automáticas.

WordPress revisa cada 12 horas; la respuesta de GitHub se guarda 6 horas.

Publicar una versión nueva

Sube Version: en another-faq-plugin.php (por ejemplo 1.2.0).
Haz commit y push a main.
Crea y sube el tag con el mismo número:
```
git tag v1.2.0
git push origin v1.2.0
```

La Action Release verifica que el tag coincida con la versión, arma another-faq-plugin.zip y publica la release. Desde ese momento los sitios ven la actualización.

Cambios

1.2.0: nuevo diseño (tarjetas numeradas, ícono que gira, respuesta destacada), modo de dos columnas con botón de contacto, preguntas como h3 y marcado FAQPage para Google.
1.1.1: historial de cambios en el README (prueba del actualizador).
1.1.0: actualizaciones automáticas desde las releases de GitHub, licencia GPL-2.0-or-later y README.
1.0: versión inicial (preguntas frecuentes con categorías y shortcode [faq]).

Licencia

GPL-2.0-or-later. Ver LICENSE.