Skip to content

Updated Gin to 5. #162

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlexSkrypnyk merged 1 commit into from
Mar 26, 2026
Merged

Updated Gin to 5. #162

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions composer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@
"drupal/environment_indicator": "^4.0.25",
"drupal/field_group": "^4",
"drupal/generated_content": "^2",
"drupal/gin": "^4.0.6",
"drupal/gin_toolbar": "^2",
"drupal/gin": "^5.0.12",
"drupal/gin_toolbar": "^3.0.3",
Comment on lines +29 to +30
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

drupal/gin 5.0 release notes breaking changes upgrade guide

💡 Result:

Gin 5.0.0 was released on June 18, 2025. It requires Drupal ^11.2, unlike 4.x series which supported Drupal 10/11<11.2. Release notes for 5.0.0: Bug fix for #3503575: Integrate Gin with the new Navigation Top Bar. Changes since 4.1.0. No explicit breaking changes or dedicated upgrade guide found in release notes across 5.0.x versions (5.0.0 to 5.0.12). All listed as bug fixes. Potential considerations from 4.x releases (may carry over): Dropped Drupal 9 support; CSS3 classes changed from CamelCase to kebab-case (#3309113); New/sticky navigation enabled by default. Upgrade via Composer: composer require 'drupal/gin:^5.0'. Clear caches after update. Check compatibility with Drupal 11.2+ and related modules (e.g., gin_lb, Layout Paragraphs have reported issues with Gin 5.x). Project page: https://www.drupal.org/project/gin. Releases: https://www.drupal.org/project/gin/releases. Source: https://git.drupalcode.org/project/gin.

Citations:

🌐 Web query:

drupal/gin_toolbar 3.0 release notes breaking changes compatibility with gin 5.x

💡 Result:

The gin_toolbar 3.0.0 release (June 18, 2025) lists only "Bug fixes" in its release notes with no detailed changelog or explicit breaking changes mentioned on the official Drupal.org release page. Subsequent patch releases (3.0.1, 3.0.2, 3.0.3 as of January 2026) are also bug fixes only: 3.0.1 removes dependency from core toolbar module; 3.0.3 fixes CSS aggregation issues. The 3.0.0-alpha1 notes "Get ready for Drupal 11.2", indicating preparation for newer Drupal core compatibility. gin_toolbar 3.x is fully compatible with Gin 5.x. Multiple sources confirm Gin 5.0 requires gin_toolbar 3.0 (while Gin 4.x uses 2.x), resolving version conflicts when updating. gin_toolbar 3.x works with Drupal ^11.2, aligning with recent Gin releases supporting Drupal 11. No incompatibilities or required workarounds noted for Gin 5.x.

Citations:

🏁 Script executed:

#!/bin/bash
# Description: Check for gin and gin_toolbar update hooks and documentation

echo "=== Checking for gin module update hooks ==="
fd -t f "gin.install" web/modules/contrib/gin --exec cat {} \; 2>/dev/null | head -100

echo -e "\n=== Checking for gin_toolbar module update hooks ==="
fd -t f "gin_toolbar.install" web/modules/contrib/gin_toolbar --exec cat {} \; 2>/dev/null | head -100

echo -e "\n=== Checking for README or CHANGELOG in gin ==="
fd -t f -e md -e txt "README|CHANGELOG|UPGRADING" web/modules/contrib/gin --exec head -50 {} \;

echo -e "\n=== Checking for README or CHANGELOG in gin_toolbar ==="
fd -t f -e md -e txt "README|CHANGELOG|UPGRADING" web/modules/contrib/gin_toolbar --exec head -50 {} \;

Repository: drevops/website

Length of output: 510

Verify compatibility with Drupal 11.2+ and test for CSS/navigation behavior changes.

The gin 5.x → gin_toolbar 3.x pairing is compatible and required. However, note these important changes:

  • Drupal version requirement: Gin 5.x requires Drupal ^11.2 (more restrictive than 4.x which supported 10/11). Verify your Drupal version is 11.2 or later.
  • CSS class naming: Classes changed from CamelCase to kebab-case in the 4.x → 5.x transition. Review any custom CSS or theme overrides.
  • Navigation defaults: New/sticky navigation is enabled by default in 5.x. Test admin UX after upgrade.

Test the configuration export against the 5.x schema before deploying to ensure config/default/gin.settings.yml settings are compatible.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@composer.json` around lines 29 - 30, Update the composer dependency
constraints to require drupal/gin ^5.0 and drupal/gin_toolbar ^3.0 only if the
project runs on Drupal ^11.2+; verify the running core version and adjust
composer.json's "drupal/gin" and "drupal/gin_toolbar" entries accordingly, audit
any custom CSS/classes for CamelCase→kebab-case renames and update overrides,
test admin/navigation/UI for the new sticky navigation defaults, and validate
the exported configuration against the 5.x gin.settings.yml schema (review
config/default/gin.settings.yml) before merging.

"drupal/google_tag": "^2.0.9",
"drupal/highlight_js": "^1.2",
"drupal/lagoon_logs": "^3.0.1",
Expand Down
36 changes: 18 additions & 18 deletions composer.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading