=== Brigade Blocks Addons ===
Contributors: brigadethemes
Tags: blocks, gutenberg, block editor, icon box, page builder alternative
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Modular blocks for the native WordPress Block Editor. Enable only the modules you need.

== Description ==

Brigade Blocks Addons extends the WordPress Block Editor with professionally designed blocks, without a page builder. Everything is organised into modules you can switch on or off; a disabled module registers no blocks, scripts or styles.

Every block can be styled in depth from the editor's Styles tab — typography, colors, gradients, background images with overlays, borders, per-corner radius, layered box shadows, spacing, sizes, flex and grid layout, position, opacity and visibility — separately for hover, focus and active states and for desktop, tablet and mobile. Only the controls that make sense for each block are shown.

Blocks use the Donix design system — coral accent, ink headings, Urbanist type and a single 6px radius — and every value is a CSS custom property your theme can override.

= Content module (available now) =

* Container — nestable flex or grid layout wrapper: full-width or boxed content, presets (columns, centered, horizontal), sizing, positioning, transforms, backgrounds, overlays and per-device settings; any block inside gets flex-item controls
* Heading — eyebrow label, accent separator, supporting text
* Text Editor — rich text with columns and drop cap
* Image — aspect-ratio crop, hover effects, caption, link
* Image Box — stacked or overlay image card
* Icon — 49 line icons with tinted badge styles
* Icon Box — feature / service card
* Button — primary, dark, outline and text styles
* Divider — with optional label or icon
* Spacer — separate desktop, tablet and mobile heights
* Video — YouTube, Vimeo or self-hosted, loaded on click
* HTML — custom markup with live preview
* Shortcode
* Google Maps — no API key, info card, directions link, optional click-to-load for GDPR

= Interactive module =

* Accordion — native, JavaScript-free; one-at-a-time option; FAQ schema
* Nested Accordion
* Tabs — accessible, keyboard navigable, deep-linkable; horizontal or vertical
* Content Toggle — switch between two panels, e.g. monthly and yearly pricing
* Timeline — one-sided or alternating
* Process Steps — numbered or icon steps with connectors
* Slider — slides you design yourself with any blocks, each with its own background image, colour and overlay; slide or fade, one or several slides at a time, arrows, dots and autoplay

= Marketing module =

* Flip Box — flips on hover, focus or tap
* Call to Action — dark, brand, tinted or image background
* Counter — animated statistic
* Progress Bar — fills when scrolled into view

= Posts module =

* Posts — one block with five layouts (grid, list, masonry, carousel, slider) and three sources (custom query, most recent, related to the current post); any public post type, category/tag filters, responsive columns
* AJAX Load More, Infinite Scroll and AJAX category filter
* Author Box
* Dynamic Content — show a post field or custom field anywhere, including inside the Query Loop

= Media module =

* Gallery — one block with four layouts (grid, masonry, carousel, slider), an accessible lightbox, captions, hover effects and a filter bar built from image tags
* Before / After — compare two images with a draggable divider; horizontal or vertical, keyboard and touch friendly
* Video Gallery — YouTube, Vimeo or self-hosted videos in a grid or carousel; play in a lightbox or in place, loaded only when clicked

= WooCommerce module (when WooCommerce is active) =

* Products — one block with four layouts (grid, list, carousel, slider) and nine sources: latest, featured, on sale, best selling, top rated, hand-picked, related, upsells and cross-sells; AJAX add to cart, sale badges and a second image on hover
* Product Categories — image tiles in a grid or carousel
* Product Search — with an optional category dropdown
* Add to Cart — for any product or the one being viewed, with quantity
* Mini Cart — live count and total, with an accessible slide-in cart drawer
* Store Page — WooCommerce's cart, checkout or My Account inside your own page layout

= Forms & Users module =

* Login Form — log in, register and reset a password in one block, without reloading the page; falls back to the standard WordPress login whenever needed (no JavaScript, cached pages, two-factor plugins) and works with captcha and security plugins
* User Profile — the visitor's avatar, name, bio, account and log-out links
* Form Styler — Contact Form 7 and WPForms forms in your design

= Advanced module =

* Advanced Search — keyword, content type and taxonomy filters with accessible live results
* Taxonomy Filter — categories, tags or any taxonomy as chips, a list or a dropdown, linking to their archives

= Data Visualization module =

* Chart — bar, horizontal bar, line, area, pie, doughnut and radar charts from numbers you type (or paste from a spreadsheet) or from a CSV / Google Sheets link; lightweight SVG with a data table for screen readers, no chart library
* Progress Chart — progress rings and half-circle gauges
* Statistics Cards — key numbers that count up, with trend badges and sparklines

= Coming next =

Pricing Table, Countdown and Logo Showcase, then People (team members, testimonials), Navigation (breadcrumbs, table of contents) and Utilities (social icons, WhatsApp chat).

= Brigade Blocks Addons Pro =

A separate, optional add-on adds a Dynamic Data module: Loop Builder, Dynamic Tags and Conditional Content. This plugin is complete on its own and contains no Pro code; its settings screen lists Pro modules and blocks with a PRO badge so you can see what the add-on includes.

= Performance and privacy =

* Styles load only on pages that use a block.
* Front-end scripts are tiny, dependency-free and load only with their block: click-to-load for Video and Google Maps, Tabs, Content Toggle, Counter, Progress Bar, carousels, AJAX load more / filter, live search, the login form, the mini cart drawer and chart animations. Accordion, Flip Box, post grids, lists and masonry, and every chart itself need no JavaScript.
* The Urbanist font is served from your own site. Choose "Inherit from theme" to load no fonts at all.
* YouTube uses youtube-nocookie.com and Vimeo uses do-not-track; neither loads until the visitor presses play.

== External services ==

Some blocks can show content from third-party services. Nothing is sent to these services unless you add the block to a page, and the Video and Google Maps blocks can wait until the visitor clicks before loading anything.

= Google Maps (Google Maps block) =

The Google Maps block embeds a map from Google Maps (maps.google.com) for the address or place you enter, and can link to Google Maps directions. When the map loads, the visitor's browser requests it from Google, which receives the visitor's IP address, browser details and the address or place shown. With "Click to load" enabled, nothing is requested until the visitor clicks the map.

* Terms of Service: https://policies.google.com/terms and https://maps.google.com/help/terms_maps/
* Privacy Policy: https://policies.google.com/privacy

= YouTube (Video and Video Gallery blocks) =

When a Video or Video Gallery block uses a YouTube link without a custom poster, the thumbnail is loaded from i.ytimg.com and, after the visitor presses play, the video is embedded from youtube-nocookie.com. YouTube receives the visitor's IP address, browser details and the video ID.

* Terms of Service: https://www.youtube.com/t/terms
* Privacy Policy: https://policies.google.com/privacy

= Vimeo (Video and Video Gallery blocks) =

When a Video or Video Gallery block uses a Vimeo link, the video is embedded from player.vimeo.com (with Do Not Track) after the visitor presses play. Vimeo receives the visitor's IP address, browser details and the video ID.

* Terms of Service: https://vimeo.com/terms
* Privacy Policy: https://vimeo.com/privacy

= Google Sheets or another CSV link (Chart block) =

Only when you set a Chart block's data to "From a link", your website's server downloads that link — for example a Google Sheet (docs.google.com) or any CSV file address you enter — to draw the chart, and keeps a cached copy (5 minutes to one day, as you choose). The request is made by your server, not by visitors' browsers; it contains no visitor data, only the address you entered. Private or local network addresses are never contacted.

* Google Terms of Service: https://policies.google.com/terms
* Google Privacy Policy: https://policies.google.com/privacy
* For any other address, the terms and privacy policy of the site that hosts the file apply.

== Installation ==

1. Upload the plugin through Plugins → Add New Plugin → Upload Plugin, or copy it to wp-content/plugins.
2. Activate Brigade Blocks Addons.
3. Open Brigade Blocks in the admin menu to choose modules and blocks.
4. In the editor, search for "Brigade" in the block inserter.

== Frequently Asked Questions ==

= Does it require a page builder? =

No. It is built entirely on the native Block Editor.

= What happens to my content if I disable a module? =

Nothing is deleted. The blocks stop rendering and are restored as soon as you switch the module back on.

= Can my theme change the colors and fonts? =

Yes. Override the --wpbb-* custom properties, for example :root { --wpbb-brand: #0a7cff; }.

= Is there a Pro version? =

Yes, Brigade Blocks Addons Pro is a separate add-on that needs this plugin. Everything described above is free and stays free.

= Where is the source code of the compiled scripts? =

The human-readable source of every file in build/ is included in the src/ folder of the plugin. Build it with Node.js: `npm install` then `npm run build` (see package.json).

== Credits ==

* Urbanist font by The Urbanist Project Authors (https://github.com/coreyhu/Urbanist), licensed under the SIL Open Font License 1.1 (see assets/fonts/OFL.txt). Bundled so no font is loaded from third-party servers.
* Line icons were drawn for this plugin and are licensed under GPLv2 or later.

== Screenshots ==

1. Modules screen: switch modules on or off; a disabled module loads no blocks, scripts or styles.
2. Style every detail from the Styles tab: typography, colour, spacing, border and shadow, per device and for hover.
3. Slider block: design every slide yourself, with its own background, overlay and content.
4. Posts, Gallery and WooCommerce Products in grid, list, masonry, carousel or slider layouts.
5. Tabs, Accordion, Timeline and Process Steps.
6. Charts, progress rings and statistics cards, drawn as lightweight SVG with no chart library.
7. Login Form and Form Styler, in your own design.

== Changelog ==

= 1.0.0 =
* Styling system: per-element, per-state and responsive styling controls for every block, in the native Styles tab with live editor preview.
* New Container block: flex/grid layout types, boxed content width, presets, flex-item settings for any child block, positioning, transforms, responsive visibility.
* Styling system: layout, sizing, position, transform and transition-timing controls; breakpoints filterable with wpbb_style_breakpoints.
* Initial release: modular core, settings screen, Donix design tokens, Content (14 blocks), Interactive (6 blocks), Marketing (4 blocks), Posts (Posts block with five layouts, Author Box, Dynamic Content) and Media (Gallery, Before / After, Video Gallery) modules.
* WooCommerce module: Products, Product Categories, Product Search, Add to Cart, Mini Cart, Store Page.
* Forms & Users module: Login Form (login, registration, lost password, without page reloads), User Profile, Form Styler for Contact Form 7 and WPForms.
* Advanced module: Advanced Search with live results, Taxonomy Filter.
* Slider block: slides you design yourself with any blocks, each with its own background image, colour and overlay; slide or fade effect, one or several slides at a time, arrows, dots and autoplay.
* Settings screen: saves without reloading the page; modules and blocks of the Pro add-on are marked PRO and listed as locked while Pro is not active.
* Data Visualization module: Chart (bar, horizontal bar, line, area, pie, doughnut, radar; typed, pasted or from a CSV / Google Sheets link), Progress Chart, Statistics Cards.
