=== MrStar Accordion Builder ===
Contributors: aniketsaini
Tags: accordion, faq, shortcode, builder, responsive
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: mrstar-accordion-builder

Create professional, responsive accordions, collapsible content, and dynamic posts, no coding required.

== Description ==

**MrStar Accordion Builder** is a comprehensive WordPress plugin that makes it easy to create professional, responsive accordions without any coding. Whether you're building FAQs, collapsible content sections, or dynamic post-based accordions, this plugin provides all the tools you need.

= Why Choose MrStar Accordion Builder? =

* **No Coding Required** – Intuitive admin interface for creating and managing accordions
* **Two Content Sources** – Create accordions manually or dynamically from WordPress posts
* **Flexible Styling** – Per-accordion and global theme-based styling options
* **Repeatable Fields** – Add unlimited accordion items with titles and content
* **Theme System** – Create reusable accordion themes for consistent styling across your site
* **Shortcode Support** – Easy shortcode integration with full customization
* **Lightweight** – Optimized code with minimal dependencies
* **Translation Ready** – Fully localized for international audiences
* **Multiple Instances** – Use multiple accordions on the same page without conflicts

= Key Features =

**1. Custom Post Type Management**
Manage all your accordions from a dedicated admin interface. Organize, edit, and publish accordions just like regular posts.

**2. Two Accordion Source Options**
* **Manual Content** – Create accordion items directly with titles and rich text content
* **Post-Based** – Automatically generate accordions from WordPress posts with custom filtering and sorting

**3. Repeatable Accordion Items**
Add unlimited accordion items to each accordion. Each item includes:
* Custom title
* Rich text content editor
* Flexible organization with drag-and-drop sorting

**4. Advanced Theme System**
* Create unlimited reusable themes
* Apply themes to multiple accordions
* Override theme settings per accordion
* Consistent styling across your entire site

**5. Customization Options**
* Choose between single and multiple open items (accordion or multi-collapse behavior)
* Configure animation speed
* Control which item opens first
* Custom styling for icons and appearance
* Per-accordion style overrides

**6. Responsive Design**
Built with mobile-first design principles to ensure your accordions look great on all devices.

**7. Easy Shortcode Integration**
Simple shortcode syntax: `[mrstar_accordion id="123"]`
Use multiple accordions on the same page without conflicts.

= Use Cases =

* Frequently Asked Questions (FAQs)
* Product features and specifications
* Pricing plans with feature lists
* Service descriptions
* Team member bios
* Terms and conditions
* Help documentation
* Any collapsible content sections

== Installation ==

**Method 1: From WordPress Admin**
1. Go to Plugins > Add New
2. Search for "MrStar Accordion Builder"
3. Click "Install Now" and then "Activate"

**Method 2: Manual Upload**
1. Download the plugin zip file
2. Go to Plugins > Add New > Upload Plugin
3. Select the downloaded zip file and click "Install Now"
4. Activate the plugin

**Method 3: FTP Upload**
1. Download and extract the plugin zip file
2. Upload the `mrstar-accordion-builder` folder to `/wp-content/plugins/` via FTP
3. Activate the plugin through the 'Plugins' menu in WordPress

**After Installation:**
1. Go to the "Accordion" menu in your WordPress admin
2. Create your first accordion
3. Add accordion items (or select post-based source)
4. Copy the shortcode and paste it into any page or post

== Getting Started ==

= Step 1: Create an Accordion =
1. Navigate to **Accordion > Add New**
2. Enter a title for your accordion
3. Click **Publish**

= Step 2: Add Accordion Items =
In the "Accordion Items" metabox:
1. Click "Add Item"
2. Enter the item title
3. Add the content in the editor
4. Drag to reorder items as needed
5. Click **Update**

= Step 3: Configure Settings =
* Select accordion **Source** (Manual Content or Posts)
* Choose or create a **Theme**
* Set **Accordion Behavior** (single or multiple items open)
* Adjust animation **Speed**
* Control which item opens **first**

= Step 4: Display Your Accordion =
Copy the shortcode from the "Accordion Shortcode" metabox and paste it into any:
* Page
* Post
* Text widget
* Custom page template

