Lokilo – Store Locator for WooCommerce

Descripción

Lokilo muestra tus tiendas físicas en la tienda. Ingresas cada ubicación una sola vez en wp-admin (nombre, dirección, ciudad, código postal, país, teléfono, correo electrónico, horario de atención, una foto y una descripción), luego colocas el shortcode [lokilo] en cualquier página y se muestra el directorio.

Sin mapa, y ese es el objetivo

No hay ninguna clave de Google Maps que obtener, ninguna API que pagar, ningún script de terceros ni nada que se envíe a ningún lado. Un localizador de tiendas que necesita una cuenta de facturación y una clave con cuota es un localizador de tiendas que deja de funcionar silenciosamente el mes en que alguien olvida pagarlo.

Cada ubicación se imprime en el HTML de la página, por lo que el directorio está ahí incluso con JavaScript desactivado, y también está disponible para un motor de búsqueda que lea la página. Cuando JavaScript sí se ejecuta, la caja de búsqueda filtra las tarjetas a medida que el visitante escribe, buscando por nombre, dirección, ciudad, código postal y país, sin una sola petición.

Lo que obtienes

  • Ubicaciones como su propia pantalla de administración. Ubicaciones de tiendas se encuentra bajo el menú de WooCommerce, con una foto, una descripción y el bloque completo de contacto por cada tienda.
  • Un solo shortcode. [lokilo] renderiza el directorio. [lokilo limit="500"] aumenta el valor por defecto de 200 tiendas y [lokilo limit="-1"] las muestra todas.
  • Un conteo honesto. Cuando la página muestra menos ubicaciones de las que tienes, lo indica arriba de la lista e informa que la caja de búsqueda solo abarca las mostradas, en lugar de permitir que un visitante concluya que no tienes ninguna tienda en su ciudad.
  • Control por tarjeta. La foto, descripción, dirección, horario de atención, teléfono y correo electrónico tienen cada uno un interruptor. El nombre de la tienda siempre se muestra.
  • Accesible por diseño. El conteo de resultados se comunica a través de una región ARIA live, el campo de búsqueda se puede operar con el teclado, las tarjetas tienen contornos para focus-visible y los estilos de la tienda respetan la preferencia de tema claro u oscuro del visitante y respetan prefers-reduced-motion.
  • No carga nada que no necesite. La hoja de estilos y el script solo se ponen en cola en una página donde el shortcode realmente se haya procesado, y el marcado está escrito para evitar desplazamientos del layout.
  • Legible para un asistente. En WordPress 6.9 y versiones posteriores, un asistente de IA en wp-admin puede listar tus ubicaciones, buscar una y leer los ajustes del directorio, a través de la Abilities API de WordPress. Solo lectura: no puede añadir ni cambiar nada.

Lo que no hace

No hay vista de mapa, ni indicaciones para llegar en auto ni geolocalización del visitante, porque las tres cosas necesitan un proveedor de mapas de pago. Si necesitas un marcador en un mapa, este no es el plugin.

No realiza importaciones masivas. Las ubicaciones se añaden una por una en wp-admin.

Servicios externos

Lokilo no se conecta a ningún servicio externo. No registra ninguna API remota, no envía peticiones HTTP y no carga ningún script, fuente, mapa o tesela de terceros. Los datos de tus tiendas nunca salen de tu sitio.

Cada ubicación se almacena en tu propio servidor como una entrada locator_store, con su dirección, ciudad, código postal, país, teléfono, horario de atención, correo electrónico y cualquier latitud/longitud guardada en los metadatos de esa entrada. Los ajustes se encuentran en la opción locator_settings. Las coordenadas se escriben a mano en la pantalla de ubicación; nada se geocodifica mediante un proveedor externo. La búsqueda en la tienda filtra las tarjetas en el navegador del visitante, por lo que no se realiza ninguna petición al escribir, y el plugin no envía correos electrónicos.

Traducciones

