=== bbp-migrate — bbPress to FluentCommunity Migration ===
Contributors: tribetools
Tags: bbpress, fluentcommunity, migration, forum, community
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Migrate your bbPress forums, topics, replies and members to FluentCommunity in 
a few clicks.

== Description ==

bbp-migrate is a free one-click migration tool that moves your bbPress 
community content into FluentCommunity. Forums become Spaces, topics become 
posts, replies become comments, and your members keep their roles.

Built by tribeTools — the team behind Space[tools] for FluentCommunity.

= What gets migrated =

* Forums → FluentCommunity Spaces (with correct privacy settings)
* Topic tags → FC Space Topics (top 20 most-used tags per forum)
* Topics → FC Posts (including sticky and closed topics)
* Replies → FC Comments (including two-level nesting)
* Anonymous content → optionally assigned to a fallback WordPress user
* Forum subscriptions and favourites → Space membership
* Topic favourites → Post likes
* Topic subscriptions → Post bookmarks
* bbPress roles → FC Space roles (admin, moderator, member)

= What does NOT get migrated =

* Likes and reactions (bbPress has no native likes system)
* Topic tags beyond the top 20 most-used per forum (FluentCommunity limits 
Spaces to 20 Topics)
* Forum and topic icons
* Anonymous content when no fallback user is selected
* Spam and trash content
* Sub-forum hierarchy (FluentCommunity does not support nested Spaces — 
sub-forums are flattened)
* Multi-site setups

= Requirements =

* WordPress 6.0 or higher
* PHP 8.2 or higher
* bbPress 2.x (active)
* FluentCommunity free (active)
* FluentCommunity Pro (optional — required for topic tag migration only)

= Free download =

Download bbp-migrate free from tribetools.pro. When you download, you will 
automatically be added to the tribeTools FluentCommunity community for support 
and updates.

= Support =

Join the tribeTools community at tribetools.pro for support, tips and updates.

---

== ⚠️ IMPORTANT — PLEASE READ BEFORE MIGRATING ==

This plugin moves your forum content from bbPress into FluentCommunity.
This process cannot be automatically undone.

**We strongly recommend testing on a staging site first and taking a full
site backup before running the migration on your live site.**

Read the full preparation guide below before you begin.

---

== Before You Migrate — Preparation Guide ==

Please read this guide carefully before running the migration. Taking a
little time to prepare now will make the migration smoother and help you
get the best result.

= Step 1 — Back up your site =

Before doing anything else, take a full backup of your WordPress site
including the database and all files. Most hosting providers offer a
one-click backup from their control panel. If yours does not, plugins
such as UpdraftPlus or All-in-One WP Migration can help.

**Minimum requirement: a full database backup.**

We also strongly recommend testing the migration on a staging copy of
your site before running it on your live site. Many hosting providers
offer a one-click staging environment. This lets you check the results
before committing to the migration on your live community. It's also 
worth disabling emails while testing the migration, if you use FluentSMTP, 
simply tick the Email Simulation option to disable emails, alternating use 
something like Disable Emails by webaware. The last thing you want is emails be 
sent to users while you are testing the migration. 

= Step 2 — Set up FluentCommunity =

Install and activate FluentCommunity on your site if you have not already.

**Do not create any Spaces before running the migration** — bbp-migrate
creates Spaces automatically from your bbPress forums. Any Spaces you
create manually will not be affected, but having extra Spaces before
migrating can cause confusion.

Before running the migration, take a few minutes to configure your
FluentCommunity settings:

1. Go to **FluentCommunity → Settings** in your WordPress dashboard
2. Set up your portal page and portal URL — this is the web address
   where your community will live (e.g. yoursite.com/community)
3. Set your community name and logo
4. Configure your default notification and privacy settings

You do not need to create Space Groups before migrating. You can assign
your migrated Spaces to groups during the migration or afterwards, but if you 
already know what Space Groups you want to use, go to FluentCommunity → 
Settings → Space Groups and set them up.

= Step 3 — Review your bbPress forums =

Take a look at your bbPress forums before migrating and consider the
following:

**Sub-forums will be flattened**
FluentCommunity does not support nested Spaces. If you have forums inside
forums (sub-forums), each one will become its own top-level Space in FC.
Its parent forum name will be noted in the Space description. If you have
deeply nested forums, consider reorganising them in bbPress first.

**Topic tags have a 20-tag limit per Space**
FluentCommunity currently limits each Space to 20 Topics (the FC equivalent of
bbPress topic tags). The migration tool will automatically select the 20
most-used tags per forum. If any forum has more than 20 tags, the
least-used ones will be skipped and listed in the migration summary.

