IntroVox - Releases

Changed

• Telemetry enabled by default - Anonymous usage statistics are now opt-out instead of opt-in
• Helps developers improve IntroVox with anonymous usage data
• Administrators can still disable telemetry in admin panel (Statistics tab)
• No personal data is ever collected - only aggregate statistics

Added

• Extended telemetry data - New privacy-friendly server environment fields
• serverRegion - Country code from admin-configured default_phone_region (ISO 3166-1)
• defaultLanguage - Server's default language setting
• defaultTimezone - Server's timezone (e.g., "Europe/Amsterdam")
• databaseType - Database type (mysql/pgsql/sqlite)
• totalGroups - Number of Nextcloud groups (count only, no names)
• groupVisibilityUsed - Whether group-based step visibility is used (boolean)
• All new fields are privacy-friendly: admin-configured values only, no personal data

Added

• Group-based step visibility - Control which user groups can see specific wizard steps
• New "Visible to groups" multi-select dropdown in step editor
• Select one or more Nextcloud groups per step
• Empty selection (default) means visible to all users
• Steps are filtered on the backend before being sent to users
• Users only see steps they have access to based on their group membership
• Perfect for role-based onboarding (e.g., different steps for admins vs regular users)
• Groups API endpoint - New /admin/groups endpoint to fetch available Nextcloud groups
• Automatic migration - Existing steps automatically get visibleToGroups: [] (visible to all)
• Admin statistics dashboard - New "Statistics" tab in admin interface
• Wizard usage metrics: users started, users completed, times skipped, completion rate
• Instance information: total users, active users (30d), total steps, enabled languages
• Real-time statistics loaded from server
• Anonymous telemetry system - Optional anonymous usage statistics
• Opt-in telemetry sharing with developers (disabled by default)
• Sends anonymous data to licenses.voxcloud.nl/api/telemetry/introvox
• Instance identified by SHA-256 hash (never sends actual URL)
• Collects: user counts, step counts, wizard usage, NC/PHP versions
• Does NOT collect: server URL, usernames, personal data, step content
• Manual "Send now" button for immediate sending
• Background job runs every 24 hours (with random jitter) when enabled
• Wizard tracking - Track wizard start, completion, and skip events per user
• New user preferences: wizard_started, wizard_completed timestamps
• Aggregated statistics visible in admin dashboard
• Privacy-friendly: only totals shown, no individual user tracking visible

Changed

• Admin interface restructured with tabs - Improved organization
• Tab 1: "Settings" - Global settings (wizard enabled, languages, show to all)
• Tab 2: "Steps" - Step editor (language selector, drag-drop steps, group visibility)
• Tab 3: "Statistics" - Usage metrics and telemetry settings
• Improved admin UI navigation - Clean tab-based interface with visual tab indicators

Technical

• Added IGroupManager and IUserSession dependencies to ApiController and AdminController
• Group filtering happens server-side in ApiController::getWizardSteps() for security
• Steps without visibleToGroups or with empty array are visible to everyone
• NcSelect component used for group selection with multi-select support
• Export/import functionality automatically includes group visibility settings
• New TelemetryService class for collecting and sending anonymous statistics
• New TelemetryJob background job (extends TimedJob) for scheduled telemetry
• New API endpoints:
• GET /admin/statistics - Fetch statistics for admin dashboard
• POST /admin/telemetry - Enable/disable telemetry
• POST /admin/telemetry/send - Manual telemetry send
• POST /api/wizard/start - Track wizard start event
• POST /api/wizard/complete - Track wizard completion event
• POST /api/wizard/skip - Track wizard skip event
• Background job registered in info.xml for automatic execution
• 35+ new translation keys added to all 6 language files (EN, NL, DE, DA, FR, SV)

Fixed

• Auto-scroll to new steps - When adding a new step in admin interface, the page now automatically scrolls to show the newly created step
• Backdrop filter blur removed - Fixed text readability issues on small UI elements (buttons) by removing the backdrop blur effect from the wizard overlay (PR #10)

Documentation

• Emoji reference link - Added link to Emojipedia in admin manual for users wanting to use emojis in step titles

Changed

• App icon - Updated to compass design with black color for better visibility in light theme
• Sidebar settings icons now use dark variant for proper contrast

Added

• Documentation link - Added link to Administrator Guide in app info.xml for easy access from App Store

Fixed

• Multi-language wizard support - Wizard now starts for users with any enabled language (not just English)
• Admin language selection - Admin panel now automatically selects first available language if English is disabled
• Step visibility bug - Fixed issue where enabled steps were incorrectly hidden after reordering
• Changed from index-based to ID-based checkbox binding using v-model
• Improved Sortable.js reactivity by creating new array instead of direct mutation
• CSS selector improvements - Updated default step selectors to match multiple UI element variations
• Search step: Added fallback selectors for unified search button
• Files/Calendar: Added data-id attribute selectors for better element detection
• Prevents steps from being skipped due to element not found errors

Improved

• Language detection - Backend now checks if user's language is enabled in admin settings
• Debug logging - Added console logging for step filtering to help troubleshoot visibility issues
• Admin panel initialization - Global settings now load before steps to ensure correct language selection

Changed

• App Store screenshot - Changed primary screenshot to welcome-step.png to better showcase the wizard experience
• Reordered screenshots: welcome-step.png (primary), admin-interface.png, personal-settings.png

Changed

• App Store metadata sync - Force refresh of App Store metadata to display correct author information