=== Featured Post Carousel by Tag ===
Contributors: desparza
Tags: posts, carousel, owlcarousel, shortcode, custom-post-types
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](https://www.gnu.org/licenses/gpl-2.0.html)

Muestra entradas, páginas, productos y otros tipos de contenido personalizado por etiqueta en un carrusel responsive con OwlCarousel2.

== Descripción ==
Featured Post Carousel by Tag te permite mostrar contenido (entradas, páginas, productos y otros custom post types) que están etiquetados con el slug "featured" o "destacado" dentro de un carrusel responsive impulsado por OwlCarousel2. Inserta el carrusel usando el shortcode [featured-post-carousel-tag]. Desde los ajustes del plugin puedes elegir qué tipos de contenido incluir.

Características principales:

1. Shortcode [featured-post-carousel-tag] para mostrar un carrusel de elementos.
2. Muestra imagen destacada (clic → ficha), título (clic → ficha) y una acción "leer más" / añadir al carrito para productos.
3. Soporta entradas, páginas, productos de WooCommerce y otros custom post types.
4. Detecta taxonomías tipo etiqueta (post_tag, product_tag, o taxonomías personalizadas no jerárquicas) y busca términos con slug "featured" o "destacado".
5. Caché con transients para reducir el trabajo en la base de datos en accesos repetidos.
6. Preparado para traducción (text domain: featured-post-carousel-tag).

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

== Instalación ==

1. Sube la carpeta `featured-post-carousel-tag` a `/wp-content/plugins/`.
2. Activa el plugin desde el admin de WordPress.
3. Ve a **Featured Post Carousel** en el menú del admin y selecciona qué tipos de contenido incluir.
4. Coloca los archivos de OwlCarousel2 (2.3.4) si quieres copias locales:

   * `public/js/owl.carousel.min.js`
   * `public/css/owl.carousel.min.css`
   * `public/css/owl.theme.default.min.css`
     (Si faltan los archivos, el plugin muestra una notificación en el admin.)
5. Inserta el shortcode donde lo necesites: `[featured-post-carousel-tag]`.

== Uso ==
Ejemplo de shortcode:
[featured-post-carousel-tag per_page="8" items="3" autoplay="true"]

Atributos:

* per_page — número de elementos a consultar (por defecto 8)
* items — número de elementos visibles en escritorio (por defecto 3)
* autoplay — "true" o "false" (por defecto "true")

== Preguntas frecuentes ==
= ¿Qué etiquetas busca el plugin? =
El plugin busca etiquetas con slug `featured` o `destacado` en las taxonomías registradas para los tipos de contenido seleccionados (por ejemplo `post_tag`, `product_tag` o taxonomías personalizadas no jerárquicas).

= Mis páginas no tienen etiquetas — ¿qué puedo hacer? =
Por defecto WordPress no añade etiquetas ni categorías a las páginas. Para habilitar etiquetas/categorías en páginas puedes añadir lo siguiente al `functions.php` de tu tema o a un pequeño plugin:

function fpct_enable_tags_for_pages() {
// Añadir post_tag a páginas
register_taxonomy_for_object_type( 'post_tag', 'page' );
// Añadir category a páginas
register_taxonomy_for_object_type( 'category', 'page' );
}
add_action( 'init', 'fpct_enable_tags_for_pages' );

== Servicios externos ==
Este plugin incluye el archivo JavaScript oficial de OwlCarousel 2.3.4. La distribución estándar de OwlCarousel contiene opcionalmente código para soportar vídeos embebidos desde proveedores externos (por ejemplo Vimeo o Vzaar) y en esas configuraciones específicas puede solicitar miniaturas o metadatos públicos a dichos servicios.

**Importante:**
El plugin **no utiliza ni activa estas funciones de vídeo por defecto**.
En la configuración actual del plugin **no se realizan peticiones a servicios externos**.
Las solicitudes externas solo ocurrirían si un administrador incluye intencionadamente vídeos de esos proveedores en un carrusel.

== Registro de cambios ==
= 1.0.0 =

* Versión inicial.
* Shortcode [featured-post-carousel-tag].
* Página de ajustes en el admin.
* Saneamiento, escapado y caché implementados siguiendo buenas prácticas de WP.

== Donaciones ==
Si te resultó útil este plugin y quieres apoyar el desarrollo, invítame a un café. ¡Gracias! ☕️
[Buy me a coffee](https://buy.stripe.com/aFadR96KU6oU5Mxfw68N200)
