=== Scintilla Blocks – Gutenberg Blocks, Page Builder & Block Editor Library ===
Contributors:      scintillawpthemes
Tags:              blocks, gutenberg, page builder, block editor, accordion
Requires at least: 6.3
Tested up to:      6.9
Stable tag:        0.0.3
Requires PHP:      7.4
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Gutenberg blocks library and page builder for the WordPress block editor — container, accordion, testimonial carousel, counter, button, icon box, and more, with responsive controls.

== Description ==

**Scintilla Blocks** is a lightweight Gutenberg blocks library and page builder for the WordPress block editor. Build landing pages, FAQ sections, hero areas, service grids, testimonial sliders, and full website layouts with 13 advanced custom blocks — no shortcodes, no third-party page builders, no bloat.

Every block ships with responsive controls (desktop / tablet / mobile), typography, colors, backgrounds, borders, hover effects, and an advanced section for margin, padding, z-index, and CSS ID. A central admin dashboard lets you enable or disable any block and configure global breakpoints.

= Why Scintilla Blocks =

* **Native Gutenberg** — built on the WordPress block API. No iframes, no canvas hacks, no separate editor.
* **Full Site Editing (FSE) ready** — works in the post editor, the site editor, templates, and template parts.
* **Responsive everywhere** — every spacing, typography, and layout control has Desktop / Tablet / Mobile tabs.
* **Zero front-end bloat** — inline CSS only emitted for blocks that have values set; no jQuery, no global stylesheet.
* **Admin dashboard** — toggle each block on or off and configure tablet / mobile breakpoints from one screen.
* **Translation-ready** — full text domain support, GPL-2.0-or-later licensed, WordPress.org coding standards.

= Included Blocks =

* **Container** — Elementor-style flex and grid container with backgrounds (color, gradient, image), borders, box-shadow, responsive spacing, and inner blocks support. Build any section, hero, or column layout.
* **Heading** — advanced heading block (H1–H6) with responsive typography, gradient text, text-shadow, letter spacing, and link controls.
* **Paragraph** — advanced paragraph / rich-text block with responsive font size, line height, drop cap, and column count.
* **Button** — advanced button with icons, hover animations, gradient backgrounds, custom typography, border radius per corner, and link target.
* **Image** — advanced image with responsive dimensions, CSS filters (blur, grayscale, brightness), hover effects, mask, and lightbox-ready markup.
* **Icon** — Font Awesome icon block with size, color, rotation, and SVG upload support.
* **Image Box** — image + heading + description + button card with flexible layout (top / left / right), hover effects, and full styling.
* **Icon Box** — Font Awesome icon with title, description, and call-to-action — great for feature grids and services sections.
* **Icon List** — repeatable icon-list block with per-item icons, dividers, link support, and inline / stacked layout.
* **Counter** — animated number counter with prefix / suffix, easing, and responsive typography. Perfect for stats sections.
* **Testimonial Carousel** — Swiper.js-powered testimonial slider with repeater items, star ratings, author image, autoplay, navigation, and pagination.
* **Accordion** — FAQ-style accordion with multiple toggle items, expand / collapse icons, and full container styling.
* **Accordion Item** — child block for the Accordion, with rich-text title and inner-blocks body content.

= Page Builder Features =

* Drag-and-drop inside the native block editor — reorder, nest, duplicate, copy / paste styles.
* Per-block **Layout**, **Style**, and **Advanced** tabs.
* Responsive **Padding** and **Margin** on every block — set different values for Desktop, Tablet, and Mobile.
* Background **color**, **gradient**, and **image** with position, size, repeat, and overlay.
* **Border** controls per corner with radius, width, color, and box-shadow.
* **Typography** — font family, weight, size, line height, letter spacing, text transform, decoration, and shadow — all responsive.
* **Hover effects** — color, background, transform, transition duration.
* **Z-index**, **CSS ID**, and **additional class** for advanced layouts.

= Built for Performance =

* No external CSS / JS loaded unless a block is actually used on the page.
* No jQuery dependency on the front end.
* Inline `<style>` per block, scoped by unique ID — no global selector pollution.
* Lazy-loaded Swiper for the testimonial carousel only when present.

