Settings

This page documents the current settings areas in ProMediClinic and the exact routes used to manage them.

Access

• Global settings: /dashboard/settings/global
• SMTP settings: /dashboard/settings/smtp
• Pusher settings: /dashboard/settings/pusher
• Stripe settings (admin): /dashboard/settings/stripe

1) Global Settings

Route:

• GET /dashboard/settings/global
• POST /dashboard/settings/global

Main configurable fields:

• app name
• clinic type (general, dentist, therapist)
• default language
• Google reCAPTCHA site key
• booking policy / terms text
• custom CSS
• logo, white logo, favicon
• JSON-based option toggles:
  • enable options
  • email notifications

Important behavior:

• If chat is enabled in options but pusher credentials are missing, save is blocked in UI.
• In demo mode, updates are blocked.
• Uploaded logo files are written to image/public paths used by the app.

2) SMTP Settings

Route:

• GET /dashboard/settings/smtp
• PUT /dashboard/settings/smtp/update

Fields:

• MAIL_HOST
• MAIL_PORT
• MAIL_USERNAME
• MAIL_PASSWORD
• MAIL_ENCRYPTION
• MAIL_FROM_ADDRESS
• MAIL_FROM_NAME

After save, config cache is refreshed from the UI flow.

3) Pusher Settings

Route:

• GET /dashboard/settings/pusher
• PUT /dashboard/settings/pusher/update

Fields:

• PUSHER_APP_ID
• PUSHER_APP_KEY
• PUSHER_APP_SECRET
• PUSHER_APP_CLUSTER

Use this for realtime modules such as chat and live updates.

4) Stripe Settings

Route:

• GET /dashboard/settings/stripe
• PUT /dashboard/settings/stripe/update

Fields:

• STRIPE_KEY
• STRIPE_SECRET
• STRIPE_WEBHOOK_SECRET

Access control:

• only admin role can open/update Stripe settings.
• demo mode prevents updates.

After update, app clears configuration cache.

5) Cache and Maintenance Utility

Route:

• GET /clear/{slug} where slug is config, optimize, cache, route, view, or all.

Use with caution in production and prefer planned maintenance windows.

Validation Notes

• SMTP and pusher forms require all key fields.
• Stripe key/secret are required; webhook secret can be nullable.
• reCAPTCHA site key is optional.

Common Issues

• Settings appear unchanged: clear config cache and hard-refresh browser.
• Chat not working after enabling: verify full pusher credentials and cluster.
• Emails not sent: validate SMTP auth/encryption values and sender address.
• Stripe checkout/webhooks failing: verify live/test key consistency and webhook secret.

Related

• features/invoicing-payments.md
• advanced/license.md
• reference/troubleshooting.md
• reference/route-map.md