Renommage des vues main-orientation

Cette page ne doit être appliquée que si le script de migration assistée vous demande de passer la migration manuelle code.20260702.SKIN-ODF-Orientation-RemoveMainOrientation

Les vues 'main-orientation' de la skin ODF Orientation n'existent plus.
Elles ont été renommées en 'main'.
Une charte graphique peut désormais définir ses propres vues. Il devient ainsi possible de faire cohabiter 2 chartes apportant chacune sa propre vue "main".

Surcharges des vue "main-orientation"

Dans le dossier WEB-INF/param/content-types/_override si la vue "main-orientation" d'un type de contenu ODF a été surchargée, vous devez déplacer cette surcharge dans le dossier content-types-views/_override de la charte déclinée.

Par exemple:

Dans le dossier WEB-INF/param/content-types/_override, le type de contenu "course" a été surchargé, avec de nouveaux attributs, et plusieurs vues redéfinies, dont la vue main-orientation :

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
  <!-- attributes -->
   <attribute name="..." ... />

   <!-- main view -->
   <view name="main">
       <item ref="title" />
       [...]
   </view>

   <!-- main-orientation view -->
   <view name="main-orientation">
       <item ref="keywords" />
       [...]
   </view>

   <!-- cart view -->
   <view name="cart">
       <item ref="description" />
       [...]
   </view>
</content-type>

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
  <!-- attributes -->
   <attribute name="..." ... />

   <!-- main view -->
   <view name="main">
       <item ref="title" />
       [...]
   </view>

   <!-- main-orientation view -->
   <view name="main-orientation">
       <item ref="keywords" />
       [...]
   </view>

   <!-- cart view -->
   <view name="cart">
       <item ref="description" />
       [...]
   </view>
</content-type>

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
  <!-- attributes -->
   <attribute name="..." ... />

   <!-- main view -->
   <view name="main">
       <item ref="title" />
       [...]
   </view>

   <!-- main-orientation view -->
   <view name="main-orientation">
       <item ref="keywords" />
       [...]
   </view>

   <!-- cart view -->
   <view name="cart">
       <item ref="description" />
       [...]
   </view>
</content-type>

Dans ce cas, il faut créer un dossier content-types-views/_override dans la skin, ajouter un fichier dont le nom est l'identifiant du type de contenu (le même que le fichier dans WEB-INF/param/content-types/_override), et y copier la surcharge de la vue "main-orientation", en la renommant "main" :

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
   <!-- main view -->
   <view name="main">
       <item ref="keywords" />
       [...]
   </view>
</content-type>

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
   <!-- main view -->
   <view name="main">
       <item ref="keywords" />
       [...]
   </view>
</content-type>

<content-type xmlns:cms="http://www.ametys.org/schema/cms">
   <!-- main view -->
   <view name="main">
       <item ref="keywords" />
       [...]
   </view>
</content-type>

Dans le fichier de surcharge du dossier WEB-INF/param/content-types/_override, supprimer la surcharge de la vue main-orientation.

Migration des surcharges de clés i18n

Si vous avez surchargé le libellé des onglets (tab, group, fieldset) au moyen d'un fichier de surcharge i18n WEB-INF/i18n/plugins/odf-orientation/messages_***.xml, votre surcharge ne sera plus prise en compte.

Les clés i18n du type PLUGINS_ODF_ORIENTATION_XXX_TAB|FIELDSET ont été renommées SKIN_ODF_ORIENTATION_XXX_TAB|FIELDSET par une migration automatique.

Commencer par déplacer ces clés dans le catalogue de la charte graphique.

La suite va dépendre de votre surcharge de vue :

• si vous avez surchargé la vue "main" (anciennement "main-orientation") entièrement, sans utiliser les attributs override/add-item, remove-item de la nouvelle syntaxe, vous n'avez rien à faire, vos surcharges de clés dans la skin seront prise en compte
• si vous avez surchargé la vue "main" (anciennement "main-orientation") avec la nouvelle syntaxe, tous les group / tab ou fieldset dont vous souhaitez surcharger le libellé doivent être redéfini entièrement pour que votre surcharge de clé soit prise en compte.

Migration des XSL de rendu

Aussi, il peut y avoir des XSL qui utilisaient les vues main-orientation, il faut maintenant utiliser la vue main.

Vous pourrez trouver des exemples de migration dans les modifications de la skin ODF Orientation pour le CMS-12659