Cursora-Anleitung – Einrichtung & Fehlersuche

Installation

Cursora braucht WordPress 6.0 oder neuer und PHP 7.4 oder neuer.

Cursora gibt es nur im Plugin-Verzeichnis von WordPress.org: Installation direkt im WordPress-Backend, Updates auf demselben Weg.

Cursora wird derzeit von WordPress.org geprüft und erscheint nach der Freigabe im Plugin-Verzeichnis.

Im WordPress-Backend Plugins → Neues Plugin hinzufügen öffnen und nach „Cursora“ suchen.
Auf „Jetzt installieren“ und danach auf „Aktivieren“ klicken.
Im Admin-Menü „Cursora“ öffnen, ein Zeigerbild wählen und speichern.
Optional: ein Hover-Bild wählen, Größe und Klickpunkt anpassen oder in den Effekt-Modus wechseln.

Nativer oder Effekt-Modus

Der native Modus macht das Bild zu einem echten Browser-Zeiger. Er braucht kein JavaScript und hinkt der Maus nie hinterher. Cursora wandelt PNG, JPG, GIF oder WebP in einen passend großen PNG-Zeiger um, damit Browser kein zu großes Bild ignorieren. Animierte GIFs werden dabei zum Standbild.

Der Effekt-Modus zeichnet das Bild in einer kleinen Ebene, die der Maus folgt, auf Wunsch mit weichem Nachziehen und einer kurzen Klick-Animation. Er erlaubt Größen bis 256 px sowie animiertes GIF, WebP und SVG.

Kleines Logo oder Icon, das sich wie ein normaler Zeiger anfühlen soll: nativer Modus, 32 px.
Großes, detailreiches oder animiertes Bild: Effekt-Modus.

Zeigerbild und Hover-Bild

Das Zeigerbild erscheint auf der ganzen Website. Das Hover-Bild erscheint über Links und Buttons. Ohne Hover-Bild zeigen klickbare Elemente die normale Hand, damit sie erkennbar bleiben.

Beide Bilder sollten denselben Klickpunkt haben, zum Beispiel die Spitze eines Pfeils. Textfelder behalten immer den normalen Text-Cursor.

Größe und Klickpunkt

Im nativen Modus akzeptieren Browser Zeiger bis 128 × 128 px, und Chromium-Browser ersetzen Zeiger über 32 px am Fensterrand durch den Standard-Pfeil – 32 px sind die sichere Wahl. Der Effekt-Modus erlaubt bis 256 px.

Der Klickpunkt ist die Stelle, die tatsächlich klickt, eingestellt in Prozent des Bildes mit Live-Vorschau: 0 % / 0 % ist die linke obere Ecke, 50 % / 50 % die Mitte. Eine scharfe Retina-Version ergänzt Cursora im nativen Modus nur bei einem Klickpunkt in der linken oberen Ecke, weil Browser den Klickpunkt von Retina-Zeigern unterschiedlich behandeln.

Weiches Nachziehen und Klick-Animation

Im Effekt-Modus folgt das Bild der Maus direkt (Aus) oder mit sanfter Verzögerung (Leicht oder Stark). Eine kurze Skalier-Animation zeigt jeden Klick.

Besucher, die im System reduzierte Bewegung eingestellt haben, bekommen weder Nachziehen noch Klick-Animation.

Den Zeiger auf einzelnen Seiten abschalten

Die Seite, den Beitrag oder das Produkt im Editor öffnen und in der Seitenleiste „Eigenen Mauszeiger auf dieser Seite deaktivieren“ anhaken (Block-Editor und klassischer Editor). Nach dem Speichern zeigt diese Seite den normalen Zeiger.

Themes und Page Builder

Cursora funktioniert mit jedem Theme und Page Builder. In den Editoren von Divi, Elementor, Beaver Builder, Bricks und Oxygen Classic schaltet es sich ab, damit sich das Bearbeiten normal anfühlt – den Zeiger in der Vorschau oder auf der Live-Seite prüfen.

Cursora respektiert Zeiger, die ein Theme bewusst setzt, etwa die Greif-Hand bei Slidern. Klickbare Elemente von Divi, Elementor, Swiper, Kadence, Slick und WooCommerce-Galerien bekommen das Hover-Bild oder die Hand.

Barrierefreiheit

Cursora ist so gebaut, dass niemand seinen Zeiger verliert:

Formularfelder behalten den Text-Cursor.
Links zeigen die Hand, solange kein Hover-Bild gewählt ist.
Reduzierte Bewegung schaltet Nachziehen und Klick-Animation ab.
Lädt das Skript oder das Bild nicht, bleibt der normale Zeiger.
Im Kontrastmodus (etwa den Kontrastdesigns von Windows) schaltet sich Cursora ab, damit Besucher ihren eigenen, oft vergrößerten System-Zeiger behalten.
Smartphones und Tablets bleiben unberührt.

Fehlersuche

Erscheint der Zeiger nicht, diese Punkte der Reihe nach prüfen:

Seiten-Cache und Optimierungs-Cache leeren.
Prüfen, ob Cursora eingeschaltet ist, ein Bild gewählt ist und unter dem Bild kein Fehler steht.
Prüfen, ob „Eigenen Mauszeiger auf dieser Seite deaktivieren“ für diese Seite angehakt ist.
Mit Maus am Computer testen: Auf Touch-Geräten, in Page-Builder-Editoren und im Kontrastmodus bleibt Cursora aus.
Ein Bereich mit normalem Pfeil kann vom Theme bewusst so gestaltet sein (etwa mit cursor: default) – Cursora respektiert das.

Deaktivieren und löschen

