=== Frontend Login & Register Forms by QuickSnail - Registration, Login, Forgot Password ===
Contributors: quicksnail
Tags: login form, register form, registration form, registration, frontend login
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create simple login forms, register forms and lost password forms. Customizable frontend login & registration forms with shortcodes or template tags.

== Description ==

Login & Register Forms helps you replace the default WordPress sign-in flow with a simple, branded front-end experience.

Add login forms, register forms & lost password forms to pages, posts, or templates without editing core files.

All forms can be customised and branded. 

## Login & Register Forms features

* Simple login forms with `[quicklrf_login]`.
* Simple register forms with `[quicklrf_register]`.
* Add your logo, colors, labels & button styles for full branded forms.
* Pre-built layouts that look nice.
* AJAX submission support for login form and registration form actions.
* Custom redirect after login.
* Custom redirect after logout.
* Custom redirect after registration.
* Hide default wp-login.php page.
* Extend form output using plugin hooks.
* Use template tags for theme integration.

### Login & Register Forms shortcodes:

* `[quicklrf_login]` - Display a front-end login form.
* `[quicklrf_register]` - Display a front-end register form / registration form.
* `[quicklrf_login_register]` - Display a dual front-end login & register form.
* `[quicklrf_lost_password]` - Display a lost password form.



### Shortcode attributes reference

Shortcode attributes allow overriding default settings on individual forms.

**`[quicklrf_login]`**

* `template="default|card|split"`
* `redirect="https://example.com/account/"`
* `form_width="narrow|medium|wide"`
* `title="Member Login"`
* `primary_color="#0073aa"`
* `bg_color="#f0f0f1"`
* `button_style="rounded|pill|square"`
* `show_logo="true|false"`

**`[quicklrf_register]`**

* `template="default|card|split"`
* `register_redirect="https://example.com/welcome/"`
* `redirect="https://example.com/welcome/"` (backward-compatible alias)
* `form_width="narrow|medium|wide"`
* `title="Create Account"`
* `primary_color="#0073aa"`
* `bg_color="#f0f0f1"`
* `button_style="rounded|pill|square"`
* `show_logo="true|false"`

**`[quicklrf_login_register]`**

* `template="default|card|split"`
* `redirect="https://example.com/account/"` (login tab redirect)
* `register_redirect="https://example.com/welcome/"` (register tab redirect)
* `active_tab="login|register"`
* `form_width="narrow|medium|wide"`
* `title="Welcome"`
* `primary_color="#0073aa"`
* `bg_color="#f0f0f1"`
* `button_style="rounded|pill|square"`
* `show_logo="true|false"`

**`[quicklrf_lost_password]`**

* `template="default|card|split"`
* `form_width="narrow|medium|wide"`
* `title="Reset Password"`
* `primary_color="#0073aa"`
* `bg_color="#f0f0f1"`
* `button_style="rounded|pill|square"`
* `show_logo="true|false"`

Examples:

* `[quicklrf_login form_width="narrow" title="Log In" button_style="pill"]`
* `[quicklrf_register register_redirect="/welcome/" primary_color="#1459c7"]`
* `[quicklrf_login_register active_tab="register" title="Join Us" bg_color="#eef4ff"]`

### Other plugin integrations

**Nextend Social Login**

