=== BuddyBoss Tools ===
Contributors: buddyboss
Tags: buddyboss, migration, import, sample data
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Repair and re-sync specific site functions, migrations and import default data to help you build and maintain your site.

== Description ==

BuddyBoss Tools helps you build and maintain your BuddyBoss Platform community. It gives site owners a single place to seed a fresh site with sample content, promote profile types into editable posts, and migrate forums from 20+ third-party platforms - alongside utilities to repair and re-sync site functions.

= Key Features =

* **Sample Data Importer** - One-click, idempotent fixtures for activities, groups, members, forums, messages, profile fields, and reactions; reversible via "Clear Default Data".
* **Profile Types Migration** - Promotes profile types registered in PHP into editable Profile Type posts manageable from the dashboard.
* **Forum Platform Migration** - 22 vendor importer classes covering 20 vendor families (phpBB, vBulletin, XenForo, MyBB, SMF, and more) with a DB-credentialed, step-by-step import flow.
* **Self-Registration Hook** - Third-party plugins can add their own migration cards via the `bb_tools_after_register_migration_sources` hook.
* **Modern React UI** - Migration Tools and Sample Data live under BuddyBoss > Settings > Tools, built on the Settings 2.0 React shell.

= Requirements =

* **WordPress** 5.0 or higher
* **PHP** 7.4 or higher
* **BuddyBoss Platform** (Required - must be installed and activated with Settings 2.0 support)
* **Node.js** 20.x or higher (for development)
* **Composer** 2.x or higher (for development)

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "BuddyBoss Tools"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded ZIP file and click "Install Now"
5. After installation, click "Activate Plugin"

= Configuration =

1. Ensure BuddyBoss Platform is installed and activated (Settings 2.0 support is required)
2. Navigate to **BuddyBoss > Settings > Tools** in the WordPress admin
3. Use the **Sample Data** importer to seed activities, groups, members, forums, messages, profile fields, and reactions - and "Clear Default Data" to remove them
4. Use the **Migration Tools** grid to run a migration:
   * **Profile Types** - promote PHP-registered profile types into editable Profile Type posts
   * **Forum Platform** - select your source forum platform, enter its database credentials, and follow the step-by-step import flow

== Changelog ==

= 1.0.0 =
* New Feature! - Introduced a new PeepSo Migration Tool to simplify the migration process from PeepSo to BuddyBoss platform and redesigned the Tools page in the BuddyBoss admin for improved usability