Ctrl K
ring2all.com

System General Settings Module Documentation

Table of Contents

  1. Module Overview (Technical)
  2. Module Overview (Commercial/Business)
  3. Module Overview (End User/Administrator)
  4. Configuration Sections
  5. Settings Reference
  6. Common Scenarios & Examples
  7. Limitations & Important Notes
  8. Troubleshooting Tips
  9. Glossary

---

1. Module Overview (Technical)

What Is System General Settings?

System General Settings is a domain-wide configuration module that defines default values for new extensions. When creating a new extension, these settings are applied automatically, ensuring consistent configuration across the tenant.

Architecture

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│             System General Settings Architecture               │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Admin Panel                                                    │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        System General Settings                           │   │
│  │                                                          │   │
│  │  Tabs:                                                   │   │
│  │  ├─ General (Language, Timezone, SIP)                   │   │
│  │  ├─ Voicemail & Recording                               │   │
│  │  └─ Codecs & Media                                      │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Stored per domain                                      │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        public.domain_settings                            │   │
│  │                                                          │   │
│  │  domain_id | setting_key | setting_value                │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Applied to new extensions                              │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        Extension Creation                                │   │
│  │                                                          │   │
│  │  New Extension 1010:                                    │   │
│  │  ├─ Language = Default Language (es_MX)                 │   │
│  │  ├─ Timezone = Default Timezone (America/Chicago)       │   │
│  │  ├─ Voicemail = Enabled (from defaults)                 │   │
│  │  ├─ Recording = Incoming (from defaults)                │   │
│  │  └─ (other defaults applied)                            │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Key Tables

TablePurpose
public.domain_settingsDomain-wide default values

Key Files

FileDescription
modules/systemGeneral/Frontend module
---

2. Module Overview (Commercial/Business)

Business Value

System General Settings provides consistent defaults:

Without System DefaultsWith System Defaults
Configure each extensionSet once, apply always
Inconsistent settingsStandardized config
Time-consuming setupQuick extension creation
Forgotten settingsNothing overlooked

Use Cases

  1. Standardized Extensions

- All new extensions use same defaults

- Consistent user experience

  1. Regional Compliance

- Set default language/timezone

- Recording policies

  1. Security Policies

- Password length requirements

- Call restrictions

  1. Voicemail Defaults

- Email notifications

- Transcription settings

Feature Highlights

FeatureBenefit
LocalizationLanguage/timezone defaults
SIP SettingsMax registrations, DTMF
VoicemailEnable/transcribe/email
RecordingIn/Out/Internal defaults
Call BehaviorRing timeout, call waiting
MediaHold music, ringtone
---

3. Module Overview (End User/Administrator)

What Can You Do?

  • Set default language for new extensions
  • Configure default timezone
  • Set codec preferences
  • Configure voicemail defaults
  • Set recording policies
  • Configure call behavior
  • Set media preferences

System General Settings Interface

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              System General Settings                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Default configurations for extension creation                  │
│                                                                 │
│  [General] [Voicemail & Recording] [Codecs & Media]            │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ▼ Language & Localization                                      │
│  ├─ Default Language: [Spanish (Mexico) ▼]                     │
│  ├─ Default Voice: [Polly - Mia ▼]                             │
│  └─ Default Timezone: [America/Chicago ▼]                      │
│                                                                 │
│  ▼ SIP Device Settings                                          │
│  ├─ Max Registrations: [3                 ]                    │
│  ├─ DTMF Mode: [RFC 2833 ▼]                                    │
│  └─ Auto-Password Length: [20 ▼]                               │
│                                                                 │
│  ▼ Call Behavior                                                │
│  ├─ Ring Timeout (seconds): [30           ]                    │
│  ├─ Call Waiting: ✓                                            │
│  ├─ Caller ID Privacy: [Screen ▼]                              │
│  ├─ Max Concurrent Calls: [5              ]                    │
│  ├─ Reject Anonymous: ☐                                        │
│  └─ PINless Dialing: ☐                                         │
│                                                                 │
│  [Save Changes] [Reset to Default]                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Voicemail & Recording Tab

Plaintext
┌─────────────────────────────────────────────────────────────────┐
│              System General Settings                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [General] [Voicemail & Recording] [Codecs & Media]            │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ▼ Voicemail Settings                                           │
│  ├─ Voicemail Enabled: ✓                                       │
│  ├─ Max Messages: [50                     ]                    │
│  ├─ Email Notifications: ✓                                     │
│  ├─ Transcription: ☐                                           │
│  └─ Email Attachment: ✓                                        │
│                                                                 │
│  ▼ Call Recording Settings                                      │
│  ├─ Record Incoming: ✓                                         │
│  ├─ Record Outgoing: ☐                                         │
│  ├─ Record Internal: ☐                                         │
│  ├─ Record On Demand: ✓                                        │
│  └─ Recording Format: [MP3 ▼]                                  │
│                                                                 │
│  [Save Changes] [Reset to Default]                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quick Tips

