Projekt

Allgemein

Profil

Inhalte die als deprecated markiert sind

Deprecation wurde eingeführt, um veraltete Inhalte, die über die ContentViews dem Smarty-Template zugewiesen werden als veraltet zu markieren und deren Verwendung zu unterdrücken.
Shopbetreiber (und auch Customizer), die mit solchen Inhalten arbeiten, haben so die Möglichkeit innerhalb eines deprecation-Zyklus', darauf zu reagieren und eine aktuellere Alternative zum veralteten Inhalt zu verwenden.
Die Dauer des deprecation-Zyklus' ist noch nicht klar festgelegt und wird sich vermutlich nach starken Templateänderungen oder Einführung eines neuen Basis-Templates richten. Sicher ist nur, dass ein solcher Zyklus in der Regel lang sein wird (> 1 Jahr).
Welche Inhalte eines ContentViews deprecated sind, ist am deprecated_array, das in der vererbenden Klasse ContentView deklariert wird, erkennbar. Es ist vorgesehen, dass alle ContentViews, die veraltete Inhalte beinhalten, die abstrakte Methode set_deprecated_array implementieren. In dieser kann gesammelt festgelegt werden, welche Inhalte veraltet sind.
Es ist möglich der set_content_data-Methode einen dritten Parameter (deprecation-Level) direkt zu übergeben. Dadurch wird der Inhalt ebenfalls im deprecated_array als veraltet markiert. Jedoch wird empfohlen, alle Einträge des deprecated_arrays gesammelt in der set_deprecated_array-Methode einzutragen.

Aufschlüsselung der deprecation-Levels:

  • '0' entsprcht stets der aktuellen, nicht veralteten Version
  • '1' entspricht Inhalten die ausschließlich für das Gambio-Template genutzt wurden
  • '2' wird der nächsten Veraltung entsprechen (vorraussichtlich EyeCandy-Inhalte, wenn sich ein neues Basis-Template durchsetzen sollte)

Bis zu welchem deprecation-Level ein Inhalt weiterhin unterstützt wird, ist in der Klasse 'ContentView' im Klassenattribut $v_min_deprecation_level zu sehen. Alle Inhalte, die mit einem deprecation-Level <= $v_min_deprecation_level markiert sind, werden dem Template nicht mehr übergeben. Ausnahme dabei stellt die '0' dar, da diese für die aktuelle Version steht.