সেটিংস
প্রতিটি সেটিং ট্যাব ও কী সহজ কথায়, কারেন্সি ও রেট, ইমেইল টেমপ্লেট ও মার্জ ফিল্ড, ভাষা, প্লাগিন, থিম, আর সিস্টেম পেজ: ক্রন, কিউ, ক্যাশ, ডাটাবেস আপডেট, ব্যাকআপ, API কী ও চেঞ্জলগ।
Everything you can change about the marketplace without touching a file is in the group Settings. This chapter explains every settings tab and key in plain words, then currencies and rates, e-mail templates and their merge fields, languages, plugins, themes, and the System & Maintenance page (cron, queue, cache, database update, backups, server information and logs), API keys and the change log.
1. How settings work
- Settings → General Settings has eleven tabs: General, Branding, Members, Listings, Verification, Search, Messages, E-mail, SEO, Security and System. A tab is one form with its own save button, titled for example Save listings settings.
- Only the keys on the tab you save are written. After a save the page says how many values changed; if none, Nothing was changed.
- Every change is written to the Admin Audit Trail with the old and new value. Secrets (the SMTP password and the captcha secret) are shown there only as (set) and (changed).
- The cache is cleared after a save, so changes show at once.
- Each tab needs a right: General, Branding, Members, Verification, Search, Messages need General settings; Listings needs Listing rules; E-mail needs Mail settings and templates; SEO needs SEO settings; Security needs Security settings; System needs System, licence, API keys. A tab you may not open is not shown.
- A field with a wrong value is not saved; the page shows the problem above the form and keeps what you typed.
Switches are Yes / No sliders. Numbers have a minimum and a maximum.
2. General
| Setting | Meaning (default) |
|---|---|
| Site name | Shown in the header, in e-mails and in the browser title. Required, up to 100 characters. (AIO Domain) |
| Tagline | One line under the name; used as the default description. |
| Site address | The address of the marketplace, like https://www.example.com, no slash at the end. Empty: the address the site is opened on. Set it correctly: links in e-mails use it. |
| Contact e-mail | Shown on the contact page and used as the reply address. |
| Contact phone | Shown on the contact page. |
| Company address | Shown in the footer; also available as {address} in page text. |
| Time zone | All dates are shown in this time zone. (Asia/Dhaka) |
| Date format | Six styles, such as M j, Y or Y-m-d. |
| Default country | Pre-selected on the sign-up form. (Bangladesh) |
| Default language | The language visitors see until they pick one. Words are edited under Languages. (English) |
| Facebook, X / Twitter, LinkedIn, YouTube, Instagram | Links shown in the footer. |
| X / Twitter handle | Without the @; used for share cards. |
3. Branding
| Setting | Meaning |
|---|---|
| Logo, Logo for dark backgrounds, Favicon | Upload buttons with a preview and Remove it. The dark logo is used in the footer and on dark pages. |
| Footer credit | Shown as Set by your licence. Cannot be changed. |
Brand colour (#0d9488) and Second colour (#f59e0b) | Buttons, links, e-mails, highlights and badges. |
| Home page badge | The small line above the home page headline. (Trusted by buyers and sellers worldwide) |
| Quick top-bar text | A one-line text for themes that show a top bar. For dated banners use Content → Announcements. |
| Dark mode switch | Shows the light / dark switch on the site. (On) |
| Cookie notice and Cookie notice text | Whether the cookie banner shows, and what it says. (On) |
4. Members
| Setting | Meaning (default) |
|---|---|
| Allow sign-ups | Off closes registration; the page says Registration is closed. (On) |
| E-mail verification | New members must click a link before they can list or send inquiries. Off: new accounts start active and verified. (On) |
| Default account type | Pre-selected on the sign-up form: Buyer, Seller or Buyer and seller. (Buyer) |
| Minimum length | Shortest password, 6 to 64. (8) |
| Need letters and numbers | When on, a password needs upper and lower case letters and a digit. (On) |
| Captcha type | Built-in question (a small sum, no keys), Google reCAPTCHA v2, Cloudflare Turnstile or hCaptcha. (Built-in) |
| Site key, Secret key | For the three outside services. The secret is stored encrypted; leave it empty to keep the stored key, or tick Remove the stored value. A service other than the built-in one needs a site key. |
| Captcha on sign-up, Captcha on sign-in | Where the captcha shows. (On, Off) |
| Trust a device for (days) | After a two-factor check a member may tick Remember this device. 0 turns it off. (30) |
| Tell members about a new device | A notification when an account is used from an unknown device. (On) |
5. Listings
| Setting | Meaning (default) |
|---|---|
| Listing runs for (days) | After this a listing expires unless renewed. (365) |
| Lowest price (USD), Highest price (USD) | The allowed Buy Now price range. (1 and 100,000,000) |
| Lowest minimum offer (USD) | A seller cannot set a minimum offer below this. (0) |
| Category is required | A listing must have a category. (Off) |
| Allow links in descriptions | Off: a description with a link is refused. (Off) |
| Allow sub-domains | Off: only registrable names such as example.com. (Off) |
| Add unknown extensions automatically | A listing with an extension that is not on the list creates it. Off: staff must add it first. (On) |
| CSV import: most rows | Cap per file, 1 to 50,000. (2,000) |
| Days a name stays claimed | How long a domain that another seller listed first blocks new claims while it is unverified. (60) |
| Ownership must be verified | A listing goes live only after the DNS check or an override. (On) |
| E-mail must be verified | Only members with a confirmed e-mail may list. (On) |
| Submit when verified | A verified draft is sent to approval by itself. (On) |
| Approve listings automatically | Skip the moderator queue for everyone. (Off) |
| Approve verified sellers automatically | Sellers with the verified badge skip the queue. (On) |
| Approve again after an edit | A live listing returns to the queue when the seller changes the title, description or category. (Off) |
| Commission | Moved to the Payments & Fees tab in 1.4.0 (standard rate, smallest / largest / fixed commission, the buyer's marketplace fee, checkout, invoices and payouts). The chapter Finance in the admin panel explains every key. |
6. Verification
| Setting | Meaning (default) |
|---|---|
| A token is good for (days) | The seller must add the DNS record in this time. (14) |
| Check again every (days) | How often verified listings are re-checked. (30) |
| Failed checks before verification is lost | How many missed re-checks in a row remove the verified status. (2) |
| Re-checks per daily run | At most this many listings are re-checked per day. (200) |
| TXT record host prefix | The TXT record is added at <prefix>.<domain>. (_aiodomain-verify) |
| CNAME target | The host name a CNAME record points at. Fill it in before offering the CNAME method; see Verification. (empty) |
| Refresh registry data every (days) | How often registrar, expiry and name servers are read again from RDAP or WHOIS. (14) |
| Refreshes per daily run | Cap per day. (100) |
| RDAP service address | The RDAP service; the domain name is added at the end. (https://rdap.org/domain/) |
7. Search
| Setting | Meaning (default) |
|---|---|
| Results per page | 12, 24, 48 or 96. (24) |
| Default order | Best match, Newest, Price low to high, Price high to low, Most popular, Most viewed, Ending soon, Shortest first, A to Z, or Oldest domains first. (Most popular) |
| Saved searches per member | 0 to 500. (20) |
| Suggestions while typing | Domain suggestions under the search box. (On) |
8. Messages
| Setting | Meaning (default) |
|---|---|
| Only verified members may send inquiries | Needs a confirmed e-mail. (On) |
| Inquiries per member per day | (20) |
| Shortest inquiry (characters) | (20) |
| Messages per minute | More than this from one member is refused. (10) |
| Block at spam score | Messages scoring this or more are refused. Lower is stricter. (50) |
| Spam words | One word or phrase per line; each hit adds 25 to the score. |
| Contact form messages per hour per visitor | (5) |
| Tickets per member per day | (10) |
| Close answered tickets after (days) | Answered tickets that nobody replied to are closed after this many days. (7) |
9. E-mail
| Setting | Meaning (default) |
|---|---|
| Send e-mail | Off: nothing is sent and every mail is logged as not sent. (On) |
| Send with | PHP mail() or SMTP server. (PHP mail()) |
| From name, From address | Use an address on your own domain. Empty address: noreply@your-domain. |
| Copy every mail to | Optional list of addresses separated by commas (a BCC). |
| Set the envelope sender (-f) | PHP mail() only. Some hosts need it, some refuse it. (Off) |
| Host, Port, Encryption, User name, Password | The SMTP server. Port 587 with TLS, 465 with SSL, 25 without. The password is stored encrypted and never shown again. Choosing SMTP without a host is refused. |
| Check the server certificate | Switch on when the server has a valid certificate. (Off) |
| Signature | Replaces {$signature} in templates. HTML allowed. |
| Header HTML, Footer HTML | Replace the standard header (the logo) and footer (company name and address) of every mail. {logo}, {company}, {url} and {year} work. |
| Confirm subscriptions by e-mail | Newsletter double opt-in. (On) |
Under the form, Send a test e-mail sends one message to an address you type, using the saved settings, and tells you the result. Save first, then test.
10. SEO
| Setting | Meaning (default) |
|---|---|
| Site title | Added to every page title. Empty: the site name. |
| Title separator | Between the page title and the site title. ( - ) |
| Home page title, Home page description | What search engines show for the home page. |
| Default description, Default share image | Used by pages with none of their own. The image is a full address, or upload one with Or upload the share image. |
| Robots meta | (index, follow, max-image-preview:large) |
| Hide the whole site from search engines | Adds noindex everywhere and blocks robots.txt. Use while building. (Off) |
| robots.txt | Empty: the standard file. Anything typed here replaces it completely. |
| Google verification code, Bing verification code | The content value of the verification meta tag. |
| Google Analytics ID, Tag Manager ID, Facebook Pixel ID | Tracking. Empty means off. |
| Code for the head, Code for the foot | Extra HTML before </head> and </body> on every site page. |
Below the form, the Sitemap card shows the address of sitemap.xml, when it was built and how many addresses it holds, with Rebuild the sitemap now. The cron job rebuilds it every night. robots.txt has its own link.
11. Security
| Setting | Meaning (default) |
|---|---|
| Failed sign-ins before a ban | Failures from one address in an hour before it is banned. (5) |
| Ban lasts (minutes) | (15) |
| Sign-in attempts per minute per address | A hard cap. (20) |
| Never ban these addresses | IP addresses or ranges (203.0.113.0/24) separated by commas. Also edited on the Banned IPs page. |
| Behind a proxy or Cloudflare | Read the visitor address from the proxy header. Switch on only when you really are behind one, or visitors could fake their address. (Off) |
| Force HTTPS (HSTS) | Tells browsers to use https only. Switch on once HTTPS works everywhere. (Off) |
| Show error details to staff | Shows the error text on a failed page. Keep it off in production. (Off) |
| Largest upload (MB) | The site-wide cap, 1 to 100. Each kind of file also has its own smaller cap: avatars and logos 2 MB, listing pictures 3, blog images 6, identity documents and media 8, ticket attachments 10, CSV imports 20. (8) |
| Public API without a key | Search and listing routes work without a key at the lower limit. (On) |
| Calls per minute with a key, without a key | (120 and 30 per address) |
| Keys per member | (5) |
12. System
| Setting | Meaning (default) |
|---|---|
| Maintenance mode | Visitors see the notice; staff keep working. Everyone gets a 503 answer with Retry-After so search engines come back later. (Off) |
| Maintenance notice | The text visitors read. |
| Daily jobs run after (hour, 0-23) | In the site time zone. (3) |
| Queue jobs per run | How many background jobs one cron run works through. (60) |
| Exchange rate service | The address that gives rates; {base} becomes the default currency code. (https://open.er-api.com/v6/latest/{base}) |
| Hide .00 | Show $1,250 instead of $1,250.00. (Off) |
| Licence server, Update check address, Server IP address | See The licence key. |
13. Settings → Currencies & Rates
Described in Your first day. In short: prices are stored in the default currency and shown in the one the visitor picks; every other rate is how many units of it equal one default unit. Rates update by themselves each night for currencies marked Update the rate by itself; Update rates now does it at once. Each manual change and each update is kept in the Rate history (the last 30 entries per currency, with the change in percent).
14. Settings → E-mail Templates
Every mail the script sends, grouped as Mails to members, Mails to staff and Marketing, each with an on/off switch. A switched-off template sends nothing. Open one to edit Name, Subject, Text (HTML) and On, press Preview (shown inside the branded frame with sample values), Send a test to me, Save, or Reset to the shipped text. You can add your own template (Code, Name, Kind); custom templates are used by plugins or code that call them by code, and can be deleted. The shipped ones cannot be deleted.
Merge fields are written {$name}. Click a field name to put it into the text. Conditions: {if $reason}...{else}...{/if}. These fields work in every mail to a member: {$name}, {$first_name}, {$last_name}, {$username}, {$email}, {$user_id}, {$site_name}, {$site_url}, {$dashboard_url}, {$login_url}, {$support_url}, {$contact_email}, {$signature}, {$date}, {$time} and {$year}.
The 26 shipped templates:
| Code | Sent when | Extra fields |
|---|---|---|
welcome | An account is ready. | |
email_verification | Sign-up, or a resend. Link good for 48 hours. | {$verify_link} |
password_reset | A reset is asked. Link good for 1 hour. | {$reset_link} |
password_changed | A password changed. | {$ip} |
email_change | A new e-mail address must be confirmed. | {$new_email}, {$confirm_link} |
twofa_enabled, twofa_disabled | Two-factor switched on or off. | |
account_suspended | A member is suspended. | {$reason}, {$until} |
account_closed | An account was closed. | |
delete_request | A member asks to close the account. | {$confirm_link} |
kyc_approved, kyc_rejected | An identity review ended. | {$reason} |
listing_approved | A listing went live. | {$domain}, {$link} |
listing_rejected | A listing was refused. | {$domain}, {$reason} |
listing_expiring | A listing ends soon. | {$domain}, {$expires} |
domain_verified | Ownership confirmed. | {$domain} |
domain_unverified | A verification record is gone. | {$domain}, {$reason} |
new_message | A message in a conversation. | {$sender_name}, {$domain}, {$message}, {$link} |
notification | A general notification by mail. | {$title}, {$body}, {$link} |
search_alert | New listings match a saved search. | {$search_name}, {$domains_html}, {$link} |
newsletter_confirm | A newsletter subscription must be confirmed. | {$confirm_link} |
ticket_opened, ticket_reply | A ticket was opened or answered. | {$ticket_id}, {$subject}, {$message}, {$link} |
staff_new_user (staff) | A member registered. | {$member_name}, {$member_email}, {$member_country}, {$member_type} |
staff_listing_pending (staff) | A listing waits for approval. | {$domain}, {$seller_name}, {$link} |
newsletter_issue (marketing) | Reserved for newsletter issues. | {$subject}, {$body} |
Marketing mails go only to members who agreed to marketing.
15. Settings → Languages & Translations
The pages are written in English and other languages are swapped in on the way out. English and Bengali ship.
| Part | What it does |
|---|---|
| Languages table | Each language with shipped phrases and your phrases. Words opens its dictionary, Export downloads it, Remove deletes a language you added. |
| Default language | The language new visitors see. |
| Collect missing words | Switch on, browse the site in another language, and the phrases without a translation are listed so you can translate them in one go. |
| Add a language | Code (two or three letters, like fr) and Name (as its speakers write it). |
| Words of <language> | Add a phrase: English phrase exactly as the page shows it, and the Translation. A shipped phrase can be overridden; your phrases win. Delete yours to bring back the shipped translation. |
| Export and import | Download all phrases or only yours as JSON; import a JSON file of "English phrase": "translation" pairs. Phrases are merged; nothing is deleted. |
Visitors switch language and currency in the site header. The admin language is picked in your name menu.
16. Settings → Plugins
A plugin adds pages, menu entries and features without changing the core. This release ships no plugins, but the page is ready.
- Upload a plugin: a ZIP with
plugin.phpat the top or inside one folder (needs thezipextension). Then press Switch on. - Each plugin shows as a card: name, version, category, free or premium, whether it is built in, a note about the licence, and buttons Settings (when on), Switch off, Switch on, Uninstall (not for built-in ones; removes its files and settings).
- A premium plugin without its addon shows Needs the licence and does not run.
- Plugin problems shows the last lines of
data/logs/plugins.log.
A plugin never calls another plugin's functions. It uses hooks, so one plugin switched off cannot break another.
17. Settings → Themes
Two lists of cards: Site themes (Horizon) and Admin themes (Slate). Use this theme switches the active one. Options opens the theme's own settings (colours, fonts, switches); Save options keeps them and Back to defaults resets. Upload a theme takes a ZIP with theme.json, templates/layout.php, templates/login.php and assets/. A premium theme without its addon cannot be chosen.
18. Settings → System & Maintenance
The place for the machine room. Four tiles on top: the cron state (Running, Late, Stopped or Never ran), jobs waiting, jobs failed, and the database size. It needs the System, licence, API keys right; some buttons need more.
| Card | Contents |
|---|---|
| Cron | The command line to copy, the web address, Make a new key (the old web address stops working), Run now (choose Every job or one, tick Even if not due) and the last runs. Run now needs PHP to be allowed to start programs; if not, the page gives you the web address to open instead. The state is Running when the last beat is under 15 minutes old, Late under 2 hours, Stopped after that. |
| Job queue | Waiting, done in 24 hours, failed. Work the queue now runs up to 100 jobs; Retry the failed and Delete the failed; the latest failed jobs with their errors. |
| Cache | The driver (file unless you set Redis), number and size of cached files, Clear the cache. Safe at any time. |
| Database | Schema version against the version this code needs (Up to date or Update needed), the time of the last update, number of tables and rows, the database server version, and Run the database update. Needs Run database updates. |
| Backups | Make a backup now: a compressed SQL file of every table in data/backups (aiodomain-YYYYMMDD-HHMMSS.sql.gz). Per file: Download and Delete. Uploads are not in it. Needs Backups. |
| Server | PHP version, web server, system, memory limit, upload limit, time limit, time zone and clock, free disk space, writable folders, whether PHP may run programs, and green or red marks for each extension. |
| Log | Pick errors.log, cron.log, mail.log, plugins.log, app.log and others; shows the last 50 lines; Clear this log. |
errors.log should be empty. A line there means a page failed; the page shown to the visitor says only that the error was logged. See Troubleshooting.
19. Settings → API Keys
Members make their own keys under API Keys in their account. This page lists them all: name, prefix (ad_ plus the first letters), owner, scopes, limit per minute (the default is shown when the key has none), last used, expiry and status. Filters: text (name, prefix, member) and status (Any, Active, Revoked). Revoke stops a key at once, Activate brings it back, Delete removes it. Four tiles show active keys, calls and errors in 24 hours, and the average answer time; two tables show the busiest routes and the newest errors. The limits themselves are on the Security tab. See The REST API.
20. Settings → What's New
Shows the version you run, the newest version the product site knows, the licence state, the License Center's message and the change log, release by release. Check for updates asks again. The footer of every admin page links here.
21. Settings without a form
A few values are kept in the database and have no field yet. You normally never touch them.
| Key | Meaning |
|---|---|
cron_key | The web cron key. Make a new one on the System page. |
license_check_interval | Seconds between background licence checks (43200). |
install_done, schema_version, db_updated_at | Install and update bookkeeping. |