= Advanced: Using Post-Based Accordions =
1. Select "Post-Based" as the source
2. Choose post type to display
3. Set up filters (categories, tags, authors)
4. Configure sorting options
5. Set pagination if needed

= Advanced: Creating Custom Themes =
1. Go to **Accordion > Accordion Themes**
2. Click **Add New**
3. Configure:
   * Default styling
   * Icon settings
   * Animation behavior
4. Apply to multiple accordions for consistent design

== Frequently Asked Questions ==

= Can I use multiple accordions on the same page? =
Yes! The plugin supports unlimited accordion instances per page. Each accordion uses a unique identifier to prevent conflicts.

= Can I customize the accordion appearance? =
Absolutely! You can:
* Create custom themes with unique styling
* Override theme styles per accordion
* Modify colors, fonts, and icons

= Can accordions be created from existing posts? =
Yes! Use the "Post-Based" source to automatically generate accordions from your WordPress posts. Filter by post type, category, tag, or author.

= Is the plugin translation ready? =
Yes! The plugin is fully translation-ready with the text domain `mrstar-accordion-builder`. Translators can contribute translations through WordPress.org.

= How do I add custom CSS? =
You can:
1. Add custom CSS through Appearance > Customize > Additional CSS
2. Add CSS to your theme's style.css
3. Use per-accordion styling options in the metabox
4. Override theme styles as needed

= Can I use accordion items with rich media? =
Yes! The content editor supports all WordPress media, including:
* Images and galleries
* Video embeds
* Custom HTML
* Shortcodes

= Does it work with other plugins? =
Yes! MrStar Accordion Builder is designed to work well with other plugins and themes. It uses standard WordPress hooks and filters.

= Does it work with page builders? =
Yes! You can use the accordion shortcode in:
* Elementor
* Divi
* Beaver Builder
* Other page builders that support shortcodes

= What happens if I delete an accordion? =
Deleting an accordion will remove it from the database. Any pages or posts using that accordion's shortcode will need to be updated.

= Can I export and import accordions? =
Yes, you can use WordPress's built-in import/export functionality or backup your database to export and import accordions.

= Is there a premium version? =
Currently, MrStar Accordion Builder is available as a free plugin with all core features included.

= How do I get support? =
Visit the plugin's support forum on WordPress.org or check the documentation on the plugin homepage.

== Shortcode Reference ==

= Basic Shortcode =
`[mrstar_accordion id="123"]`

**Attributes:**
* `id` (required) – The accordion post ID to display

= Example =
`[mrstar_accordion id="42"]`

To find your accordion ID:
1. Go to Accordion > All Accordions
2. Copy the shortcode for the accordion you want from the table.

== Technical Details ==

= Requirements =
* WordPress 6.0 or higher
* PHP 7.2 or higher
* Modern web browser (Chrome, Firefox, Safari, Edge)

= Compatibility =
* Fully compatible with WordPress 6.0 and higher
* Works with popular themes and page builders
* Compatible with multisite installations

= Performance =
* Lightweight and optimized for speed
* Minimal database queries
* Efficient CSS and JavaScript loading
* Inline styles only when necessary

= Security =
* Nonces for form security
* Proper capability checks
* Sanitized and escaped output
* SQL injection prevention

== Screenshots ==

1. **Main Accordion Manager** – Manage all your accordions from the custom post type interface
2. **Accordion Items Editor** – Easily add, edit, and organize accordion items with drag-and-drop sorting
3. **Post-Based Source** – Automatically generate accordions from WordPress posts
4. **Theme System** – Create and apply reusable accordion themes
5. **Frontend Display** – Beautiful, responsive accordion rendering

== Frequently Requested Features ==

We're always looking to improve MrStar Accordion Builder. Requested features include:
* Custom animation effects
* Advanced styling options
* Integration with popular plugins
* Additional content sources

Have a feature request? Post in the support forum!

1. Admin: Create and manage accordions
2. Frontend: Example accordion display

== Changelog ==

= 1.0.0 =
* Initial release
* Custom Post Type for accordion management
* Manual content accordion source
* Post-based accordion source
* Accordion theme system
* Repeatable accordion items
* Shortcode support [mrstar_accordion_builder]
* Responsive design
* Admin interface with metaboxes
* jQuery animation support
* Full internationalization support