blanq Motion

Lädt GSAP und Lenis lokal vom eigenen Server (kein CDN) und nur auf Seiten, die sie brauchen. Gedacht für Bricksmotion-Komponenten und eigenen GSAP-Code in Bricks. Die Grundbewegung (Einblenden, Hover) läuft über die ACSS-Effekte und braucht dieses Plugin nicht.

Enthalten: GSAP 3.15.0 mit allen Plugins, Lenis 1.3.27.

Was das Plugin macht

Bei jedem Seitenaufruf prüft es das fertige HTML und bindet nur die nötigen Dateien im <head> ein:

Es erkennt auch Header, Footer, Templates und Komponenten, weil es die fertig gerenderte Seite prüft. Wird GSAP schon von anderer Stelle geladen (z. B. von Bricksforge), lädt es nicht doppelt.

Bricksmotion nutzt das vorhandene GSAP und lädt dann nichts vom CDN nach. Nicht window.BM_GSAP = 'own' setzen.

Nicht aktiv im Bricks-Editor, im Admin, bei REST/AJAX, Feeds und Embeds.

Prüfen, ob es läuft

1. Als Admin eingeloggt eine Seite öffnen, Quelltext ansehen. Im <head> steht z. B. ``
2. Entwicklertools → Netzwerk, nach gsap, lenis, jsdelivr, unpkg, cdnjs filtern. Alles muss von der eigenen Domain kommen.
3. Seite ohne Animationen öffnen: Es darf keine GSAP-Datei geladen werden.

Einstellungen (optional)

In der wp-config.php:

define( 'BQ_MOTION_REPO', 'https://github.com/blanq-agency/blanq-motion/' ); // Repository für Updates
define( 'BQ_MOTION_GITHUB_TOKEN', 'github_pat_…' ); // nur bei privatem Repository
define( 'BQ_MOTION_AUTO_UPDATE', false );           // automatische Updates abschalten (Details unten)

Filter für Sonderfälle (z. B. in einem Code-Snippet):

// Auf einer bestimmten Seite immer Flip laden
add_filter( 'bq_motion_libraries', function ( $libs ) {
    if ( is_page( 'referenzen' ) ) { $libs = array_unique( array_merge( [ 'gsap', 'Flip' ], $libs ) ); }
    return $libs;
} );

// Skripte mit defer laden (schnellere Darstellung, vorher testen!)
add_filter( 'bq_motion_defer', '__return_true' );

// Plugin auf einer Seite komplett aus
add_filter( 'bq_motion_enabled', fn() => ! is_page( 'impressum' ) );

Hinweis zu defer: Standardmäßig werden die Bibliotheken direkt geladen, damit sie sicher bereitstehen, bevor Bricksmotion- oder eigener Code läuft. defer nur nutzen, wenn alle Animationen erst nach DOMContentLoaded starten.

Performance-Plugins

Bei WP Rocket, Perfmatters, FlyingPress, LiteSpeed o. ä. diese Begriffe von „JavaScript verzögern“ ausnehmen:

bq-motion
gsap
BRICKSMOTION

Automatische Updates

Fester Monatsrhythmus:

An allen anderen Tagen wird ein verfügbares Update in WordPress nur angezeigt und kann bei Bedarf von Hand eingespielt werden. Wird der Pull Request erst nach dem ersten Montag zusammengeführt, kommt das Update einen Monat später automatisch.

Die Action lässt sich unter Actions → Bibliotheken aktualisieren → Run workflow auch jederzeit von Hand starten.

Zeitplan ändern (wp-config.php):

define( 'BQ_MOTION_AUTO_UPDATE', 'first-monday' ); // Standard
define( 'BQ_MOTION_AUTO_UPDATE', 'always' );       // sofort installieren
define( 'BQ_MOTION_AUTO_UPDATE', false );          // nur von Hand

Eigene Änderungen: Version erhöhen (npm run build -- --bump), auf main pushen. Das Release entsteht sofort, installiert wird am nächsten ersten Montag.

Entwicklung

npm install        # GSAP und Lenis holen
npm run build      # nach vendor/ kopieren, manifest.json schreiben
npm test           # Erkennung testen (PHP)
npm run package    # dist/blanq-motion.zip bauen

Lizenzen

• GSAP: GreenSock Standard License (kostenlos, auch kommerziell): https://gsap.com/standard-license
• Lenis: MIT, siehe vendor/lenis/LICENSE.txt
• Plugin Update Checker: MIT, siehe lib/plugin-update-checker/license.txt