{"id":22893,"date":"2026-04-30T18:20:32","date_gmt":"2026-04-30T18:20:32","guid":{"rendered":"https:\/\/couponaffiliates.com\/?post_type=docs&p=22893"},"modified":"2026-04-30T18:25:13","modified_gmt":"2026-04-30T18:25:13","password":"","slug":"add-custom-columns-to-referred-orders-table","status":"publish","type":"docs","link":"https:\/\/couponaffiliates.com\/fr\/documents\/add-custom-columns-to-referred-orders-table\/","title":{"rendered":"Ajouter des colonnes personnalis\u00e9es au tableau \u201cCommandes r\u00e9f\u00e9renc\u00e9es\u201d (Fonction)"},"content":{"rendered":"

Par d\u00e9faut, le tableau des commandes r\u00e9f\u00e9renc\u00e9es dans le tableau de bord de l'affili\u00e9 affiche un ensemble fixe de colonnes telles que la date de la commande, le statut et la commission.<\/p>\n\n\n\n

Si vous souhaitez afficher des informations suppl\u00e9mentaires, telles qu'un champ personnalis\u00e9 collect\u00e9 lors du paiement, vous pouvez le faire \u00e0 l'aide d'un petit bout de code ajout\u00e9 \u00e0 la section functions.php<\/code> ou un plugin sp\u00e9cifique au site.<\/p>\n\n\n\n

Aucun fichier central ne doit \u00eatre modifi\u00e9, et la modification survivra aux mises \u00e0 jour des plugins.<\/p>\n\n\n\n

La version 7.8.0+ de Coupon Affiliates est n\u00e9cessaire.<\/strong><\/p>\n\n\n\n

\n\n\n\n

Comment cela fonctionne-t-il ?<\/h2>\n\n\n\n

Vous avez besoin de deux petits extraits de code :<\/p>\n\n\n\n

    \n
  1. Enregistrez votre colonne<\/strong> - indique au tableau l'intitul\u00e9 \u00e0 afficher.<\/li>\n\n\n\n
  2. Fournir la valeur<\/strong> - indique au tableau ce qu'il doit afficher dans cette colonne pour chaque commande.<\/li>\n<\/ol>\n\n\n\n

    Voil\u00e0, c'est fait. Voici un exemple complet et fonctionnel qui ajoute un \u201cNote \u00e0 l'attention des clients\u201d<\/strong> colonne affichant la note laiss\u00e9e par un client lors de son passage en caisse :<\/p>\n\n\n\n

    \/\/ Step 1 - Register the column heading\nadd_filter( 'wcusage_filter_referred_orders_custom_columns', function( $columns ) {\n    $columns['customer_note'] = array(\n        'label' => 'Customer Note',\n    );\n    return $columns;\n}, 10, 1 );\n\n\/\/ Step 2 - Display the value for each order row\nadd_filter( 'wcusage_filter_referred_orders_custom_column_value', function( $value, $column_key, $order ) {\n    if ( 'customer_note' !== $column_key ) {\n        return $value;\n    }\n\n    $note = $order->get_customer_note();\n\n    return '' !== $note ? esc_html( $note ) : '&mdash;';\n}, 10, 3 );<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    Afficher un champ de caisse personnalis\u00e9 \u00e0 la place<\/h2>\n\n\n\n
    Si vous avez collect\u00e9 un champ personnalis\u00e9 lors de la commande et que vous l'avez enregistr\u00e9 en tant que m\u00e9ta de la commande, remplacez le champ $order->get_customer_note()<\/code> pour $order->get_meta()<\/code> et transmettez la cl\u00e9 m\u00e9ta de votre champ. Par exemple, si votre champ est enregistr\u00e9 sous le nom de Date de livraison<\/code>:<\/p>\n\n\n\n
    \/\/ Step 1 - Register the column heading\nadd_filter( 'wcusage_filter_referred_orders_custom_columns', function( $columns ) {\n    $columns['delivery_date'] = array(\n        'label' => 'Delivery Date',\n    );\n    return $columns;\n}, 10, 1 );\n\n\/\/ Step 2 - Display the value for each order row\nadd_filter( 'wcusage_filter_referred_orders_custom_column_value', function( $value, $column_key, $order ) {\n    if ( 'delivery_date' !== $column_key ) {\n        return $value;\n    }\n\n    $date = $order->get_meta( '_delivery_date' );\n\n    return '' !== $date ? esc_html( $date ) : '&mdash;';\n}, 10, 3 );<\/code><\/pre>\n\n\n\n
    Vous ne savez pas quelle est la cl\u00e9 m\u00e9ta de votre champ ? Vous pouvez g\u00e9n\u00e9ralement la trouver en v\u00e9rifiant les param\u00e8tres de votre plugin de paiement, ou en regardant les d\u00e9tails de la commande dans WooCommerce > Commandes<\/strong> en utilisant un plugin comme WP Meta Inspector<\/a>.<\/p>\n\n\n\n
    \n\n\n\n
    Ajouter plusieurs colonnes \u00e0 la fois<\/h2>\n\n\n\n
    Vous pouvez enregistrer autant de colonnes que vous le souhaitez dans un seul extrait. Il suffit d'ajouter des lignes suppl\u00e9mentaires \u00e0 l'\u00e9tape 1, et de traiter chacune d'entre elles \u00e0 l'\u00e9tape 2 :<\/p>\n\n\n\n
    \/\/ \u00c9tape 1 - Enregistrer les en-t\u00eates de colonnes multiples\nadd_filter( 'wcusage_filter_referred_orders_custom_columns', function( $columns ) {\n    $columns['delivery_date'] = array('label' => 'Delivery Date' ) ;\n    $columns['purchase_order'] = array('label' => 'Purchase Order #' ) ;\n    return $columns ;\n}, 10, 1 ) ;\n\n\/\/ Etape 2 - Afficher la valeur de chaque colonne\nadd_filter( 'wcusage_filter_referred_orders_custom_column_value', function( $value, $column_key, $order ) {\n    switch ( $column_key ) {\n        case 'delivery_date' :\n            $v = $order->get_meta( '_delivery_date' ) ;\n            return $v ? esc_html( $v ) : '-' ;\n\n        case 'purchase_order' :\n            $v = $order->get_meta( '_purchase_order_number' ) ;\n            return $v ? esc_html( $v ) : '-' ;\n    }\n    return $value ;\n}, 10, 3 ) ;<\/code><\/pre>\n\n\n\n
    <\/p>","protected":false},"excerpt":{"rendered":"
    By default, the Referred Orders table in the affiliate dashboard shows a fixed set of columns like order date, status, and commission. If you’d like to display additional information – such as a custom field collected at checkout – you can do that with a small snippet of code added to your theme’s functions.php file […]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","footnotes":"","_links_to":"","_links_to_target":""},"doc_category":[136],"doc_tag":[],"class_list":["post-22893","docs","type-docs","status-publish","hentry","doc_category-developers","wpbf-post"],"year_month":"2026-05","word_count":504,"total_views":"8","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Elliot Sowersby","author_link":"#"},"doc_category_info":[{"term_name":"Developers","term_url":"https:\/\/couponaffiliates.com\/fr\/categorie-docs\/developpeurs\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":136,"label":"Developers"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/22893","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/comments?post=22893"}],"version-history":[{"count":5,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/22893\/revisions"}],"predecessor-version":[{"id":22900,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/docs\/22893\/revisions\/22900"}],"wp:attachment":[{"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/media?parent=22893"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/doc_category?post=22893"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/couponaffiliates.com\/fr\/wp-json\/wp\/v2\/doc_tag?post=22893"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}