If [Nextend Social Login](https://wordpress.org/plugins/nextend-facebook-connect/) is active, you can show their social login buttons at the bottom of your forms.

To enable this integration:

1. Install and activate Nextend Social Login.
2. Go to Login & Register settings > Advanced > Nextend Social Login.
3. Enable one or more switches:
	* Login Form
	* Register Form
	* Login + Register Form

Behavior notes:

* Login Form switch: shows Nextend buttons at the bottom of `[quicklrf_login]`.
* Register Form switch: shows Nextend buttons at the bottom of `[quicklrf_register]`.
* Login + Register Form switch: shows Nextend buttons inside each tab of `[quicklrf_login_register]` (no duplicate extra output below the form).

**WP Social**

If [WP Social](https://wordpress.org/plugins/wp-social/) is active, you can output the WP Social login buttons at the bottom of your forms.

To enable this integration:

1. Install and activate WP Social.
2. Go to Login & Register settings > Advanced > WP Social.
3. Enable one or more switches:
	* Login Form
	* Register Form
	* Login + Register Form

Behavior notes:

* Login Form switch: renders WP Social buttons at the bottom of `[quicklrf_login]`.
* Register Form switch: renders WP Social buttons at the bottom of `[quicklrf_register]`.
* Login + Register Form switch: renders WP Social buttons inside each tab of `[quicklrf_login_register]` (without duplicate output below the full wrapper).


== Installation ==

1. Upload the Login & Register Forms to the `/wp-content/plugins/` directory.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to the plugin settings page and configure login form, register form and other options.
4. Create a page for your simple login form and insert `[quicklrf_login]`.
5. Create a page for your simple registration form and insert `[quicklrf_register]`.
6. Test the full flow: registration form submission, login form submission, and redirects.

== Frequently Asked Questions ==

= How do I show a simple login form? =

Use the `[quicklrf_login]` shortcode on any page or post.

= How do I show a simple register form? =

Use the `[quicklrf_register]` shortcode on any page or post.

= Is this plugin good for a simple login form setup? =

Yes. You can create a simple login form page in minutes using the shortcode and default styling controls.

= Can I create a simple register form without coding? =

Yes. Add `[quicklrf_register]` to a page and configure text, colors, logo, and redirect settings in the admin panel.

= What is the difference between a register form and a registration form? =

In this plugin, both terms refer to the same user sign-up experience. You can use either phrase when planning your page content.

= Does the login form work with AJAX? =

Yes. The plugin includes AJAX-powered submission for login and registration workflows where available.

= Can I redirect users after login form submission? =

Yes. Configure redirect targets after login, logout, and registration form completion.

= Can I hide wp-login.php and use only front-end forms? =

The plugin includes a hide wp-login.php option. Test carefully with your admin access flow before enabling it on a live site.

= Can I style the register form to match my brand? =

Yes. You can customize layout style, colors, logo, button appearance, and spacing to better match your theme.

= Can I place forms in theme templates instead of shortcodes? =

Yes. Template tag support is available if you prefer rendering the login form or registration form directly in PHP theme files.

= Does it replace the default WordPress login form? =

It provides front-end alternatives so most users can avoid the default screen. Administrators can still use standard WordPress access when needed.

= Can I add custom fields or content to the forms? =

Yes. The forms expose action and filter hooks for developers (see the "For Developers" section below) so other plugins can inject fields, notices, and more.

= Will this work with any theme? =

It is designed to work with most WordPress themes. If your theme has aggressive form styling, you may need minor CSS adjustments.

== For Developers ==

The login and registration forms expose hooks so you can extend them without editing the plugin.

Plugin-specific action hooks (each receives the resolved `$args` array):

* `quicklrf_login_form_before_fields`
* `quicklrf_login_form_after_fields`
* `quicklrf_login_form_before_submit`
* `quicklrf_login_form_after_submit`
* `quicklrf_register_form_before_fields`
* `quicklrf_register_form_after_fields`
* `quicklrf_register_form_before_submit`
* `quicklrf_register_form_after_submit`

Registration also fires `quicklrf_login_before_register` (filter) and `quicklrf_login_after_register` (action) during processing.

== Screenshots ==

1. Frontend lost password form
2. Frontend dual login + register form
3. Frontend register form
4. Frontend login form
5. Settings page
6. Settings page
7. Settings page
8. Settings page

== Changelog ==

= 1.0.3 (2026-07-03) =

* Added Nextend Social Login integration switches in Advanced settings for Login, Register, and Login + Register forms.
* Added WP Social integration switches in Advanced settings for Login, Register, and Login + Register forms.
* Added support to render Nextend social buttons at the bottom of enabled forms.
* Added support to render `[xs_social_login]` at the bottom of enabled forms.
* Fixed duplicate social output on the Login + Register wrapper by keeping output at tab level only.
* Added integration documentation under "Other plugin integrations".

= 1.0.2 (2026-07-03) =

* Fixed register shortcode redirect handling by supporting `register_redirect` overrides.
* Added per-shortcode style attributes: `form_width`, `title`, `primary_color`, `bg_color`, `button_style`.
* Added full shortcode attribute documentation for login, register, login/register, and lost password forms.

= 1.0.1 (2026-07-02) =

* Update mismatched prefixes.
* UI updates.

= 1.0.0 =

* Initial release.
