Quick Registration

After configuring your billing system integration, you need to set up Quick Registration to optimize the user onboarding experience. This feature allows seamless registration and service provisioning for new users.

Registration

Enable Quick Registration

When enabled, the /register endpoint in the Client Area becomes active. Users can register directly through PanelAlpha's interface. When disabled, attempts to access /register will result in an error message: "Registration is disabled."

Registration Password Skip

• Disabled: Requires users to set a password and confirm their email address using a verification code sent to their email.
• Enabled: Users only need to set a password, with email verification required at their second login.

Pre-created Accounts

This feature allows you to prepare WordPress instances in advance for new users to provide immediate access upon registration.

• Instances are created under a special system user named "Pre-Created Trial" (this user is automatically created if it doesn't exist)
• When a new user registers, ownership of a pre-created service/instance is transferred to them
• This eliminates waiting time for WordPress installations and improves user experience
• Pre-created services are automatically replenished (a cron job checks every minute and adds new installation tasks as needed)
• The "Force Create" button triggers these tasks immediately
• Setting the count to 0 disables pre-created instances, meaning new trial users will need to wait for their instances to be installed
• Pre-created services and instances are not included in your billing usage calculations
• The "Force Create" button is non-functional if no trial plan is selected

Trial Settings

Trial Plan

• Select a plan to assign to newly registered users
• It's recommended to use a super-quick onboarding plan with "ask for domain" disabled for the best user experience
• This ensures users can immediately access their WordPress instance without additional setup steps

Trial Duration

• Specifies how long the trial period lasts (in days)
• Setting this to 0 creates user accounts without assigning any service, functioning as if an admin created the account manually without adding a service

Default Site Name

• Sets the default name for trial sites
• Similar to the site name setting in WHMCS, as trial services don't exist in WHMCS initially

Upgrade URL

• Identical to the "Upgrade Link" in plan details
• Changes made here will be synchronized with the corresponding plan settings and vice versa

Trial Notifications

Send Trial Expiration Reminders

Configure up to 7 notifications for each user, each with its own template:

• First Reminder Before Expiration
• Second Reminder Before Expiration
• Third Reminder Before Expiration
• On Expiry Date
• First Reminder After Expiration
• Second Reminder After Expiration
• Third Reminder After Expiration

Trial Registration Links

Special URL parameters to customize the registration experience:

• Accessing the /register endpoint directly creates a user account and assigns the configured trial plan. When this user later decides to create an instance, it will be provisioned using the Pre-Created Accounts system, significantly reducing installation time and improving user experience.
• Adding ?new-site to the /register URL (e.g., /register?new-site) automatically initiates a new instance installation process after registration, as if the user clicked "Add New" → "New instance"
• Adding ?new-import to the /register URL automatically initiates an import process after registration, as if the user clicked "Add New" → "Import"

You can also pre-populate the email field by adding it to the URL, for example: /register/email@example.com?new-site - this will auto-fill the email address and display a registration placeholder.

You can use these registration links in a form on your website to allow users to start trials directly:

<form method="get" action="https://example.com/register" >
  <input type="hidden" name="new-site" />
  <input type="email" name="email" placeholder="Enter Your Email Address" required />
  <button type="submit">Start Your Trial</button>
</form>

Note: Remember to replace https://example.com/register with your actual PanelAlpha registration URL.

Other

Registration Terms Text

• Content displayed in the modal on the register page under the link "By registering, you accept Terms of Service"

reCAPTCHA

• Adds protection to login and register pages
• Site key and Secret key must be generated through the Google Admin Console
• Score Threshold: tolerance for bot detection (default 0.5)
• Setting the threshold to 1 may cause false positives, especially when using quick registration links

Configuration

To set up reCAPTCHA for your PanelAlpha installation, follow these steps:

1. Visit the Google reCAPTCHA Admin Console at https://www.google.com/recaptcha/admin/ (opens new window)

2. Sign in with your Google account

3. Click the "+" button to create a new site registration

4. Fill in the form:

   • Label: Enter a name for your site (e.g., "PanelAlpha Registration")
   • reCAPTCHA type: Select "reCAPTCHA v3" for invisible verification
   • Domains: Add your PanelAlpha domain(s)
   • Accept the Terms of Service: Check the box
   • Send alerts to owners: Optional - add email addresses for security alerts

5. Click "Submit"

6. On the next screen, you'll receive two keys:

   • Site Key: This is the public key that will be displayed on your page
   • Secret Key: This is the private key for secure server-side communication

7. Copy both keys and enter them in the corresponding fields in the PanelAlpha Background Billing Quick Registration settings

8. Configure the Score Threshold according to your security needs (0.5 is recommended for most sites):

   • Higher values (closer to 1.0): More strict detection but may block legitimate users
   • Lower values (closer to 0.0): Less strict detection but may allow some automated traffic