= Use Cases =

Landing pages, business websites, agency portfolios, FAQ pages, pricing tables, hero sections, feature grids, services pages, about pages, contact pages, blog post layouts, WooCommerce product descriptions, FSE site templates.

= Compatible With =

Block themes, classic themes, Full Site Editing (FSE), Site Editor, Twenty Twenty-Four, Twenty Twenty-Five, Astra, Kadence, GeneratePress, Blocksy, Neve, and most WordPress themes that support the block editor.

== Installation ==

1. Upload the `scintilla-blocks` folder to `/wp-content/plugins/`, or install through **Plugins → Add New** and search for "Scintilla Blocks".
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Open any post or page in the block editor and search for "Scintilla" in the block inserter to use the new blocks.
4. Visit **Scintilla Blocks** in the admin sidebar to enable / disable blocks and configure breakpoints.

== Frequently Asked Questions ==

= Is Scintilla Blocks a page builder? =

Yes — but it is built entirely on the native WordPress block editor. There is no separate editor, no iframe, no canvas. You get page-builder capability (containers, columns, responsive controls, hover effects) without leaving Gutenberg.

= Does this plugin slow down my site? =

No. Block styles are inlined per block instance only when used, there is no global stylesheet, and no jQuery is loaded on the front end. The Swiper library for the testimonial carousel loads only on pages that contain that block.

= Can I disable blocks I don't use? =

Yes. Open **Scintilla Blocks → Block Controls** and toggle off any block. Disabled blocks are removed from the inserter and their assets are not enqueued.

= Is it compatible with Full Site Editing? =

Yes. All blocks work inside the Site Editor, templates, template parts, patterns, and reusable blocks.

= Does it work with my theme? =

Yes. Scintilla Blocks works with any theme that supports the WordPress block editor — block themes (FSE) and classic themes alike. It has been tested with Twenty Twenty-Four, Twenty Twenty-Five, Astra, Kadence, GeneratePress, Blocksy, and Neve.

= Can I change tablet and mobile breakpoints? =

Yes. Go to **Scintilla Blocks → Global Settings** and set your own breakpoint values (px, em, rem are supported).

= Are the blocks responsive? =

Yes. Every spacing, typography, and layout control has separate Desktop, Tablet, and Mobile values, and the editor previews update live when you switch the device preview mode.

= Does it conflict with other block plugins? =

No. All blocks are namespaced under `scintilla-blocks/*` and styles are scoped by unique block IDs, so it runs cleanly alongside Kadence Blocks, GenerateBlocks, Stackable, Spectra, Ultimate Addons, and core blocks.

= Is it translation-ready? =

Yes. All strings are wrapped with the `scintilla-blocks` text domain and a `/languages` folder is included for `.pot` / `.po` / `.mo` files.

= Will existing content break if I disable a block? =

No. Saved attributes remain in the post content; the block simply stops rendering until you re-enable it.

== Screenshots ==

1. Block inserter showing all Scintilla Blocks in one category.
2. Container block with flex layout, background image, and responsive spacing controls.
3. Testimonial Carousel block with Swiper slider and repeater items.
4. Accordion block with multiple FAQ items and custom expand / collapse icons.
5. Admin dashboard — Block Controls tab with per-block enable / disable toggles.
6. Admin dashboard — Global Settings tab for tablet and mobile breakpoints.
7. Responsive Spacing panel — Desktop / Tablet / Mobile tabs in the Inspector.

== Changelog ==

= 0.0.3 =
* Initial release.
* 13 blocks: Container, Heading, Paragraph, Button, Image, Icon, Image Box, Icon Box, Icon List, Counter, Testimonial Carousel, Accordion, Accordion Item.
* Responsive Desktop / Tablet / Mobile controls on every block.
* Admin dashboard with per-block enable / disable toggles and global breakpoint settings.
* Live preview synced to the editor device preview mode.
* Font Awesome icon picker and SVG upload support.
* Swiper-powered testimonial carousel with conditional asset loading.

= 0.0.2 =
* Bug Fixes


== Upgrade Notice ==

= 0.0.1 =
Initial release — no upgrade steps required.
