Other

The Other tab allows you to configure additional WHMCS settings.

The Other tab in General Settings

You can access this tab at Configuration () > System Settings > General Settings.

Marketing Emails

Enable this to display the Newsletter Opt-In option to new customers during checkout or registration, allowing them to easily opt in to receive marketing emails that your WHMCS installation sends. The system enables this setting by default.

Require User Opt-In

Enable this to require clients to explicit opt-in before they will receive marketing emails. By default, users must opt in to receive marketing emails.

You can use this setting to enable the Newsletter Opt-In option by default, requiring users instead to opt out of marketing emails.

Marketing Email Opt-In Messaging

Enter the message that will appear to clients in the Client Area if Marketing Emails is enabled (above). The message that you enter will display with the Newsletter Opt-In option.

Make certain that this message accurately reflects the type of marketing emails that you will send.

Admin Client Display Format

Choose the format that your customer’s names appear in throughout the Admin Area. For example, you can choose to display the client’s company name rather than a first and last name.

Client Dropdown Format

Choose the format that your customer’s names appear in when you view client menus throughtout the Admin Area.

Default to Client Area

Enable this option to take visitors directly to your Client Area login form when they visit your website. If you disable this option, visitors see a homepage with various options when they access your website.

Disable Client Area User Management

Check this option to prevent account owners from adding and managing other users. Admins can still invite and manage users at Clients > Manage Users and in the Users tab in the client’s profile.

This setting does not prevent existing users from logging in to their associated accounts.

Allow Client Registration

If you enable this, customers can sign up at /registration.php without ordering a product.

Client Email Preferences

Enable this setting to allow clients to customize the emails that they receive by configuring the settings in their Client Area profile page. If you disable this option, clients cannot change which emails they receive.

  • This setting will not change the opt-in and opt-out email notification preferences of clients.
  • Regardless of their settings, clients will continue to receive any Email Verification and Password Reset emails.

By default, clients and users receive all email notification types. The groups of email notifications match the groups at Configuration () > System Settings > Email Templates.

Optional Client Profile Fields

Check the profile fields that you want to set as optional on registration and order forms. For example, checking Phone Number will cause it to be optional to enter a phone number while completing an order in the Client Area.

Certain modules, particularly domain registrars, may require all the client profile information in order to function.

Locked Client/User Profile Fields

Check profile fields to prevent clients and users from updating this information in the Client Area. Clients will still be able to view these details as text, but edits will only be possible in the Admin Area.

Client Details Change Notify

Enable this option to send email notification to all admins when a customer changes their contact details.

Marketing Opt-out

Enable this option to display an option to opt out of marketing emails on the Account Details page of the Client Area.

Enable this to activate the cancellation system. Customers can request cancellation from the Product Details page, and admins can view the requests in the Admin Area at Clients > Cancellation Requests.

For more information, see Cancellations.

Monthly Affiliate Reports

Enable this to send a monthly report email with the status of the customer’s affiliate account to all active affiliates.

For more information, see Affiliates.

Banned Subdomain Prefixes

Enable this setting to prevent customers from placing orders using any of the subdomains that you specify for products that have enabled the free subdomain option. Enter subdomains to block in a comma-separated list.

For example, the default values will block users from placing orders using a subdomain like ftp.example.com.

Encoded File Loading

Enable this setting to allow encoded file loading. When loading custom PHP assets like hooks or widgets, WHMCS will perform static analysis on ionCube-encoded files. If the encoded file is either unknown or incompatible with the environment, the file will not load normally.

  • You can disable this feature if you have custom files that you are certain are compatible with your environment but that the analysis considers incompatible.

  • When you enable this, any files that do not load will appear in either the activity log or the hook log. You can override this in the configuration.php file by defining the $enable_safe_include variable with a value of either true (enabled) or false (disabled). For example:

    $enable_safe_include = false;

For more information on updating this file, see The configuration.php File.

Event Handling

We added this setting in WHMCS 8.4.

Select the way in which the system handles events. Events are actions that the system executes in order to complete a provisioning-related request. For example, provisioning a hosting product with WordPress® results in an event that installs WordPress on the server.

Many events can relate to the fulfillment of a single order or automation routine. The Event Handling setting controls and optimizes how and when WHMCS prepares and executes these events.

You can choose from the following options:

  • Concurrent (Launch an asynchronous request.) — Run events as asynchronous requests, concurrent with the process that caused them. The setting defaults to this option and most admins should select this. When you select this, WHMCS will present the optimal user experience with the lowest wait times for the client.
  • Inline (Handle events within the same request.) — Run all events within the same request as the process that caused them. Use this option for WHMCS installations that use uncommon or constrained CGI environments in which concurrency is not possible. Prior to WHMCS 8.3, WHMCS used this mode of event preparation and execution. When you select this option, clients will still have a positive experience but it may not be as fast as Concurrent (Launch an asynchronous request.).
  • Cron (Defer events until the next cron run.) — Defer events to the next time that the cron runs. We only recommend this option for specialized environments with unique runtime constraints or highly-customized provisioning and procurement systems. When you select this option, clients will have a quick experience but it may delay changes to remote systems.
    For more information, see System Cron.

Display Errors

Enable this option to view additional error message information when an error occurs.

If you encounter a blank page or Oops! error page in WHMCS, make certain that display_errors is enabled in the server’s PHP configuration and then enable this setting. Use the displayed error when you troubleshoot the problem.

Log Errors

Enable this option to log PHP errors to Configuration () > System Logs. Use this if you do not want to show sensitive path information on public-facing pages.

Enabling this option may result in a large number of activity log entries. We recommend only enabling it when you are actively debugging an issue.

SQL Debug Mode

Disable this option unless WHMCS Technical Support has instructed you to enable it. When you enable this option, the system logs database errors to Configuration () > System Logs.

Enabling this option may result in a large number of activity log entries. We recommend only enabling it when WHMCS Technical Support instructs you to do so.

Hooks Debug Mode

Enable this option to log hook system errors to the Activity Log at Configuration () > System Logs.

Enabling this option may result in a large number of activity log entries. We recommend only enabling it when you are actively debugging an issue.

Last modified: June 14, 2024