Advanced Topics & Migration

include/CalendarSync/migrations/.google_sync_migrated_checked

<?php
// Add to config_override.php

$sugar_config['calendar_sync'] = [
    // ===================================
    // Sync Window
    // ===================================

    // Number of days in the past to include in synchronization
    'sync_window_past_days' => 30,

    // Number of days in the future to include in synchronization
    'sync_window_future_days' => 90,

    // ===================================
    // Conflict Resolution
    // ===================================

    // Strategy for resolving conflicts when the same event is modified in both systems
    // Valid values: 'timestamp', 'external_based', 'internal_based'
    'conflict_resolution' => 'timestamp',

    // ===================================
    // Deletion Behavior
    // ===================================

    // Allow deletions in external calendar to delete meetings in SuiteCRM
    'allow_internal_event_deletion' => true,

    // Allow deletions in SuiteCRM to delete events in external calendar
    'allow_external_event_deletion' => true,

    // ===================================
    // Real-time Sync
    // ===================================

    // Enable logic hooks to trigger immediate sync when meetings are saved/deleted
    'enable_calendar_sync_logic_hooks' => false,

    // ===================================
    // External Calendar Settings
    // ===================================

    // Name displayed in external calendar for SuiteCRM events
    'external_calendar_name' => 'SuiteCRM',
];

// Sync only today and future (minimal resource usage)
$sugar_config['calendar_sync']['sync_window_past_days'] = 0;

// Or sync 90 days of history for reporting
$sugar_config['calendar_sync']['sync_window_past_days'] = 90;

// Sync 1 year ahead for long-term planning
$sugar_config['calendar_sync']['sync_window_future_days'] = 365;

// External calendar is primary (mobile users)
$sugar_config['calendar_sync']['conflict_resolution'] = 'external_based';

// Or SuiteCRM is authoritative source
$sugar_config['calendar_sync']['conflict_resolution'] = 'internal_based';

// Preserve SuiteCRM meetings when external calendar events are deleted
$sugar_config['calendar_sync']['allow_internal_event_deletion'] = false;

// Preserve external calendar events when SuiteCRM meetings are deleted
$sugar_config['calendar_sync']['allow_external_event_deletion'] = false;

// Enable real-time sync for immediate updates
$sugar_config['calendar_sync']['enable_calendar_sync_logic_hooks'] = true;

// Brand with company name
$sugar_config['calendar_sync']['external_calendar_name'] = 'Acme Corp CRM';

// Or use descriptive identifier
$sugar_config['calendar_sync']['external_calendar_name'] = 'Business Calendar';

<?php
// CRM-Authoritative Setup
// Best for: Sales teams, CRM-first workflows, controlled planning

$sugar_config['calendar_sync'] = [
    // SuiteCRM changes always win conflicts
    'conflict_resolution' => 'internal_based',

    // Preserve SuiteCRM meetings when external events are deleted
    'allow_internal_event_deletion' => false,

    // Enable logic hooks for immediate sync to external calendar
    'enable_calendar_sync_logic_hooks' => true,

    // Standard sync window
    'sync_window_past_days' => 30,
    'sync_window_future_days' => 90,
];

<?php
// External Calendar Primary Setup
// Best for: Mobile-first users, field teams, external calendar as source

$sugar_config['calendar_sync'] = [
    // External calendar changes always win conflicts
    'conflict_resolution' => 'external_based',

    // Preserve external events when SuiteCRM meetings are deleted
    'allow_external_event_deletion' => false,

    // Disable logic hooks (batch sync only)
    'enable_calendar_sync_logic_hooks' => false,

    // Longer sync window for comprehensive history
    'sync_window_past_days' => 60,
    'sync_window_future_days' => 180,
];

<?php
// Minimal Resource Usage Setup
// Best for: Small installations, limited server resources, low meeting volume

$sugar_config['calendar_sync'] = [
    // Minimal sync window to reduce event count
    'sync_window_past_days' => 0,        // Only today and future
    'sync_window_future_days' => 30,     // Only 1 month ahead

    // Disable logic hooks to avoid overhead
    'enable_calendar_sync_logic_hooks' => false,

    // Standard conflict resolution
    'conflict_resolution' => 'timestamp',
];

$sugar_config['calendar_sync']['enable_calendar_sync_logic_hooks'] = false;

$sugar_config['calendar_sync']['enable_calendar_sync_logic_hooks'] = true;