Skip to content
Docs

Installation

This page covers installing and activating Who Viewed My Profile, the post-activation checklist, multisite notes, and how to uninstall cleanly. For license activation, see License activation.

Install methods

Section titled “Install methods”
Section titled “From the WordPress admin (recommended)”
  1. Go to Plugins → Add New → Upload Plugin.
  2. Choose who-viewed-my-profile.zip and click Install Now.
  3. Click Activate.
  4. You’ll be redirected to WB Plugins → Profile Views so you can configure it.

Via FTP

Section titled “Via FTP”
  1. Unzip the package.
  2. Upload the who-viewed-my-profile/ folder into wp-content/plugins/.
  3. Activate from Plugins → Installed Plugins.

Via WP-CLI

Section titled “Via WP-CLI”
Terminal window
wp plugin install who-viewed-my-profile.zip --activate

After activation — what you should see

Section titled “After activation — what you should see”
  • A new sidebar entry WB Plugins → Profile Views (the WB Plugins hub is shared by every Wbcom plugin you have installed).
  • A new database table {prefix}bp_profile_views is created.
  • A default settings array is stored under the option bp_profile_views_general_options with these defaults:
    • save_count_by = session
    • chart_style = line
    • view_member_count = 10
    • show_in_directory = no
    • show_recent_members = no
    • allow_user_settings = no
    • exclude_logout_user_count = yes
  • On the first admin page load after activation, every existing user who has no visitor_setting user meta gets it set to 'yes'. This backfill is gated by the bp_profile_views_visitor_setting_seeded option, so it runs once per install — not on every request. The gate uses admin_init, so the backfill only runs when an admin visits a dashboard page (not on frontend page loads).

Admin Overview tab right after activation

If any of these don’t appear, re-check that BuddyPress is active and look at wp-content/debug.log for PHP errors.

Multisite

Section titled “Multisite”

The plugin supports multisite. Each site has its own {prefix}bp_profile_views table and its own settings — there is no network-level configuration. Network Activate the plugin if you want every sub-site to share the same plugin version; otherwise activate per-site.

Uninstalling

Section titled “Uninstalling”

By default, deleting the plugin from Plugins → Installed Plugins wipes everything it created:

  • Drops the {prefix}bp_profile_views table.
  • Deletes the option bp_profile_views_general_options.
  • Deletes the option edd_wbcom_BPPV_license_key.
  • Deletes the user meta visitor_setting and bp_profile_views_user_login_session for every user.
  • Clears related transients.
  • Deletes any BuddyPress notifications under component_name = 'bp_profile_view_notifications'.

If you want to keep historical visit data after uninstall — for example, to re-install later or migrate environments — set the BPV_KEEP_DATA_ON_UNINSTALL constant. See Uninstall.

Theme integration

Section titled “Theme integration”

The recent-visitors header strip auto-detects the active theme and picks the right hook target — you don’t need to configure anything. Override behaviour and theme template paths are documented in Theme overrides.

Where to next

Section titled “Where to next”