Integration for Google Drive 1.4.22: File List Folder View & Stability Fixes

Integration for Google Drive 1.4.22 is officially available, bringing interactive folder view and breadcrumb navigation to the File List module. This release resolves navigation loops across Google Workspace Shared Drives, fixes Search Box subfolder exploration, ensures folder names containing dots are never mistaken for files, and protects frontend interactive modules from third-party speed optimizer script crashes.

Following our major root folder locking and Smart Auto download release in version 1.4.21, this update focuses on frontend exploration ergonomics, directory reliability, and runtime stability for both authenticated and logged-out visitors. You can test all new features on our Live Interactive Demo or update directly from your WordPress dashboard.

1. Interactive Folder View & Breadcrumb Navigation in File List

The File List module was originally built to present curated flat lists of documents, media files, and downloads. As teams organize complex document hierarchies inside Google Drive, displaying directory structures without forcing full file browser chrome became a frequent request.

Version 1.4.22 introduces full Folder View support for the File List module across all six display layouts (List, Table, Grid, Compact, Gallery, and Timeline):

• Hierarchical Folder Exploration: Visitors can click any folder to navigate directly into child directories with clean parent-child trail tracking.
• Persistent Breadcrumb Bar: Displays an intuitive breadcrumb path (Home > Parent > Current Folder), letting visitors jump back to any ancestor folder or the root directory in a single click.
• Native Shimmer Skeleton Loaders: When navigating into a folder, the module displays animated shimmer skeleton placeholders tailored to the active layout columns, giving immediate visual feedback while folder contents load.
• Click Race Guards: Folder actions and breadcrumbs automatically ignore duplicate clicks while requests are in flight, preventing concurrent network flooding.
• Full Theme Adaptation: Skeletons dynamically adapt to both light and dark themes using var(--bg-tertiary) for seamless visual integration with your site styles.

2. MIME-First Folder Name Normalization (Fix for Dotted Names)

When organizing project deliverables, teams frequently use periods in folder names (for instance: 28200 - Rev. A, Firmware v2.0, or Release 1.4). In the official Google Drive API v3, native folders return an empty fileExtension property.

Previously, standard PHP pathinfo() fallbacks mistook the characters following a period as a file extension (e.g. interpreting .0 in v2.0 as an extension). This led to three severe usability bugs:

• Truncated Basenames: Folder titles were cut short on screen, stripping away essential version or revision markers.
• Sorting Confusion: Folders with periods were classified as files, pushing them to the bottom of file lists instead of grouping them at the top with other directories.
• Exploration Failures: Clicking a dotted folder attempted to trigger a file preview instead of exploring directory contents.

Version 1.4.22 enforces strict MIME-first folder inspection (application/vnd.google-apps.folder) before running any extension fallback. Folder names containing periods retain their exact titles, sort accurately at the top of directory trees, and open instantly. In addition, an automated database migration routine (Update_1_4_22) runs seamlessly on upgrade to normalize any historical records in your files cache.

3. Shared Drives & File Manager Navigation Loop Resolution

Organizations relying on Google Workspace Shared Drives (Team Drives), Computers, or Shared With Me directories experienced an edge-case navigation loop in the File Manager. When clicking through nested subdirectories, breadcrumb parent lookup evaluated against account root IDs rather than virtual parent identifiers.

This caused the File Browser route guard to treat the navigation as an unauthorized exit from the root folder, repeatedly snapping visitors back to the top-level directory. Version 1.4.22 refactors App::getBreadcrumbByKey to resolve virtual parent lookups using raw parent IDs, preserving complete breadcrumb trails and eliminating route reset loops across all shared workspaces.

4. Search Box Subfolder Exploration & Pagination Controls

The Search Box module enables site visitors to find cloud documents instantly. However, exploring subfolders discovered via search previously stripped directory nodes or leaked parent directories above the assigned root.

Version 1.4.22 upgrades the Search Box module with comprehensive subfolder handling:

• Subfolder Child Queries: Visitors can click into subfolders returned in search results to browse child assets directly without leaving the module interface.
• Dynamic Ancestor Isolation: Breadcrumbs resolve strictly against the configured root folder, preventing exposure of parent directories located higher up in your Google Drive hierarchy.
• Clean Breadcrumb Home Resets: Clicking “Home” properly resets both active folder state and search scope back to global browsing.
• Integrated Pagination Controls: Embedded ModuleBottom integration ensures pagination buttons and infinite scroll triggers respect user preferences seamlessly.

5. Speed Optimizer Shield for Logged-Out Visitors

Caching and minification plugins such as SiteGround Speed Optimizer and LiteSpeed Cache provide valuable page speed gains. However, when aggressive script combination or deferral is enabled, minifiers often combine WordPress core React dependencies out of order for non-logged-in visitors.

This frequently triggered JavaScript console errors like TypeError: Cannot read properties of undefined (reading 'forwardRef'), ReferenceError: _ is not defined, or (0, I2.observableMap) is not a function on public pages, preventing file lists and interactive modules from initializing.

Version 1.4.22 resolves this across three defensive layers following official WordPress Plugin Standards:

• Comprehensive Optimizer Exclusions: Added complete WordPress core UI script handles (wp-element, react, react-dom, wp-compose, underscore, wp-i18n, wp-components, wp-util) and file URLs to third-party optimization exclusion filters (SiteGround, LiteSpeed, WP Rocket, Autoptimize).
• Dependency Bundling via AddDepsPlugin: Injected core dependencies directly into shared.asset.php during webpack compilation to enforce correct loading order on every frontend view.
• Embedded JSON Fallback Parser: Added getShortcodeData in all frontend entry points to parse embedded JSON configuration tags even if inline script variables are delayed or moved by minifiers.

6. Lightbox Preview & Context Menu Stability

In addition to major architectural improvements, version 1.4.22 refines several frontend interaction details:

• Clean Lightbox Dismissal: Fixed modal backdrop dismissal handlers to ensure image and document previews close reliably without lingering overlay DOM nodes.
• Context Menu Race Conditions: Resolved a timing issue in the File List right-click context menu when selecting items during active search filtering.
• Root Breadcrumb 403 Resolution: Fixed shortcode root breadcrumbs to resolve to / instead of raw virtual account identifiers, eliminating 403 Forbidden errors when returning to the root view.

Version 1.4.22 Changelog

How to Update

Updating to version 1.4.22 is quick and seamless across both Free and Pro plans:

1. One-Click Dashboard Update: Head to your WordPress dashboard > Plugins > Installed Plugins and click Update Now next to Integration for Google Drive.
2. Direct Package Download: Download the latest release archive directly via our official direct download endpoint and upload it under Plugins > Add New Plugin > Upload Plugin.
3. Test the Interactive Demo: Explore the new File List folder view, breadcrumbs, and Search Box enhancements live on the Integration for Google Drive Live Demo.

Version 1.4.22 is fully backward-compatible with all existing modules, shortcodes, and cloud backups. To explore advanced backup and restoration workflows, check out our guide on WordPress Site Backup, Restore & Migration with Google Drive or visit our comprehensive documentation portal.