<?php

if ( ! defined( 'ABSPATH' ) ) { exit; }

class AIEO_DMM_Contributors_Page extends AIEO_DMM_Module_Base {

	public function get_id()       { return 'contributors'; }
	public function get_icon()     { return 'users-round'; }
	public function get_label()    { return __( 'Contributors', 'ai-eshop-optimizer' ); }
	public function get_priority() { return 13; }
	public function get_group()    { return 'attribution'; }
	public function get_section()  { return 'sources'; }

	public function register_hooks() {
		add_action( 'wp_ajax_aieo_dmm_contributor_save', array( $this, 'ajax_save' ) );
		add_action( 'wp_ajax_aieo_dmm_contributor_delete', array( $this, 'ajax_delete' ) );
	}

	private function boot() {
		foreach ( array(
			'class-aieo-dmm-conversions-registry.php',
			'class-aieo-dmm-internal-promotions.php',
			'class-aieo-dmm-contributors.php',
		) as $f ) {
			$p = AIEO_DIR . 'includes/dmm/' . $f;
			if ( file_exists( $p ) ) { require_once $p; }
		}
		return class_exists( 'AIEO_DMM_Contributors' );
	}

	public function ajax_save() {
		AIEO_DMM::verify_ajax_request();
		if ( ! $this->boot() ) { wp_send_json_error( array( 'message' => 'registry unavailable' ) ); }
		$res = AIEO_DMM_Contributors::save_rule( array(
			'user_id'     => isset( $_POST['user_id'] ) ? (int) $_POST['user_id'] : 0,
			'match_field' => isset( $_POST['match_field'] ) ? sanitize_key( wp_unslash( $_POST['match_field'] ) ) : 'campaign',
			'match_type'  => isset( $_POST['match_type'] ) ? sanitize_key( wp_unslash( $_POST['match_type'] ) ) : 'contains',
			'match_value' => isset( $_POST['match_value'] ) ? sanitize_text_field( wp_unslash( $_POST['match_value'] ) ) : '',
			'label'       => isset( $_POST['label'] ) ? sanitize_text_field( wp_unslash( $_POST['label'] ) ) : '',
		) );
		if ( empty( $res['ok'] ) ) { wp_send_json_error( $res ); }
		wp_send_json_success( $res );
	}

	public function ajax_delete() {
		AIEO_DMM::verify_ajax_request();
		if ( ! $this->boot() ) { wp_send_json_error( array( 'message' => 'registry unavailable' ) ); }
		$ok = AIEO_DMM_Contributors::delete_rule( isset( $_POST['id'] ) ? (int) $_POST['id'] : 0 );
		if ( ! $ok ) { wp_send_json_error( array( 'message' => __( 'Could not delete.', 'ai-eshop-optimizer' ) ) ); }
		wp_send_json_success( array( 'message' => __( 'Removed. Credit is recalculated on the next page load.', 'ai-eshop-optimizer' ) ) );
	}

	public function render_subtab() {
		if ( ! $this->boot() ) {
			list( $aieo_ct_open, $aieo_ct_close ) = AIEO_DMM_UI::card( array( 'icon' => 'users-round', 'title' => $this->get_label() ) );
			echo $aieo_ct_open; 
			echo \Rooster\Admin\Ui::notice( esc_html__( 'The conversions registry is not loaded.', 'ai-eshop-optimizer' ), 'destructive', array( 'inline' => true ) ); 
			echo $aieo_ct_close; 
			return;
		}

		
		$days  = isset( $_GET['pdays'] ) ? (int) $_GET['pdays'] : 90;
		$until = gmdate( 'Y-m-d H:i:s' );
		$since = $days > 0 ? gmdate( 'Y-m-d H:i:s', time() - $days * DAY_IN_SECONDS ) : '1970-01-01 00:00:00';

		$board = AIEO_DMM_Contributors::leaderboard( $since, $until );
		$rec   = AIEO_DMM_Contributors::reconcile( $since, $until );
		$open  = AIEO_DMM_Contributors::unassigned( $since, $until, 60 );
		$rules = AIEO_DMM_Contributors::rules();

		
		
		
		$band = function_exists( 'rooster_admin_band_open' );
		if ( $band ) {
			rooster_admin_band_open( array( 'cols' => 2 ) );
		}
		$this->card_assign( $open );
		$this->card_unclaimed( $open, $rec );
		if ( $band ) {
			rooster_admin_band_close();
			rooster_admin_band_open( array( 'cols' => 2 ) );
		}
		$this->card_rules( $rules );
		$this->card_board( $board, $rec );
		if ( $band ) {
			rooster_admin_band_close();
		}
		$this->card_macros();
		$this->print_script();
	}

	private function card_assign( $open ) {
		
		
		
		
		$aieo_ct_form = 'aieo-card-contributors-assign-a-campaign-value-form';
		list( $aieo_ct_open, $aieo_ct_close ) = AIEO_DMM_UI::card( array(
			'anchor'      => 'contributors-assign-a-campaign-value',
			'icon'        => 'pencil-line',
			'title'       => __( 'Assign a campaign value', 'ai-eshop-optimizer' ),
			'description' => __(
				'A contributor is a person or partner whose campaign brings you business. There is no enrolment and no keys: you point an existing campaign value at a WordPress user and all of that value\'s history credits to them immediately. Credit is resolved when the report runs and is never stamped onto the order, so assigning, reassigning and removing are all retroactive and reversible. Reporting only, no commissions or payouts.',
				'ai-eshop-optimizer'
			),
			'tools'       => '<a class="rooster-admin-button" href="' . esc_url( admin_url( 'admin.php?page=ai-eshop-dmm&dmm_tab=promotions' ) ) . '">' . esc_html__( 'Back to Promotions', 'ai-eshop-optimizer' ) . '</a>',
			'footer'      => \Rooster\Admin\States::save_button( $aieo_ct_form, array( 'label' => __( 'Assign', 'ai-eshop-optimizer' ) ) ),
			'col'         => 1,
		) );
		echo $aieo_ct_open; 
		echo \Rooster\Admin\Guidance::text( __( 
			'Prefer "contains" with the person\'s name. That is not a shortcut: the same campaign is often typed several ways, and on one live site a single contributor\'s campaign appears three ways with the separator lost in one of them. Matching on the name unifies all three, while exact matching would split one person into two.',
			'ai-eshop-optimizer'
		) );

		$aieo_ct_rows = '';
		
		
		
		
		
		
		
		
		
		
		
		
		$aieo_ct_rows .= \Rooster\Admin\Ui::field_row( array(
			'id'      => 'aieo-ct-user',
			'label'   => __( 'Contributor', 'ai-eshop-optimizer' ),
			'control' => '<select name="user_id" id="aieo-ct-user" class="aieo-dmm-user-select rooster-admin-select rooster-admin-select--medium" data-placeholder="' . esc_attr__( 'Search users by name or email…', 'ai-eshop-optimizer' ) . '"><option value=""></option></select>',
			'help'    => __( 'Any WordPress user can be a contributor. They do not need to log in for their figures to be recorded.', 'ai-eshop-optimizer' ),
		) );

		$aieo_ct_value = \Rooster\Admin\Ui::input( 'match_value', '', array( 'id' => 'aieo-ct-value', 'medium' => true, 'placeholder' => __( 'e.g. Thanasis', 'ai-eshop-optimizer' ) ) );
		if ( $open ) {
			
			
			
			
			
			
			$aieo_ct_pick_label = __( '— or copy from the worklist (utm_campaign values) —', 'ai-eshop-optimizer' );
			$aieo_ct_pick       = '<select id="aieo-ct-pick" class="rooster-admin-select" aria-label="' . esc_attr( $aieo_ct_pick_label ) . '"><option value="">' . esc_html( $aieo_ct_pick_label ) . '</option>';
			foreach ( $open as $o ) {
				if ( '' !== $o['rejected_reason'] ) { continue; }
				$aieo_ct_pick .= '<option value="' . esc_attr( $o['value'] ) . '">' . esc_html( $o['value'] ) . ' (' . esc_html( number_format_i18n( (int) $o['conversions'] ) ) . ')</option>';
			}
			$aieo_ct_pick .= '</select>';
			$aieo_ct_value = '<div class="rooster-admin-row">' . $aieo_ct_value . $aieo_ct_pick . '</div>'; 
		}
		$aieo_ct_rows .= \Rooster\Admin\Ui::field_row( array(
			'id'      => 'aieo-ct-value',
			'label'   => __( 'Value to match', 'ai-eshop-optimizer' ),
			'control' => $aieo_ct_value,
		) );

		$aieo_ct_fields = array(
			'campaign' => __( 'utm_campaign (recommended)', 'ai-eshop-optimizer' ),
			'content'  => 'utm_content',
			'term'     => 'utm_term',
			'medium'   => 'utm_medium',
			'source'   => 'utm_source',
		);
		$aieo_ct_types  = array(
			'contains'    => __( 'contains (recommended)', 'ai-eshop-optimizer' ),
			'exact'       => __( 'exactly equals', 'ai-eshop-optimizer' ),
			'starts_with' => __( 'starts with', 'ai-eshop-optimizer' ),
		);
		$aieo_ct_rows .= \Rooster\Admin\Ui::field_row( array(
			'id'    => 'aieo-ct-match',
			'label' => __( 'Match on', 'ai-eshop-optimizer' ),
			'parts' => array(
				array( 'label' => __( 'Field', 'ai-eshop-optimizer' ), 'id' => 'aieo-ct-field', 'control' => \Rooster\Admin\Ui::select( 'match_field', $aieo_ct_fields, 'campaign', array( 'id' => 'aieo-ct-field', 'aria-label' => __( 'Match on', 'ai-eshop-optimizer' ) . ', ' . __( 'Field', 'ai-eshop-optimizer' ) ) ) ),
				array( 'label' => __( 'Rule', 'ai-eshop-optimizer' ), 'id' => 'aieo-ct-type', 'control' => \Rooster\Admin\Ui::select( 'match_type', $aieo_ct_types, 'contains', array( 'id' => 'aieo-ct-type', 'aria-label' => __( 'Match on', 'ai-eshop-optimizer' ) . ', ' . __( 'Rule', 'ai-eshop-optimizer' ) ) ) ),
			),
		) );
		
		echo AIEO_DMM_UI::card_form( 'aieo_dmm_contributor_save', 'contributors', $aieo_ct_form, '<div class="rooster-admin-fields">' . $aieo_ct_rows . '</div>' ); 
		echo $aieo_ct_close; 
	}

	
	private function state_card( $anchor, $icon, $title, $col, $state, $description = '' ) {
		list( $aieo_ct_open, $aieo_ct_close ) = AIEO_DMM_UI::card( array(
			'anchor'      => $anchor,
			'icon'        => $icon,
			'title'       => $title,
			'description' => $description,
			'col'         => $col,
		) );
		echo $aieo_ct_open . $state . $aieo_ct_close; 
	}

	
	private function card_unclaimed( $open, $rec ) {
		$desc = __( 'Campaign values recorded in this period that are not credited to anyone yet, ready to assign with the form.', 'ai-eshop-optimizer' );
		
		if ( empty( $open ) ) {
			$this->state_card(
				'contributors-unclaimed-values-in-this-period',
				'list-filter',
				__( 'Unclaimed values in this period', 'ai-eshop-optimizer' ),
				2,
				\Rooster\Admin\States::from(
					array( 'total' => isset( $rec['total'] ) ? (int) $rec['total'] : 0, 'shown' => 0 ),
					array(
						'all-done'  => array( 'text' => __( 'Nothing unclaimed.', 'ai-eshop-optimizer' ) ),
						'first-use' => array( 'title' => __( 'Nothing unclaimed.', 'ai-eshop-optimizer' ) ),
					)
				),
				$desc
			);
			return;
		}
		
		
		
		$unclaimed = array();
		foreach ( (array) $open as $o ) {
			$bad = '' !== $o['rejected_reason'];
			$unclaimed[] = array(
				'value'       => (string) $o['value'],
				'conversions' => (int) $o['conversions'],
				'revenue'     => (float) $o['revenue'],
				'status'      => $bad
					? $this->reason_label( $o['rejected_reason'] )
					: __( 'assignable', 'ai-eshop-optimizer' ),
				'assignable'  => ! $bad,
			);
		}
		AIEO_Table::card( array(
			'anchor'  => 'contributors-unclaimed-values-in-this-period',
			'icon'    => 'list-filter',
			'heading' => 'h2',
			'title'   => __( 'Unclaimed values in this period', 'ai-eshop-optimizer' ),
			'description' => $desc,
			'col'     => 2,
			'narrow'  => true, 
			'page_id' => $this->get_id(),
			'row_key' => 'value',
			'rows'    => $unclaimed,
			'empty'   => __( 'Nothing unclaimed.', 'ai-eshop-optimizer' ),
			'columns' => array(
				array( 'key' => 'value', 'label' => _x( 'Value', 'the value of a field', 'ai-eshop-optimizer' ), 'type' => 'code' ),
				array( 'key' => 'conversions', 'label' => __( 'Conversions', 'ai-eshop-optimizer' ), 'type' => 'integer' ),
				array( 'key' => 'revenue', 'label' => __( 'Revenue', 'ai-eshop-optimizer' ), 'type' => 'money' ),
				array(
					'key'    => 'status',
					'label'  => __( 'Status', 'ai-eshop-optimizer' ),
					'type'   => 'badge',
					'format' => array( 'map' => array( __( 'assignable', 'ai-eshop-optimizer' ) => 'success' ) ),
				),
			),
			'actions' => array(
				array(
					'id'      => 'use',
					'label'   => __( 'Use', 'ai-eshop-optimizer' ),
					'description' => __( 'Opens the assignment form with this value filled in.', 'ai-eshop-optimizer' ),
					'variant' => 'secondary',
					'hook'    => 'aieo-ct-use',
					'visible' => static function ( $r ) { return ! empty( $r['assignable'] ); },
					'data'    => array( 'v' => 'value' ),
				),
			),
		) );
	}

	
	private function print_script() {
		$nonce = wp_create_nonce( AIEO_DMM::NONCE_ACTION );
		?>
		<script>
		document.addEventListener('DOMContentLoaded', function(){
			var val = document.getElementById('aieo-ct-value');

			/* A VALUE COPIED FROM THE WORKLIST CARRIES ITS FIELD WITH IT.
			 *
			 * Both sources below serve `canon_campaign` values and nothing else
			 * (AIEO_DMM_Contributors::unassigned). "Match on" is a separate
			 * control that keeps whatever it was last left at, so copying a
			 * campaign string while it reads utm_content built a rule that could
			 * never match — and nothing said so: it saved, it listed, it simply
			 * credited no one. Carrying the field over makes the pair correct by
			 * construction; it is still free to change afterwards. */
			function useValue(v){
				val.value = v;
				val.dispatchEvent(new Event('input', {bubbles: true}));
				var f = document.getElementById('aieo-ct-field');
				if (f) { f.value = 'campaign'; f.dispatchEvent(new Event('change', {bubbles: true})); }
			}
			document.querySelectorAll('.aieo-ct-use').forEach(function(b){
				b.addEventListener('click', function(){ useValue(b.getAttribute('data-v')); val.focus(); });
			});
			var pick = document.getElementById('aieo-ct-pick');
			if (pick) { pick.addEventListener('change', function(){ if (pick.value) { useValue(pick.value); } }); }
			function post(action, data, done){
				data.action = action; data.nonce = '<?php echo esc_js( $nonce ); ?>';
				var body = new URLSearchParams(data);
				fetch(ajaxurl, {method:'POST', credentials:'same-origin', body: body})
					.then(function(r){ return r.json(); }).then(done)
					.catch(function(){ if (window.roosterAdmin && roosterAdmin.toast) { roosterAdmin.toast('Network error.', 'destructive'); } });
			}
			/* Assign is the card's own Save (the library's, answered by dmm.js with aieo_dmm_contributor_save): it says Saved or
			 * the handler's refusal in the footer, and the list shows the new mapping after a reload. */
			var assign = document.getElementById('aieo-card-contributors-assign-a-campaign-value-form');
			if (assign) { assign.addEventListener('rooster-admin:saved', function(){ setTimeout(function(){ location.reload(); }, 900); }); }
			/* Remove: the mappings table asks its own question (the action's confirm) and, once it is answered Yes, announces the
			 * action as aieo-table:action. The button also asked here, so every removal was confirmed twice (and the second
			 * answer changed nothing: the request had gone already). */
			document.addEventListener('aieo-table:action', function(e){
				var b = e.detail && e.detail.button;
				if (!b || !b.classList.contains('aieo-ct-del')) { return; }
				post('aieo_dmm_contributor_delete', {id: b.getAttribute('data-id')}, function(){ location.reload(); });
			});
		});
		</script>
		<?php
	}

