Skip to main content
Le panier est vide

Comment utiliser des éléments de contenu personnalisés et surchargés

Depuis la version 6.10 de FaLang, vous pouvez créer des éléments de contenu personnalisés et surcharger les éléments existants, sans modifier les fichiers livrés avec le composant.

Créer ou surcharger des éléments de contenu

  • Placez vos propres fichiers XML dans le sous-répertoire custom :

administrator/components/com_falang/contentelements/custom/

  • Les fichiers de custom/ sont chargés après les fichiers natifs. Si un fichier personnalisé déclare la même table qu’un élément natif, il le remplace entièrement. Il n’y a pas de fusion champ par champ.
  • Le répertoire custom/ accueille vos fichiers XML :
    • pour surcharger un élément natif, utilisez le même nom de fichier que l’original
    • pour ajouter l’élément d’un composant personnalisé, créez un nouveau fichier XML.
  • Le répertoire custom est créé lors de l'installation de la version 6.10
  • Assurez-vous que votre XML est bien formé et respecte la structure attendue (<falang type="contentelement">). Un fichier invalide dans custom/ est ignoré, et l’élément natif est alors utilisé à sa place. voir la documentation sur la création de content elements

Exemple

Voici un exemple de surcharge de l’élément de contenu de la table des articles, pour ajouter un champ à l’onglet de traduction.

1. Copiez le fichier de l’élément de contenu (content.xml) depuis le répertoire :

administrator/components/com_falang/contentelements/

2. Collez-le dans le répertoire (à créer si nécessaire) :

administrator/components/com_falang/contentelements/custom/

Conservez le même nom de fichier que le fichier natif. C’est ainsi que FaLang retrouve votre surcharge.

 Le fichier d’origine déclare les champs traduisibles :

<field type="titletext" name="title" translate="1">Title</field>
<field type="text" name="alias" translate="1">Alias</field>

Dans cet exemple, le champ metakey doit être ajouté à l’onglet de traduction de FaLang :

<field type="titletext" name="title" translate="1">Title</field>
<field type="text" name="alias" translate="1">Alias</field>
<field type="text" name="created_by_alias" length="50" maxlength="255" translate="1">Author Alias</field>

Le résultat de ces modifications est visible dans l’onglet de traduction de FaLang.

Bon à savoir

  • Mises à jour : le répertoire custom ne fait pas partie du paquet, il n’est donc pas écrasé lors d’une mise à jour de FaLang. Après une mise à jour, comparez votre surcharge avec le nouveau fichier natif, car vous pourriez manquer les nouveaux champs ajoutés par la mise à jour.
  • Sauvegarde : conservez tout de même une copie de votre répertoire custom, puisque c’est le seul endroit qui contient vos modifications.