# ✨ MagicBB for Flarum
MagicBB enhances your [Flarum](https://flarum.org) forum composer by adding handy toolbar buttons, extra BBCodes, and unique text formatting styles. **Supports Flarum 1.x and 2.x**

---

## 🚀 Features
- 🖊️ Adds composer toolbar buttons  
- 🎨 Extra BBCode tags:  
  `[iframe]`, `[left]`, `[right]`, `[justify]`, `[spoiler]`, `[table]`, `[info]`, `[error]`, `[success]`, `[warning]`, `[ileft]`, `[iright]`, `[icenter]`, `[hr]`, `[abbr]`, `[sub]`, `[sup]`
- 📦 Custom formatting styles for:
  - Alerts
  - Spoilers
  - Tables

- 🔐 Permission for iframe usage
- 🖼️ Auto-scaling for Fof Upload Images
- 🎨 Ability to choose an icon for each button
- ⚙️ Admin panel toggles to enable or disable each feature

---

## 📸 Screenshots
<img width="850" height="90" alt="image" src="https://github.com/user-attachments/assets/979a2037-8658-42bb-9448-8e00bb0ec4fc" />
<img width="850" height="215" alt="image" src="https://github.com/user-attachments/assets/f6ed58ec-ef3f-4335-8f11-ff31511cc6c1" />
<img width="850" height="400" alt="image" src="https://github.com/user-attachments/assets/054eefe5-0b9c-4404-9974-f2d821018940" />
<img width="850" height="490" alt="image" src="https://github.com/user-attachments/assets/1665e56d-0fbe-4370-9b13-dc26015a1930" />

---

## 📦 Installation
Run in your Flarum root directory:
```
composer require capybash/magicbb:"*"
```

---

## 🔗 Links
- [**GitHub Repository**](https://github.com/capybash/magicbb)  
- [**Packagist**](https://packagist.org/packages/capybash/magicbb)  
- [**Extiverse**](https://extiverse.com/extension/capybash/magicbb)
- [**Discuss**](https://discuss.flarum.org/d/38053-magicbb-extra-bbcodes-toolbar-buttons)