Fehleranalyse & Erweiterungen
Beim Bearbeiten eines ACF-FAQ-Feldes mit JCE traten JavaScript-Fehler rund um tfeditor und TinyMCE auf. Die Praxisnotiz beschreibt die Diagnose, die getestete Anpassung und das Risiko, dass ein Erweiterungsupdate die geänderte Datei wieder ersetzt.
Beobachtetes Fehlerbild
In der untersuchten Joomla-Konfiguration ließ sich ein ACF-FAQ-Feld mit aktiviertem JCE Editor nicht fehlerfrei bearbeiten. In der Browser-Konsole erschienen unter anderem diese Meldungen:
SyntaxError: import declarations may only appear at top level of a module
TypeError: tinyMCE.onAddEditor is undefinedDie Meldungen zeigen einen Konflikt in der Initialisierung des Editorfeldes. Sie beweisen für sich allein noch nicht, dass jede Kombination aus ACF FAQ und JCE betroffen ist.
Diagnose
In diesem Fall definierte die value.xml des ACF-FAQ-Feldes die Felder für Frage und Antwort mit dem Typ tfeditor. Nach dem Wechsel auf den Joomla-Feldtyp editor ließ sich der konfigurierte Standardeditor verwenden und der konkrete Konflikt trat in der geprüften Umgebung nicht mehr auf.
Getestete Anpassung
Vor der Änderung müssen Dateipfad, Erweiterungsversion und vorhandene Overrides dokumentiert werden. Anschließend wurde in der betroffenen value.xml für beide Felder nur der Typ geändert:
<field name="question" type="editor" ... />
<field name="answer" type="editor" ... />Danach wurden Joomla- und Browser-Cache geleert sowie das Bearbeiten, Speichern und erneute Öffnen vorhandener FAQ-Inhalte geprüft.
Wichtiger Hinweis zum Update-Risiko
Wird die XML-Datei direkt innerhalb der Erweiterung geändert, ist dieser Eingriff nicht automatisch updatesicher. Ein Update von ACF kann die Datei ersetzen. Die Änderung sollte deshalb in der Projektdokumentation stehen und nach jedem Update kontrolliert werden. Falls die eingesetzte Erweiterung einen belastbaren Override oder eine korrigierte Version anbietet, ist diese Lösung vorzuziehen.
Prüfliste
- Sicherung und Testumgebung vorhanden
- genauer Pfad und Ausgangsdatei dokumentiert
- bestehende FAQ-Inhalte vor und nach der Änderung verglichen
- Speichern mit JCE und dem Joomla-Standardeditor geprüft
- Browser-Konsole auf Folgefehler kontrolliert
- erneute Prüfung nach Erweiterungsupdates eingeplant
Wenn das Fehlerbild abweicht oder weitere Skripte beteiligt sind, sollte die Ursache zuerst reproduziert und der beteiligte Editor- beziehungsweise Erweiterungscode getrennt geprüft werden.