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).

Account Activate page in the WordPress block editor with the shortcode and slug set

Once published, the activation page renders the code entry form for your visitors:

Account Activate page on the frontend showing the activation code field

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: