wBrowseEdit::createButtonInsertNavpoint

Öffnet die Navigationsbearbeitung, um eine Seite, falls diese noch nicht verlinkt ist, hinzuzufügen.

Funktionsaufruf

String createButtonInsertNavpoint(String path = '', String caption = '', String title = '')

Parameter

pathNavigation
Pfad der zu bearbeitenden Navigation
navpointURL
URL des einzufügenden Navigationspunktes. Wenn dieser Wert leer ist, wird der Pfad der aktuellen Seite genutzt.
navpointTitle
Titel des einzufügenden Navigationspunktes. Wenn dieser Wert leer ist, wird der Titel der aktuellen Seite genutzt.
icon
Symbol der Schaltfläche
caption
Beschriftung der Schaltfläche
title
Titel der Schaltfläche
attributes
Weitere Attribute
id => String
ID der Schaltfläche
class => String
CSS Klasse
style => String
CSS Style

Beispiel: Button, um Seite in der Navigation zu verlinken

Quelltext

<?php

$pathNavigation = "/spin/wGlobal/content/navigations/standard.wNavigation.php"; // Pfad der zu bearbeitenden Navigation
$navpointURL    = ""; // URL des einzufügenden Navigationspunktes
$navpointTitle  = ""; // Titel des einzufügenden Navigationspunktes
$icon           = "add_navpoint"; // Symbol der Schaltfläche
$caption        = "In der Navigation verlinken"; // Bezeichnung der Schaltfläche
$title          = "Klicken Sie hier, um eine Datei hochzuladen"; // Titel der Schaltfläche
print wBrowseEdit::createButtonInsertNavpoint($pathNavigation, $navpointURL, $navpointTitle, $icon, $caption, $title);

?>

Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.

 
FAQs
Wozu dient wBrowseEdit::createButtonInsertNavpoint?
Die Funktion öffnet die Navigationsbearbeitung, um eine Seite hinzuzufügen, falls diese noch nicht verlinkt ist.
Wie lautet die Signatur von wBrowseEdit::createButtonInsertNavpoint?
<code class="codeInline">String createButtonInsertNavpoint(String path = '', String caption = '', String title = '')</code> (laut Doku).
Was bedeutet der Parameter „pathNavigation“?
<code class="codeInline">pathNavigation</code> ist der Pfad der zu bearbeitenden Navigation.
Welchen Zweck hat der Parameter „navpointURL“?
<code class="codeInline">navpointURL</code> ist die URL des einzufügenden Navigationspunktes. Wenn der Wert leer ist, wird der Pfad der aktuellen Seite genutzt.
Was passiert, wenn „navpointTitle“ leer ist?
Wenn <code class="codeInline">navpointTitle</code> leer ist, wird der Titel der aktuellen Seite als Titel für den Navigationspunkt verwendet.
Wofür steht „icon“ bei der Funktion?
<code class="codeInline">icon</code> ist das Symbol (Icon) der Schaltfläche, die für das Einfügen des Navigationspunkts ausgegeben wird.
Wofür sind „caption“ und „title“ vorgesehen?
<code class="codeInline">caption</code> ist die Beschriftung der Schaltfläche, und <code class="codeInline">title</code> ist der Titel der Schaltfläche (z. B. als Tooltip).
Welche Rolle spielen zusätzliche Parameter wie „class“ und „style“?
Zusätzliche Attribute steuern das Aussehen und Verhalten der Schaltfläche, z. B. <code class="codeInline">class</code> für die CSS-Klasse und <code class="codeInline">style</code> für CSS-Styles. Außerdem kann über <code class="codeInline">attributes</code> bzw. <code class="codeInline">id</code> eine konkrete <code class="codeInline">StringID</code> gesetzt werden.
Wie kann man mit der Funktion eine Seite in der Navigation verlinken?
Im Beispiel wird ein Pfad zur Navigation gesetzt (<code class="codeInline">$pathNavigation</code>), <code class="codeInline">navpointURL</code> und <code class="codeInline">navpointTitle</code> werden leer gelassen (damit aktuelle Seite genutzt wird), danach werden Icon, Caption und Title definiert und die Funktion ausgegeben: <pre><code class="codeBlock" style="color: #000000">php $pathNavigation = "/spin/wGlobal/content/navigations/standard.wNavigation.php"; $navpointURL = ""; $navpointTitle = ""; $icon = "add_navpoint"; $caption = "In der Navigation verlinken"; $title = "Klicken Sie hier, um eine Datei hochzuladen"; print wBrowseEdit::createButtonInsertNavpoint($pathNavigation, $navpointURL, $navpointTitle, $icon, $caption, $title); </code></pre>
Muss das Framework bei Einbindung in eine Weblication® Seite noch referenziert werden?
Wenn eine Funktion innerhalb einer Weblication® Seite z. B. über das PHP-Quelltext Element oder in einem XSL-Template über <code class="codeInline">wsl:php</code> eingebunden wird, muss das Framework über die <code class="codeInline">grid.php</code> nicht mehr referenziert werden.