This project provides a shared foundation of vanilla JavaScript code for a suite of Drupal Views display format modules. It enables interactive components like accordions, carousels, and slideshows without requiring jQuery. This module acts as a dependency for other VVJ modules, centralizing code for improved performance and consistency.
VVJ Core is the shared base for the ten VVJ modules that add interactive formats to Drupal Views. Site builders get it automatically when they install a VVJ format module.
It adds no Views format of its own. It holds the code, settings sections and styles that every VVJ 2.x format module uses, so each format behaves the same way in the Views interface.
Start here
The VVJ format modules
Install one or more of these. Each requires VVJ Core and adds its own "Format" choice to a view.
Features
VVJ Core has no settings page of its own. Its settings appear in the format settings of each view, under Structure > Views.
- "Advanced options": a section with the "Enable CSS library" checkbox.
- "Deep linking settings": the "Enable deep linking" checkbox and the "URL identifier" field. The identifier is required when deep linking is on, must contain a letter, and cannot be a reserved word.
- "Token documentation": explains that Twig-style tokens do not work in the view header, footer or empty text with a VVJ format.
- "Active breakpoint" and "Animation": shared selects. "Animation" offers None, Fade, Zoom, and Slide from Top, Bottom, Left or Right. A format module can switch each setting off.
- Fields row: VVJ formats use the "Fields" row plugin. Views switches any other row plugin back to "Fields".
- Help page: read the module help at
/admin/help/vvj_coreafter you enable it. - Upgrade check: the Drush command
drush vvj:upgradeaudits the views that use a VVJ format and converts any old settings to the current ones. Add--dry-runto report what would change without saving, or--module=vvja,vvjsto check only those formats. It is for sites coming from VVJ 1.x.
For developers, VVJ Core also provides a Views style plugin base class, shared PHP services, a Twig filter named safe_html, a JavaScript element base and three stylesheets.
Submodules
- VVJ Patterns: adds a "Patterns" section with a "Pattern" select to the format settings of any format that ships Patterns. A Pattern is a ready-made design. Choosing one replaces the layout, animation, styling and deep-linking settings when you save. Choose "None" to keep your own settings. After you pick a Pattern, a list headed "To finish the Pattern" shows what is left to set. VVJ Core ships no Patterns itself; each format module ships its own. It also adds a theme bridge for the APEX, Solo and W3CSS themes, so Patterns take their colors from the active theme; other themes get none. An update function creates any shared image styles a site is missing. It needs Image and installs six image styles. Uninstalling it is blocked while those image styles are in use.
- VVJ Patterns Demo: adds a "VVJ Slide" content type with the fields kicker, nav label, summary, image and link, five demo pictures, and ten example views, one per format, titled "VVJ demo: " followed by the format name. Pages such as
vvj/vvja/agenda,vvj/vvja/cardsandvvj/vvja/faqshow them. - VVJ Core AI: optional. It adds the page "Build a VVJ view with AI" at
/admin/structure/views/vvj-ai, with an action button on the Views list. The form asks for "Format", "Content type", "Show each item as", "How many", "What should it show?", "Block title", "Also make a page" and "Page path", then "Create the view". It creates a new disabled view as a block, and a page when you ask. It never edits an existing view. Opening the page needs the permissions "Use the VVJ views assistant" and "Administer views". It requires the AI module and supports Drupal 11.3 only.
Installation: get started in 3 steps
Most sites never install VVJ Core by name. Requiring a format module installs it too.
- Install a format module with Composer. This example uses VVJA:
composer require 'drupal/vvja:^2.0' - Enable it on the Extend page, or with Drush. VVJ Core is enabled with it:
drush en vvja - Open a view under Structure > Views and set "Format" to the format that the module adds. Then open the format settings.
To install VVJ Core on its own, run composer require drupal/vvj_core. To upgrade from VVJ 1.x, upgrade every installed VVJ module to 2.x together. Mixing 1.x and 2.x is not supported.
Requirements
- Drupal ^11.3 || ^12
- PHP 8.3 or later
- Views and Filter (both in Drupal core)
Sites on Drupal 10 or on Drupal 11.0 to 11.2, or on PHP 8.1 or 8.2, stay on VVJ 1.x. The AI submodule also needs the AI module.
Support and maintenance
Questions, ideas, and bug reports are welcome. Please use this project’s issue queue so discussions and solutions remain available to the Drupal community.
Maintainers monitor issues, but response times depend on availability.
Developed and maintained by Alaa Haddad of Flash Web Center, LLC.
AI disclosure: AI tools assisted with drafting and reviewing this project description. The maintainer verified the final content against the project source.
Ask your assistant about VVJ Core
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
- filter Drupal core
- views Drupal core
Required by
10 tracked projects depend on this one
- Views Slideshow - Views Vanilla JavaScript Slideshow (VVJS) 856 sites
- Views Carousel - Views Vanilla JavaScript Carousel (VVJB) 196 sites
- Views Accordion - Views Vanilla JavaScript Accordion (VVJA) 147 sites
- Views Tabs - Views Vanilla JavaScript Tabs (VVJT) 146 sites
- Views 3D Carousel - Views Vanilla JavaScript 3D Carousel (VVJC) 117 sites
- Views Lightbox - Views Vanilla JavaScript Lightbox (VVJL) 91 sites
- Views FlipBox - Views Vanilla JavaScript 3D FlipBox (VVJF) 87 sites
- Views Parallax - Views Vanilla JavaScript Parallax (VVJP) 81 sites
- Views Hero - Views Vanilla JavaScript Hero (VVJH) 77 sites
- Views Reveal - Views Vanilla JavaScript Reveal (VVJR) 69 sites