Banner Cards API

A module for managing banners and cards with GraphQL support.

Abstract

The banner-cards module provides functionality for handling banners and cards in modern applications. It integrates with GraphQL APIs, offering queries for banner management and real-time updates.

What it does

This module enables your application to:

• Manage banners through GraphQL queries
• Handle card data associated with banners
• Provide real-time updates via subscriptions

Key Features

• GraphQL Integration: Provides queries for banner and card data
• Data Storage: Persists banner and card information in the database
• Event System: Supports subscriptions for real-time banner updates
• Media Manager: The React admin editor picks the background image and icon through Adminizer’s shared media manager — select from the existing library or upload a new file without leaving the card form. See docs/media-manager.md.

Changelog

2.6.3 (2026-07-06)

• Fixed the admin bundle being shadowed by the site frontend: the static route /banner-cards-admin-assets is now mounted at hook-initialize time via src/hook/bindAssets.ts (same as core’s hook/bindAssets). Previously it was mounted inside the Adminpanel:afterHook:loaded handler — middleware added at that point lands after the app’s frontendRoutes catch-all (config/http.js), so the bundle URL returned the site index.html instead of JS and the Banner Cards Manager page was taken over by the site frontend.

2.6.0 (2026-07-06)

• Replaced the plain adminpanel model CRUD with a React/Inertia admin module (same pattern as core Notifications / blocking-popups):
  • horizontal carousel preview of all cards exactly as visitors see them,
  • card list with quick activate/deactivate toggle, edit and soft delete,
  • editor with a live preview pane (gradient, badges, icon, background image and a ticking countdown update as you type),
  • badge editor with color pickers and one-click templates from the module config,
  • countdown validation (ISO date or systemd calendar expression) reusing lib/systemdCalendar on both backend and frontend.
• New access-rights tokens banner-cards-view / banner-cards-manage (department Marketing); page requires view, write API requires manage.
• Admin bundle is built with Vite into assets/banner-cards-admin (npm run build:adminizer) and served at /banner-cards-admin-assets.
• Removed src/lib/bindAdminpanelconfig.ts (old model-CRUD registration).