To get the best tag results, we recommend reviewing your bbPress topic
tags before migrating. Merge or delete rarely-used tags so your most
important ones are preserved. You can manage tags in bbPress under
**Forums → Topic Tags**.

**Deal with spam**
Any spam topics or replies in bbPress will not be migrated, but they
will show in the content counts on the pre-flight screen. If you want
accurate counts, clear out spam in bbPress before running the migration.

= Step 4 — Decide what to do with anonymous content =

bbPress allows posts and replies without a WordPress user account
(anonymous content). FluentCommunity requires every post to have a user.

You have two options:

**Option A — Skip anonymous content**
Leave the anonymous user field blank in the migration settings. Any
anonymous topics and replies will be skipped and listed in the migration
summary. This is the safest option if you do not need to preserve
anonymous content.

**Option B — Assign to a fallback user**
Choose a WordPress user to be credited with all anonymous content.
We strongly recommend creating a dedicated user for this purpose rather
than using your admin account or a real user's account.

To create a dedicated anonymous content user:
1. Go to **Users → Add New** in your WordPress dashboard
2. Create a user with a name like "Forum Archive" or "Anonymous User"
3. Set their role to Subscriber
4. **Important:** Log in as that user and visit your FluentCommunity
   portal at least once — this creates their FC profile, which is
   required before they can be selected in the migration tool
5. Log back in as admin and run the migration

**Why do I need to visit the FC portal first?**
FluentCommunity only creates a user profile the first time a user visits
the community portal. The migration tool can only assign anonymous content
to users who already have an FC profile. Any user who has not yet visited
the FC portal will not appear in the dropdown.

= Step 5 — Check your WordPress users =

The migration tool works with WordPress user accounts. Content posted by
WordPress users will be correctly attributed in FluentCommunity.

**Deleted users:** If a bbPress user account has been deleted from
WordPress, their content will be treated as anonymous. Decide in advance
whether to assign it to a fallback user or skip it.

**BuddyPress or BuddyBoss:** If your site also uses BuddyPress or
BuddyBoss alongside bbPress, run FluentCommunity's built-in BuddyPress
importer **first**, before running bbp-migrate. You will see a warning
on the pre-flight screen if BuddyPress is detected.

= Step 6 — Prepare your FluentCommunity user profiles (optional) =

If any of your WordPress users have never visited your FluentCommunity
portal, they will not have an FC profile yet. The migration will still
work — user profiles are created automatically during the migration —
but if you want to select specific users for things like the anonymous
content fallback, those users need to have visited FC first.

For most sites this is not a concern. The migration creates FC profiles
for all migrated users automatically.

---

== Running the Migration ==

= Installing the plugin =

1. Download bbp-migrate from tribetools.pro
2. In your WordPress dashboard go to **Plugins → Add New → Upload Plugin**
3. Upload the bbp-migrate zip file and click **Install Now**
4. Click **Activate Plugin**

= Starting the migration =

1. Go to **Tools → bbPress Migration** in your WordPress dashboard
2. The **Pre-flight Check** screen will confirm bbPress and
   FluentCommunity are both active and show a summary of your content
3. Review the tag scan results — if any forums have more than 20 tags,
   consider going back to bbPress and consolidating them before continuing
4. Click **Continue to Configure**

= Configuring the migration =

On the Configure screen you can:

**Select which forums to migrate**
All forums are selected by default. Uncheck any forums you do not want
to migrate. Unselected forums and all their content will be skipped.

**Assign forums to Space Groups**
If you have created Space Groups in FluentCommunity, you can assign each
forum to a group here. Leave set to "No group" if you want to organise
your Spaces manually after migration.

**Handle anonymous content**
If your bbPress site has anonymous posts, choose a fallback user here or
leave blank to skip anonymous content.

**Acknowledge the migration terms**
Tick the acknowledgement checkboxes to confirm you understand how the
migration handles things like sub-forum flattening, tag limits and
topic subscription bookmarks.

Click **Start Migration** when you are ready.

= During the migration =

* **Do not close your browser tab** while the migration is running.
  The progress screen needs to stay open for the migration to continue.
  If you accidentally close it, reopen the migration tool and click
  Resume if prompted.
* **Do not edit your bbPress forums, topics or replies** while the
  migration is running.
* The migration processes content in batches. Depending on how much
  content you have, it may take anywhere from a few seconds to several
  minutes.
