General settings

Overview

General settings control page assignments, form text, email templates, and redirect behavior. These settings determine where users are sent during the password reset flow and what text they see at each stage.

Access general settings at Settings > Frontend Reset Password > General tab.

Page assignments

Reset Password Page (required)

Setting: somfrp_reset_page

Purpose: The page containing the [reset_password] shortcode where users complete password resets.

Configuration:

1. Create a page with the [reset_password] shortcode
2. Select that page from the dropdown
3. Save changes

Default: None (must be configured)

warning

This setting is required. Without it, WordPress will continue using wp-login.php for password resets instead of your custom page.

Login Page

Setting: somfrp_login_page

Purpose: The page where users log in after successfully resetting their password.

Configuration: Select your custom login page from the dropdown

Default: WordPress default login page (wp-login.php)

Use cases:

• Membership sites with custom login pages
• E-commerce sites using WooCommerce My Account
• Sites using custom authentication plugins

Request Success Page

Setting: somfrp_request_success_page

Purpose: Optional redirect after user requests a password reset (Stage 1 completion).

Configuration: Select a page to redirect to after email is sent

Default: None (stays on reset password page with success message)

Use case: Redirect to a custom "Check Your Email" page with additional instructions

Reset Success Page

Setting: somfrp_reset_success_page

Purpose: Optional redirect after user successfully changes their password (Stage 3).

Configuration: Select a page to redirect to after password is changed

Default: None (displays success message on reset password page)

Use case: Redirect to account dashboard or welcome page after password change

Form text customization

Form Title

Setting: somfrp_form_title

Purpose: Heading displayed at the top of password reset forms.

Default: "Reset Password"

Example: "Forgot Your Password?" or "Password Recovery"

Appears on: Both Stage 1 (request) and Stage 2 (reset) forms

Lost Password Message

Setting: somfrp_lost_password_message

Purpose: Instruction text shown on the initial password reset request form (Stage 1).

Default: "Please enter your username or email address. You will receive a link to create a new password via email."

Example: "Enter your email address and we'll send you a link to reset your password."

Appears on: Stage 1 (request form) only

Reset Password Message

Setting: somfrp_reset_password_message

Purpose: Instruction text shown on the new password entry form (Stage 2).

Default: "Enter your new password below."

Example: "Choose a strong password for your account."

Appears on: Stage 2 (reset form) only

Button Text

Setting: somfrp_button_text

Purpose: Label for the submit button on password reset forms.

Default: "Reset Password"

Example: "Send Reset Link" (Stage 1) or "Update Password" (Stage 2)

Appears on: Both Stage 1 and Stage 2 forms

note

The same button text is used on both forms. If you want different text for each stage, you'll need to create template overrides.

Success Message

Setting: somfrp_success_message

Purpose: Message displayed after password is successfully changed (Stage 3).

Default: "Your password has been reset successfully."

Example: "Success! Your password has been updated. You can now log in with your new password."

Appears on: Stage 3 (completion page) only

Login Link Text

Setting: somfrp_login_link_text

Purpose: Text for the login link shown after successful password reset.

Default: "Log in"

Example: "Click here to log in" or "Sign in to your account"

Appears on: Stage 3 (completion page) only

Email customization

Email Subject

Setting: somfrp_email_subject

Purpose: Subject line for password reset emails.

Default: "Account Password Reset"

Example: "[Your Site Name] Password Reset Request"

Filter available: somfrp_retrieve_password_title for programmatic customization

Email Message

Setting: somfrp_email_message

Purpose: Body content for password reset emails.

Default: WordPress default reset email template

Template variables:

• {username} - User's login name
• {reset_link} - Password reset URL
• {email} - User's email address

Example:

Hello {username},

Someone requested a password reset for your account at Our Site.

If this was you, click the link below to reset your password:
{reset_link}

If you didn't request this, you can safely ignore this email.

Thanks,
The Our Site Team

Filter available: somfrp_retrieve_password_message for programmatic customization

tip

Use HTML in the email message for better formatting. The plugin sends HTML emails by default.

From Name

Setting: somfrp_from_name

Purpose: Sender name displayed in password reset emails.

Default: WordPress site name

Example: "Support Team" or "Your Site Name"

Email header: From: [From Name] <[From Email]>

From Email Address

Setting: somfrp_from_email

Purpose: Sender email address for password reset emails.

Default: WordPress admin email

Example: "[email protected]" or "[email protected]"

Email header: From: [From Name] <[From Email]>

warning

Ensure the from email address is authorized to send from your domain to avoid emails being marked as spam. Configure SPF and DKIM records for your domain.

Reset Link Text

Setting: somfrp_reset_link_text

Purpose: Custom text for the reset link in emails instead of showing the full URL.

Default: Empty (shows full URL)

Example: "Click here to reset your password" or "Reset My Password"

Behavior:

• If empty: Email shows full reset URL
• If set: Email shows custom text as clickable link

Notice Background Color

Setting: somfrp_notice_bg

Purpose: Background color for success and error messages.

Default: Empty (uses plugin default styling)

Format: Hex color code (e.g., #0073aa)

Use case: Match message styling to your theme's color scheme

Settings validation

The plugin validates general settings before saving:

Page selections: Verifies selected pages exist and are published

Email addresses: Checks from email address is properly formatted

Required fields: Ensures Reset Password Page is selected

If validation fails, settings are not saved and an error message is displayed.

Common configurations

Membership site

Reset Password Page: /reset-password/
Login Page: /login/
Form Title: "Recover Your Account"
Email Subject: "[Site Name] Password Recovery"
From Name: "Support Team"

E-commerce site (WooCommerce)

Reset Password Page: /my-account/lost-password/
Login Page: /my-account/
Reset Success Page: /my-account/
Email Subject: "Reset Your [Store Name] Password"
From Name: "[Store Name] Support"

Simple blog

Reset Password Page: /forgot-password/
Login Page: (default wp-login.php)
Form Title: "Reset Password"
Email customization: (use defaults)

Troubleshooting

Reset link goes to wp-login.php

Problem: Email link redirects to WordPress default login instead of custom page.

Solution: Verify Reset Password Page is selected and saved. Clear all caches.

Emails not arriving

Problem: Users don't receive password reset emails.

Solution: See Email not sending troubleshooting for detailed solutions.

Custom email text not appearing

Problem: Email still shows default WordPress text despite custom settings.

Solution: Ensure you clicked Save Changes. Check if another plugin is filtering the email content.

Page dropdown is empty

Problem: Can't select pages in dropdown menus.

Solution: Create and publish pages first. Ensure you have admin permissions.

What's next

• Security settings - Configure password requirements
• Email customization guide - Advanced email customization
• Quick start tutorial - Test your configuration