MetaVox - Releases

Fixed

• Sidebar header not translated — {itemType} Metadata used an untranslated English variable, resulting in "File-metadata" in Swedish. Replaced with separate File Metadata / Folder Metadata strings so all languages translate the full header. Reported by Magnus (@maghog) on #62. Same anti-pattern fixed in the "No metadata fields configured" empty-state.

Changed

• Dutch (nl) translation polish — 78 strings rewritten to use idiomatic Dutch compound forms (Bestandsmetadata, Mapmetadata, Metadatavelden instead of Bestand Metadata, Map Metadata, Metadata Velden) and sentence case for button labels (Veld toevoegen instead of Veld Toevoegen). Aligns with the Nextcloud Dutch style guide.

Added

• Swedish (sv) translation — complete translation of all 432 strings by Magnus (@maghog). (#62)

Fixed

• Telemetry error feedback: The "Send report now" button now shows the actual server error message (e.g., rate limit, connectivity issue) instead of silently failing
• View columns not enriched when created without field_id — enrichViewColumns() only resolved columns by field_id, so views created via the API with only field_name were missing field_type, field_label, and field_options. This caused column headers to be invisible until the view was re-saved in the UI. Now resolves columns by both field_id and field_name.
• Sharing files with metadata crashes — FieldService::getGroupfolderIdByFileId() was called by the Flow engine during share events but never implemented, causing an "undefined method" fatal error. Added the missing method. (#58)

Removed

• Dead code: unreachable saveFieldOverride() and getFieldOverrides() controller methods referencing the removed metavox_gf_overrides table.

Added

• Support tab in admin panel — subscription info, pricing table, benefits overview, and subscription key management. Friendly, non-aggressive tone: "no limits, no restrictions, no catch."
• Remove subscription key button — allows returning to free usage state after subscription expires.
• Localized pricing URL — NL users link to Dutch pricing page, others to English.
• 43 new translations for Support tab content (EN, NL, DE, FR — 429 strings total).

Changed

• Banner tone — all banners are now blue/info, no more red/orange. Subscription nudge triggers at >50 users or >20 team folders.
• Support tab replaces license section in Statistics tab. Statistics now only shows stats, AI toggle, and telemetry.
• Organization fields above subscription key — fill in org details before activating a key.
• Licensing docs rewritten with current pricing (€49/149/349) and friendly tone.

Fixed

• Dark mode icon invisible — inline SVGs (sidebar tab, filter bar, bulk edit) used hardcoded stroke="#000" which is invisible in dark mode. Changed to currentColor which inherits the theme text color automatically.
• NC32 filter button misaligned — MetaVox filter button was 3px lower than native buttons (Type, Modified, People). Matched padding and margin to NC's native button styling.
• Folder copy error — copying a folder with files showed "Move or copy: failed on some elements" despite successful copy. FileCopyListener::getAllNodesRecursively() declared $type as int but received FileInfo::TYPE_FOLDER ("dir") which is a string. Changed to string type. (#56)

Fixed

• NC31/NC32 sidebar tab not showing — MetaVox tab was missing from the sidebar on NC31 and NC32 (reported on NC32.0.6). The NC33 registration path was incorrectly triggered on older versions because window._nc_files_scope existed as an empty object. Now verifies that the NC33 filesSidebarTabs Map is already initialized by Nextcloud before using it, otherwise falls back to the legacy OCA.Files.Sidebar API.
• NC32 sidebar tab order — added order: 100 to legacy tab registration so MetaVox appears after Sharing and Versions.
• NC32 filter button alignment — added proper height and vertical-align to match native filter buttons.

Fixed

• Statistics showing 0 team folders — "Team Folders with Metadata" count was always 0 when only folder-level metadata was configured. The query only checked file-level metadata (metavox_file_gf_meta), missing folder-level entries (metavox_gf_metadata). Now both tables are counted in statistics, telemetry, and license checks. (#55)

Fixed

• NC32 migration crash — Migration 14 (metavox_gf_column_config) used boolean type with notnull which caused "Bool NotNull cannot store false" error on NC32. Changed to smallint type. (#55)

Added

• Inline grid editing with field-type-specific editors (text, number, date, checkbox, URL, filelink, user)
• Cell locking with real-time sync via notify_push + Redis (prevents concurrent edits)
• Presence tracking — push events only sent to users actively viewing a groupfolder
• Views system — predefined column/filter/sort/formatting combinations with tabs UI
• "Default" tab with 🏠 icon — shows standard Nextcloud file view without MetaVox filters, visually separated from custom views
• Client-side filter and sort — zero server calls, operates on metadata cache
• Undo support with toast notification and field revert
• Fill handle for quick cell value propagation
• Lock badge with username — portaled, always visible during editing
• Rich cell rendering for user, URL, and filelink field types
• Backup/restore with progress bar, gzip compression, and keyset pagination
• AI autofill capability for metadata fields
• Bulk metadata modal UI with search
• Flow integration (vanilla JS, Vue 2 compatible)
• Checkbox fields use Yes/No dropdown with fill handle support
• NC32 compatibility with feature detection and fallback UI
• Field name validation — only lowercase letters (a-z), numbers (0-9) and underscores allowed. Specific error messages on both frontend and backend.
• License warning banner — red/orange banner at top of admin panel for invalid licenses or exceeded free tier limits
• ApiFieldService facade — all external API metadata operations go through ApiFieldService, shielding FieldService from API concerns
• French translation — complete FR support. All 4 languages (EN, NL, DE, FR) in sync at 386 strings.
• New fox ears + document icon — filled triangles with document body, light/dark mode support via app.svg (#000) and app-dark.svg (#fff)
• Field naming convention documented in API reference with prefix rules and examples

Changed

• Complete JS modular refactor: monolithic MetaVoxColumns split into 14 focused modules
• Centralized state management via MetaVoxState.js
• PHP 8 attributes replace annotation docblocks
• BaseController and BaseOCSController extraction for shared logic
• Services split into dedicated responsibilities (Field, Filter, View, Cache, Presence, Lock, Push)
• Single init endpoint eliminates 4 sequential API calls
• Inline init data via IInitialState for instant pageload (~8ms vs ~1500ms)
• Replace error_log with LoggerInterface (fixes #49)
• Documentation completely restructured (admin, user, architecture, features)
• Updated app description and screenshots in info.xml

Fixed

• View switching crash — fetchServerSortedIds is not a function replaced with triggerResort()
• NC32 sorting — DOM-based row reorder fallback
• NC32 sidebar tab + filter registration crashes
• NC33 sidebar tab and bulk metadata action registration via scoped globals
• Breadcrumb dropdown no longer blocked by view tabs
• Cell lock released when user switches to another program
• Prevent notify_push crash on malformed WebSocket messages
• Prevent flex layout from inflating column widths
• Loading indicator timing and spinner hang prevention
• N+1 queries in permission and groupfolder lookups
• OCS /api/v1/files/{fileId}/metadata endpoint now auto-detects groupfolder correctly

Performance

• 10K+ user scalability — presence cooldown, push batching, LRU cache
• Direct push cache updates eliminate race conditions
• Metadata cache persists across submap navigation
• Instant metadata on pageload with early prefetch on navigation
• Bulk metadata loading with lazy filters and virtual scroll optimization
• Optimized restore with batch inserts + cross-platform support
• Optimized metadata loading for large datasets (43M+ rows)

Upgrade Notes

• Free tier introduced: MetaVox 2.0.0 includes a free tier (5 team folders, 500 metadata entries per folder). If your installation exceeds these limits, an informational banner will appear in the admin panel. All features continue to work — nothing is blocked or restricted. For unlimited usage, visit voxcloud.nl.
• Nextcloud 31+ required: Minimum version raised from NC28 to NC31.

Added

• Automatic daily metadata backup to JSON (background job)
• Admin panel: Backup & Restore tab with manual backup, download, and restore
• Streaming backup/restore for large datasets (millions of entries)
• Circles/Teams support: team folders assigned to circles are now correctly detected

Fixed

• Fixed search index not updating when saving metadata
• Search index now updates directly on save instead of via background job
• Admin panel now shows all team folders regardless of membership
• Added groupfolder access checks on all metadata endpoints

Fixed

• Fixed sidebar tab not appearing on NC32 due to registration timing
• Added missing telemetry/statistics routes

Fixed

• NC33 sidebar tab now registers correctly by writing to NC33's scoped globals (window._nc_files_scope.v4_0) instead of the bundled @nextcloud/files window global
• NC33 bulk metadata action now registers correctly using the same scoped globals approach
• Groupfolder path matching uses exact boundary checks to prevent substring false positives

Added

• NC33 + Vue 3 migration with backwards compatibility (NC31-33)
• CacheCleanupListener for real-time metadata cleanup on file removal

Changed

• Migrated frontend from Vue 2 to Vue 3 with @nextcloud/vue v9
• Dual sidebar registration strategy (NC33 getSidebar() API + legacy fallback)
• CleanupDeletedMetadata converted from QueuedJob to TimedJob

Fixed

• File copy listener now only copies metadata within the same team folder, preventing orphaned metadata when copying between different team folders

Fixed

• Sidebar header not translated — {itemType} Metadata used an untranslated English variable, resulting in "File-metadata" in Swedish. Replaced with separate File Metadata / Folder Metadata strings so all languages translate the full header. Reported by Magnus (@maghog) on #62. Same anti-pattern fixed in the "No metadata fields configured" empty-state.

Changed

• Dutch (nl) translation polish — 78 strings rewritten to use idiomatic Dutch compound forms (Bestandsmetadata, Mapmetadata, Metadatavelden instead of Bestand Metadata, Map Metadata, Metadata Velden) and sentence case for button labels (Veld toevoegen instead of Veld Toevoegen). Aligns with the Nextcloud Dutch style guide.

Added

• Swedish (sv) translation — complete translation of all 432 strings by Magnus (@maghog). (#62)

Fixed

• Telemetry error feedback: The "Send report now" button now shows the actual server error message (e.g., rate limit, connectivity issue) instead of silently failing
• View columns not enriched when created without field_id — enrichViewColumns() only resolved columns by field_id, so views created via the API with only field_name were missing field_type, field_label, and field_options. This caused column headers to be invisible until the view was re-saved in the UI. Now resolves columns by both field_id and field_name.
• Sharing files with metadata crashes — FieldService::getGroupfolderIdByFileId() was called by the Flow engine during share events but never implemented, causing an "undefined method" fatal error. Added the missing method. (#58)

Removed

• Dead code: unreachable saveFieldOverride() and getFieldOverrides() controller methods referencing the removed metavox_gf_overrides table.

Added

• Support tab in admin panel — subscription info, pricing table, benefits overview, and subscription key management. Friendly, non-aggressive tone: "no limits, no restrictions, no catch."
• Remove subscription key button — allows returning to free usage state after subscription expires.
• Localized pricing URL — NL users link to Dutch pricing page, others to English.
• 43 new translations for Support tab content (EN, NL, DE, FR — 429 strings total).

Changed

• Banner tone — all banners are now blue/info, no more red/orange. Subscription nudge triggers at >50 users or >20 team folders.
• Support tab replaces license section in Statistics tab. Statistics now only shows stats, AI toggle, and telemetry.
• Organization fields above subscription key — fill in org details before activating a key.
• Licensing docs rewritten with current pricing (€49/149/349) and friendly tone.

Fixed

• Dark mode icon invisible — inline SVGs (sidebar tab, filter bar, bulk edit) used hardcoded stroke="#000" which is invisible in dark mode. Changed to currentColor which inherits the theme text color automatically.
• NC32 filter button misaligned — MetaVox filter button was 3px lower than native buttons (Type, Modified, People). Matched padding and margin to NC's native button styling.
• Folder copy error — copying a folder with files showed "Move or copy: failed on some elements" despite successful copy. FileCopyListener::getAllNodesRecursively() declared $type as int but received FileInfo::TYPE_FOLDER ("dir") which is a string. Changed to string type. (#56)

Fixed

• NC31/NC32 sidebar tab not showing — MetaVox tab was missing from the sidebar on NC31 and NC32 (reported on NC32.0.6). The NC33 registration path was incorrectly triggered on older versions because window._nc_files_scope existed as an empty object. Now verifies that the NC33 filesSidebarTabs Map is already initialized by Nextcloud before using it, otherwise falls back to the legacy OCA.Files.Sidebar API.
• NC32 sidebar tab order — added order: 100 to legacy tab registration so MetaVox appears after Sharing and Versions.
• NC32 filter button alignment — added proper height and vertical-align to match native filter buttons.

Fixed

• Statistics showing 0 team folders — "Team Folders with Metadata" count was always 0 when only folder-level metadata was configured. The query only checked file-level metadata (metavox_file_gf_meta), missing folder-level entries (metavox_gf_metadata). Now both tables are counted in statistics, telemetry, and license checks. (#55)

Fixed

• NC32 migration crash — Migration 14 (metavox_gf_column_config) used boolean type with notnull which caused "Bool NotNull cannot store false" error on NC32. Changed to smallint type. (#55)

Added

• Inline grid editing with field-type-specific editors (text, number, date, checkbox, URL, filelink, user)
• Cell locking with real-time sync via notify_push + Redis (prevents concurrent edits)
• Presence tracking — push events only sent to users actively viewing a groupfolder
• Views system — predefined column/filter/sort/formatting combinations with tabs UI
• "Default" tab with 🏠 icon — shows standard Nextcloud file view without MetaVox filters, visually separated from custom views
• Client-side filter and sort — zero server calls, operates on metadata cache
• Undo support with toast notification and field revert
• Fill handle for quick cell value propagation
• Lock badge with username — portaled, always visible during editing
• Rich cell rendering for user, URL, and filelink field types
• Backup/restore with progress bar, gzip compression, and keyset pagination
• AI autofill capability for metadata fields
• Bulk metadata modal UI with search
• Flow integration (vanilla JS, Vue 2 compatible)
• Checkbox fields use Yes/No dropdown with fill handle support
• NC32 compatibility with feature detection and fallback UI
• Field name validation — only lowercase letters (a-z), numbers (0-9) and underscores allowed. Specific error messages on both frontend and backend.
• License warning banner — red/orange banner at top of admin panel for invalid licenses or exceeded free tier limits
• ApiFieldService facade — all external API metadata operations go through ApiFieldService, shielding FieldService from API concerns
• French translation — complete FR support. All 4 languages (EN, NL, DE, FR) in sync at 386 strings.
• New fox ears + document icon — filled triangles with document body, light/dark mode support via app.svg (#000) and app-dark.svg (#fff)
• Field naming convention documented in API reference with prefix rules and examples

Changed

• Complete JS modular refactor: monolithic MetaVoxColumns split into 14 focused modules
• Centralized state management via MetaVoxState.js
• PHP 8 attributes replace annotation docblocks
• BaseController and BaseOCSController extraction for shared logic
• Services split into dedicated responsibilities (Field, Filter, View, Cache, Presence, Lock, Push)
• Single init endpoint eliminates 4 sequential API calls
• Inline init data via IInitialState for instant pageload (~8ms vs ~1500ms)
• Replace error_log with LoggerInterface (fixes #49)
• Documentation completely restructured (admin, user, architecture, features)
• Updated app description and screenshots in info.xml

Fixed

• View switching crash — fetchServerSortedIds is not a function replaced with triggerResort()
• NC32 sorting — DOM-based row reorder fallback
• NC32 sidebar tab + filter registration crashes
• NC33 sidebar tab and bulk metadata action registration via scoped globals
• Breadcrumb dropdown no longer blocked by view tabs
• Cell lock released when user switches to another program
• Prevent notify_push crash on malformed WebSocket messages
• Prevent flex layout from inflating column widths
• Loading indicator timing and spinner hang prevention
• N+1 queries in permission and groupfolder lookups
• OCS /api/v1/files/{fileId}/metadata endpoint now auto-detects groupfolder correctly

Performance

• 10K+ user scalability — presence cooldown, push batching, LRU cache
• Direct push cache updates eliminate race conditions
• Metadata cache persists across submap navigation
• Instant metadata on pageload with early prefetch on navigation
• Bulk metadata loading with lazy filters and virtual scroll optimization
• Optimized restore with batch inserts + cross-platform support
• Optimized metadata loading for large datasets (43M+ rows)

Upgrade Notes

• Free tier introduced: MetaVox 2.0.0 includes a free tier (5 team folders, 500 metadata entries per folder). If your installation exceeds these limits, an informational banner will appear in the admin panel. All features continue to work — nothing is blocked or restricted. For unlimited usage, visit voxcloud.nl.
• Nextcloud 31+ required: Minimum version raised from NC28 to NC31.

Added

• Automatic daily metadata backup to JSON (background job)
• Admin panel: Backup & Restore tab with manual backup, download, and restore
• Streaming backup/restore for large datasets (millions of entries)
• Circles/Teams support: team folders assigned to circles are now correctly detected

Fixed

• Fixed search index not updating when saving metadata
• Search index now updates directly on save instead of via background job
• Admin panel now shows all team folders regardless of membership
• Added groupfolder access checks on all metadata endpoints

Fixed

• Fixed sidebar tab not appearing on NC32 due to registration timing
• Added missing telemetry/statistics routes

Fixed

• NC33 sidebar tab now registers correctly by writing to NC33's scoped globals (window._nc_files_scope.v4_0) instead of the bundled @nextcloud/files window global
• NC33 bulk metadata action now registers correctly using the same scoped globals approach
• Groupfolder path matching uses exact boundary checks to prevent substring false positives

Added

• NC33 + Vue 3 migration with backwards compatibility (NC31-33)
• CacheCleanupListener for real-time metadata cleanup on file removal

Changed

• Migrated frontend from Vue 2 to Vue 3 with @nextcloud/vue v9
• Dual sidebar registration strategy (NC33 getSidebar() API + legacy fallback)
• CleanupDeletedMetadata converted from QueuedJob to TimedJob

Fixed

• File copy listener now only copies metadata within the same team folder, preventing orphaned metadata when copying between different team folders

Fixed

• Fixed "The requested uri() cannot be processed by the script '/var/www/nextcloud/occ'" error when running occ commands — boot() now skips request-dependent logic in CLI mode

Fixed

• Fixed "The requested uri() cannot be processed by the script '/var/www/nextcloud/occ'" error when running occ commands — boot() now skips request-dependent logic in CLI mode

Changed

• Renamed Telemetry tab to Statistics: Admin settings tab renamed from "Telemetry" to "Statistics" for consistency with IntraVox and FormVox apps
• Updated "About" section to "The Future of MetaVox": New section explaining potential future licensing model for larger organizations
• Clear communication that MetaVox remains free for most users
• Promises: free tier for small/medium installations, all current features remain available, transparent pricing

Added

• Telemetry expansion: Added 7 new server configuration fields to anonymous usage statistics
• Country code, database type, default language, timezone, OS family, web server, Docker detection
• Send report now button: Manual telemetry report trigger in admin Statistics tab
• New Statistics API endpoint (/api/telemetry/stats) for admin panel statistics display
• Metadata statistics overview showing field counts, team folders with metadata, and total entries
• Complete French (fr) translations: Full translation of all 252 strings
• Complete German (de) translations: Full translation of all 252 strings
• Complete Dutch (nl) translations: Full translation of all 252 strings

Fixed

• Telemetry countryCode and timezone: Country code now derived from default_phone_region instead of default_language (which produced invalid codes like EN). Timezone uses smarter fallback: Nextcloud config → php.ini → UTC

Fixed

• Fixed Files app detection not working behind reverse proxy with subpath (e.g., /nextcloud/apps/files)
• Now uses both getRequestUri() and getPathInfo() for reliable detection
• Thanks to @user for debugging and reporting this issue

Added

• Telemetry Service: Optional anonymous usage statistics to help improve MetaVox
• Collects anonymous metrics: field counts, metadata entries, groupfolder usage, user counts
• Instance identification via hashed URL (fully anonymous)
• Opt-out via admin settings (enabled by default)
• Background job runs daily to send reports
• Admin panel shows telemetry status and last report time
• Field-type specific operators in Flow: Operators now dynamically change based on selected metadata field type
• Text/Textarea: equals, contains, does not contain, is not empty, is empty
• Date: equals, is before, is after, is not empty, is empty
• Number: equals, greater than, less than, greater or equal, less or equal, is not empty, is empty
• Select/Dropdown: equals, is one of, is not empty, is empty
• Multiselect: contains, contains all, is not empty, is empty
• Checkbox: equals (with Yes/No dropdown), is not empty, is empty
• Nextcloud 33 compatibility: Updated FileAction API to support both @nextcloud/files v3.x (NC 28-32) and v4.x (NC 33+)
• Backwards compatible detection of API version
• Supports new destructured context object { nodes, view, folder, contents }

Changed

• Flow operator selector moved inside MetaVox component for better field-type awareness
• Checkbox fields now show "Yes (checked)" / "No (unchecked)" dropdown with proper 1/0 values
• Improved styling of Flow configuration panel to match Nextcloud design guidelines

Fixed

• Fixed Flow check configuration not loading on page refresh (timing issue with fields API)
• Fixed value input not refreshing when switching between different field types
• Fixed input alignment issues in Flow configuration panel
• Fixed bulk metadata editor opening when selecting a single file (now only shows for 2+ files)

Fixed

• Fixed Flow check configuration not persisting after page refresh
• Fixed newly added metadata fields not appearing in Flow dropdown until page reload

Added

• Nextcloud Flow Integration: MetaVox metadata can now be used as conditions in Nextcloud Flow rules
• New "MetaVox metadata" check available in Flow/Workflow Engine
• Supports operators: is, is not, contains, does not contain, matches regex, does not match regex
• Dynamic value input based on field type (dropdown for select fields, checkbox toggle for booleans, date picker, number input, text)
• Fields grouped into "File fields" and "Team folder fields" in the UI
• Auto-detect groupfolder from file context (no manual configuration needed)
• Optional manual groupfolder selection for advanced use cases
• Access Control Integration: Combine with the files_accesscontrol app to restrict file access based on metadata
• Example: Block access to files where classification = confidential
• Example: Only allow download if status = approved

Changed

• Sidebar UI Improvements: Updated styling to follow Nextcloud design guidelines
• Save button moved from header to bottom of form (follows natural form flow)
• Save button right-aligned per Nextcloud Forms pattern
• Simplified separator lines using --color-border instead of darker variants
• Section headers use subtle 1px borders instead of prominent 2px primary borders
• Field separators replaced with whitespace-only spacing

Fixed

• Fixed missing deleteGroupfolderField method in FieldController (fixes "Method does not exist" error when deleting fields in admin settings)

Added

• New Field Types: Three new metadata field types for enhanced data capture:
• URL Field: URL input with validation and clickable external link button
• User Picker: Select Nextcloud users with avatar display
• File Link: Browse and link to files/folders within Nextcloud using the native file picker
• Bulk Metadata Editor: Edit metadata for multiple selected files at once from the Files app toolbar
• Appears as "Edit Metadata" action when files are selected
• Supports both single and multiple file selection
• Merge strategies: "Overwrite existing values" or "Only fill empty fields"
• Bulk Metadata Clear: New "Clear All" button in bulk editor to remove all metadata from selected files
• Confirmation dialog to prevent accidental data loss
• Also clears search index entries for the files
• Metadata Export to CSV: Export metadata from selected files to CSV format
• Includes file path, file name, and all metadata field values
• Automatic download with date-stamped filename
• Proper CSV escaping for special characters
• Dutch and German translations for all new features
• Buffer polyfill for webpack 5 compatibility with @nextcloud/files
• OpenAPI Specification: Added openapi.json for OCS API Viewer compatibility
• Full documentation of all external API endpoints
• Enables API exploration via the Nextcloud OCS API Viewer app
• API Documentation: Added <api-documentation> tag in info.xml

Changed

• Improved bulk metadata modal layout with action buttons grouped left (destructive/export) and right (cancel/save)
• Cleaned up CleanupDeletedMetadata background job code, removed unused debug variables

Fixed

• Fixed "Only fill empty fields" option incorrectly overwriting existing values
• Fixed fields not loading in bulk editor (now uses same endpoint as sidebar)
• Corrected field filtering to use applies_to_groupfolder instead of field_scope
• Removed hardcoded file_put_contents to /var/www/nextcloud/data/metavox_delete.log in CleanupDeletedMetadata background job (fixes "Failed to open stream" error)

Added

• Unified Search Integration: Search files by metadata content directly from Nextcloud's search bar
• File Copy Metadata Preservation: Metadata is automatically copied when files are duplicated (via FileCopyListener)
• Bulk API Operations: New API endpoints for batch metadata operations:
• getBulkFileMetadata: Fetch metadata for multiple files in one request
• batchUpdateFileMetadata: Update metadata for multiple files at once
• batchDeleteFileMetadata: Delete metadata from multiple files
• batchCopyFileMetadata: Copy metadata from one file to multiple target files
• Sidebar Tab in Files App: MetaVox metadata panel integrated into the Files app sidebar, fully rewritten in Vue.js (replaces vanilla JavaScript implementation)
• Dutch (nl) and German (de) translations for the entire application
• Caching for groupfolder mappings and field labels to improve performance
• PHP 8.x match expression for file icon detection with expanded file type support
• API response caching for groupfolders (5-minute TTL) with request cancellation
• Memoization for getFieldOptions() to prevent redundant parsing
• File access permission checks on all file metadata API endpoints
• Duplicate sidebar tab registration prevention (window flag guard)

Changed

• Major Architecture Refactoring: Removed global metadata system, now exclusively uses groupfolder-scoped metadata
• Modernized PHP codebase to PHP 8.x standards:
• Added declare(strict_types=1) to all PHP files
• Implemented constructor property promotion with readonly properties
• Replaced strpos() with str_contains() for string checks
• Replaced error_log() and file_put_contents() with PSR-3 LoggerInterface
• Replaced deprecated execute() with executeQuery()/executeStatement()
• Added proper return type declarations to all methods
• Refactored event listeners to use dependency injection for IJobList and LoggerInterface
• Improved code organization with proper use statements and class imports
• Vue Component Optimizations:
• Fixed v-for keys using index anti-pattern in GroupfolderMetadataFields.vue and FileMetadataFields.vue
• Added proper required attribute binding to SelectFieldInput.vue and CheckboxFieldInput.vue
• Removed debug console.log statements from all Vue components

Removed

• Global metadata tables (metavox_fields, metavox_metadata)
• Field override system (metavox_gf_overrides)
• License/subscription model
• Filter functionality
• Retention manager
• Hardcoded log file paths
• Performance test commands from app registration

Fixed

• Database error "Table 'nextcloud.oc_metavox_fields' doesn't exist" after migration
• Updated all services to use metavox_gf_fields and metavox_file_gf_meta tables
• Cleaned up orphaned test data (4776 test groupfolders removed)
• Unified search icon visibility in light theme (changed SVG fill from currentColor to #1a1a1a)
• Fixed "UpdateSearchIndex called without file_id" warning by correcting background job registration
• Fixed 404 error when editing fields in admin panel (incorrect API URL)
• Fixed dropdown options input only allowing one character at a time (v-for key reactivity issue)

Security

• Removed hardcoded absolute paths for logging
• Improved input validation in background jobs
• API endpoints now verify user has file access before allowing metadata read/write operations
• Admin-only endpoints (updateField, deleteField, createGroupfolderField, etc.) no longer allow non-admin access

Added

• Support for NextCloud 32.

Fixed

• Resolved an issue where values could not be selected in the multi-select component when spaces were present.
• Resolved an issue in the external API that prevented retrieving fields associated with a group folder.

Fixed

• Sidebar header not translated — {itemType} Metadata used an untranslated English variable, resulting in "File-metadata" in Swedish. Replaced with separate File Metadata / Folder Metadata strings so all languages translate the full header. Reported by Magnus (@maghog) on #62. Same anti-pattern fixed in the "No metadata fields configured" empty-state.

Changed

• Dutch (nl) translation polish — 78 strings rewritten to use idiomatic Dutch compound forms (Bestandsmetadata, Mapmetadata, Metadatavelden instead of Bestand Metadata, Map Metadata, Metadata Velden) and sentence case for button labels (Veld toevoegen instead of Veld Toevoegen). Aligns with the Nextcloud Dutch style guide.

Added

• Swedish (sv) translation — complete translation of all 432 strings by Magnus (@maghog). (#62)

Fixed

• Telemetry error feedback: The "Send report now" button now shows the actual server error message (e.g., rate limit, connectivity issue) instead of silently failing
• View columns not enriched when created without field_id — enrichViewColumns() only resolved columns by field_id, so views created via the API with only field_name were missing field_type, field_label, and field_options. This caused column headers to be invisible until the view was re-saved in the UI. Now resolves columns by both field_id and field_name.
• Sharing files with metadata crashes — FieldService::getGroupfolderIdByFileId() was called by the Flow engine during share events but never implemented, causing an "undefined method" fatal error. Added the missing method. (#58)

Removed

• Dead code: unreachable saveFieldOverride() and getFieldOverrides() controller methods referencing the removed metavox_gf_overrides table.

Added

• Support tab in admin panel — subscription info, pricing table, benefits overview, and subscription key management. Friendly, non-aggressive tone: "no limits, no restrictions, no catch."
• Remove subscription key button — allows returning to free usage state after subscription expires.
• Localized pricing URL — NL users link to Dutch pricing page, others to English.
• 43 new translations for Support tab content (EN, NL, DE, FR — 429 strings total).

Changed

• Banner tone — all banners are now blue/info, no more red/orange. Subscription nudge triggers at >50 users or >20 team folders.
• Support tab replaces license section in Statistics tab. Statistics now only shows stats, AI toggle, and telemetry.
• Organization fields above subscription key — fill in org details before activating a key.
• Licensing docs rewritten with current pricing (€49/149/349) and friendly tone.

Fixed

• Dark mode icon invisible — inline SVGs (sidebar tab, filter bar, bulk edit) used hardcoded stroke="#000" which is invisible in dark mode. Changed to currentColor which inherits the theme text color automatically.
• NC32 filter button misaligned — MetaVox filter button was 3px lower than native buttons (Type, Modified, People). Matched padding and margin to NC's native button styling.
• Folder copy error — copying a folder with files showed "Move or copy: failed on some elements" despite successful copy. FileCopyListener::getAllNodesRecursively() declared $type as int but received FileInfo::TYPE_FOLDER ("dir") which is a string. Changed to string type. (#56)

Fixed

• NC31/NC32 sidebar tab not showing — MetaVox tab was missing from the sidebar on NC31 and NC32 (reported on NC32.0.6). The NC33 registration path was incorrectly triggered on older versions because window._nc_files_scope existed as an empty object. Now verifies that the NC33 filesSidebarTabs Map is already initialized by Nextcloud before using it, otherwise falls back to the legacy OCA.Files.Sidebar API.
• NC32 sidebar tab order — added order: 100 to legacy tab registration so MetaVox appears after Sharing and Versions.
• NC32 filter button alignment — added proper height and vertical-align to match native filter buttons.

Fixed

• Statistics showing 0 team folders — "Team Folders with Metadata" count was always 0 when only folder-level metadata was configured. The query only checked file-level metadata (metavox_file_gf_meta), missing folder-level entries (metavox_gf_metadata). Now both tables are counted in statistics, telemetry, and license checks. (#55)

Fixed

• NC32 migration crash — Migration 14 (metavox_gf_column_config) used boolean type with notnull which caused "Bool NotNull cannot store false" error on NC32. Changed to smallint type. (#55)

Added

• Inline grid editing with field-type-specific editors (text, number, date, checkbox, URL, filelink, user)
• Cell locking with real-time sync via notify_push + Redis (prevents concurrent edits)
• Presence tracking — push events only sent to users actively viewing a groupfolder
• Views system — predefined column/filter/sort/formatting combinations with tabs UI
• "Default" tab with 🏠 icon — shows standard Nextcloud file view without MetaVox filters, visually separated from custom views
• Client-side filter and sort — zero server calls, operates on metadata cache
• Undo support with toast notification and field revert
• Fill handle for quick cell value propagation
• Lock badge with username — portaled, always visible during editing
• Rich cell rendering for user, URL, and filelink field types
• Backup/restore with progress bar, gzip compression, and keyset pagination
• AI autofill capability for metadata fields
• Bulk metadata modal UI with search
• Flow integration (vanilla JS, Vue 2 compatible)
• Checkbox fields use Yes/No dropdown with fill handle support
• NC32 compatibility with feature detection and fallback UI
• Field name validation — only lowercase letters (a-z), numbers (0-9) and underscores allowed. Specific error messages on both frontend and backend.
• License warning banner — red/orange banner at top of admin panel for invalid licenses or exceeded free tier limits
• ApiFieldService facade — all external API metadata operations go through ApiFieldService, shielding FieldService from API concerns
• French translation — complete FR support. All 4 languages (EN, NL, DE, FR) in sync at 386 strings.
• New fox ears + document icon — filled triangles with document body, light/dark mode support via app.svg (#000) and app-dark.svg (#fff)
• Field naming convention documented in API reference with prefix rules and examples

Changed

• Complete JS modular refactor: monolithic MetaVoxColumns split into 14 focused modules
• Centralized state management via MetaVoxState.js
• PHP 8 attributes replace annotation docblocks
• BaseController and BaseOCSController extraction for shared logic
• Services split into dedicated responsibilities (Field, Filter, View, Cache, Presence, Lock, Push)
• Single init endpoint eliminates 4 sequential API calls
• Inline init data via IInitialState for instant pageload (~8ms vs ~1500ms)
• Replace error_log with LoggerInterface (fixes #49)
• Documentation completely restructured (admin, user, architecture, features)
• Updated app description and screenshots in info.xml

Fixed

• View switching crash — fetchServerSortedIds is not a function replaced with triggerResort()
• NC32 sorting — DOM-based row reorder fallback
• NC32 sidebar tab + filter registration crashes
• NC33 sidebar tab and bulk metadata action registration via scoped globals
• Breadcrumb dropdown no longer blocked by view tabs
• Cell lock released when user switches to another program
• Prevent notify_push crash on malformed WebSocket messages
• Prevent flex layout from inflating column widths
• Loading indicator timing and spinner hang prevention
• N+1 queries in permission and groupfolder lookups
• OCS /api/v1/files/{fileId}/metadata endpoint now auto-detects groupfolder correctly

Performance

• 10K+ user scalability — presence cooldown, push batching, LRU cache
• Direct push cache updates eliminate race conditions
• Metadata cache persists across submap navigation
• Instant metadata on pageload with early prefetch on navigation
• Bulk metadata loading with lazy filters and virtual scroll optimization
• Optimized restore with batch inserts + cross-platform support
• Optimized metadata loading for large datasets (43M+ rows)

Upgrade Notes

• Free tier introduced: MetaVox 2.0.0 includes a free tier (5 team folders, 500 metadata entries per folder). If your installation exceeds these limits, an informational banner will appear in the admin panel. All features continue to work — nothing is blocked or restricted. For unlimited usage, visit voxcloud.nl.
• Nextcloud 31+ required: Minimum version raised from NC28 to NC31.

Added

• Automatic daily metadata backup to JSON (background job)
• Admin panel: Backup & Restore tab with manual backup, download, and restore
• Streaming backup/restore for large datasets (millions of entries)
• Circles/Teams support: team folders assigned to circles are now correctly detected

Fixed

• Fixed search index not updating when saving metadata
• Search index now updates directly on save instead of via background job
• Admin panel now shows all team folders regardless of membership
• Added groupfolder access checks on all metadata endpoints

Fixed

• Fixed sidebar tab not appearing on NC32 due to registration timing
• Added missing telemetry/statistics routes

Fixed

• NC33 sidebar tab now registers correctly by writing to NC33's scoped globals (window._nc_files_scope.v4_0) instead of the bundled @nextcloud/files window global
• NC33 bulk metadata action now registers correctly using the same scoped globals approach
• Groupfolder path matching uses exact boundary checks to prevent substring false positives

Added

• NC33 + Vue 3 migration with backwards compatibility (NC31-33)
• CacheCleanupListener for real-time metadata cleanup on file removal

Changed

• Migrated frontend from Vue 2 to Vue 3 with @nextcloud/vue v9
• Dual sidebar registration strategy (NC33 getSidebar() API + legacy fallback)
• CleanupDeletedMetadata converted from QueuedJob to TimedJob

Fixed

• File copy listener now only copies metadata within the same team folder, preventing orphaned metadata when copying between different team folders

Fixed

• Fixed "The requested uri() cannot be processed by the script '/var/www/nextcloud/occ'" error when running occ commands — boot() now skips request-dependent logic in CLI mode

Fixed

• Fixed "The requested uri() cannot be processed by the script '/var/www/nextcloud/occ'" error when running occ commands — boot() now skips request-dependent logic in CLI mode

Changed

• Renamed Telemetry tab to Statistics: Admin settings tab renamed from "Telemetry" to "Statistics" for consistency with IntraVox and FormVox apps
• Updated "About" section to "The Future of MetaVox": New section explaining potential future licensing model for larger organizations
• Clear communication that MetaVox remains free for most users
• Promises: free tier for small/medium installations, all current features remain available, transparent pricing

Added

• Telemetry expansion: Added 7 new server configuration fields to anonymous usage statistics
• Country code, database type, default language, timezone, OS family, web server, Docker detection
• Send report now button: Manual telemetry report trigger in admin Statistics tab
• New Statistics API endpoint (/api/telemetry/stats) for admin panel statistics display
• Metadata statistics overview showing field counts, team folders with metadata, and total entries
• Complete French (fr) translations: Full translation of all 252 strings
• Complete German (de) translations: Full translation of all 252 strings
• Complete Dutch (nl) translations: Full translation of all 252 strings

Fixed

• Telemetry countryCode and timezone: Country code now derived from default_phone_region instead of default_language (which produced invalid codes like EN). Timezone uses smarter fallback: Nextcloud config → php.ini → UTC

Fixed

• Fixed Files app detection not working behind reverse proxy with subpath (e.g., /nextcloud/apps/files)
• Now uses both getRequestUri() and getPathInfo() for reliable detection
• Thanks to @user for debugging and reporting this issue

Added

• Telemetry Service: Optional anonymous usage statistics to help improve MetaVox
• Collects anonymous metrics: field counts, metadata entries, groupfolder usage, user counts
• Instance identification via hashed URL (fully anonymous)
• Opt-out via admin settings (enabled by default)
• Background job runs daily to send reports
• Admin panel shows telemetry status and last report time
• Field-type specific operators in Flow: Operators now dynamically change based on selected metadata field type
• Text/Textarea: equals, contains, does not contain, is not empty, is empty
• Date: equals, is before, is after, is not empty, is empty
• Number: equals, greater than, less than, greater or equal, less or equal, is not empty, is empty
• Select/Dropdown: equals, is one of, is not empty, is empty
• Multiselect: contains, contains all, is not empty, is empty
• Checkbox: equals (with Yes/No dropdown), is not empty, is empty
• Nextcloud 33 compatibility: Updated FileAction API to support both @nextcloud/files v3.x (NC 28-32) and v4.x (NC 33+)
• Backwards compatible detection of API version
• Supports new destructured context object { nodes, view, folder, contents }

Changed

• Flow operator selector moved inside MetaVox component for better field-type awareness
• Checkbox fields now show "Yes (checked)" / "No (unchecked)" dropdown with proper 1/0 values
• Improved styling of Flow configuration panel to match Nextcloud design guidelines

Fixed

• Fixed Flow check configuration not loading on page refresh (timing issue with fields API)
• Fixed value input not refreshing when switching between different field types
• Fixed input alignment issues in Flow configuration panel
• Fixed bulk metadata editor opening when selecting a single file (now only shows for 2+ files)

Fixed

• Fixed Flow check configuration not persisting after page refresh
• Fixed newly added metadata fields not appearing in Flow dropdown until page reload

Added

• Nextcloud Flow Integration: MetaVox metadata can now be used as conditions in Nextcloud Flow rules
• New "MetaVox metadata" check available in Flow/Workflow Engine
• Supports operators: is, is not, contains, does not contain, matches regex, does not match regex
• Dynamic value input based on field type (dropdown for select fields, checkbox toggle for booleans, date picker, number input, text)
• Fields grouped into "File fields" and "Team folder fields" in the UI
• Auto-detect groupfolder from file context (no manual configuration needed)
• Optional manual groupfolder selection for advanced use cases
• Access Control Integration: Combine with the files_accesscontrol app to restrict file access based on metadata
• Example: Block access to files where classification = confidential
• Example: Only allow download if status = approved

Changed

• Sidebar UI Improvements: Updated styling to follow Nextcloud design guidelines
• Save button moved from header to bottom of form (follows natural form flow)
• Save button right-aligned per Nextcloud Forms pattern
• Simplified separator lines using --color-border instead of darker variants
• Section headers use subtle 1px borders instead of prominent 2px primary borders
• Field separators replaced with whitespace-only spacing

Fixed

• Fixed missing deleteGroupfolderField method in FieldController (fixes "Method does not exist" error when deleting fields in admin settings)

Added

• New Field Types: Three new metadata field types for enhanced data capture:
• URL Field: URL input with validation and clickable external link button
• User Picker: Select Nextcloud users with avatar display
• File Link: Browse and link to files/folders within Nextcloud using the native file picker
• Bulk Metadata Editor: Edit metadata for multiple selected files at once from the Files app toolbar
• Appears as "Edit Metadata" action when files are selected
• Supports both single and multiple file selection
• Merge strategies: "Overwrite existing values" or "Only fill empty fields"
• Bulk Metadata Clear: New "Clear All" button in bulk editor to remove all metadata from selected files
• Confirmation dialog to prevent accidental data loss
• Also clears search index entries for the files
• Metadata Export to CSV: Export metadata from selected files to CSV format
• Includes file path, file name, and all metadata field values
• Automatic download with date-stamped filename
• Proper CSV escaping for special characters
• Dutch and German translations for all new features
• Buffer polyfill for webpack 5 compatibility with @nextcloud/files
• OpenAPI Specification: Added openapi.json for OCS API Viewer compatibility
• Full documentation of all external API endpoints
• Enables API exploration via the Nextcloud OCS API Viewer app
• API Documentation: Added <api-documentation> tag in info.xml

Changed

• Improved bulk metadata modal layout with action buttons grouped left (destructive/export) and right (cancel/save)
• Cleaned up CleanupDeletedMetadata background job code, removed unused debug variables

Fixed

• Fixed "Only fill empty fields" option incorrectly overwriting existing values
• Fixed fields not loading in bulk editor (now uses same endpoint as sidebar)
• Corrected field filtering to use applies_to_groupfolder instead of field_scope
• Removed hardcoded file_put_contents to /var/www/nextcloud/data/metavox_delete.log in CleanupDeletedMetadata background job (fixes "Failed to open stream" error)

Added

• Unified Search Integration: Search files by metadata content directly from Nextcloud's search bar
• File Copy Metadata Preservation: Metadata is automatically copied when files are duplicated (via FileCopyListener)
• Bulk API Operations: New API endpoints for batch metadata operations:
• getBulkFileMetadata: Fetch metadata for multiple files in one request
• batchUpdateFileMetadata: Update metadata for multiple files at once
• batchDeleteFileMetadata: Delete metadata from multiple files
• batchCopyFileMetadata: Copy metadata from one file to multiple target files
• Sidebar Tab in Files App: MetaVox metadata panel integrated into the Files app sidebar, fully rewritten in Vue.js (replaces vanilla JavaScript implementation)
• Dutch (nl) and German (de) translations for the entire application
• Caching for groupfolder mappings and field labels to improve performance
• PHP 8.x match expression for file icon detection with expanded file type support
• API response caching for groupfolders (5-minute TTL) with request cancellation
• Memoization for getFieldOptions() to prevent redundant parsing
• File access permission checks on all file metadata API endpoints
• Duplicate sidebar tab registration prevention (window flag guard)

Changed

• Major Architecture Refactoring: Removed global metadata system, now exclusively uses groupfolder-scoped metadata
• Modernized PHP codebase to PHP 8.x standards:
• Added declare(strict_types=1) to all PHP files
• Implemented constructor property promotion with readonly properties
• Replaced strpos() with str_contains() for string checks
• Replaced error_log() and file_put_contents() with PSR-3 LoggerInterface
• Replaced deprecated execute() with executeQuery()/executeStatement()
• Added proper return type declarations to all methods
• Refactored event listeners to use dependency injection for IJobList and LoggerInterface
• Improved code organization with proper use statements and class imports
• Vue Component Optimizations:
• Fixed v-for keys using index anti-pattern in GroupfolderMetadataFields.vue and FileMetadataFields.vue
• Added proper required attribute binding to SelectFieldInput.vue and CheckboxFieldInput.vue
• Removed debug console.log statements from all Vue components

Removed

• Global metadata tables (metavox_fields, metavox_metadata)
• Field override system (metavox_gf_overrides)
• License/subscription model
• Filter functionality
• Retention manager
• Hardcoded log file paths
• Performance test commands from app registration

Fixed

• Database error "Table 'nextcloud.oc_metavox_fields' doesn't exist" after migration
• Updated all services to use metavox_gf_fields and metavox_file_gf_meta tables
• Cleaned up orphaned test data (4776 test groupfolders removed)
• Unified search icon visibility in light theme (changed SVG fill from currentColor to #1a1a1a)
• Fixed "UpdateSearchIndex called without file_id" warning by correcting background job registration
• Fixed 404 error when editing fields in admin panel (incorrect API URL)
• Fixed dropdown options input only allowing one character at a time (v-for key reactivity issue)

Security

• Removed hardcoded absolute paths for logging
• Improved input validation in background jobs
• API endpoints now verify user has file access before allowing metadata read/write operations
• Admin-only endpoints (updateField, deleteField, createGroupfolderField, etc.) no longer allow non-admin access

Added

• Support for NextCloud 32.

Fixed

• Resolved an issue where values could not be selected in the multi-select component when spaces were present.
• Resolved an issue in the external API that prevented retrieving fields associated with a group folder.

Added

• Possibility to connect externally with the API

Fixed

• Fixed an issue where it was not possible to add columns.

Added

• Native Nextcloud controls for improved integration and consistency with the Nextcloud design system

Changed

• Refactored UI components to use the Nextcloud design language
• Improved stability and maintainability

Fixed

• Minor bugs and performance issues
• Not able to edit text in File metadata text field