=== 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.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Exiba um carousel de conteúdo (notícias, páginas ou qualquer tipo de conteúdo customizado) 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
conteúdo puxado 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:

* **Tipo de conteúdo configurável** — por padrão busca notícias (posts), mas também funciona com
  Páginas ou qualquer tipo de conteúdo customizado (CPT) público registrado em qualquer site da
  rede. Tipo novo aparece sozinho no seletor assim que existir.
* **Multi-seleção de site + categoria/taxonomia** — escolha um ou mais termos (categoria, ou a
  taxonomia equivalente do tipo de conteúdo escolhido), de um ou mais sites da rede. Termo 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. Escolha o **"Tipo de conteúdo"** (Posts é o padrão) e, no painel "Fonte das notícias", escolha
   uma ou mais opções em "Site(s) + Termo(s)".

== Frequently Asked Questions ==

= Preciso editar código quando criar uma categoria, taxonomia, tipo de conteúdo ou site novo? =

Não. Os seletores "Tipo de conteúdo" e "Site(s) + Termo(s)" são lidos do banco toda vez que o
editor do Elementor é aberto — tipo de conteúdo, taxonomia, termo 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.3.0 =
* Novo controle "Tipo de conteúdo": o carousel agora pode buscar Posts (padrão, retrocompatível),
  Páginas, ou qualquer tipo de conteúdo customizado (CPT) público registrado em qualquer site da
  rede, sem editar código.
* O seletor de origem passou de "Site(s) + Categoria(s)" para "Site(s) + Termo(s)": lista os termos
  das taxonomias públicas registradas para o Tipo de conteúdo escolhido (ex.: Categoria para Posts,
  ou uma taxonomia customizada para um CPT), em qualquer site da rede.
* Retrocompatível: instâncias já configuradas continuam idênticas (Tipo de conteúdo = Posts,
  origens antigas de categoria continuam funcionando sem precisar reconfigurar nada).

= 1.2.1 =
* Ajuste cosmético: o nome da categoria de widgets no editor do Elementor passou de
  "Modulareasy — Multisite" para "Modulareasy · Multisite" (separador padrão da marca). Sem
  mudança de comportamento do widget.

= 1.2.0 =
* Atualização automática: o plugin agora consulta o site da Modulareasy periodicamente e mostra
  a notificação nativa de "nova versão disponível" na tela Plugins (e em Rede Admin, Atualizações,
  quando ativado pela rede), com o botão "Atualizar agora" de sempre. Sem mudança de comportamento
  do widget.

= 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.3.0 =
Novo controle "Tipo de conteúdo" (Posts continua sendo o padrão): carousel agora funciona também
com Páginas e CPTs. Retrocompatível, instâncias já configuradas continuam idênticas.

= 1.2.0 =
Ativa atualização automática pelo site da Modulareasy: sem mudança de comportamento do widget.

= 1.0.0 =
Primeira versão pública.
