Skip to main content

Installation & Setup

Installation​

Method 1: WordPress Plugin Directory​

  1. Navigate to Plugins → Add New in WordPress admin
  2. Search for "LoginBerry"
  3. Click "Install Now"
  4. Click "Activate"

Method 2: Manual Upload​

  1. Download LoginBerry from WordPress.org
  2. Navigate to Plugins → Add New → Upload Plugin
  3. Select the downloaded ZIP file
  4. Click "Install Now"
  5. Click "Activate"

Initial Setup​

Step 1: Verify Email Configuration​

LoginBerry requires your site to send emails. Test your email delivery before setup.

Recommended: Install SMTP Plugin

For reliable email delivery, use an SMTP plugin:

Test Email Delivery:

  1. Create test user account
  2. Check if WordPress sends registration email
  3. If no email arrives, configure SMTP plugin

Step 2: Create Activation Page​

Required: Create a page with the exact slug /account-activate/

  1. Navigate to Pages → Add New
  2. Enter page title (e.g., "Account Activation")
  3. Add the shortcode: [loginberry_account_activate]
  4. Important: Set page slug to account-activate (Settings → Permalink)
  5. Publish the page

Page Content Example:

<!-- wp:heading -->
<h2>Activate Your Account</h2>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>Please enter the 6-digit activation code sent to your email address.</p>
<!-- /wp:paragraph -->

<!-- wp:shortcode -->
[loginberry_account_activate]
<!-- /wp:shortcode -->
tip

You can add additional content above or below the shortcode (instructions, branding, support links).

Step 3: Verify Setup​

Test User Registration:

  1. Log out of WordPress
  2. Create a new test user account
  3. Check if user is redirected to /account-activate/
  4. Check email for 6-digit activation code
  5. Enter code on activation page
  6. Verify successful activation

Check Admin Column:

  1. Navigate to Users → All Users
  2. Verify "Account Activated" column appears
  3. Check test user status shows ✓ Activated

Configuration Options​

LoginBerry works with zero configuration. All settings are automatic:

  • Activation Page: /account-activate/ (page must exist)
  • Failed Attempts Limit: 15 (account locked after)
  • Activation Code: 6 digits (auto-generated)
  • Code Expiration: None (code valid until used)
Future Updates

Custom configuration options (attempt limits, page URLs, redirects) are planned for future releases.

Troubleshooting Setup​

Users Not Redirected to Activation Page​

Possible causes:

  • Page slug is not exactly account-activate
  • Page is not published
  • Permalink structure not updated

Solution:

  1. Verify page slug in Pages → All Pages
  2. Navigate to Settings → Permalinks
  3. Click "Save Changes" (flushes rewrite rules)

Activation Emails Not Arriving​

Possible causes:

  • Email delivery not configured
  • Email sent to spam folder
  • Server email restrictions

Solution:

  1. Install SMTP plugin (recommended)
  2. Check spam folder
  3. Test with different email provider (Gmail, Outlook)
  4. Check server email logs

Shortcode Not Rendering​

Possible causes:

  • Plugin not activated
  • Page builder conflict
  • Theme shortcode compatibility

Solution:

  1. Verify LoginBerry is activated (Plugins → Installed Plugins)
  2. Try WordPress default editor (disable page builder)
  3. Contact support with theme details

Next Steps​

After installation: