Verlinkungsverweise zwischen Dateien neu aufbauen

Nutzbar ab: Version

Veröffentlichungsdatum: 02. Mai 2016
Änderungsdatum: 18. Februar 2020

links verlinkungen verweis linkverweis aufbauen korrigieren rebuild verlinkungsneuaufbau linkaufbau

Für die Linkanpassung greift Weblication® auf die angelegten Linkverweise zurück, die Sie auch wieder neu aufbauen können.

Ab Weblication® CMS Version 11.x steht über das Weblication® Panel unter "Weitere Werkzeuge" das Werkzeug "Linkaufbau" zur Verfügung. Nutzen Sie ab CMS 11.x dieses Werkzeug, welches im Gegensatz zur nachfolgend genannten Funktion weiterentwickelt und optimiert wird.

Bedenken Sie bei den Verlinkungsangaben folgendes:
Eine Datei, welche keine Verlinkungsangaben besitzt, muss nicht zwangsläufig im Projekt nicht genutzt werden. Z.B. kann solch eine Datei über eine Liste, individuelle Skripte, o.ä. ohne direkte Verlinkung genutzt werden.

Für Querverlinkungen von Dateien nutzt Weblication® ein internes System für diese Verlinkungsangaben. Somit  bleibt beim Ändern von Links (z.B. beim Umbenennen und Speichern von Dateien) gewährleistet, dass alle Verweise korrekt auf den neu gesetzten Link angepasst werden.
Wichtige Voraussetzung dafür ist, daß die einzelnen Projekte (Inhaltsprojekt, Assetsprojekt, Globalprojekt) alle korrekt eingecheckt sind, was Sie über den Projekt-Report prüfen können.

Die Verlinkungen werden bei allen Aktionen, die über Weblication® stattfinden, gesetzt. Weblication® unabhängige Änderungen (z.B. via FTP) können nicht erfasst werden.

Um nicht mehr korrekte bzw. unvollständige Verlinkungsangaben für das Projekt zu korrigieren, können Sie durch Aufruf eines Skriptes die Verweise in den Link-Dateien neu aufbauen. Durch Angabe des globalen Projektpfades bei diesem Aufruf werden alle über das globale Projekt verknüpften Projekte erfasst (z.B. /de, /de-wAssets, /de-wGlobal).
Die in den Seiten enthaltenen Linktypen sollten hierfür korrekt gesetzt sein (siehe "Bedeutung des Typs von Elementen und Fragmenten"), damit die Querverweise erfasst werden können!

Rufen Sie - als Administrator eingeloggt - folgende URL auf und passen Sie die Pfade zuvor an Ihre lizenzierte Domain und Ihr globales Projektverzeichnis an:

Beispiel: URL zum Aufruf der Link-Reorganisierung / Verlinkungsneuaufbau

http://[lizenzierteDomain]/weblication/grid5/scripts/wProjectmanager.php?project=/[IHR-LAYOUT-PROJEKT]&action=rebuildLinks

<!--
Bei domain.dd und /de-wGlobal als globalem Projektverzeichnis z.B.:
-->
https://www.domain.dd/weblication/grid5/scripts/wProjectmanager.php?project=/de-wGlobal&action=rebuildLinks

Debug-Möglichkeiten

Ab Weblication® CMS Version 009.005.170.000 bietet die Debug-Funktion zu rebuildLinks weitergehende Möglichkeiten.

/logs wird als Verzeichnis beim Verlinkungsneuaufbau nun standardmäßig ausgeschlossen (z.B. Logs für actions, clicks, requests). Zudem kann dem Aufruf ein Projektverzeichnis mitgegeben werden, das beim Skriptdurchlauf ausgeschlossen wird.

Beispielhaft ein Aufruf (Domain und Pfade bitte an Ihr Projekt anpassen):

https://www.domain.dd/weblication/grid5/scripts/wProjectmanager.php?action=rebuildLinks&project=/de-wGlobal&projectExclude=/de-wGlobal&debug=1
  • action
    Parameter für die Aktion des Projektmanagers, welche beim Verlinkungsneuaufbau mit dem Wert rebuildLinks versehen werden muß.
  • project
    Parameter für die Angabe des globalen Projektverzeichnisses (z.B. /de-wGlobal).
    Alle mit diesem globalen Projekt verknüpften Inhalts- und Assetsprojekte werden beim Verlinkungsneuaubau mit berücksichtigt.
  • projectExclude
    Parameter für die Angabe eines Projektpfades, der vom Verlinkungsneuaubau ausgeschlossen werden soll.
    z.B.: /de-wGlobal um im globalen Projekt selber keine Anpassungen vorzunehmen.
  • debug
    Setzen Sie diesen Parameter auf 1, um weitergehende Debugausgaben zu Beginn der Skriptausgabe zu erhalten.
Ein Neuaufbau der Verlinkungsangaben kann auch separat für Projekte angestossen werden. Hierfür verwenden Sie die in den weiterführenden Links genannte Framework-Funktion wRepository::rebuildLinks . Beachten Sie dabei, daß sich der Neuaufbau nur auf Verlinkungen innerhalb des entsprechenden Projektes bezieht.
Bedeutung des Typs von Elementen und Fragmenten
PHP-Framework Funktoin: wRepository::rebuildLinks
Online-Dokumentation: Projekte-Report
FAQs
Ab welcher Weblication®-CMS-Version steht der optimierte Link-Neuaufbau über das Panel zur Verfügung?
Ab **Weblication® CMS Version 11.x** steht im Weblication® Panel unter **"Weitere Werkzeuge"** ein Werkzeug zum **Verlinkungsneuaufbau** zur Verfügung. Dieses Werkzeug ist gegenüber der nachfolgend genannten Funktion weiterentwickelt und optimiert.
Wie funktioniert der Verlinkungsneuaufbau in Weblication® grundsätzlich?
Weblication® greift für die Linkanpassung auf die **angelegten Linkverweise** zurück, die Sie bei Bedarf **neu aufbauen** können. Für Querverlinkungen verwendet Weblication® dabei ein **internes System**, sodass Verweise beim Umbenennen und Speichern von Dateien korrekt auf die neu gesetzten Links angepasst bleiben.
Was muss Voraussetzung dafür sein, dass Weblication® Verweise korrekt anpasst?
Damit die Verweise beim Ändern von Links korrekt angepasst werden, müssen die einzelnen Projekte **(Inhaltsprojekt, Assetsprojekt, Globalprojekt)** **alle korrekt eingecheckt** sein. Prüfen können Sie das über die entsprechende Stelle im System (im Text als „über den ... prüfen können“ beschrieben).
Welche Einschränkung gibt es beim Neuaufbau, wenn Änderungen außerhalb von Weblication® vorgenommen werden?
Verlinkungen werden bei allen Aktionen, die über **Weblication®** stattfinden, gesetzt. **Weblication® unabhängige Änderungen** (z.B. via **FTP**) können **nicht erfasst** werden, daher können Linkverweise danach veraltet sein.
Warum kann eine Datei ohne Verlinkungsangaben trotzdem im Projekt genutzt werden?
Eine Datei ohne Verlinkungsangaben muss nicht zwangsläufig im Projekt nicht genutzt werden. Sie kann z.B. über **Listen**, **individuelle Skripte** oder andere Mechanismen verwendet werden, auch ohne direkte Verlinkung.
Wie kann ich die Verweise in den Link-Dateien neu aufbauen, wenn sie unvollständig oder nicht mehr korrekt sind?
Sie können durch Aufruf eines **Skriptes** die Verweise in den **Link-Dateien neu aufbauen**. Dabei müssen Sie den **globalen Projektpfad** beim Aufruf angeben, sodass alle über das globale Projekt verknüpften Projekte erfasst werden (z.B. */de*, */de-wAssets*, */de-wGlobal*).
Welche Linktypen müssen für den Verweis-Neuaufbau korrekt gesetzt sein?
Die in den Seiten enthaltenen **Linktypen** sollten korrekt gesetzt sein (siehe im Dokument genannten Hinweis), damit die **Querverweise** beim Neuaufbau erfasst werden können.
Wie lautet der Beispielaufruf für die Link-Reorganisierung / den Verlinkungsneuaufbau?
Als Administrator einloggen und die URL aufrufen, dabei **Domain und Pfade** anpassen: <code class="codeInline">http://[lizenzierteDomain]/weblication/grid5/scripts/wProjectmanager.php?project=/[IHR-LAYOUT-PROJEKT]&action=rebuildLinks</code> Beispielhaft (angepasst): <code class="codeInline">https://www.domain.dd/weblication/grid5/scripts/wProjectmanager.php?project=/de-wGlobal&action=rebuildLinks</code>
Welche URL-Parameter sind beim Skriptaufruf für rebuildLinks relevant?
Wichtig sind u.a.: - **action**: muss auf **<code class="codeInline">rebuildLinks</code>** gesetzt sein. - **project**: Angabe des **globalen Projektverzeichnisses** (z.B. <code class="codeInline">/de-wGlobal</code>). Dadurch werden alle damit verknüpften Inhalts- und Assetsprojekte berücksichtigt.
Was bedeutet der Parameter projectExclude beim Debug- bzw. erweiterten rebuildLinks-Aufruf?
Mit **<code class="codeInline">projectExclude</code>** kann ein Projektpfad angegeben werden, der vom Skriptdurchlauf **ausgeschlossen** werden soll. Beispiel im Text: <code class="codeInline">projectExclude=/de-wGlobal</code>, um im globalen Projekt selber keine Anpassungen vorzunehmen.
Was ist die Debug-Funktion für rebuildLinks ab Weblication® CMS Version 009.005.170.000?
Ab **Weblication® CMS Version 009.005.170.000** bietet die Debug-Funktion zu **<code class="codeInline">rebuildLinks</code>** weitergehende Möglichkeiten. u.a. wird **<code class="codeInline">/logs</code>** beim Verlinkungsneuaufbau standardmäßig ausgeschlossen (z.B. Logs für actions, clicks, requests). Außerdem kann zusätzlich ein Projektverzeichnis über **projectExclude** ausgeschlossen werden. Mit **<code class="codeInline">debug=1</code>** erhalten Sie weitergehende Debugausgaben zu Beginn der Skriptausgabe.
Wie sieht ein beispielhafter Debug-Aufruf für rebuildLinks aus?
Beispiel (Domain und Pfade anpassen): <code class="codeInline">https://www.domain.dd/weblication/grid5/scripts/wProjectmanager.php?action=rebuildLinks&project=/de-wGlobal&projectExclude=/de-wGlobal&debug=1</code>
Kann der Neuaufbau der Verlinkungen auch separat nur für ein einzelnes Projekt angestoßen werden?
Ja. Dafür kann die **Framework-Funktion <code class="codeInline">wRepository::rebuildLinks</code>** verwendet werden. Dabei gilt: Der Neuaufbau bezieht sich **nur auf Verlinkungen innerhalb des entsprechenden Projektes** (keine übergreifenden Querverweise wie beim globalen Ansatz).