New Account Trials

After configuring your billing system integration, you need to set up New Account Trials 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

Suspend Trial After

• Set the duration after which trial accounts will be suspended if not upgraded to a paid plan
• Specifies the number of days before the trial service gets suspended

Remove Trial After

• Define when trial accounts should be completely removed from the system if they remain inactive
• Specifies the number of days before the trial service gets permanently deleted

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 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 New Account Trials 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