* If the migration appears to stall, the tool will detect this and offer
  a Resume or Reset option.

= After the migration =

Once complete, the migration summary screen will show:

* How many Spaces, posts, comments and members were migrated
* Any content that was skipped (spam, trash, anonymous, excluded forums)
* Any topic tags that were skipped due to the 20-tag limit
* A downloadable migration log for your records

**Review your migrated content**

1. Visit your FluentCommunity portal and check your new Spaces
2. Verify privacy settings are correct — especially for private and
   hidden forums which should be private or secret Spaces
3. Check Space Topics (tags) are correct for each Space
4. If you used a fallback user for anonymous content, review their posts
   and update as needed
5. Check that Space moderators and admins are correctly assigned

**Set up URL redirects (important for SEO)**

bbPress and FluentCommunity use different URL structures. Old bbPress
topic URLs (e.g. yoursite.com/forums/topic/my-topic/) will not
automatically redirect to the new FC URLs. If your forum content appears
in search engines, setting up redirects will prevent broken links and
loss of search rankings.

This is outside the scope of bbp-migrate. We recommend using a redirect
plugin such as Redirection to map your old bbPress URLs to new FC URLs.

**Deactivate bbPress**

Once you are happy with the migration results, deactivate bbPress from
**Plugins → Installed Plugins**. Do not uninstall it straight away —
keep it available for a few weeks in case you need to reference your
original forum data. Once you are confident everything has migrated
correctly you can uninstall it.

---

== Resetting and Re-running ==

If you need to re-run the migration (for example after adjusting your
bbPress tags or forum structure), use the **Reset & Delete Migrated
Content** button on the completion screen.

**Important:** This will delete all the FluentCommunity content created
by the migration (Spaces, posts, comments, memberships). It will NOT
affect your bbPress data. After resetting you can run the migration again
with different settings.

If you run the migration twice without resetting first, you will end up
with duplicate content in FluentCommunity.

---

== Frequently Asked Questions ==

= Will this delete my bbPress data? =

No. bbp-migrate only creates new content in FluentCommunity. Your bbPress
forums, topics and replies are not modified or deleted at any point.

= Can I run the migration more than once? =

Yes, but you must use the Reset & Delete Migrated Content button between
runs. Running the migration twice without resetting will create duplicate
content in FluentCommunity.

= What happens to my bbPress user roles? =

bbPress Keymasters become Space admins, Moderators become Space
moderators, and Participants/Subscribers become Space members.

= Do I need FluentCommunity Pro? =

No — the migration works with the free version of FluentCommunity.
However topic tag migration (migrating bbPress tags as FC Space Topics)
requires FluentCommunity Pro. If Pro is not installed, tags will be
skipped and a note will appear in the migration summary.

= What happens to sub-forums? =

FluentCommunity does not support nested Spaces, so sub-forums are
flattened to top-level Spaces. The parent forum name is added to the
Space description so you know where it came from.

= What happens to anonymous posts? =

Anonymous posts (posted without a WordPress account) can optionally be
assigned to a fallback WordPress user you choose during setup. If no
fallback user is selected, anonymous content is skipped and listed in
the migration summary.

= What about topic subscriptions? =

bbPress topic subscriptions (where a user asked to be notified of new
replies) are migrated as FluentCommunity bookmarks. Users will not
receive notifications based on migrated bookmarks — FC's notification
system works differently. Users can re-subscribe to content in FC after
migration.

= The migration seems stuck — what do I do? =

If the migration appears to stall, the tool will show a warning after a
few minutes of no progress. You can click Resume to try continuing from
where it left off, or Full Reset to start again. Check your
wp-content/debug.log file for any error messages.

= I closed the browser tab — is my migration lost? =

No. The migration tool will detect that a previous migration was in
progress when you reopen it, and offer to resume from where it left off.

= Can I choose which forums to migrate? =

Yes. The Configure screen shows all your bbPress forums with checkboxes.
You can uncheck any forums you do not want to migrate.

= Will my SEO be affected? =

bbPress and FluentCommunity use different URL structures so old forum
URLs will no longer work after migration. If your forum content appears
in search engines we recommend setting up URL redirects using a plugin
like Redirection. This is not handled automatically by bbp-migrate.

---

== Changelog ==

= 1.0.0 =
* Initial release

---

== Support ==

Need help? Join the tribeTools community at tribetools.pro where you can
ask questions, report issues and connect with other FluentCommunity users.

Built with ❤️ by tribeTools — makers of SpaceEvents for FluentCommunity.
tribetools.pro
