Version: 1.3.0
Author: Martin Brampton
License: GNU/GPL
Email: martin@remository.com
URL: https://remository.com

A comprehensive Joomla 5 plugin that provides seamless Single Sign-On (SSO) integration between Joomla and Flarum using JWT-based authentication.

✅ Single Sign-On (SSO) - Automatic login to Flarum when logged into Joomla
✅ Menu-Based Forum Access - Direct forum links with automatic authentication
✅ User Synchronization - Automatic user creation, updates, and deletion
✅ Group Management - Joomla user groups mapped to Flarum groups
✅ JWT Authentication - Secure token-based authentication using lcobucci/jwt
✅ Cross-Domain Support - Works with subdomains (e.g., forum.yoursite.com)
✅ API-First Approach - Uses Flarum API with minimal database access

• Joomla 5.x
• PHP 8.2+
• OpenSSL extension
• Sodium extension

• Flarum 1.8+
• maicol07/flarum-ext-sso extension
• lcobucci/clock library (automatically installed)

⚠️ IMPORTANT: Before starting, ensure your Flarum admin user has the same email address as your Joomla admin user. See Flarum Setup Guide for details.

1. Install the plugin in Joomla (plugins/user/flarum/)
2. Configure Flarum SSO - See Flarum Setup Guide
3. Enable the plugin in Joomla Extensions → Plugins
4. Configure settings - Flarum URL, API key, JWT settings
5. Create menu link - Use the forum redirect URL in your menu

https://yoursite.com/index.php?option=com_ajax&plugin=flarum&group=user&method=forumRedirect&format=raw

• Flarum Setup Guide - Complete Flarum installation and configuration
• Usage Examples - Common usage scenarios and API examples
• Development Guide - Development instructions and architecture

• Standard Joomla Plugin - Follows Joomla 5 best practices
• JWT Authentication - Secure token-based SSO with maicol07/flarum-ext-sso
  
• API-First - Minimal database access, prefers Flarum API
• Dependency Injection - Uses Joomla DI container with provider.php
• PSR-4 Autoloading - Namespace: BlackSheepResearch\Plugin\User\Flarum

This plugin integrates with the mature maicol07/flarum-ext-sso extension, providing enterprise-grade Single Sign-On between Joomla and Flarum.

For issues or questions, please check the documentation files or contact the author.