Skip to content

docs: Add FAQ entries for Multisite, locked-out users, and role enforcement - #881

Merged
masteradhoc merged 1 commit into
WordPress:masterfrom
masteradhoc:add-faqs
Apr 20, 2026
Merged

docs: Add FAQ entries for Multisite, locked-out users, and role enforcement#881
masteradhoc merged 1 commit into
WordPress:masterfrom
masteradhoc:add-faqs

Conversation

@masteradhoc

Copy link
Copy Markdown
Collaborator

What?

Adds three missing FAQ entries to readme.txt.

Why?

Checked a few support requests lately that we've had. The FAQ section lacked answers to several commonly asked questions. Users and site administrators frequently ask about Multisite compatibility, how to recover a locked-out user's account, and whether 2FA can be enforced across all users or roles. Without these entries, users are left to search the support forums or GitHub issues for answers that could be surfaced directly in the plugin docs.

How?

Three new FAQ entries were added to the == Frequently Asked Questions == section of readme.txt:

  • Does this plugin work on WordPress Multisite? — Confirms compatibility and clarifies that 2FA settings are stored in user meta (making them valid across all network sites), while noting there are no network-wide enforcement settings.
  • How do I disable 2FA for a user who is locked out? — Walks administrators through disabling 2FA via the user profile editor or WP-CLI.
  • Can I require 2FA for all users or specific roles? — Explains there are no built-in enforcement settings, points developers to the two_factor_providers_for_user filter, and references issue Enforce 2FA #255 for the native enforcement feature request.

Use of AI Tools

AI assistance: Yes
Tool(s): Claude (Anthropic)
Model(s): Claude Sonnet 4.6
Used for: Drafting the FAQ content based on existing plugin documentation and known feature gaps; final wording reviewed and approved by me.

Changelog Entry

Added - Three new FAQ entries covering Multisite compatibility, admin-side 2FA removal for locked-out users, and role-based enforcement.

@github-actions

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: masteradhoc <masteradhoc@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@masteradhoc masteradhoc added this to the 0.17.0 milestone Apr 19, 2026
@masteradhoc masteradhoc self-assigned this Apr 19, 2026
@masteradhoc
masteradhoc merged commit 78ae56b into WordPress:master Apr 20, 2026
28 checks passed
@masteradhoc
masteradhoc deleted the add-faqs branch April 20, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants