auto_libraries_version
4 sites
Security covered
Auto Libraries Version centralizes and automates asset versioning for Drupal libraries. Use `version: AUTO_VERSION` in your *.libraries.yml files and the module injects a single, site‑wide version to bust caches for CSS/JS. CI/CD‑friendly with UI and Drush control.
Features
- Replace hard‑coded library versions with the
AUTO_VERSIONtoken in any*.libraries.yml. - Appends the configured version to asset URLs for reliable cache‑busting across themes and custom modules.
- Single, centralized version value: use semantic versions (e.g., 1.2.3), Git tags, or commit SHAs.
- Enable/disable behavior and set the version via the Drupal UI or Drush—ideal for automated deployments.
- No code changes to your assets—just declare
version: AUTO_VERSIONwhere needed. - Works in all environments and plays well with CDNs, reverse proxies, and aggressive caches.
- No external dependencies; safe and lightweight.
Post-Installation
- Install and enable the module as usual.
- Go to Administration » Configuration » Development » Performance » Auto Libraries Version.
- Check “Enabled” and set your preferred version string (e.g.,
1.0.0,2025-10-07, or a Git SHA). - In your project’s
*.libraries.yml, addversion: AUTO_VERSIONto libraries you want auto‑versioned. Example:
global-styling: version: AUTO_VERSION css: theme: css/theme.css: {} - Clear caches. Drupal will now append the configured version to those assets’ URLs.
Additional Requirements
None. This module depends only on Drupal core.
Supporting this Module
Issues and feature requests are welcome via the project issue queue once published on drupal.org. Contributions, bug reports, and merge requests are appreciated.
Community Documentation
- See the module’s README for detailed configuration and Drush examples.
- Continuous Delivery tip: set the version automatically from your pipeline (e.g., latest Git tag or commit SHA).
Thanks for using Auto Libraries Version! If you find it useful, consider sharing feedback or contributing improvements.