=== Modulareasy Multisite News Carousel ===
Contributors: modulareasy
Tags: elementor, multisite, carousel, news, widget
Requires at least: 6.4
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Exiba um carousel de últimas notícias de qualquer site de uma rede WordPress Multisite dentro de qualquer outro site da mesma rede — widget nativo do Elementor, 100% configurável pela UI.

== Description ==

**Modulareasy Multisite News Carousel** adiciona um widget do Elementor que exibe um carousel de
últimas notícias puxadas de **qualquer site de uma rede WordPress Multisite**, dentro de
**qualquer outro site da mesma rede** — por exemplo, as notícias do site principal aparecendo
dentro de um site "vertical"/hub secundário da mesma rede.

Toda a configuração acontece pela UI do Elementor, sem editar código:

* **Multi-seleção de site + categoria** — escolha uma ou mais categorias, de um ou mais sites
  da rede. Categoria ou site novo aparece sozinho no seletor assim que existir, sem precisar
  editar nada.
* **Mescla inteligente** — quando mais de uma origem é selecionada, as notícias de todas
  aparecem juntas no mesmo carousel, sem duplicar o mesmo post caso ele esteja em duas categorias
  escolhidas.
* **Modo "todas as notícias de um site"** — em vez de selecionar categoria por categoria, escolha
  um site da rede e o carousel puxa TODAS as publicações dele.
* **Ordenação configurável** — ordene por Data, Título, Autor ou Categoria, em ordem crescente ou
  decrescente. A ordem é aplicada sobre o conjunto já mesclado de todos os sites (a ordem global
  fica correta, não só dentro de cada site).
* **Layout responsivo completo** — slides por breakpoint (desktop/tablet/mobile), espaçamento,
  autoplay com velocidade configurável, loop infinito, setas e paginação opcionais.
* **Dois modos visuais de card** — overlay (foto preenchendo o card com título sobreposto) ou
  clássico (foto em cima, texto embaixo com resumo).
* **Altura do card por Proporção (aspect-ratio) ou Fixa** (px/vh, responsiva por breakpoint).
* **Herda a identidade visual do site** — cores e tipografia globais do Kit do Elementor por
  padrão, com todos os controles de estilo do Elementor Style tab disponíveis pra sobrescrever.
* **Cache-aware** — ao publicar/atualizar uma notícia no site principal da rede, o plugin limpa
  automaticamente o cache de página do WP Rocket (se instalado) dos outros sites da rede, pra
  que o carousel reflita a notícia nova sem esperar o cache expirar.

Requer **WordPress Multisite** e **Elementor** (ativo em cada site onde o widget for usado).
Ative o plugin pela Rede (Network Admin → Plugins) para que o widget fique disponível em todos
os sites da rede.

== Installation ==

1. Faça upload da pasta `modulareasy-multisite-news-carousel` para `/wp-content/plugins/` (ou
   instale o `.zip` direto por Rede Admin → Plugins → Adicionar novo → Enviar plugin).
2. Ative o plugin pela **Rede** (Network Admin → Plugins → Ativar pela rede) — não pela ativação
   de site individual, senão o widget não vai aparecer em todos os sites.
3. Confirme que o **Elementor** está ativo no(s) site(s) onde o widget será usado.
4. No editor do Elementor, procure o widget **"Carousel de Notícias (Multisite)"** na categoria
   **"Modulareasy — Multisite"** e arraste pra dentro da página.
5. No painel "Fonte das notícias", escolha uma ou mais opções em "Site(s) + Categoria(s)".

== Frequently Asked Questions ==

= Preciso editar código quando criar uma categoria ou site novo? =

Não. O seletor "Site(s) + Categoria(s)" é lido do banco toda vez que o editor do Elementor é
aberto — categoria ou site novo aparece sozinho na lista.

= Funciona fora de Multisite? =

Não. O plugin depende de `switch_to_blog()` para ler posts de outros sites da rede — em uma
instalação WordPress single-site o seletor de origem fica vazio.

= Precisa do Elementor Pro? =

Não necessariamente — o widget depende apenas da biblioteca Swiper que o Elementor (versão
gratuita) já registra para seus próprios widgets nativos.

== Screenshots ==

1. Painel "Fonte das notícias" com o seletor multi-select de Site + Categoria.
2. Carousel renderizado no front, modo overlay (padrão).
3. Carousel renderizado no front, modo clássico (overlay desligado).

== Changelog ==

= 1.1.0 =
* Novo modo de fonte "Todas as notícias de um site" — escolha um site da rede e o carousel puxa
  TODAS as publicações dele, sem precisar selecionar categoria por categoria. O modo "Categorias
  específicas" continua sendo o padrão.
* Novos controles de ordenação "Ordenar por" (Data, Título, Autor, Categoria) e "Ordem"
  (Decrescente/Crescente). A ordenação é aplicada sobre o conjunto já mesclado de todos os sites,
  não por site — a ordem global fica correta. "Por categoria" ordena pelo nome da categoria (a
  primeira em ordem alfabética quando o post tem mais de uma).
* Retrocompatível: instâncias já configuradas continuam idênticas (Fonte = Categorias
  específicas, ordenação por Data decrescente).

= 1.0.0 =
* Primeira versão pública do produto Modulareasy: seleção multi-site/multi-categoria, mescla e
  deduplicação por data, layout responsivo completo, dois modos de card (overlay/clássico),
  altura por proporção ou fixa, cache-aware (WP Rocket).

== Upgrade Notice ==

= 1.0.0 =
Primeira versão pública.
