=== Button Group Block ===
Contributors: snehalpancholi
Tags: gutenberg, block, button, button group, call to action, CTA
Requires at least: 6.3
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A Gutenberg block for creating flexible, styled button groups with full alignment, size, and colour controls.

== Description ==

Button Group Block adds a native Gutenberg block that lets you place multiple call-to-action buttons side by side in a single, cohesive group.

**Key features:**

* Add up to 6 buttons per group.
* Choose between **Filled** and **Outline** styles per button.
* Set individual background colour and text colour for each button.
* Control alignment: Left, Centre, Right, or Full Width (each button stretches equally).
* Three size presets: Small, Medium, Large.
* Adjustable gap between buttons (0–48 px).
* Adjustable corner radius (0–32 px).
* Option to open each link in a new tab (with `rel="noopener noreferrer"` for security).
* Dynamic render callback — works with full-site editing and block themes.
* Zero jQuery dependency.
* Fully accessible (keyboard focus indicators).

== Installation ==

1. Upload the `button-group-block` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Open any post or page in the Block Editor.
4. Search for **Button Group** in the block inserter and add it.

== Frequently Asked Questions ==

= How many buttons can I add? =

Up to 6 buttons per group. The "Add Button" control is disabled once you reach the maximum.

= Can I use the same block multiple times on one page? =

Yes. Each block instance is completely independent.

= Does this block work with full-site editing (FSE)? =

Yes. The block uses a PHP render callback which works everywhere the Block Editor is available, including FSE templates.

= Does the plugin add any database tables? =

No. The block stores all data as block attributes inside post content — no custom database tables or options are created.

= Will uninstalling the plugin delete my buttons? =

The button data lives inside post content. Uninstalling the plugin removes the plugin files; any posts that contained the block will show the raw block comment markup until the plugin is re-installed.

== Screenshots ==

1. Block in the editor showing two buttons with Inspector Controls open.
2. Frontend output — Filled and Outline button styles side by side.
3. Full Width alignment stretching buttons to equal widths.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
