Configuration

Le T32B est livré avec une configuration de base parfaitement fonctionnelle et cohérente, mais pour les besoins du projet, il peut être nécessaire de faire quelques ajustements.

Configuration de l'éditeur Gutenberg

La configuration de l'éditeur passe par 2 fichiers : config/blocks.php et le fichier theme.json

Gestion du theme.json

Dans la V2, la gestion du fichier theme.json est différente. La modification n'est plus à faire au niveau du fichier de configuration de votre preprocesseur mais directement dans le theme.json à la racine du thème. Vite.js va merger le fichier theme.json avec votre configuration tailwind.config.js pour générer un nouveau fichier theme.json dans le dossier public/build/assets.

Gestion des blocs Gutenberg

Activation et désactivation de blocs

Pour activer ou désactiver globalement des blocs Gutenberg, vous devez modifier le fichier config/blocks.php et l'index allowed_block_types.

return [
    ...
    'allowed_block_types' => [
        ... # block par défaut
        'acf/mon-bloc-perso' # activation du bloc dans l'éditeur
    ],
   ...
]

Ajout de variation

Dans la v2, l'ajout de variation se fait maintenant via php. Dans le fichier config/blocks.php, vous pouvez en ajouter via l'index styles

return [
    ...
    'styles' => [
        ...
        'core/button' => [
            ...
            'custom' => 'Personnalisé'
            ...
        ],
        ...
    ]   
    ...
]

Chargement forcé des fichiers css

Depuis la version 6.9 de WordPress, le chargement des styles de blocs est uniquement fait si le bloc est réellement utilisé. Cela améliore les performances de chargement de vos sites WordPress. Le souci, c'est que certains blocs peuvent être utilisé dans des pages sans éditeur Gutenberg. Vous devez donc forcer l'ajout des fichiers css de ces blocs.

return [
    ...
    'force_load_style' => [
        'columns',
        'buttons',
        'group',
    ],
    ...
]

Gestion des medias

La version 2 du thème introduit des outils natifs pour booster les performances de votre site WordPress, notamment via l’usage d’un CDN et la gestion du Lazyloading.

Configuration du CDN

Pour accélérer le chargement de vos médias, vous pouvez utiliser un CDN en définissant simplement l’hôte des fichiers :

• Configuration globale : Ajoutez la variable MEDIA_HOST dans le fichier .env à la racine de votre projet. Cette URL sera appliquée par défaut à l'ensemble du site.
• Cas particuliers (Multi thème) : Si vous avez besoin d'une URL spécifique par thème, vous pouvez surcharger cette valeur directement dans le fichier config/media.php.

Gestion du Lazyloading

Le fichier config/media.php vous permet également d'affiner le chargement différé (lazyloading) :

• Exclusion d'images : Vous pouvez lister les images à ne pas "lazyloader".
• Impact SEO & UX : Cette option est cruciale pour les images situées au-dessus de la ligne de flottaison (LCP - Largest Contentful Paint). En les excluant, elles s'affichent instantanément, ce qui améliore directement vos scores Google PageSpeed Insights.

Gestion des constantes

La gestion des constantes a complétement était révu dans la V2. Le fichier app/constantes.php a été supprimé et les options ont été déplacé dans app/Providers/ThemeServiceProvider.php.

Exemple

Ajouter une constante pour une page statique :

$config = app('config');

$config->set('app.options.[option_name]', [value]);

Récupérer cette constante :

config('app.options.[option_name]');