Lokilo es totalmente traducible e incluye la plantilla lokilo.pot. Las traducciones se distribuyen mediante paquetes de idioma de WordPress.org desde translate.wordpress.org, donde se está colaborando con polaco, alemán y español; el paquete en sí no contiene archivos de traducción compilados.

Capturas

Instalación

  1. Sube el plugin a /wp-content/plugins/lokilo o instálalo mediante Plugins > Añadir nuevo.
  2. Actívalo. WooCommerce debe estar activo.
  3. Ve a WooCommerce > Store Locations y añade tus tiendas.
  4. Configura WooCommerce > Lokilo (caja de búsqueda y campos visibles).
  5. Añade el shortcode [lokilo] a cualquier página.

Preguntas frecuentes

¿Requiere WooCommerce?

Sí. Lokilo se registra bajo el menú de WooCommerce y requiere que WooCommerce esté activo.

¿Muestra un mapa?

No. Lokilo muestra una lista de tarjetas con buscador, no un mapa, por lo que no necesita ninguna clave de mapa ni servicio externo. Aún puedes almacenar la latitud y longitud por ubicación para que las use un complemento.

¿Qué detalles puedo mostrar en cada tarjeta?

El nombre de la tienda siempre se muestra. Puedes activar o desactivar la foto de la tienda, la descripción, la dirección, el horario de atención, el teléfono y el correo electrónico en los ajustes. Cada uno solo aparece en una tarjeta cuando esa ubicación realmente tiene un valor para ello.

¿Cómo funciona la caja de búsqueda?

El shortcode [lokilo] filtra las tarjetas de ubicación del lado del cliente a medida que el comprador escribe.

¿Puedo añadir tiendas sin código personalizado?

Sí. Añade ubicaciones en WooCommerce > Store Locations y coloca [lokilo] en cualquier página.

¿Este plugin funciona en WordPress Multisitio?

Sí. Este plugin es compatible con WordPress Multisitio. Actívalo en la red o actívalo en sitios individuales; cada sitio conserva sus propios ajustes y datos.

Reseñas

23 de septiembre de 2026
Works really well and has no issues
Leer toda la 1 reseña

Colaboradores y desarrolladores

Este software es de código abierto. Las siguientes personas han contribuido a este plugin.

Colaboradores

“Lokilo – Store Locator for WooCommerce” ha sido traducido a 4 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce “Lokilo – Store Locator for WooCommerce” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

1.2.6

  • La búsqueda ahora coincide con nombres de tiendas, ciudades y direcciones con mayúsculas no ASCII (Łódź, Überlingen). La caja de la tienda y la habilidad list-stores solo convertían a minúsculas de la A a la Z, por lo que estas tiendas nunca coincidían.
  • Las habilidades de solo lectura ahora están marcadas como de solo lectura donde la Abilities API lo comprueba, por lo que se llaman con GET como la API espera para las habilidades de solo lectura (GET solía devolver 405 y solo funcionaba POST). list-stores y get-directory-settings también aceptan una llamada sin parámetros.
  • La habilidad list-stores busca en todas las tiendas antes de aplicar su límite, de modo que se pueda encontrar una tienda posterior a la primera página.
  • La habilidad get-store carga únicamente la tienda solicitada.

1.2.5

  • Las etiquetas «Coming soon» y «Get notified» del aviso de actualización son cadenas de origen en inglés para todos los idiomas; los sitios en polaco solían recibir su propio texto de origen en polaco, que los traductores de otros idiomas veían luego sin traducir.

1.2.4

  • La promoción de PRO apuntaba a una pantalla llamada «Store Locator Import». El complemento de pago renombra esa pantalla a Lokilo Import, por lo que la instrucción nombraba una entrada de menú que no existe.

1.2.3

  • Corregido: la tarjeta de promoción de PRO en la pantalla de ajustes todavía les decía a los comerciantes que usaran [locator], el shortcode que la versión anterior reemplazó, por lo que ofrecía una instrucción que ya no funciona.

