XenForo 2.2 Importation/exportation d'archives de style, emplacements d'éléments de style et téléchargements d'éléments

Définition des emplacements des actifs pour les styles​

Restez concentré car cela demande quelques explications, mais cela en vaut la peine...

Avec XenForo 2.2, nous introduisons le concept d'emplacements d'actifs pour les styles, qui peuvent être utilisés pour définir des emplacements, généralement des répertoires, dans lesquels les actifs de votre style sont stockés.

Les actifs peuvent être n'importe quoi, une police, un fichier JavaScript, une image ou même un répertoire contenant plusieurs fichiers.

Voici un exemple de la façon dont vous pourriez configurer l'un de vos styles :


Ici, nous avons défini une clé d'actif appelée logos et pointée vers le répertoire styles/my_style.

Maintenant que cela est défini, vous êtes libre d'utiliser l'emplacement d'actif logos actif à divers endroits, y compris dans les templates avec la fonction de tempate asset('logos') et les propriétés de style à l'aide de l'espace réservé %ASSET:logos%.


Ces propriétés de style font désormais directement référence aux trois fichiers de logo dans le répertoire styles/my_style que nous avons défini comme emplacement d'actif. Si jamais nous modifions cet emplacement d'actif, il mettra automatiquement à jour ces trois propriétés de style pour pointer vers l'emplacement correct.

Les emplacements des ressources de style sont également extrêmement puissants pour les styles enfants. Vous aimeriez peut-être créer un dérivé de ce style, ce qui peut impliquer de modifier certaines propriétés et de modifier certains logos pour refléter vos modifications.

Par défaut, les styles enfants héritent des emplacements de ressources de style de leurs parents :


Tout comme les propriétés de style, vous pouvez personnaliser un emplacement de ressource existant dans un style ou vous pouvez ajouter des emplacements entièrement nouveaux. Tapez simplement dans un champ vide pour en ajouter un nouveau, ou cliquez sur l'icône en forme de crayon pour en modifier un existant :


Étant donné que les propriétés de style sont également héritées du parent et qu'elles utilisent l'actif logos, aucune modification ne doit être apportée aux propriétés de style elles-mêmes. Les logos seront désormais servis à partir du chemin d'accès aux ressources nouvellement défini.

Exporter les styles vers les archives​

VOICI MON CHEF-D'ŒUVRE.

La corvée​

Vous avez conçu un style XenForo de classe et, bien sûr, vous souhaitez le partager avec tout le monde. Auparavant, vous deviez exporter le fichier XML depuis votre panneau de contrôle d'administration et créer manuellement une archive zip contenant le fichier XML et tous les autres fichiers que vous souhaitez inclure - vous connaissez l'exercice.

Et s'il y avait un meilleur moyen ?​

Oubliez l'ancienne méthode. Vous pourrez désormais exporter votre style sous forme d'archive en sélectionnant cette option dans le menu "Plus d'options" de la liste des styles.



Et vous pourriez penser qu'il n'y a pas grand-chose de plus à dire à ce sujet, mais c'est vraiment là que le concept d'emplacements d'actifs Style prend tout son sens. L'archive inclura automatiquement les fichiers trouvés dans les emplacements de ressources personnalisés ou personnalisés du style.

Si vous exportez le style en tant que "Indépendant", il inclura également tous les éléments définis dans le style parent.
C'est pas mal non ? Mais qu'en est-il de l'importation de styles... ?

Importer des styles à partir d'archives​

Nous ne pourrions pas ajouter la prise en charge de l'exportation de styles en tant qu'archive si nous n'ajoutons pas également la prise en charge de l'importation à partir de ces mêmes archives, de sorte que tous les styles qui ont été exportés vers une archive peuvent désormais également être importés directement de cette archive.

Auparavant, les styles devaient être installés en téléchargeant manuellement les fichiers nécessaires au style, puis en téléchargeant séparément un fichier XML à partir du système "Importer le style" dans le panneau de configuration XenForo, mais avec XenForo 2.2, vous avez la possibilité de télécharger une archive zip pour importer le style et tous ses éléments directement depuis le panneau de configuration, sans avoir à jouer avec FTP (en supposant que le style que vous importez est disponible dans le nouveau format).

