Ansicht für die Druckfunktion definieren
08. November 2019
weblication cms drucken druckfunktion druckversion ausdrucken druckansicht print
Für die Darstellung der Druckversion von Inhaltsseiten liefert die BASE bereits das entsprechende Template mit, das Sie an eigene Bedürfnisse anpassen können.
Die BASE Projektbasis liefert bereits im Standard die Funktion für die Druckansicht mit.
1. Aufruf der Druckansicht
Über die angesprochene Javascript-Funktion im Druckansicht-Link wird der Ansichtsmodus für die Druckansicht aufgerufen (viewmode=print).
In der BASE Classic erfolgt der Aufruf über die Metanavigation und den Navigationspunkt "Druckansicht":
Die BASE (Mobile First) hat dies im Standard nicht hinterlegt. So kann jeder selber für sein Projekt entscheiden, ob individuelle Anpassungen über "@media print" Angaben für die Browser-Druckfunktion definiert werden sollen, und/oder ggf. die Druckvorschau des Projektes genutzt werden soll.
2. JavaScript für die Druckvorschau
Als Link für diesen Navigationspunkt ist eine Javascript-Funktion hinterlegt. Dieser wird die Breite und Höhe des zu öffnenden Fensters der Druckansicht mitgegeben. Setzen Sie als Ziel "Aktuelles Fenster" (_self), da über die Javascript-Funktion die Druckansicht in einem Popup-Fenster geöffnet wird.
Beispiel: Linkziel des Druckansicht-Links
javascript:wOpenPrintPreview(800,600)
3. Definition und Einbindung der JavaScript-Funktion
Diese Javascript-Funktion ist in der ui.js definiert, welche mit jedem Projekt im Standard bereits mitgeliefert wird.
Die JS-Funktion erwartet unter anderem die Parameter Breite und Höhe für das Druckfenster und übergibt die aktuelle URL mit viewmode-Parameter an eine Popup-Funktion (wOpenPopupURL).
Beispiel: Auszug aus /[IHR-LAYOUT-PROJEKT]/wGlobal/layout/scripts/ui.js
////////////////////////////////////////////////////////////////
//
// @method void wOpenPrintPreview(url)
//
// @desc Öffnet die aktuelle Seite in der Druckvorschau
//
// @return void
//
////////////////////////////////////////////////////////////////
wOpenPrintPreview = function(width, height, name){
var name = name || 'printpreview';
var url = location.href.indexOf('?') == -1 ? location.href.replace(/#.*/, '') + '?viewmode=print' : location.href.replace(/#.*/, '') + '&viewmode=print';
options = ',location=no,menubar=no,toolbar=no,resizable=yes,scrollbars=yes,status=no';
wOpenPopupURL(url, width, height, name, options);
};In älteren Projekten war diese Funktion in der design.js definiert. Sollten Sie Änderungen in der über die ui.js definierten Funktion vornehmen wollen, gehen Sie am besten so vor, daß Sie eine eigene Funktion über die design.js abbilden, welche Sie dann ansprechen.
4. Ausgabetemplate für Druckansicht
Über die pre.php der BASE spricht Weblication® CMS das Ausgabetemplate für die Druckansicht an (print.wDocument.php), welches die für die Druckansicht aufgerufene Seite darstellt. Über diese für die Druckansicht optimierte Darstellung kann die Seite durch Klick auf den Button "Drucken" ausgedruckt werden.
Die Umsetzung des Druckansichttemplates liegt parallel zu den anderen Ansichts- und Bearbeitungstemplates ab und kann an individuelle Wünsche angepasst werden.
Das Template beinhaltet auch die Referenzierung zur CSS-Datei (print.css), über welche die Formatierung der Druckausgabe individuell beeinflusst werden kann.