=== Lewe Bootstrap Visuals ===
Contributors: glewe
Donate link: https://www.paypal.me/GeorgeLewe
Tags: lewe bootstrap shortcode styles visual
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 3.0.1
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

A WordPress plugin that provides Bootstrap visual components through easy-to-use shortcodes.

== Description ==

Lewe Bootstrap Visuals is a comprehensive WordPress plugin that brings the power of Bootstrap 5 to your WordPress site through an extensive collection of shortcodes. This plugin replaces the legacy shortcode-bootstrap-visuals plugin with modern Bootstrap 5.

**Key Features:**

* **Bootstrap 5.3.8** - Latest Bootstrap version with modern CSS and JavaScript
* **Prefix Support** - All CSS classes use the `bsv-` prefix to avoid conflicts
* **Modern WordPress Standards** - Built following current WordPress Plugin Development Handbook
* **Comprehensive Components** - Alerts, badges, buttons, cards, modals, progress bars, and more
* **Responsive Grid System** - Bootstrap 5 grid with responsive breakpoints
* **CDN Integration** - Automatic loading of Bootstrap 5.3.8 from CDN
* **Shortcode API** - Simple shortcodes for all Bootstrap components using dash syntax
* **TinyMCE Integration** - Visual editor buttons for easy shortcode insertion
* **Admin Interface** - Clean settings page with component documentation

**Available Shortcodes:**

*Layout Components:*
* `[bsv-container]` - Bootstrap container
* `[bsv-row]` - Bootstrap row
* `[bsv-column]` - Bootstrap column with responsive sizes

*UI Components:*
* `[bsv-alert]` - Alert messages with optional dismiss button
* `[bsv-badge]` - Badges and labels
* `[bsv-button]` - Buttons with various styles and sizes
* `[bsv-card]` - Cards with headers, footers, and images
* `[bsv-panel]` - Alias for card (backward compatibility)

*Content Components:*
* `[bsv-blockquote]` - Styled blockquotes
* `[bsv-code]` - Inline and block code formatting
* `[bsv-highlight]` - Highlighted text
* `[bsv-lead]` - Lead paragraphs
* `[bsv-text]` - Text with utility classes
* `[bsv-list]` - Styled lists

*Interactive Components:*
* `[bsv-modal]` - Modal dialogs
* `[bsv-collapse]` - Collapsible content
* `[bsv-accordion]` - Accordion panels
* `[bsv-tooltip]` - Tooltips
* `[bsv-popover]` - Popovers

*Progress & Loading:*
* `[bsv-progress]` - Progress bars
* `[bsv-spinner]` - Loading spinners

**Migration from Legacy Plugin:**

If you're migrating from the old shortcode-bootstrap-visuals plugin, most shortcodes work with the new dash syntax (`[bsv-alert]` instead of `[bsv_alert]`). The plugin maintains backward compatibility where possible while following modern WordPress shortcode conventions.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/shortcode-bootstrap-visuals` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the Settings > Bootstrap Visuals screen to configure the plugin.
4. Start using shortcodes in your posts and pages.

== Frequently Asked Questions ==

= Does this plugin include Bootstrap CSS and JavaScript? =

Yes, the plugin automatically loads Bootstrap CSS and JavaScript from CDN. You can disable this in the settings if you prefer to load Bootstrap manually.

= Are the shortcodes compatible with the old plugin? =

The new plugin uses dash syntax (`[bsv-alert]`) instead of underscore syntax (`[bsv_alert]`) to follow WordPress standards. Most functionality remains the same with improved Bootstrap 5 support.

= Can I customize the Bootstrap components? =

Yes, all components use the `bsv-` prefix, so you can add custom CSS to override or extend the default Bootstrap styles without conflicts.

= Does this work with my theme? =

Yes, the plugin is designed to work with any properly coded WordPress theme. The prefixed CSS classes prevent conflicts with your theme's styles.

= Is this plugin responsive? =

Yes, all components are fully responsive and support Bootstrap 5's responsive breakpoints (sm, md, lg, xl, xxl).

== Screenshots ==

1. Example of various Bootstrap components in action
2. TinyMCE editor integration with shortcode buttons

== Changelog ==

= 3.0.1 =
* Update asset images

= 3.0.0 =
* Complete rewrite for Bootstrap 5.3.8
* Modern WordPress standards compliance
* Improved admin interface
* Enhanced shortcode system with dash syntax
* TinyMCE editor integration
* Better performance and security
* Prefixed CSS classes to avoid conflicts
* Responsive grid system updates
* New component options and styling

= 2.x.x =
* Legacy version (deprecated)

== Upgrade Notice ==

= 3.0.0 =
Complete rewrite based on Bootstrap 5.3.8 and modern WordPress standards.

== Support ==

For support, documentation, and feature requests, please visit:

* [Plugin Documentation](https://lewe.gitbook.io/lewe-bootstrap-visuals/ "Lewe Bootstrap Visuals Documentation")
* [WordPress Support Forum](https://wordpress.org/support/plugin/shortcode-bootstrap-visuals/ "WordPress Support Forum")
* [Lewe Service Desk](https://georgelewe.atlassian.net/servicedesk/customer/portal/5/ "Lewe Service Desk")

== Credits ==

* Based on [Bootstrap](https://getbootstrap.com/)
* Follows [WordPress Coding Standards](https://developer.wordpress.org/coding-standards/)