	private function card_rules( $rules ) {
		$desc = __( 'The rules that credit a person when a campaign\'s UTM value matches, as added with the form.', 'ai-eshop-optimizer' );
		
		if ( empty( $rules ) ) {
			$this->state_card(
				'contributors-current-mappings',
				'table-properties',
				__( 'Current mappings', 'ai-eshop-optimizer' ),
				1,
				\Rooster\Admin\States::state( 'first-use', array( 'title' => __( 'No mappings yet.', 'ai-eshop-optimizer' ) ) ),
				$desc
			);
			return;
		}
		$rows = array();
		foreach ( (array) $rules as $r ) {
			$u      = get_userdata( (int) $r['user_id'] );
			$rows[] = array(
				'id'    => (int) $r['id'],
				'who'   => $u ? $u->display_name : '#' . $r['user_id'],
				'rule'  => 'utm_' . esc_html( $r['match_field'] ) . ' <em>' . esc_html( str_replace( '_', ' ', $r['match_type'] ) ) . '</em> <code>' . esc_html( $r['match_value'] ) . '</code>',
				'added' => substr( (string) $r['created_at'], 0, 10 ),
			);
		}
		AIEO_Table::card( array(
			'anchor'  => 'contributors-current-mappings',
			'icon'    => 'table-properties',
			'heading' => 'h2',
			'title'   => __( 'Current mappings', 'ai-eshop-optimizer' ),
			'description' => $desc,
			'col'     => 1,
			'narrow'  => true,
			'page_id' => $this->get_id(),
			'row_key' => 'id',
			'rows'    => $rows,
			'filters' => array( array( 'key' => 'who', 'label' => __( 'Contributor', 'ai-eshop-optimizer' ), 'kind' => 'values', 'control' => 'select' ) ),
			'empty'   => __( 'No mappings yet.', 'ai-eshop-optimizer' ),
			'columns' => array(
				array( 'key' => 'who', 'label' => __( 'Contributor', 'ai-eshop-optimizer' ) ),
				array( 'key' => 'rule', 'label' => __( 'Rule', 'ai-eshop-optimizer' ), 'type' => 'prose' ),
				array( 'key' => 'added', 'label' => __( 'Added', 'ai-eshop-optimizer' ) ),
			),
			'actions' => array(
				array(
					'id'          => 'remove',
					'label'       => __( 'Remove', 'ai-eshop-optimizer' ),
					'description' => __( 'Deletes this mapping and recalculates the credit straight away.', 'ai-eshop-optimizer' ),
					'variant'     => 'secondary',
					'hook'        => 'aieo-ct-del',
					'destructive' => true,
					'confirm_noun' => __( 'mapping', 'ai-eshop-optimizer' ),
					'confirm_name' => 'who', 
					'confirm'     => __( 'Credit is recalculated immediately.', 'ai-eshop-optimizer' ),
					'data'        => array( 'id' => 'id' ),
				),
			),
		) );
	}

