The general site setup for the Super Admins on FHBRS is an advanced configuration that allows the Admin to quickly enable and disable some key features and also, to quickly modify and edit important values that might apply. This documentation explains all segment of this very important configuration page. Admins are encouraged to visit this page to learn about all segments on this very important page.
Here is how to navigate to the page;
Each menu on the configuration page would be explained one after the other. When each menu is added, this document would be updated to accommodate the newly added feature on this page;
1) Enable Affiliate: The affiliate system makes it possible for both the Super admin and the resellers to offer an affiliate system where people are paid to refer users to complete an order on the site. If this is enabled, users would be able to see the Affiliate Menu from their dashboard and their referral link. The referral link works easily; when the users visit the link, the cookies is logged for 90days and when the user later makes a purchase with the same device, the affiliate records are easily logged.
2) Affiliate Percentage: The affiliate percentage is how much should be paid as affiliate commission. For example: If you offer 20% affiliate commission as the Super Admin and your sales price is $50. This means your profit here on each sales would be $45 as $5 would be recorded as affiliate commission. Also, if you have a recurring product, and there is an initial affiliate commission on that product, this would be paid each time the customer renews the service.
If you enable the Affiliate system as the Super admin, the reseller would be able to set affiliate commission value also from Resellers –> Site Configuration. If resellers set their affiliate commission rate, it differs from the value for the Super Admin. If the user is registered on the reseller’s domain, it means the affiliate percentage would apply to what the reseller has set.
Illustration: If the default price for an item is $50 and the reseller’s price is $60 and the reseller’s affiliate percentage is 10% per sale. The user would earn the sum of $6 per sale and the reseller would be left with the profit of $4.
Another illustration: If the reseller sets an affiliate percentage of 50% this means the user would earn only $10 since 50% of $60 is greater than the resellers profit and the reseller’s profit in this type of sale would be $0.
No matter what the Super admin set it’s gotten based on the default cost, but resellers need to set a value not greater than their profit.
3) Enable Resellers Create Custom Email: The custom email is perfect if you want your resellers to attend to their own customers via a custom email and also it gives them this control over their domain and website. Example: if their-reseller-domain.ext is a reseller’s domain, enabling this feature would enable your resellers create a custom email like email@example.com or firstname.lastname@example.org. email@example.com is already created by default
4) Enable Resellers Create Sub Domain: This becomes necessary if you want your resellers to be able to create a custom subdomain like blog.their-reseller-domain.ext or doc.their-reseller-domain.ext or api.their-reseller-domain.ext or whatever they want to create. The sub domain makes it possible for them to be able to host a complete independent version of their reseller site for a particular purpose.
5) Enable Resellers Create Custom Payment: This feature is very interesting; resellers can create a custom payment integration which they can add to the list of available payment options. There is a simple guide for them to follow and if properly integrated, they would be able to add other payment methods and accept payment in their name.
How it works: Here is pretty simple; Resellers would need to have a balance in their wallet before this would work. This is how it flows;
Step 1: Customer clicks the payment method which the reseller has set
Step 2: Customer is redirected to the payment gateway
Step 3: If payment is successful, the system checks if the reseller has the equivalent in his wallet to pay for the order. If available balance is greater than the order amount proceed to Step 4
Step 4: Create order and deduct the value from the reseller’s balance.
Step 5: Redirect the user to a payment successful page.
If the reseller doesn’t have enough balance, even if the payment was successful at the reseller’s payment gateway, we would mark the order as Not Paid then the reseller would be able to manually mark order as paid from his dashboard.
6) Force Email Verification Before Activity: It is either you want to allow users use the panel without email verification or you want the user to verify email before the panel can be used.
7) Default Session Time In Seconds: The primary timeframe in seconds when each active session should expire if inactive.
8) Default Email Per Minute: There is a central email system which stores all emails sent to the system, this enables the user see previously sent emails from their Message Logs. So, in a situation where you have so many activities happening on your site, first; we store them in a temporary table and then follow this configuration to send those emails minute by minute. The default is 3, it means only 3 emails are sent per minute on the general system.
Note: If you send bulk emails, it would follow this configuration also and this limit could be very important in order for your emails not to be marked as SPAM. Example: if you are sending over 10,000 emails to all resellers and users, you would want the system to send the emails in batches and not to try and send all at once!
9) Use Default Email Settings: When a new reseller successfully points his domain, the domain is added as an addon, panel is created as a subdomain and an email is also created for the domain. The email created is firstname.lastname@example.org. All the emails from the reseller’s domain is sent from this email address. Setting this to true means you want the system to continue using these default settings to send all emails from the domain’s custom email address created to the customer.
If for one reason or the other, emails are not delivering or IP reputation issue or whatever reason, you can change this setup to send emails from a configured SMTP settings (Super Admin –> Email & SEO –>Email SetUp –> SMTP)
If you disable this option, it would automatically select an active configuration from your set SMTP settings and send the email. Reseller’s sender name would still be used and reseller’s reply-to would still remain as email@example.com
10) Maximum API Calls Per Minute: In other to protect your server from BOTS, and other abnormal API calls we have built this very important feature where you can limit the maximum number of API calls per seconds for every reseller. The default is 5.
11) Use Renewal Cost For Upgrade: If you have a recurring pricing product, this simply means you want users to pay for upgrade using the renewal cost.
12) Use Period Remaining Calculation For Upgrade: If you have a recurring pricing product, this means you want users to pay for the difference of the product considering the period when the upgrade is being made in relation to the expiry date.
13) Allow Product Downgrade: If you have a recurring pricing product, this means you want to allow users downgrade a product.
14) Enable Automatic Currency Calculations Based On Location: This makes it possible for customers to see prices from the location they are browsing from. Example, if resellers default currency is EUR, and someone from Canada is accessing reseller’s website, he would see the prices in CAD and can checkout in CAD. This doesn’t change the original value as the cost remains the same just the exchange rate calculation is based on Location.
15) Enable Verification: If you want to enable the verification system.
16) Require Billing Filled Before Checkout: Some payment processors require you adding billing details before you can check out, but if you don’t intend using any of those, you can disable this option and the user would navigate and pay without having to enter billing details during checkout.
17) Auto close Ticket Without Response For How Many Days: When do you want to close a ticket without any response?
18) Reseller Earnings Clearing Period In Days: Default is 7 days, the number of days you set here should also be the number of days for your MBG. After sales are made from your reseller’s site, after the number of days set for this configuration then it’s marked as cleared and the funds would be available for withdrawal.
19) Delete Unpaid Orders After How Many Hours: Orders placed as unpaid should be deleted to clean up the database, select number of hours here.
20) Grace Period In Days Before Order Is Sent For Suspension: If you have a recurring pricing product, and user hasn’t renewed, the settings here would determine when to suspend the account
21) Max Days Allowed To Pay For Suspended Order: If you have a recurring pricing product and the order has been suspended for non payment, here is the maximum number of days the product can be renewed. After this number of days, the product can’t be renewed anymore.
21) Enable Live Chat For All Resellers: Enable or disable the live-chat button for all your resellers.
22) Exempt Currencies Separated By Comma From Currency Live Update: Sometimes, there are some currencies you don’t want the currency API to update based on your own currency calculations. You should manually place the currencies and separate them by comma if more than one. Ex. GHX, NGN, ZAR e.t.c You would be required to manually update them as at when you wish
23) Add Percentage To Currency Rates: If you want to add a particular percentage to the currency exchange rates, just do so from this settings.
24) Currencyapi1 Key: FHBRS uses https://currencyapi.net/ for the currency conversion, you can begin with their free plan and later subscribe as the need increases. Register and add your own Keys