TIP
Domain Selection: Select a domain from the header first.
TIP
Reset to Default: Click reset icon next to any field.
NOTE
New Extensions Only: Changes apply to new extensions, not existing ones.

---

4. Configuration Sections

General Tab

SectionSettings
Language & LocalizationDefault Language, Voice, Timezone
SIP Device SettingsMax Registrations, DTMF, Password Length
Call BehaviorRing Timeout, Call Waiting, Privacy, etc.

Voicemail & Recording Tab

SectionSettings
Voicemail SettingsEnabled, Max Messages, Email, Transcription
Recording SettingsIn/Out/Internal, On Demand, Format

Codecs & Media Tab

SectionSettings
CodecsInbound/Outbound Preferences
MediaHold Music, Ringtone
---

5. Settings Reference

Language & Localization

SettingDescription
Default LanguageLanguage for prompts
Default VoiceTTS voice (e.g., Polly)
Default TimezoneFor voicemail timestamps

SIP Device Settings

SettingDescription
Max RegistrationsMax devices per extension
DTMF ModeRFC4733, RFC2833, INFO, Inband
Auto-Password LengthGenerated password length

Call Behavior

SettingDescription
Ring TimeoutSeconds before timeout
Call WaitingAllow call waiting
Caller ID PrivacyScreen, Name, Number, Full
Max Concurrent CallsPer extension (0 = unlimited)
Reject AnonymousBlock no-CID calls
PINless DialingAllow without PIN

Voicemail Settings

SettingDescription
Voicemail EnabledEnable by default
Max MessagesMessage limit
Email NotificationsSend email alerts
TranscriptionSpeech-to-text
Email AttachmentAttach audio file

Recording Settings

SettingDescription
Record IncomingRecord inbound calls
Record OutgoingRecord outbound calls
Record InternalRecord ext-to-ext
Record On DemandEnable to record
Recording FormatWAV, MP3, GSM

Codecs & Media

SettingDescription
Inbound Codec PrefsIncoming codec order
Outbound Codec PrefsOutgoing codec order
Hold MusicMOH source
RingtoneDefault ringtone
---

6. Common Scenarios & Examples

Scenario 1: Set Regional Defaults

  1. Open System General Settings
  2. Set Default Language = Spanish
  3. Set Default Timezone = America/Mexico_City
  4. Save changes

Scenario 2: Enable Recording Policy

  1. Go to Voicemail & Recording tab
  2. Enable Record Incoming = Yes
  3. Set Recording Format = MP3
  4. Enable Record On Demand = Yes
  5. Save changes

Scenario 3: Security Hardening

  1. Set Auto-Password Length = 25
  2. Set Max Registrations = 2
  3. Enable Reject Anonymous = Yes
  4. Disable PINless Dialing
  5. Save changes

Scenario 4: Voicemail Defaults

  1. Go to Voicemail & Recording tab
  2. Enable Voicemail Enabled = Yes
  3. Set Max Messages = 50
  4. Enable Email Notifications
  5. Enable Email Attachment
  6. Save changes

---

7. Limitations & Important Notes

Technical Notes

NOTE
Domain-Scoped: Settings apply per domain/tenant.
NOTE
New Extensions Only: Existing extensions keep their settings.
WARNING
No Bulk Update: Changing defaults doesn't update existing extensions.

Best Practices

  1. Set Before Creating: Configure before creating extensions
  2. Document Policies: Note company recording policies
  3. Consistent Language: Match user language preferences
  4. Timezone Accuracy: Set correct timezone for voicemail
  5. Security First: Use strong password lengths

Privacy Options

OptionHidden From
ScreenName + Number on call
NameName hidden
NumberNumber hidden
FullAll hidden
---

8. Troubleshooting Tips

Common Issues

SymptomPossible CauseSolution
Defaults not appliedWrong domainCheck domain selection
Existing ext unchangedBy designUpdate extensions manually
Wrong languageNot savedSave changes
Recording not workingRecording disabledCheck recording settings
Voicemail offDisabled in defaultsEnable voicemail

Check Domain Settings

Sql
SELECT 
  setting_key,
  setting_value
FROM public.domain_settings
WHERE domain_id = [domain_id]
ORDER BY setting_key;

---

9. Glossary

TermDefinition
Domain DefaultsSettings applied to new extensions
LocalizationLanguage and timezone settings
Max RegistrationsDevice limit per extension
TranscriptionVoicemail speech-to-text
Recording FormatAudio file format (MP3/WAV)
PrivacyCaller ID visibility settings
---

Lua Script Status ℹ️

No Lua Handler Required

ComponentStatus
System General Settingsℹ️ Configuration module - defaults applied during extension creation
System General Settings is a configuration module. Settings are stored per domain and applied when new extensions are created. No Lua handlers are used.

---

Documentation last updated: January 2026*

AI Assistant

👋 Hello! I'm your Ring2All documentation assistant. I can help you find information about configuring and using the Ring2All PBX platform.

How can I help you today?