	private function card_board( $board, $rec ) {
		$rows = array();
		foreach ( (array) $board as $b ) {
			$u      = get_userdata( (int) $b['user_id'] );
			$rows[] = array(
				'user'      => $u ? $u->display_name : '#' . $b['user_id'],
				'leads'     => (int) $b['leads'],
				'orders'    => (int) $b['orders'],
				'revenue'   => (float) $b['revenue'],
				'campaigns' => (int) $b['campaigns'],
				'last_seen' => substr( (string) $b['last_seen'], 0, 10 ),
			);
		}
		
		
		$recon = \Rooster\Admin\Ui::notice(
			'<strong>' . esc_html__( 'Reconciliation:', 'ai-eshop-optimizer' ) . '</strong> '
			. esc_html( sprintf(
				
				__( '%1$s credited + %2$s unassigned + %3$s not creditable = %4$s conversions carrying an external promotion.', 'ai-eshop-optimizer' ),
				number_format_i18n( $rec['credited'] ), number_format_i18n( $rec['unassigned'] ),
				number_format_i18n( $rec['rejected'] ), number_format_i18n( $rec['total'] )
			) ),
			$rec['balanced'] ? 'success' : 'destructive',
			array( 'inline' => true )
		);
		list( $aieo_ct_open, $aieo_ct_close ) = AIEO_DMM_UI::card( array(
			'anchor' => 'contributors-what-each-contributor-brought',
			'description' => __( 'The leads, orders and revenue credited to each person in this period through their campaign mappings.', 'ai-eshop-optimizer' ),
			'icon'   => 'banknote',
			'title'  => __( 'What each contributor brought', 'ai-eshop-optimizer' ),
			'flush'  => true,
			'footer' => $recon,
			'col'    => 2,
		) );
		echo $aieo_ct_open; 
		if ( empty( $rows ) ) {
			
			echo \Rooster\Admin\States::state( 'first-use', array( 'title' => __( 'Nothing credited yet.', 'ai-eshop-optimizer' ) ) ); 
			echo $aieo_ct_close; 
			return;
		}
		AIEO_Table::render( array(
			'narrow'  => true,
			'page_id' => $this->get_id(),
			'row_key' => 'user',
			'rows'    => $rows,
			'empty'   => __( 'Nothing credited yet.', 'ai-eshop-optimizer' ),
			'columns' => array(
				array( 'key' => 'user', 'label' => __( 'Contributor', 'ai-eshop-optimizer' ) ),
				array( 'key' => 'leads', 'label' => __( 'Leads', 'ai-eshop-optimizer' ), 'type' => 'integer' ),
				array( 'key' => 'orders', 'label' => __( 'Orders', 'ai-eshop-optimizer' ), 'type' => 'integer' ),
				array( 'key' => 'revenue', 'label' => __( 'Revenue', 'ai-eshop-optimizer' ), 'type' => 'money' ),
				array( 'key' => 'campaigns', 'label' => __( 'Campaigns', 'ai-eshop-optimizer' ), 'type' => 'integer' ),
				array( 'key' => 'last_seen', 'label' => __( 'Last seen', 'ai-eshop-optimizer' ) ),
			),
		) );
		echo $aieo_ct_close; 
	}

	
	private function card_macros() {
		list( $aieo_ct_open, $aieo_ct_close ) = AIEO_DMM_UI::card( array(
			'anchor'      => 'contributors-how-to-tag-your-ad-urls-and-the-mistake-to-avoid',
			'icon'        => 'hash',
			'title'       => __( 'UTM parameters in ad URLs', 'ai-eshop-optimizer' ),
			'description' => __(
				'A value shown as "unexpanded macro" means the ad platform sent the placeholder text itself instead of substituting the real campaign name. Nothing can be credited from it, because every ad in the account arrives under the identical literal string.',
				'ai-eshop-optimizer'
			),
		) );
		echo $aieo_ct_open; 

		
		
		$aieo_ct_braces = __( 'Meta (Facebook / Instagram) uses DOUBLE braces. Google Ads uses SINGLE braces. They are different systems and the syntax is not interchangeable.', 'ai-eshop-optimizer' );
		echo \Rooster\Admin\Guidance::text( $aieo_ct_braces, 'guidance', array( 'html' => '<strong>' . esc_html( $aieo_ct_braces ) . '</strong>', 'question' => __( 'Which braces does each platform use?', 'ai-eshop-optimizer' ) ) ); 

		echo rooster_admin_card_section_html( 
			__( 'Meta: dot, not underscore', 'ai-eshop-optimizer' ),
			array(
				'id'          => 'aieo-card-contributors-meta-dot-not-underscore',
				'description' => __(
					'This is the trap. Meta names its campaign, ad-set and ad parameters with a DOT. Written with an underscore they are not recognised and Meta passes the text through untouched. Only site_source_name and placement use no dot.',
					'ai-eshop-optimizer'
				),
			)
		);
		
		
		$macros = array();
		foreach ( array(
			'{{campaign_name}}' => '{{campaign.name}}',
			'{{adset_name}}'    => '{{adset.name}}',
			'{{adset_id}}'      => '{{adset.id}}',
			'{{ad_name}}'       => '{{ad.name}}',
			'{{ad_id}}'         => '{{ad.id}}',
		) as $bad => $good ) {
			$macros[] = array( 'bad' => $bad, 'good' => $good );
		}
		AIEO_Table::render( array(
			'page_id'  => $this->get_id(),
			'row_key'  => 'bad',
			'rows'     => $macros,
			'sortable' => false,
			'columns'  => array(
				array( 'key' => 'bad', 'label' => __( 'Wrong (passes through literally)', 'ai-eshop-optimizer' ), 'type' => 'code', 'tone' => 'danger' ),
				array( 'key' => 'good', 'label' => __( 'Correct', 'ai-eshop-optimizer' ), 'type' => 'code', 'tone' => 'success' ),
			),
		) );

		echo '<p>' . esc_html__( 'A complete, correct Meta URL-parameters string:', 'ai-eshop-optimizer' ) . '</p>';
		echo '<pre class="rooster-admin-code">'
			. 'utm_source={{site_source_name}}&amp;utm_medium=paid_social&amp;utm_campaign={{campaign.name}}&amp;utm_content={{ad.name}}&amp;utm_term={{adset.name}}'
			. '</pre>';
		
		echo \Rooster\Admin\Guidance::text( __( 
			'{{site_source_name}} resolves to fb, ig, msg or an, which is why utm_source has always worked while the campaign name did not.',
			'ai-eshop-optimizer'
		), 'guidance', array( 'question' => __( 'Why did only utm_source work?', 'ai-eshop-optimizer' ) ) );

		echo rooster_admin_card_section_html( 
			__( 'Google Ads: single braces (ValueTrack)', 'ai-eshop-optimizer' ),
			array( 'id' => 'aieo-card-contributors-google-ads-single-braces' )
		);
		echo '<pre class="rooster-admin-code">'
			. 'utm_source=google&amp;utm_medium=cpc&amp;utm_campaign={campaignid}&amp;utm_content={creative}&amp;utm_term={keyword}'
			. '</pre>';
		echo \Rooster\Admin\Guidance::text( __( 
			'Google auto-tagging (gclid) is separate and keeps working regardless. Note that {campaignid} gives you a number, not a name, so a Google campaign is best credited on utm_campaign only if you name campaigns manually.',
			'ai-eshop-optimizer'
		), 'guidance', array( 'question' => __( 'What about auto-tagging?', 'ai-eshop-optimizer' ) ) );

		$aieo_ct_history = \Rooster\Admin\Ui::notice(
			esc_html__( 'Conversions already recorded under a literal placeholder cannot be told apart afterwards, because the real campaign name was never sent. Correct the URL parameters in Ads Manager and credit starts from the next click.', 'ai-eshop-optimizer' ),
			'warning',
			array( 'title' => __( 'Fixing the template does not repair history.', 'ai-eshop-optimizer' ), 'inline' => true )
		);
		echo $aieo_ct_history; 
		echo $aieo_ct_close; 
	}

	private function reason_label( $r ) {
		$map = array(
			'bare_numeric_adset_id'   => __( 'ad-set number, not a person', 'ai-eshop-optimizer' ),
			'internal_upsell_tagging' => __( 'internal promotion, not external', 'ai-eshop-optimizer' ),
			'unexpanded_macro'        => __( 'unexpanded macro — see the guide below', 'ai-eshop-optimizer' ),
			'marketplace'             => __( 'marketplace traffic', 'ai-eshop-optimizer' ),
			'literal_undefined'       => __( 'literal "undefined"', 'ai-eshop-optimizer' ),
			'empty'                   => __( 'empty', 'ai-eshop-optimizer' ),
		);
		return isset( $map[ $r ] ) ? $map[ $r ] : str_replace( '_', ' ', $r );
	}
}