CarbonFields est une bibliothèque PHP légère et facile à utiliser qui permet de créer des champs personnalisés pour les options de thème, les pages d’administration et les types de contenu personnalisés dans WordPress. Cette bibliothèque offre une syntaxe simple et intuitive pour ajouter des champs personnalisés à votre site WordPress sans avoir à écrire de code personnalisé complexe.

Dans cet article, nous allons expliquer comment créer des champs avec CarbonFields en utilisant des exemples pratiques pour vous montrer comment utiliser cette bibliothèque pour personnaliser votre site WordPress.

Installation et configuration de CarbonFields

Avant de pouvoir commencer à utiliser CarbonFields, vous devez l’installer et le configurer sur votre site WordPress. Pour ce faire, vous devez d’abord ajouter la bibliothèque à votre thème ou plugin, soit en la téléchargeant depuis le site officiel de CarbonFields, soit en l’installant via Composer si vous utilisez cette méthode de gestion des dépendances.

Une fois que vous avez ajouté CarbonFields à votre site, vous devez l’activer en ajoutant le code suivant à votre fichier functions.php : 


        Carbon_FieldsCarbon_Fields::boot();

Création d’un groupe de champs

La première étape pour créer des champs avec CarbonFields est de créer un groupe de champs. Un groupe de champs est une collection de champs qui seront affichés sur une page d’administration spécifique, un type de contenu personnalisé ou une option de thème.

Pour créer un groupe de champs, vous devez utiliser la méthode Container::make() de CarbonFields et spécifier le nom du groupe de champs, la position où il doit être affiché et les champs qui lui sont associés. Voici un exemple de création d’un groupe de champs : 


        Container::make( 'mon_groupe_de_champs', 'Options du thème' )
            ->add_fields( array(
                Field::make( 'text', 'mon_champ_texte', 'Mon champ texte' ),
                Field::make( 'textarea', 'mon_champ_textarea', 'Mon champ textarea' ),
                Field::make( 'select', 'mon_champ_select', 'Mon champ select' )
                    ->add_options( array(
                        'option_1' => 'Option 1',
                        'option_2' => 'Option 2',
                        'option_3' => 'Option 3',
                    ) ),
            ) );

Affichage des champs dans l’administration

Une fois que vous avez créé votre groupe de champs, vous devez l’afficher dans l’administration de WordPress pour pouvoir les utiliser. Pour cela, vous pouvez utiliser le hook carbon_fields_register_fields et spécifier la fonction de rappel qui sera exécutée lorsque l’administration est chargée. Dans cette fonction de rappel, vous pouvez utiliser la méthode Container::make() pour afficher votre groupe de champs.

Voici comment vous pouvez afficher votre groupe de champs dans l’administration : 


        add_action( 'carbon_fields_register_fields', function () {
            Container::make( 'mon_groupe_de_champs', 'Options du thème' )
                ->add_fields( array(
                    Field::make( 'text', 'mon_champ_texte', 'Mon champ texte' ),
                    Field::make( 'textarea', 'mon_champ_textarea', 'Mon champ textarea' ),
                    Field::make( 'select', 'mon_champ_select', 'Mon champ select' )
                        ->add_options( array(
                            'option_1' => 'Option 1',
                            'option_2' => 'Option 2',
                            'option_3' => 'Option 3',
                        ) ),
                ) );
        } );

Récupération des valeurs des champs

Une fois que vous avez créé vos champs et les avez affichés dans l’administration, vous pouvez récupérer leurs valeurs pour les utiliser où vous le souhaitez sur votre site WordPress. Pour cela, vous pouvez utiliser la méthode get_value() de CarbonFields en spécifiant l’ID du champ dont vous voulez récupérer la valeur.

Voici un exemple de récupération de la valeur d’un champ texte : 


        $mon_champ_texte = carbon_get_theme_option( 'mon_champ_texte' );
        echo $mon_champ_texte;

CarbonFields est une bibliothèque puissante qui simplifie la création et la gestion des champs personnalisés dans WordPress. Elle offre une syntaxe simple et intuitive pour ajouter des champs personnalisés à votre site WordPress sans avoir à écrire de code personnalisé complexe. Avec CarbonFields, vous pouvez personnaliser facilement votre site WordPress en ajoutant des champs personnalisés à vos options de thème, pages d’administration et types de contenu personnalisés.

Que ce soit pour créer des options de personnalisation pour votre thème, des champs supplémentaires pour vos pages d’administration ou des champs pour vos types de contenu personnalisés, CarbonFields est un outil puissant et flexible qui simplifie grandement le processus de création et de gestion des champs personnalisés dans WordPress.