Admin Settings

The Admin → Settings panel controls how Folio looks and behaves. Changes here are saved to the database and take effect on reload.

---

Settings tabs

The tabs available depend on your active usage profile. The table below shows which tabs appear in each profile.

Tab	Single User	Library	Public Showcase
General	✅	✅	✅
Pages	✅	✅	✅
Hero	✅	✅	✅
Stats	❌	✅	✅
About	❌	✅	✅
Footer	❌	✅	✅
Contact	❌	✅	✅
Users	❌	✅	✅
Reviews	❌	✅	✅
Loans	❌	✅	❌
Requests	❌	✅	❌

---

General tab

• Site name — shown in the browser tab and footer.
• Site language — affects date/text formatting.
• Registration — toggle whether new users can sign up.
• Email verification — require new users to verify their email before logging in.

---

Profile Presets tab

Switch between Single User, Library, and Public Showcase profiles. See Usage Profiles for full details.

---

Pages tab

Enable or disable public-facing pages:

• About page
• Contact page

When disabled, those pages return a 404 and are removed from navigation.

---

Hero tab

Customize the landing page hero section:

• Title — main heading on the home page
• Subtitle — tagline below the title
• Background image — upload or URL
• CTA button text/link — call-to-action button

---

Stats tab (Library + Showcase)

Display collection statistics on the landing page:

• Total books, authors, genres
• Toggle visibility of each stat

---

About tab (Library + Showcase)

Configure the About page content:

• Page title and body text
• Team/contact information

---

Footer tab (Library + Showcase)

Customize links and text in the site footer.

---

Contact tab (Library + Showcase)

Set up the Contact page with a form or plain contact details.

---

Loans tab (Library)

The Loans tab now includes borrowing policy, credit policy, and payment configuration placeholders.

Borrowing policy

• Enable Loan System — turns new borrowing on/off.
• Max Concurrent Loans per User — hard cap for active/pending loans.
• Default Loan Duration (Days) — due date baseline.

Credit policy

• Minimum Credit to Enable Borrowing — required account balance before users can borrow/request books.
• Credit Currency — global currency code used in balances and book price display (default USD).

Payment options

• Manual Cash Payment — enabled by default; admins can top-up users directly in Edit User.
• Online Payments (Future) — enables provider configuration only (no live checkout in this phase).

When online payments are enabled:

• Stripe
  • Toggle enable/disable
  • Publishable key (pk_test_... / pk_live_...)
  • Secret key (sk_test_... / sk_live_...)
  • Webhook signing secret (whsec_...)
  • Mode (sandbox or production)
• PayPal
  • Toggle enable/disable
  • Client ID
  • Client Secret
  • Mode (sandbox or production)

These values are stored as admin configuration and documented for future checkout integration.

---

Backup reminder

Settings are stored in the database. Regular database backups protect your configuration. See Troubleshooting for backup commands.

---

Back to Loans & Requests · Troubleshooting →