Pendant le processus d'importation, nous vérifions la liste des "emplacements des éléments de style". Si ces emplacements correspondent à des fichiers ou répertoires enregistrés dans l'archive, ils seront automatiquement déplacés vers un emplacement approprié.

Annuaire unifié​

Vous remarquerez peut-être que l'emplacement final des actifs n'est en fait pas exactement tel qu'il était lorsqu'il a été défini avant l'exportation du style.

Nous pouvons gérer la copie de fichiers installés à partir d'une archive de style quelque peu différemment de la façon dont nous gérons la copie de fichiers à partir d'une archive complémentaire. Pour les fichiers de style, notre seule exigence est que les fichiers se trouvent dans un emplacement accessible sur le Web et dans un emplacement dont nous savons qu'il est accessible en écriture par votre installation XF.

Pour éviter les problèmes d'autorisations de fichiers et pour garantir l'accessibilité des fichiers (tels que les images), le répertoire data convient parfaitement. Mais ce qui rend cela encore meilleur, c'est que vous êtes déjà en mesure de servir des fichiers dans le répertoire data à partir d'un CDN ou de le décharger vers une sorte de stockage de fichiers à distance cela vous permet donc potentiellement de réduire l'utilisation du disque, tout en servant des fichiers à partir d'un emplacement potentiellement plus rapide et géographiquement plus proche de vos visiteurs.

Les mises à niveau aussi​

L'importation d'un style à partir d'une archive peut également être utilisée pour mettre à niveau un style également. Comme toujours, il vous suffit d'importer le style et d'écraser celui existant.

Téléchargements d'éléments​

Bien qu'elle ne soit pas directement liée à l'importation ou à l'exportation de styles, cette nouvelle fonctionnalité s'inscrit définitivement dans la catégorie des changements qui devraient réduire votre besoin de télécharger manuellement des fichiers pour votre forum.

Il existe un certain nombre de zones dans votre panneau de contrôle d'administration qui vous obligent à saisir une URL, puis à télécharger manuellement un fichier à cet emplacement.

Quelques exemples :

• Images/sprites de réaction
• Images/sprites souriants
• Divers champs de propriété de style, par exemple les logos

Dans ces emplacements (et bien d'autres encore), vous pouvez désormais garder un œil sur les champs de saisie qui ressemblent à ceci :

Cliquer sur l'icône "télécharger" vous permet de parcourir les fichiers sur votre appareil et une fois sélectionné, le fichier sera téléchargé et remplira le chemin dans l'entrée.

Vous pouvez voir un exemple pratique de la façon dont cela fonctionne dans cette vidéo :

L'ajout de la prise en charge des champs de téléchargement d'éléments dans vos propres modules complémentaires est aussi simple que l'ajout d'un code similaire au suivant dans vos modèles :


L'attribut asset agit comme une clé qui détermine le répertoire où le fichier téléchargé sera stocké :

Donc, ce que nous avons ici est une suite complète d'outils pour permettre aux concepteurs de styles d'emballer beaucoup plus facilement les styles pour la distribution, couplée à un système remanié pour permettre à ces styles d'être importés directement depuis le panneau de contrôle sans avoir à s'embêter avec des téléchargements manuels à l'extérieur du contexte XenForo.

Le système d'actifs offre également la possibilité de gérer d'autres actifs de style depuis le panneau de contrôle, tels que les icônes de réaction et les smileys.

Nous n'avons rien contre les clients FTP, mais nous pensons que vous passerez beaucoup moins de temps à les utiliser une fois que vous aurez exécuté XenForo 2.2.

Invisibles pour les membres mais tellement utiles pour un administrateur et surtout un créateur de styles XF.
D'ailleurs à quand le premier style XenForo FR @Nicolas ?

J'y pense, j'ai déjà le nom : Dark side of the Blue
Actuellement j'ai trop de choses à faire sur XF FR avant de me lancer dans un nouveau style, mais ça viendra.

Est-ce vraiment nécessaire ?
Il y a plein d'extensions de navigateur pour naviguer en mode nuit automatiquement et ça fait très bien l'affaire !