Dashboard configuration
There are multiple things that can and need to be configured for the Dashboard to be functional which can be accessed from the edit button on the Dashboard settings page.
These configuration settings include:
Business Name
This should be the public name for the Dashboard. It appears on the site titles and all emails originating from the Dashboard.
Hostname
This is the domain or subdomain name that the Dashboard will be accessible at. It needs to be pointing at our server IP with an A record which will be provided. Depends on your domain registrar this is usually done on the DNS configuration page.
Changing this hostname to a domain/subdomain not pointing at our server will result in the Dashboard instance being inaccessible**
Logo URL
A direct URL to an image (png, svg, jpg) to be used as a logo for the Dashboard and all emails that originate from it.
Primary Colour
This is the primary colour of the Dashboard for buttons, highlighted text, checkboxes and etc. Can only use 6 letter HTML HEX codes like #AABBCC
Currency
This is the primary currency of which the prices on the Dashboard are. Only ISO 3-Letter Currency Code that are supported by Stripe can be used.
For more information on what currencies you can use with Stripe you can check https://stripe.com/docs/currencies (opens in a new tab)
Stripe Secret Key
Your live Stripe secret key obtained from the developer section of the Stripe dashboard.
If you are not sure where to look, please see
https://support.stripe.com/questions/locate-api-keys-in-the-dashboard (opens in a new tab)
Please note that changing this Stripe key should only be done after notifying us of the change. This is because Stripe webhooks are automatically created and stored when you set a key, and if that's replaced without these being cleared by us your site will not receive payment notifications/orders
Mailgun/SMTP Options
These are multiple options that are titled
- Mailgun Email Login SMTP Username
- Mailgun Email Password SMTP Password
- Mailgun Email From Emails will be sent with this from address
- Mailgun Email Server SMTP Server (
smtp.mailgun.orgif you're using mailgun)
We recommend using mailgun.com to fill these fields but it does support any SMTP server, default port is assumed to be 587.
If you can't locate the information for these fields please see SMTP Credientials section on https://help.mailgun.com/hc/en-us/articles/203380100-Where-Can-I-Find-My-API-Key-and-SMTP-Credentials- (opens in a new tab)
Privacy Policy / Terms of Service Links
These should be direct links to your Privacy Policy and Terms of Service pages. They are displayed in checkout page and registration page.
Discord Client ID / Secret
These are needed to enable login through Discord for the Dashboard instance. They are obtained from the Discord application through the developers portal.
Please set a redirect URL on OAUTH page that points at your domain with this specific path /api/auth/callback/discord
Your full redirect URL should look like https://domain.com/api/auth/callback/discord (replacing domain.com with your domain/hostname)
Stripe Automatic Tax (VAT)
This setting is for enabling Stripe's automatic tax collection through checkout session. If you have tax rules on your Stripe account you can enable this option to start collecting tax.
The Dashboard sets checkout price to Tax inclusive when this option is enabled.
For more information, please check https://stripe.com/docs/tax (opens in a new tab)