Skip to content

Clarify TOTP setup instructions #763

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kasparsd merged 4 commits into from
Feb 13, 2026
+34 −15
Merged

Clarify TOTP setup instructions #763

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
dc8b9d8
Clarify TOTP setup instructions - draft
masteradhoc Jan 31, 2026
e1567f1
Merge branch 'master' into patch-5
masteradhoc Feb 1, 2026
0f71524
Merge branch 'WordPress:master' into patch-5
masteradhoc Feb 9, 2026
3604e2d
rework semantic
masteradhoc Feb 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 34 additions & 15 deletions providers/class-two-factor-totp.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -314,14 +314,35 @@ public function user_two_factor_options( $user ) {

?>
<p>
<?php esc_html_e( 'Please scan the QR code or manually copy the shared secret key from below to your Authenticator app:', 'two-factor' ); ?>
</p>
<p id="two-factor-qr-code">
<a href="<?php echo esc_url( $totp_url, array( 'otpauth' ) ); ?>">
<?php esc_html_e( 'Loading…', 'two-factor' ); ?>
<img src="<?php echo esc_url( admin_url( 'images/spinner.gif' ) ); ?>" alt="" />
</a>
</p>
<?php esc_html_e( 'Please follow these steps in order to complete setup:', 'two-factor' ); ?>
</p>

<ol class="totp-steps">
<li>
<?php esc_html_e( 'Install an authenticator app on your desktop/laptop and/or phone. Popular examples are Microsoft Authenticator, Google Authenticator and Authy.', 'two-factor' ); ?>
</li>
<li>
<?php esc_html_e( 'Scan this QR code using the app you installed:', 'two-factor' ); ?>

<p id="two-factor-qr-code">
<a href="<?php echo esc_url( $totp_url, array( 'otpauth' ) ); ?>">
<?php esc_html_e( 'Loading…', 'two-factor' ); ?>
<img src="<?php echo esc_url( admin_url( 'images/spinner.gif' ) ); ?>" alt="" />
</a>
</p>

<p>
<?php
esc_html_e(
'If scanning isn’t possible or doesn’t work, use the secret key shown below to manually add the account to your chosen app:',
'two-factor'
);
?>
<br />
<code><?php echo esc_html( $key ); ?></code>
</p>
</li>
</ol>
<style>
#two-factor-qr-code {
/* The size of the image will change based on the length of the URL inside it. */
Expand Down Expand Up @@ -364,14 +385,12 @@ public function user_two_factor_options( $user ) {
}
})();
</script>

<p>
<?php esc_html_e( 'Shared secret key:', 'two-factor' ); ?> <code><?php echo esc_html( $key ); ?></code>
</p>
<hr />
<p>
<?php esc_html_e( 'Enter the code generated by the Authenticator app to complete the setup:', 'two-factor' ); ?>
</p>
<ol class="totp-steps" start="3">
<li>
<?php esc_html_e( 'Enter the code generated by the Authenticator app to complete the setup:', 'two-factor' ); ?>
</li>
</ol>
<p>
<input type="hidden" id="two-factor-totp-key" name="two-factor-totp-key" value="<?php echo esc_attr( $key ); ?>" />
<label for="two-factor-totp-authcode">
Expand Down