1.2.2

  • El shortcode ahora es [lokilo]. Antes era [locator], una etiqueta lo suficientemente genérica como para que cualquier otro plugin pudiera reclamarla primero y que ya no coincidía con el nombre del plugin. Esta es la última versión en la que esto se podía cambiar sin romper páginas existentes, porque el plugin aún no se había publicado.
  • El submenú de WooCommerce ahora muestra Lokilo en lugar de Store Locator, y se actualizaron los lugares donde la documentación todavía decía Locator.

1.2.1

  • La promoción de actualización de la barra lateral ahora sigue el mismo descarte que el banner. Antes, descartar el banner dejaba un anuncio de altura completa en la pantalla de ajustes de forma permanente, lo cual no es lo que la directriz de WordPress.org sobre avisos de actualización entiende por uso con moderación.

1.2.0

  • Se cambió el nombre a Lokilo. El equipo de revisión de WordPress.org solicita que el nombre de un plugin empiece con un identificador distintivo e inventado en lugar de una palabra descriptiva genérica. Lokilo significa herramienta de localización en esperanto. El textdomain adopta el nombre; las ubicaciones almacenadas, los ajustes, el shortcode [locator] y cada hook no sufren cambios.

1.1.9

  • Corregido: el directorio anunciaba cuántas ubicaciones había impreso, no cuántas tiene la tienda. Desde la versión 1.1.8 la página renderiza 200 por defecto, por lo que una tienda con 700 ubicaciones le decía a cada visitante y leía a cada lector de pantalla «200 locations». El conteo ahora dice «Showing 200 of 700 locations», y una tienda cuyas ubicaciones caben todas en la página se lee exactamente como antes.
  • Corregido: la caja de búsqueda solo buscaba en las ubicaciones impresas en la página y nada lo indicaba. A un visitante que buscaba la ubicación número 500 se le decía «No locations match your search» sin darle ningún motivo. Ahora, la página indica encima de la lista que está mostrando las primeras 200 de 700 y que la búsqueda solo cubre esas, y el resultado vacío lo vuelve a indicar.

1.1.8

  • Corregido: el directorio renderizaba todas las tiendas publicadas en la página. El shortcode ignoraba por completo sus atributos, por lo que no había forma de solicitar menos, y una tienda con una larga lista de franquicias generaba cada tienda, con una búsqueda de fotos independiente por tienda, en una sola página pública. [locator] ahora renderiza 200 tiendas y respeta limit, incluyendo limit="-1" para todas ellas, y las fotos de las tiendas se precargan en una sola pasada para toda la página en lugar de una búsqueda por cada tienda.

1.1.7

  • Corregido: la promoción de actualización a PRO seguía mostrándose a las personas que ya habían comprado la versión de pago. Solo se podía descartar el banner, por lo que la promoción de la barra lateral y las tarjetas de funciones bloqueadas perseguían permanentemente a los clientes de pago. La promoción ahora comprueba si la versión de pago está activa y se oculta cuando lo está.
  • Corregido: glifos de flecha en las rutas del menú de administración y en las cadenas entregadas a los traductores. Una flecha dentro de una cadena traducible convierte el glifo en un problema para cada traductor y altera el layout en cualquier configuración regional que la omita.

1.1.6

  • Corregido: al eliminar el plugin quedaba en la base de datos la marca de «descartar» por usuario del aviso de PRO. La desinstalación ahora la elimina para todos los usuarios, no solo para quien la descartó.

1.1.5

  • Se regeneró la plantilla de traducción. Todavía indicaba una versión anterior del plugin y apuntaba a líneas de código fuente que habían cambiado de lugar, que es lo que leen las herramientas de traducción para mostrar una cadena en contexto.

1.1.4

  • Se cambió el nombre a Plogins Locator – Store Locator for WooCommerce para que el nombre comience con la marca en lugar de una palabra genérica, que es lo que solicita el equipo de revisión de plugins de WordPress.org. El slug del plugin no cambia.

1.1.3

  • Se eliminó la cabecera «Tested up to» del archivo PHP principal. Pertenece únicamente a readme.txt, donde ya está declarada; al estar presente en ambos, la cabecera puede anular la del readme y mostrar una versión de compatibilidad no deseada.

1.1.2

  • Probado con WordPress 7.1. Verificado al activar esta compilación en una instalación limpia de 7.1 con WooCommerce 11.1, no editando la cabecera.

1.1.1

  • Se corrigió la promoción de PRO en la pantalla de ajustes que mostraba un precio en PLN. PRO tiene precio y se cobra en EUR, por lo que a un administrador en un sitio polaco se le mostraba una cantidad en zlotys y luego se le facturaba en euros, y la cifra en zlotys era una conversión fija que variaba respecto al cobro real a medida que fluctuaba el tipo de cambio. La promoción ahora muestra el precio en euros que realmente se cobra.

1.1.0

  • Un asistente de IA que trabaje en tu wp-admin ahora puede leer las ubicaciones de tus tiendas por ti, a través de la Abilities API de WordPress (WordPress 6.9 y posteriores). Pídele la tienda de una ciudad o código postal determinados y te responderá con la dirección, el teléfono, el correo electrónico y el horario de atención, exactamente lo que encontraría la caja de búsqueda de la tienda. También puede decirte cómo está configurado el directorio.
  • Solo lectura. Nada de lo que un asistente pueda invocar añade, edita o elimina una ubicación; eso queda en tus manos. Solo los usuarios que pueden gestionar WooCommerce pueden usar esto, y en WordPress 6.8 y versiones anteriores nada cambia.

1.0.7

  • El correo electrónico de la tienda que escribes en una ubicación ahora aparece en su tarjeta, como un enlace de clic para escribir junto al número de teléfono. Hasta ahora se guardaba y nunca se mostraba a los compradores.
  • La imagen destacada que estableces en una ubicación ahora aparece en la parte superior de su tarjeta.
  • El texto que escribes en el editor de ubicaciones ahora aparece debajo del nombre de la tienda.
  • Foto, descripción y correo electrónico tienen ahora su propio interruptor en WooCommerce > Store Locator, junto a los interruptores de dirección, horario de atención y teléfono.

1.0.6

  • Interno: la búsqueda en la lista de tiendas genera su lista de meta-keys mediante un mapa con tipos explícitos, de modo que el análisis estático pueda ver que solo cadenas llegan a la consulta. Sin cambios en el comportamiento.

1.0.4

  • Traducciones: se completaron en polaco, alemán y español para el panel de actualización a PRO.

1.0.3

  • Se corrigieron los encabezados de administración de bajo contraste bajo la preferencia de modo oscuro del sistema operativo.

1.0.2

  • Se añadieron traducciones integradas en polaco, alemán y español para la interfaz del plugin.

1.0.1

  • Primer lanzamiento estable.

0.1.4

  • Se cambió el nombre a Plogins Locator for WooCommerce para que el plugin tenga un nombre más distintivo.

0.1.3

  • Corrección: las ubicaciones de tiendas ya no se apropian de la capacidad manage_woocommerce. Al registrar el tipo de entrada de ubicaciones, se asignaron capacidades meta a manage_woocommerce, lo que hacía que fallara cada comprobación de manage_woocommerce mientras el plugin estaba activo, ocultando todo el menú de administración de WooCommerce (Ajustes, Estado, Pedidos) y la propia página de ajustes del plugin.

0.1.2

  • Importación programática de tiendas mediante StoreWriter con el filtro locator/import_store_fields y la acción locator/store_imported.

0.1.1

  • Añadido el filtro locator/store_groups para que los complementos puedan agrupar el directorio de la tienda por región o país.

0.1.0

  • Lanzamiento inicial: tipo de entrada store-location, shortcode [locator], lista con buscador, ajustes.