Quick Registration Configuration

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.

Accessing Quick Registration Settings

1. Navigate to the Admin Area
2. Go to the "Background Billing" section
3. Select the "Quick Registration" tab

Quick Registration Options

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.
• Social Media Login: When users register through social media authentication, no additional verification is required.

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 Configuration

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 Notification Before
• Second Notification Before
• Third Notification Before
• On the expiry date
• First Notification After
• Second Notification After
• Third Notification After

Trial Registration Links

Special URL parameters to customize the registration 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"

Note: When using these parameters with pre-created accounts, be aware that registration with ?new-import will still create/assign a trial service, potentially using up the instance limit if the plan allows only one instance.

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.

Legal & Security Settings

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

Setting Up reCAPTCHA with Google

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

Social Media Login

For detailed information about configuring Social Media Login options, please refer to the Social Media Login documentation.

After configuring Quick Registration, your Background Billing setup is complete and ready for use.