Beim Deaktivieren bleiben die Einstellungen erhalten. Beim Löschen entfernt das Plugin seine Einstellungen, die erzeugten Zeigerbilder in uploads/cursora und den Schalter pro Seite. Bilder in der Mediathek bleiben unberührt.

Häufige Fragen

Wie lässt sich der Mauszeiger einer WordPress-Website ändern?

Cursora installieren, im Admin-Menü „Cursora“ öffnen, ein Bild aus der Mediathek wählen und speichern. Der neue Zeiger erscheint sofort auf der Website (einen Seiten-Cache vorher leeren).

Welcher Modus ist der richtige?

Der native Modus für kleine Icons, die sich genau wie ein normaler Mauszeiger anfühlen sollen (empfohlene Größe: 32 px). Der Effekt-Modus für größere oder animierte Bilder und weiches Nachziehen.

Welche Bildformate gehen?

Im nativen Modus: PNG, JPG, GIF oder WebP (WebP, wenn der Server es unterstützt). Cursora wandelt das Bild in einen PNG-Zeiger um, animierte GIFs werden dabei zum Standbild; SVG geht nicht. Im Effekt-Modus: jedes Bild, das Browser anzeigen können, auch animiertes GIF, WebP und SVG (SVG-Uploads erlaubt WordPress nur mit einem Zusatz-Plugin).

Warum ist der native Zeiger auf 128 px begrenzt?

Browser ignorieren Bild-Zeiger über 128 × 128 px. Chrome, Edge und andere Chromium-Browser ersetzen native Zeiger über 32 px außerdem am Fensterrand durch den Standard-Pfeil. Für größere Bilder den Effekt-Modus nutzen.

Warum wirkt der native Zeiger auf hochauflösenden Bildschirmen unscharf?

Cursora ergänzt eine scharfe Retina-Version (2x), wenn der Zeiger höchstens 64 px groß ist, das Ausgangsbild mindestens doppelt so groß ist und der Klickpunkt in der linken oberen Ecke liegt. Browser behandeln den Klickpunkt von Retina-Zeigern unterschiedlich, deshalb hat bei jedem anderen Klickpunkt die Genauigkeit Vorrang vor der Schärfe.

Funktioniert Cursora mit Divi und Elementor?

Ja. Der Zeiger funktioniert mit jedem Theme und Page Builder. In den Editoren von Divi, Elementor, Beaver Builder, Bricks und Oxygen Classic schaltet sich Cursora ab. Divi-Toggles, Tabs, Slider-Pfeile und der Button des mobilen Menüs gelten als klickbar, ebenso Video-Overlays von Elementor, Pfeile und Punkte von Swiper-Karussells, Kadence-Tabs, Slick-Slider-Punkte und WooCommerce-Galerie-Vorschaubilder – sie bekommen das Hover-Bild oder die Hand.

Warum erscheint an manchen Stellen der normale Pfeil oder ein anderer Zeiger?

Cursora respektiert Zeiger, die ein Theme oder Plugin bewusst setzt, etwa die Greif-Hand bei Slidern und Karten. Setzt ein Theme cursor: default auf einen ganzen Bereich, behält dieser Bereich den Standard-Pfeil. Links und Buttons – auch verlinkte Galeriebilder samt Text und Icons darin – zeigen das Hover-Bild oder die Hand. Deaktivierte Buttons und Formularfelder darin behalten ihren eigenen Zeiger, zum Beispiel das Verbotszeichen.

Der Zeiger erscheint nicht. Was lässt sich prüfen?

Zuerst den Seiten- und Optimierungs-Cache leeren. Dann prüfen, ob Cursora eingeschaltet ist, ein Bild gewählt ist und unter dem Bild kein Fehler steht, und ob der Schalter pro Seite in der Editor-Seitenleiste für diese Seite gesetzt ist. Auf Touch-Geräten, in Page-Builder-Editoren und im Kontrastmodus bleibt Cursora außerdem aus.

Macht Cursora die Website langsamer?

Nein. Der native Modus fügt ein paar Zeilen CSS und kein JavaScript hinzu. Der Effekt-Modus lädt ein kleines Stylesheet und ein kleines, verzögert geladenes Skript ohne Abhängigkeiten wie jQuery. Nichts wird von fremden Servern geladen.

Sehen Besucher am Smartphone den Zeiger?

Nein. Touch-Geräte haben keinen Mauszeiger, deshalb macht Cursora dort nichts.

Ist Cursora barrierearm?

Cursora behält in Formularfeldern den normalen Text-Cursor, zeigt über Links die Hand, solange kein Hover-Bild gewählt ist, schaltet Animationen für Besucher mit reduzierter Bewegung ab und versteckt den Zeiger nie, wenn Skript oder Bild nicht laden. Im Kontrastmodus (etwa den Kontrastdesigns von Windows) schaltet sich Cursora in beiden Modi ab, damit Besucher ihren eigenen, oft vergrößerten oder kontrastreichen System-Zeiger behalten.

Sammelt Cursora Daten oder lädt es externe Dateien?

Nein. Alles kommt von der eigenen Website.

Was passiert beim Löschen von Cursora?

Beim Deaktivieren bleiben die Einstellungen erhalten. Beim Löschen des Plugins (nicht nur Deaktivieren) entfernt Cursora seine Einstellungen, die erzeugten Zeigerbilder in uploads/cursora und den Schalter pro Seite. Die Bilder in der Mediathek bleiben unberührt. In einem Multisite-Netzwerk entfernt das Löschen nur die Daten der Hauptseite; die anderen Seiten des Netzwerks behalten ihre.