=== All Post Type Ajax Search ===
Contributors: desparza
Tags: ajax, search, custom-post-types, shortcode, realtime
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Buscador AJAX en tiempo real. Selecciona desde el admin qué tipos de contenido (post types) aparecen. Shortcode: [all-post-type-ajax-search]

== Description ==

All Post Type Ajax Search añade un buscador ligero y seguro que devuelve resultados en tiempo real (AJAX). Desde la pantalla de ajustes puedes seleccionar exactamente qué tipos de contenido (Entradas, Páginas, Productos, y otros Custom Post Types) se deben incluir en las búsquedas. Cada resultado incluye miniatura (o imagen por defecto), título y enlace.

Principales ventajas:

* Búsqueda rápida en frontend con hasta 5 resultados y mínimo 3 caracteres.
* Control total desde el administrador: selecciona los post types que aparecerán.
* Filtrado inteligente para evitar mostrar tipos técnicos (attachments, revisiones, órdenes, variaciones, etc.).
* Implementado siguiendo buenas prácticas de seguridad: nonces, sanitización y escape.
* Código procedural y simple, apto para personalización por desarrolladores de todos los niveles.
* Preparado para traducciones (textdomain: all-post-type-ajax-search).

== Features ==

1. Shortcode simple: [all-post-type-ajax-search].
2. Ajustes en Admin: seleccionar post types habilitados y establecer imagen por defecto (URL).
3. Resultado por item: miniatura (o imagen por defecto), título y enlace.
4. Lógica de búsqueda que reparte resultados entre post types para no priorizar siempre 'post' o 'page'.
5. Limite por defecto: 5 resultados; mínimo 3 caracteres para iniciar búsqueda.
6. Rendimiento: no_found_rows en consultas, limitación de posts por query.
7. Seguridad: nonces en AJAX y ajustes; capability checks (manage_options) en admin.
8. Fácilmente extensible con filtros y acciones (p. ej. apply_filters( 'aptas_default_image', ... )).

== Installation ==

1. Subir la carpeta `all-post-type-ajax-search` al directorio `/wp-content/plugins/`.
2. Activar el plugin desde el menú **Plugins** en el escritorio de WordPress.
3. Ir a **CP Ajax Search** en el menú del admin y seleccionar los post types a incluir.
4. Insertar el shortcode `[all-post-type-ajax-search]` donde quieras mostrar el buscador.

== Video == 
[youtube https://www.youtube.com/watch?v=5StfrP4YTFM]

== Frequently Asked Questions ==

= ¿Qué post types aparecen en la lista de ajustes? =
Sólo se muestran tipos relevantes: entradas (post), páginas (page), productos (product) y otros CPT públicos o con UI en el administrador. Tipos técnicos (attachment, revision, nav_menu_item, shop_order, product_variation, etc.) se ocultan automáticamente.

= ¿Puedo cambiar el número máximo de resultados? =
Actualmente el valor por defecto es 5. Puedes modificarlo añadiendo un parámetro en la localización de scripts o cambiar la constante/localización en el código. También puedo añadir una opción en la pantalla de ajustes si lo deseas.

= ¿Cómo se controla la imagen por defecto? =
Desde Ajustes → CP Ajax Search tienes un campo para la URL de la imagen por defecto. Además hay un filtro PHP: add_filter( 'aptas_default_image', function(){ return 'https://tudominio/...'; } );

= ¿Es compatible con WooCommerce? =
Sí. Si tienes el post type product registrado (WooCommerce), aparecerá en la lista y puede incluirse en las búsquedas.

= ¿Está preparado para ser traducido? =
Sí. Todas las cadenas principales usan funciones de internacionalización y el text domain all-post-type-ajax-search.

== Screenshots ==

1. Ajustes: pantalla donde seleccionar los post types y la imagen por defecto.
2. Frontend: input de búsqueda y lista de resultados (miniatura, título, tipo).
3. Ejemplo del shortcode incrustado en una página.

== Changelog ==

= 1.0.0 =
* Versión inicial.
* Shortcode [all-post-type-ajax-search].
* Interfaz de ajustes: selección de post types y URL de imagen por defecto.
* Búsqueda AJAX en tiempo real con límite y reparto por post type.
* Implementación segura (nonces, sanitización, escape) y optimizada (no_found_rows).

== Upgrade Notice ==

= 1.0.0 =
Primer lanzamiento. Instalación simple y configuración mínima para empezar a usar el buscador.

== Additional Notes for Developers ==

* Opciones guardadas:
  * aptas_search_post_types (array): post types habilitados.
  * aptas_default_image_url (string): URL de la imagen por defecto.
* Nonces:
  * AJAX: aptas_search_nonce
  * Admin: aptas_settings_save (name aptas_settings_nonce)
* Shortcode: [all-post-type-ajax-search]
* Filtros útiles:
  * aptas_default_image — permite sustituir la imagen por defecto vía código.
* Hooks:
  * aptas_ajax_search (ajax action) — usar wp_ajax_aptas_ajax_search / wp_ajax_nopriv_aptas_ajax_search.
* Recomendación: para sitios con muchos CPTs o resultados se puede mejorar la búsqueda con índices o búsquedas por título/meta específicas (en futuras versiones).

== Donaciones ==
¿Te fue útil este plugin? Si te gusta mi trabajo y deseas que siga desarrollando, invítame a un café. ¡Mil gracias por tu apoyo! ☕️
[Invítame a un café](https://buy.stripe.com/aFadR96KU6oU5Mxfw68N200)