render_next_step( $next_step ); ?>
render_coverage_panel( $coverage, $done ); ?>
render_health_panel( $health, $compat, $freshness, $risk_counts, $ack_display ); ?>
render_preview_panel( $estimate, $preview_state ); ?>
render_getting_started_panel( $done, $coverage, $preview_state ); ?>
render_upgrade_cta_card();
?>
'warning',
'title' => __( 'Next step: finish cost setup', 'marginbeacon' ),
'body' => __( 'MarginBeacon cannot classify a product until it can resolve a tax-exclusive cost. Incomplete coverage never produces Safe.', 'marginbeacon' ),
'primary_label' => __( 'Open COGS Wizard', 'marginbeacon' ),
'primary_url' => Tabs::url( Tabs::COST_SETUP ),
'secondary_label' => __( 'Review thresholds', 'marginbeacon' ),
'secondary_url' => Tabs::url( Tabs::SETTINGS ),
);
}
if ( $missing > 0 ) {
return array(
'tone' => 'warning',
'title' => sprintf(
/* translators: %d: number of supported catalog items without a resolvable cost. */
_n( 'Next step: %d item still has no resolvable cost', 'Next step: %d items still have no resolvable cost', $missing, 'marginbeacon' ),
$missing
),
'body' => __( 'These items are reported as Unknown, never Safe. Add a native or MarginBeacon cost, or enable an assumed-cost fallback.', 'marginbeacon' ),
'primary_label' => __( 'Review cost coverage', 'marginbeacon' ),
'primary_url' => Tabs::url( Tabs::COST_SETUP, array( 'step' => 3 ) ),
'secondary_label' => __( 'Edit products', 'marginbeacon' ),
'secondary_url' => admin_url( 'edit.php?post_type=product' ),
);
}
if ( $critical > 0 ) {
return array(
'tone' => 'critical',
'title' => sprintf(
/* translators: %d: number of orders currently classified Critical. */
_n( 'Next step: %d order is flagged Critical', 'Next step: %d orders are flagged Critical', $critical, 'marginbeacon' ),
$critical
),
'body' => __( 'Open Findings to read the reason, cost source, and freshness for each order before deciding on any action.', 'marginbeacon' ),
'primary_label' => __( 'Open Findings', 'marginbeacon' ),
'primary_url' => Tabs::url( Tabs::FINDINGS ),
'secondary_label' => __( 'View WooCommerce Orders', 'marginbeacon' ),
'secondary_url' => admin_url( 'admin.php?page=wc-orders' ),
);
}
if ( empty( $preview_state['ever_run'] ) ) {
return array(
'tone' => 'info',
'title' => __( 'Next step: test a coupon before you launch it', 'marginbeacon' ),
'body' => __( 'Preflight simulates one native coupon at quantity 1 per eligible product. It never changes the coupon and never blocks checkout.', 'marginbeacon' ),
'primary_label' => __( 'Run preflight', 'marginbeacon' ),
'primary_url' => Tabs::url( Tabs::PREFLIGHT ),
'secondary_label' => __( 'Preview recent orders', 'marginbeacon' ),
'secondary_url' => '#aksmb-recent-preview',
);
}
return array(
'tone' => 'info',
'title' => __( 'Setup complete — keep watching new promotions', 'marginbeacon' ),
'body' => __( 'Cost coverage is resolved and no order is currently Critical. Preflight a coupon before each campaign and review Promo Risk badges on new orders.', 'marginbeacon' ),
'primary_label' => __( 'Run preflight', 'marginbeacon' ),
'primary_url' => Tabs::url( Tabs::PREFLIGHT ),
'secondary_label' => __( 'Open Findings', 'marginbeacon' ),
'secondary_url' => Tabs::url( Tabs::FINDINGS ),
);
}
/**
* Render the priority next-step panel.
*
* @param array $step Step descriptor.
* @return void
*/
private function render_next_step( array $step ) {
$tone = isset( $step['tone'] ) ? (string) $step['tone'] : 'info';
if ( ! in_array( $tone, array( 'info', 'warning', 'critical' ), true ) ) {
$tone = 'info';
}
?>