=== Gravisain Blocks ===
Contributors: yudisain
Tags: blocks, gutenberg, page builder, block patterns, layout
Requires at least: 6.2
Tested up to: 7.1
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Modular Gutenberg blocks with responsive design controls for website creation.

== Description ==

Gravisain Blocks provides a comprehensive suite of 40+ responsive Gutenberg blocks and block patterns for WordPress, allowing you to create high-performance, structured page layouts directly within the native block editor.

Each block includes responsive controls across desktop, tablet, and mobile devices, with settings logically organized into General, Style, and Advanced tabs. Frontend scripts use pure Vanilla JavaScript with zero jQuery, ensuring fast load times and clean output.

= 40+ Custom Blocks Included =

**Layout & Containers**
* **Row Layout** – Responsive grid and flex row containers with customizable column gutters, backgrounds, and overlays.
* **Column** – Independent column wrapper with device-specific column spans and alignment options.
* **Section / Container** – Flexible container wrapper with responsive width, minimum height, and overflow controls.
* **Spacer / Divider** – Space divider with responsive height controls across device breakpoints.
* **Navigation** – Responsive site navigation menu container.
* **Navigation Link** – Navigation menu item link with custom label and target options.
* **Site Identity** – Render your site logo, title, and tagline with typography and spacing controls.

**Typography & Content**
* **Advanced Heading** – Responsive typography with device-specific font sizes, line heights, gradient text, highlight styling, and custom margins.
* **Advanced Text** – Extended paragraph typography and text styling controls.
* **Badge** – Status badges, category tags, and pill labels with color and border styling.
* **Table of Contents** – Automatically generate interactive anchor links from post headings.
* **Table** – Clean, responsive data tables with custom cell padding and border styling.
* **Show More** – Expandable content toggle for read-more sections and collapsible text.

**Buttons & Call to Action**
* **Advanced Button** – Standalone customizable buttons with icon positioning, hover animations, and border radius.
* **Buttons Group** – Responsive flex layout button groups with alignment and gap controls.
* **Marquee** – Animated continuous scrolling text, logos, or content ticker.

**Media & Visuals**
* **Image** – Advanced image block with aspect ratio, border radius, and overlay styling.
* **Advanced Gallery** – Multi-column responsive image gallery with gap and lightbox controls.
* **Vector / SVG** – Custom vector and SVG graphics renderer with color and dimension controls.
* **Video Popup** – Interactive modal video player supporting YouTube, Vimeo, and self-hosted video.
* **Lottie Animations** – Interactive JSON Lottie player with loop, autoplay, and speed controls.
* **Google Maps** – Interactive Google Maps embeds with location queries and custom height.

**Interactive & Cards**
* **Hero Section** – Modern hero banner sections with headings, buttons, and responsive backgrounds.
* **Modal Popup** – Interactive modal dialog popups triggered by buttons or user actions.
* **FAQ Accordion** – Interactive accordion containers with toggle icons and animated transitions.
* **FAQ Item** – Accordion item with question header and rich collapsible content area.
* **Tabs** – Horizontal and vertical tab interfaces with customizable active states.
* **Tab Pane** – Independent content canvas for each tab panel.
* **Info Box** – Feature info boxes with icon presets, headings, and description text.
* **Feature Card** – Modern feature presentation cards with icon presets and hover effects.
* **Features Grid** – Responsive grid layouts for displaying multiple feature highlights.
* **Icon & Icon List** – SVG and Dashicon icons with custom sizing, circle backgrounds, and list layouts.

**Social Proof & Dynamics**
* **Testimonial** – Individual client review card with avatar, rating stars (1-5), and quote styling.
* **Testimonials Grid** – Showcase client testimonials in responsive multi-column layouts.
* **Count Up** – Animated numeric stat counters with prefix, suffix, and duration controls.
* **Countdown Timer** – Fixed-date and evergreen countdown timers with localized labels.
* **Posts Grid** – Dynamic query loop displaying recent posts with featured images, excerpts, and meta.

**Forms, Search & Marketing**
* **Form & Input Fields** – Native Gutenberg contact form container with input fields.
* **Advanced Form** – Structured multi-field forms with validation and styling options.
* **Search** – Integrated site search bar with customizable input background, button styles, and border radius.
* **Progress Bar** – Visual progress indicators with percentage labels and animated stripes.
* **Advertisement / Ad Space** – Structured Google AdSense slots (Publisher ID & Slot ID) and clickable image banners.

= Key Features =
* **100% Native Block Editor:** Built strictly to WordPress core block standards and dynamic CSS custom properties.
* **Zero jQuery Frontend:** Fast, lightweight Vanilla JavaScript frontend execution with zero jQuery dependencies.
* **Modular Asset Loading:** Scripts and styles for each block are only enqueued when that specific block is present on the page.
* **Organized Inspector Controls:** Block settings structured cleanly across General, Style, and Advanced tabs.

== Installation ==

1. Upload the `gravisain-blocks` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Open any page or post in the Gutenberg Block Editor and click the '+' inserter to find the 'Gravisain Blocks' category.

== Frequently Asked Questions ==

= Which themes are compatible with Gravisain Blocks? =
Gravisain Blocks is compatible with any WordPress theme that supports the Block Editor (Gutenberg), including block themes and classic themes.

= Does this plugin require jQuery? =
No. Frontend scripts use Vanilla JavaScript without jQuery dependencies.

= Are block assets loaded on every page? =
No. Styles and scripts for each block are only enqueued when that block is present on the page.

== External Services ==

This plugin utilizes external services to deliver typography fonts, interactive map embeds, advertising units, and optional login security protection:

1. **Google Fonts**
* **Service Name:** Google Fonts
* **Provider:** Google LLC
* **Usage:** Used to render typography fonts in Gutenberg blocks when non-system fonts are chosen in block typography settings (e.g. Advanced Heading, Hero, Advanced Text). The plugin loads stylesheets from `https://fonts.googleapis.com` and web font files from `https://fonts.gstatic.com`.
* **What Data is Sent and When:** When a user views a page containing blocks configured with Google Fonts, the visitor's browser sends an HTTP GET request to Google servers including standard browser request headers (such as IP address and User-Agent) to download the requested font files. No personal identifiable information (PII) is collected or stored by this plugin.
* **Terms of Service:** https://policies.google.com/terms
* **Privacy Policy:** https://policies.google.com/privacy

2. **Google Maps Embed**
* **Service Name:** Google Maps Embed
* **Provider:** Google LLC
* **Usage:** Used when the Google Maps block (`gravisain/google-maps`) is added to a page or post to display an interactive map based on the location entered by the editor. The block embeds an iframe from `https://maps.google.com/maps`.
* **What Data is Sent and When:** When a visitor views a page containing the Google Maps block, the visitor's browser loads the map iframe directly from Google servers, sending standard browser request headers (such as IP address and User-Agent) and the configured location query parameters.
* **Terms of Service:** https://policies.google.com/terms
* **Privacy Policy:** https://policies.google.com/privacy

3. **Google AdSense (Optional)**
* **Service Name:** Google AdSense
* **Provider:** Google LLC
* **Usage:** Used only when the Advertisement / Ad Space block (`gravisain/ad`) is configured in "Google AdSense" mode with a valid Publisher ID (`ca-pub-xxx`) and Slot ID. The block renders a structured `<ins class="adsbygoogle">` unit.
* **What Data is Sent and When:** When a visitor views a page containing an active AdSense ad unit, the visitor's browser communicates with Google AdSense servers to retrieve relevant ad content, transmitting standard browser request data.
* **Terms of Service:** https://policies.google.com/terms
* **Privacy Policy:** https://policies.google.com/privacy

4. **Cloudflare Turnstile (Optional)**
* **Service Name:** Cloudflare Turnstile
* **Provider:** Cloudflare, Inc.
* **Usage:** Used only when explicitly enabled by an administrator under `Gravisain > Login Security` and valid API keys are configured. When enabled, it enqueues the official Turnstile API script (`https://challenges.cloudflare.com/turnstile/v0/api.js`) on `wp-login.php` and verifies verification tokens with Cloudflare's API (`https://challenges.cloudflare.com/turnstile/v0/siteverify`) to protect against brute-force login attacks.
* **Terms of Service:** https://www.cloudflare.com/website-terms/
* **Privacy Policy:** https://www.cloudflare.com/privacypolicy/

== Source Code & Build ==

In compliance with WordPress.org Guidelines #1 and #4 (GPL & Open Source Transparency):
* The uncompiled source code for all blocks is included in the `src/` directory.
* Public development repository: https://github.com/yudisain/gravisain-blocks
* Build instructions:
  1. Clone repository: `git clone https://github.com/yudisain/gravisain-blocks.git`
  2. Install dependencies: `npm install`
  3. Compile assets: `npm run build`

== Copyright and Licenses ==

This plugin bundles and uses the following third-party libraries, icon sets, and assets in compliance with their respective open-source licenses:

1. DotLottie Player Component
* Source: https://github.com/dotlottie/player-component
* Author: LottieFiles / dotLottie
* Copyright: 2023-2024 LottieFiles
* License: Apache License 2.0
* License URI: https://www.apache.org/licenses/LICENSE-2.0

2. Lucide Icons
* Source: https://lucide.dev (https://github.com/lucide-icons/lucide)
* Author: Lucide Contributors
* Copyright: 2022-2024 Lucide Project
* License: ISC License
* License URI: https://github.com/lucide-icons/lucide/blob/main/LICENSE

3. Simple Icons (Brand & Social Marks)
* Source: https://simpleicons.org (https://github.com/simple-icons/simple-icons)
* Author: Simple Icons Contributors
* License: Creative Commons Zero v1.0 Universal (CC0 1.0)
* License URI: https://creativecommons.org/publicdomain/zero/1.0/

4. Starter Template Demonstration Photography
* Source: https://unsplash.com
* Authors: Unsplash Community Photographers
* License: Unsplash License (Free to use for commercial and non-commercial purposes, per Unsplash Terms)
* License URI: https://unsplash.com/terms

== Changelog ==

= 1.0.1 =
* Feature: Add manual column widths control with compact inspector UI for Advance Pricing Table.
* Performance: Optimize table rendering and column layout controls.

= 1.0.0 =
* Initial release.
