Configuración
La configuración vive en Admin, Stores, Configuration, MIBIZUM, Mibizum Search. Los campos de Connection y Frontend son scopeables por vista de tienda (ver Multi-tienda).
1. Connection
Es el único paso imprescindible para que el módulo empiece a trabajar.
| Campo | Qué poner |
|---|---|
| Enabled | No al principio. Ponlo en Yes solo cuando las claves estén puestas. |
| API URL | https://app.mibizum.io |
| Clave privada | Tu clave secreta que escribe el catálogo (es decir, lo indexa). Panel, tu catálogo, API keys. Se guarda cifrada. Si se expone, regenérala en el panel. |
| Clave pública | Clave de solo lectura que usa el override de Enter (la misma que el widget público), segura de exponer. Se guarda cifrada. |
| Data source slug | El slug del catálogo (por ejemplo products). Vacío = el primer catálogo de la cuenta. |
Dos permisos a propósito: la clave privada escribe el catálogo; la clave pública lee. La que viaja al navegador del cliente (la pública) nunca puede modificar nada.
2. Primer connect y reindexado
- Pega la API URL, las dos claves y el slug. Deja Enabled = No. Guarda.
- Pon Enabled = Yes y guarda. Guardar un cambio de conexión programa automáticamente una reindexación completa de ese catálogo.
- Ve a Mibizum Search, Reindex and sync y pulsa Resync all products y luego Drain queue now, o deja que el cron vacíe la cola. Verás el progreso (documentos en el índice y cambios pendientes) en pantalla.
No pongas Enabled = Yes sin las claves. El módulo no publica nada hasta que la conexión está completa, así que no pasa nada malo, pero tampoco indexa.
3. El panel de Reindex
En Mibizum Search, Reindex and sync:
- Documents in the index y Changes pending indexing (contadores en vivo).
- Resync all products (encola todo) y Drain queue now (procesa la cola).
- Tabla Connected catalogs (solo con más de una vista de tienda), ver Multi-tienda.
4. Frontend (widget y presentación)
| Campo | Notas |
|---|---|
| Widget snippet | Pega el snippet del panel de Mibizum (Domains, JS Code). Se inyecta tal cual en el <head>. Vacío = sin widget. |
| Show category filter row | Píldoras de categoría sobre los resultados. Desactivado por defecto. |
| Strings to strip from the title | Texto (separado por comas) que se quita de los títulos al mostrarlos. |
| Show price / Show format chips | Activa el precio y el formato (10ml, 30ml) por resultado. |
| Results per search / LRU cache size | Cuántos resultados pedir y cuántas búsquedas recordar en memoria. |
| Overlay min/max width | Tamaño del panel de resultados (móvil y escritorio). |
| Search input CSS selector | A qué caja de búsqueda se engancha el widget. Vacío = el valor por defecto. |
El paracaídas. Cuando un cliente busca con Enter, el módulo pide resultados a Mibizum. Si Mibizum no respondiera (error de red, 5xx) o la búsqueda viniera vacía, cae automáticamente al buscador nativo de Magento. El cliente siempre ve resultados; nunca un error.
5. Badges (opcional)
En el menú Mibizum Search puedes gestionar las etiquetas de los resultados (System, Category y Attribute). Ver Badges.
6. Sync (avanzado)
Batch size (productos por petición, máx. 500), Maximum retries (dead-letter tras N intentos) y HTTP timeout. Valores por defecto sensatos; rara vez hay que tocarlos.
Notas
- El módulo es seguro por defecto: no publica nada hasta que Enabled = Yes y las claves están presentes.
- Las claves de API se guardan cifradas en la base de datos.