attributes WP

Get Started

Login Form Shortcode Reference

Version: 1.2.1 (Core)Last Updated: November 2025Difficulty: IntermediateTime Required: 15 minutes

Overview

The

shortcode is the foundation of Attributes User Access, allowing you to embed fully functional login forms anywhere on your WordPress site. This comprehensive reference covers every parameter and option available.

Basic Usage

Minimal Shortcode

This displays a complete login form with default settings:

  • Username/email field
  • Password field
  • Remember me checkbox
  • Submit button
  • Lost password link

Complete Parameter Reference

Redirect Parameters

redirect

Purpose: Where users go after successful login

Type: String (URL)
Default: WordPress dashboard
Example:

Accepts:

  • Relative URLs: /member-area/
  • Absolute URLs: https://yoursite.com/dashboard/
  • Page slugs: Will auto-resolve to full URL

redirect_on_logout

Purpose: Where users go after logging out

Type: String (URL)
Default: Current page
Example:

Common Values:

  • / - Homepage
  • /login/ - Login page
  • /goodbye/ - Thank you page

Form Identification

form_id

Purpose: Custom HTML ID for the form element

Type: String
Default: attributes_login_form
Example:

Use Cases:

  • Multiple forms on same page
  • Custom CSS targeting
  • JavaScript form manipulation
  • Analytics tracking
Important: Each form_id must be unique on the page. Duplicate IDs will cause HTML validation errors.

Label Customization

label_username

Purpose: Label text for username/email field

Type: String
Default: "Username or Email"
Example:

Popular Alternatives:

  • "Email"
  • "Username"
  • "Email or Username"
  • "Student ID"
  • "Member ID"

label_password

Purpose: Label text for password field

Type: String
Default: "Password"
Example:

Alternatives:

  • "Enter Password"
  • "Account Password"
  • "Secure Password"

label_remember

Purpose: Label text for remember me checkbox

Type: String
Default: "Remember Me"
Example:

Popular Alternatives:

  • "Remember me on this device"
  • "Stay logged in"
  • "Keep me signed in"
  • "Remember on this computer"

label_submit

Purpose: Text for submit button

Type: String
Default: "Log In"
Example:

Creative Alternatives:

  • "Access Account"
  • "Enter"
  • "Sign In Now"
  • "Access Members Area"
  • "Continue"

label_lost_password

Purpose: Link text for password reset

Type: String
Default: "Lost your password?"
Example:

Alternatives:

  • "Reset Password"
  • "Can't access your account?"
  • "Forgot your password?"
  • "Need help signing in?"

Behavior Parameters

value_remember

Purpose: Default state of remember me checkbox

Type: Boolean (true/false)
Default: false
Example:

Values:

  • true - Checkbox is checked by default
  • false - Checkbox is unchecked by default
💡 Security Tip: Set to false for public computers or high-security sites. Set to true for member sites where users typically use personal devices.

Complete Examples

Example 1: Simple Member Login

Use Case: Membership website with exclusive content area

Features:

  • Redirects to member dashboard after login
  • Custom button text for clarity

Example 2: E-Commerce Customer Login

Use Case: WooCommerce store or online shop

Features:

  • Customer-friendly labels
  • Redirects to account page
  • Returns to shop after logout

Example 3: Corporate Intranet

Use Case: Employee portal with enhanced security

Features:

  • Security-focused (no remember me)
  • Professional labeling
  • Returns to login after logout

Example 4: Educational Platform

Use Case: Online learning platform for students

Features:

  • Student-specific terminology
  • Clear instructions
  • Device-specific remember me text

Example 5: Client Portal

Use Case: Professional services client area

Features:

  • Client-focused language
  • Descriptive labels
  • Professional branding

Using Shortcodes in Different Contexts

In Pages and Posts

Standard Usage:

  • Edit page or post
  • Add shortcode block (Block Editor) or paste directly (Classic Editor)
  • Enter shortcode with desired parameters
  • Publish or update

In Widgets

Widget Area Implementation:

  • Go to Appearance > Widgets
  • Add "Shortcode" or "Custom HTML" widget
  • Paste shortcode:

Recommended for: Sidebars, footers, header areas

In Theme Templates

PHP Method:

With Wrapper:


';
    echo do_shortcode('


    
    
    
    

    


');
    echo '
'; } ?>

Conditional Display

Show Only to Logged-Out Users:


Logout';
}
?>

Parameter Combination Best Practices

Keep It Simple

✅ Good:

❌ Too Complex:

Recommendation: Only customize parameters you actually need.

Prioritize User Experience

Essential Parameters:

  • redirect - Where users go after login
  • label_submit - Clear call-to-action

Optional Parameters:

  • Only customize labels if defaults don't fit
  • Only change form_id if you have multiple forms
  • Only set value_remember if security requires it

Test All Combinations

After adding parameters, always test:

    • Form displays correctly
    • Labels are clear and readable
    • Redirects work as expected
    • Mobile view is functional
    • No JavaScript errors in console

Common Mistakes to Avoid

Mistake 1: Typos in Parameters

❌ Wrong:

✅ Correct:

Error Result: Parameter is ignored, default behavior applies

Mistake 2: Invalid URLs

❌ Wrong:

✅ Correct:

Always include leading slash for relative URLs!

Mistake 3: Duplicate Form IDs

❌ Wrong (on same page):

✅ Correct:

Mistake 4: Quotes Within Quotes

❌ Wrong:

✅ Correct:

Or use HTML entities:

Debugging Shortcode Issues

Shortcode Appears as Text

Symptoms: You see

on the page

Causes:

  • Plugin not activated
  • Shortcode in wrong context
  • Syntax error in shortcode

Solutions:

  • Verify plugin is activated
  • Check for typos in shortcode name
  • Ensure shortcode is in a block that supports shortcodes

Parameters Not Working

Symptoms: Changes to parameters have no effect

Debug Steps:

  • Check syntax: Ensure proper spacing and quotes
  • Clear cache: Browser cache and WordPress cache
  • Test default: Try
    ` without parameters
  • Browser console: Check for JavaScript errors (F12)

Form Doesn’t Display

Symptoms: Blank space where form should be

Causes:

  • JavaScript error
  • CSS hiding form
  • Plugin conflict

Solutions:

  • Check console: Look for JavaScript errors
  • Inspect element: Look for hidden CSS
  • Test theme: Switch to default WordPress theme
  • Disable plugins: Test for conflicts