WemX

All application-wide settings live in Admin → Settings. The page has one tab per area. Changes apply as soon as you save. Each field shows when it was last changed.

Some infrastructure values, such as the database, APP_URL, the license key and the active theme, live in the .env file rather than in the admin panel. See Environment values below.

Application

Setting	What it does
Application Name	Shown in the header, page titles and emails.
Company Address	Your business address. It appears on invoices.
Default Language	The language guests see. Logged-in users see the language saved on their own account.
Application Timezone	Used for every date shown in the panel, in emails and in scheduled tasks. Use a PHP timezone identifier such as `Europe/Amsterdam`.
Default Currency	The base currency. Prices are entered in it, balances are kept in it, and revenue is reported in it. Customers can browse in other currencies, but everything is stored in the base currency.
Default Email Theme	The design used for outgoing emails. See Emails.

Upload your Application Logo and Favicon. Uploaded files are also listed in the image library at Admin → Settings → Images, where you can reuse them, for example as package or category icons.

Metrics & Options

These settings control the billing automation.

Setting	Default	What it does
Date Format	`d M Y H:i`	The PHP date format used across the app. A live preview is shown next to the field.
Renewal Reminder	—	How many days before an order's due date the customer gets a renewal reminder email.
Suspension Period	3 days	How many days after the due date an unpaid order is suspended.
Termination Period	7 days	How many days after the due date an unpaid order is terminated. It must be longer than the suspension period.
Delete Terminated Orders Period	Off	Optionally delete terminated orders after a number of days, to keep the order list clean.

In the current beta, Renewal Reminder and Delete Terminated Orders Period are saved but no scheduled task acts on them yet. Suspension and termination are fully automated.

Termination deletes the service on the server and can't be undone. Choose a termination period that gives customers enough time to pay.

Payments & Invoicing

Setting	What it does
Invoice ID Format	The pattern for invoice numbers. Placeholders: `{id}`, `{year}`, `{month}`, `{day}`. Default: `INV-{year}-{id}`.
Invoice ID Padding	Pads `{id}` with zeros. With `4`, IDs become `0001`, `0002` and so on.
Default Invoice Theme	The layout used for invoice PDFs. Every installed invoice theme is listed.
Billing From Details	The sender block printed on invoices: company name, address, tax ID and contact details.

Taxes

Controls whether and how sales tax or VAT is charged. Tax rates themselves are managed per country under Admin → Tax Countries. Both are covered in Taxes.

Setting	What it does
Enable Sales Tax	Turns tax calculation on or off.
Include Tax In Price	If on, your package prices already include tax and the tax is worked out from the price. If off, tax is added on top at checkout.
Enable Sales Tax Exemption	Businesses that enter a company name and tax ID at checkout don't pay tax (reverse charge).
Verify VAT ID	Checks EU VAT IDs against the European Commission's VIES service before granting the exemption.
Always Taxable Countries	Countries where the exemption never applies, typically your own country.
Exclude Gateways for Tax Calculation	Gateways that never get tax added, such as gateways that handle tax themselves. The Balance gateway is excluded by default so top-ups aren't taxed twice.
Allow Client PDF Invoices	Lets customers download PDF invoices from the client area. Admins can always download them.

Authentication

Setting	What it does
Enable Registrations	Allow or block new sign-ups. Existing customers can still log in.
Require Address	Customers whose address is missing or incomplete must complete it before they can continue. Turn this on if you need addresses for tax or invoicing.
Block Reserved Usernames	Stops people registering usernames such as `admin` or `support`. The list lives in `config/reserved-usernames.php`.

Extension settings

Extensions can add their own settings tabs. They appear under Third Party in the settings sidebar once the extension is enabled.

Environment values

These are set in .env in your WemX folder. Run php artisan config:clear after you change them.

Key	Purpose
`APP_URL`	The public URL of your installation. It's used to build links in emails and gateway callback URLs, so it must be correct.
`LICENSE_KEY`	Your WemX license key. You can also update it from Admin → License.
`APP_THEME`	The client area theme (folder in `resources/client_area`). Default: `default`.
`APP_ADMIN_THEME`	The admin area theme (folder in `resources/admin_area`). Default: `default`.
`FORCE_HTTPS`	Forces generated URLs to use `https`. Turn this on behind a proxy or load balancer.
`APP_KEY`	The encryption key. Gateway and server credentials are encrypted with it. Back it up, and never change it on a live installation.

Settings