Debug-Funktionen zu Listen, Navigationen, Vorschaubildern und CSS nutzen
Veröffentlichungsdatum: 25. Juli 2011
Änderungsdatum: 28. Juli 2022
debug debuggen ausgabe listen navigationen css picture rendering bildgrössenanpassung vorschaubilder thumbnails
Einblenden von Debug-Informationen für einen Administrator zu unterschiedlichen Funktionen.
Weblication® CMS ermöglicht es Ihnen als eingeloggter Administrator, zu diversen Funktionen nützliche Informationen ausgeben zu lassen. Wie Sie den jeweiligen Debug-Parameter aufrufen, ist zur jeweiligen Funktion nachfolgend beschrieben.
Hinweis:
Ab CMS-Version 7.x ermöglicht das Weblication® Panel einem Administrator im Bereich Werkzeuge direkt den Aufruf der Debug-Informationen (Listen, Navigationen, Generierte Bilder, CSS-Rendering).
Die Funktionen im Überblick:
Debug-Informationen zu Vorschaubildern
Als Administrator können Sie über ?debugThumbnail=1 die Generierung von Vorschaubildern kontrollieren.
Fügen Sie auf der Seite, auf welcher Vorschaubilder (Thumbnails) generiert werden, der URL den oben genannten Parameter hinzu, z.B.:
http://www.lizenzierteDomain.tld/base/index.php?debugThumbnail=1
Über den generierten Vorschaubildern der Seite wird Ihnen zu jedem erstellten Vorschaubild eine Debuginformation ausgegeben, z.B.:
generateThumbnail(/baseAssets/img/bild-gruen.jpg, 120, , default)
Beschreibung der Parameter zu generateThumbnail:
- Pfad
Pfad des Originalbildes - Breite
Breite des generierten Vorschaubildes in Pixel - Modus
Modus der Thumbnail-Funktion (zu wsl:thumbnail oder wThumbnail::createThumbnail)
Die Informationen ermöglichen Ihnen eine schnelle Kontrolle, welches Bild zugrundliegt, welcher mode verwendet wird und auf welche Breite das Bild generiert wurde.
(verfügbar ab Version 006.000.006.000)
Debug-Informationen zur Bildgrössenanpassung (CSS-Rendering)
Als Administrator können Sie über ?debugCSS=1 die Ermittlung der Spaltenbreiten über das CSS-Picture-Rendering einsehen.
Fügen Sie auf der Seite, auf welcher Bildgrössenanpassungen erfolgen, der URL den oben genannten Parameter hinzu, z.B.:
http://www.lizenzierteDomain.tld/base/index.php?debugCSS=1
Am Anfang der Seite wird Ihnen zu jedem angepassten Bild eine Debuginformation ausgegeben, z.B.:
wCSS::getWidthCol(/[IHR-LAYOUT-PROJEKT]/wGlobal/layout/styles/design.css, #blockContent .col2_50, width)
blockWidth(#blockContent):500
blockInnerDiff(#blockContentInner):-0
colWidthPercentage:50
blockInnerDiff(#blockContent .col2_50_inner):-10
width:240(240)
Zur entsprechenden Spalte wird Ihnen die Klasse mit der jeweiligen Breitenangabe, Differenzen und ggf. Prozentangaben ausgegeben.
Die Informationen ermöglichen Ihnen eine schnelle Kontrolle, welche Breiten für die Bildgrössenanpassung zugrundeliegen.
(verfügbar ab Version 005.067.054.000)
Debug-Informationen zu Listenparameter
Als Administrator können Sie Sie sich über ?debugList=1 die Listenparameter ausgeben lassen.
Fügen Sie auf der Seite, auf welcher eine Liste eingebunden ist, der URL den oben genannten Parameter hinzu, z.B.:
http://www.lizenzierteDomain.tld/base/index.php?debugList=1
Über der entsprechenden Weblication® Liste wird Ihnen eine Debuginformation ausgegeben, z.B.:
array(...) {
....
}
Zur
entsprechenden Liste werden Ihnen alle Listenparameter ausgegeben.
Die Informationen ermöglichen Ihnen eine schnelle Kontrolle, welche Parameter in der Liste verwendet werden.
(verfügbar ab Version 005.065.049.000)
Debug-Informationen zum Generieren von Navigationen
Als Administrator können Sie Sie sich über ?debugNavigation=1 die Navigations-ID (navid) ausgeben lassen,
Fügen Sie auf der Seite, auf welcher eine Liste eingebunden ist, der URL den oben genannten Parameter hinzu, z.B.:
http://www.lizenzierteDomain.tld/base/index.php?debugNavigation=1
Über die entsprechende Seite wird Ihnen eine Debuginformation ausgegeben, z.B. bei der Startseite des BASE Projektes:
getNavId(/base/wGlobal/content/navigations/all.wNavigation.php, /base/index.php?debugNavigation=1) (getNavIdNavConfigDOM = wNoNavpoint())
wNoNavpoint()
Auf Unterseiten mit Navigations-ID sieht eine Debug-Ausgabe dann z.B. wie folgt aus:
getNavId(/base/wGlobal/content/navigations/all.wNavigation.php, /base/unternehmen/index.php?debugNavigation=1) (getNavIdNavConfigDOM = 1243194933573)
1243194933573
Zur entsprechenden Navigation werden Ihnen somit die verwendete Navigation und die generierte navid ausgegeben.
(verfügbar ab Version 006.009.147.000)
- Wie kann ich als Administrator Debug-Informationen im Weblication® CMS anzeigen lassen?
- Als eingeloggter Administrator können Sie mithilfe spezieller URL-Parameter Debug-Informationen zu verschiedenen Funktionen ausgeben lassen. Die jeweiligen Debug-Parameter werden zu den einzelnen Funktionen beschrieben. Hinweis: Ab CMS-Version 7.x kann ein Administrator die Debug-Informationen im Weblication® Panel im Bereich **Werkzeuge** direkt aufrufen (Listen, Navigationen, generierte Bilder, CSS-Rendering).
- Wie aktiviere ich Debug-Informationen zur Thumbnail-/Vorschaubild-Generierung?
- Verwenden Sie den Parameter **<code class="codeInline">?debugThumbnail=1</code>**. Fügen Sie ihn auf der Seite hinzu, auf der Vorschaubilder generiert werden, z.B.: <code class="codeInline">http://www.lizenzierteDomain.tld/base/index.php?debugThumbnail=1</code>. Über den generierten Vorschaubildern wird pro erstelltetem Thumbnail eine Debuginformation ausgegeben, z.B. <code class="codeInline">generateThumbnail(/baseAssets/img/bild-gruen.jpg, 120, , default)</code>. Verfügbar ab Version **006.000.006.000**.
- Welche Parameter werden bei der Debug-Ausgabe für <code class="codeInline">generateThumbnail</code> angezeigt?
- Die Debug-Ausgabe beschreibt u.a.: **Pfad** des Originalbildes, **Breite** des generierten Vorschaubildes (in Pixel) sowie den **Modus** (z.B. <code class="codeInline">wsl:thumbnail</code> oder <code class="codeInline">wThumbnail::createThumbnail</code>). Damit können Sie schnell prüfen, welches Bild zugrunde liegt, welcher Modus verwendet wird und auf welche Breite generiert wurde.
- Wie kann ich Debug-Informationen zum CSS-Picture-Rendering bzw. zur Bildgrössenanpassung anzeigen lassen?
- Nutzen Sie den Parameter **<code class="codeInline">?debugCSS=1</code>**. Fügen Sie ihn auf der Seite hinzu, auf der die Bildgrössenanpassungen erfolgen, z.B.: <code class="codeInline">http://www.lizenzierteDomain.tld/base/index.php?debugCSS=1</code>. Am Anfang der Seite wird eine Debuginformation je angepasstem Bild ausgegeben. Dazu gehört u.a. die Breite der Spalte (inkl. Differenzen und ggf. Prozentangaben). Außerdem wird zur jeweiligen Spalte die Klasse mit Breitenangabe und Differenzen angezeigt. Verfügbar ab Version **005.067.054.000**.
- Welche Debug-Details erhalte ich bei <code class="codeInline">?debugCSS=1</code>?
- Sie sehen u.a. Angaben wie <code class="codeInline">blockWidth(...)</code>, <code class="codeInline">blockInnerDiff(...)</code>, <code class="codeInline">colWidthPercentage</code> sowie <code class="codeInline">width: ...</code>-Werte, die zeigen, wie die Breiten über das CSS-Picture-Rendering ermittelt werden. Zusätzlich wird zur entsprechenden Spalte eine Klasse mit Breitenangaben und ggf. Prozent-/Differenzwerten ausgegeben.
- Wie lasse ich mir Debug-Informationen zu Listenparametern anzeigen?
- Verwenden Sie den Parameter **<code class="codeInline">?debugList=1</code>**. Fügen Sie ihn auf der Seite hinzu, auf der eine Weblication® Liste eingebunden ist, z.B.: <code class="codeInline">http://www.lizenzierteDomain.tld/base/index.php?debugList=1</code>. Über der entsprechenden Liste wird eine Debug-Ausgabe (z.B. <code class="codeInline">array(...) { ... }</code>) ausgegeben, und es werden alle Listenparameter der jeweiligen Liste angezeigt. Verfügbar ab Version **005.065.049.000**.
- Was bringt es, <code class="codeInline">?debugList=1</code> zu verwenden?
- Sie können schnell kontrollieren, welche Parameter tatsächlich in der eingebundenen Liste verwendet werden (Liste-Parameter und deren Werte).
- Wie lasse ich mir Debug-Informationen für das Generieren von Navigationen ausgeben?
- Verwenden Sie den Parameter **<code class="codeInline">?debugNavigation=1</code>**. Fügen Sie ihn auf der Seite hinzu, auf der eine Liste eingebunden ist, z.B.: <code class="codeInline">http://www.lizenzierteDomain.tld/base/index.php?debugNavigation=1</code>. Es wird eine Debuginformation ausgegeben, die u.a. die **Navigations-ID (navid)** zeigt. Verfügbar ab Version **006.009.147.000**.
- Welche Navigation- und navid-Infos erhalte ich mit <code class="codeInline">?debugNavigation=1</code>?
- Auf der Startseite (Beispiel) wird z.B. die Ausgabe von <code class="codeInline">getNavId(...)</code> mit entsprechender nav-Config-DOM/<code class="codeInline">wNoNavpoint()</code> gezeigt. Auf Unterseiten wird die navid dann z.B. als konkreter Wert ausgegeben (z.B. <code class="codeInline">getNavId(... ) ... 1243194933573</code>). Damit sehen Sie, welche Navigation verwendet wurde und welche **navid** generiert wurde.