<?php
/**
 * Starting points for conversion groups.
 *
 * @package TurtleReport
 */

namespace TurtleReport\Profiles;

defined( 'ABSPATH' ) || exit;

/**
 * Ready-made conversion groups for common kinds of website.
 *
 * Presets only pre-fill the site editor; admins can rename groups and change
 * events freely. Event names follow GA4's recommended events where one exists.
 */
final class ConversionPresets {

	/**
	 * All presets, keyed by slug.
	 *
	 * @return array<string,array> Items with label, conversion_label and groups.
	 */
	public static function all() {
		$presets = array(
			'lead_gen'  => array(
				'label'            => __( 'Lead generation', 'turtlereport' ),
				'conversion_label' => __( 'Leads', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Form submissions', 'turtlereport' ),
						'events' => array( 'generate_lead' ),
					),
					array(
						'label'  => __( 'Sign-ups', 'turtlereport' ),
						'events' => array( 'sign_up' ),
					),
				),
			),
			'saas'      => array(
				'label'            => __( 'SaaS', 'turtlereport' ),
				'conversion_label' => __( 'Sign-ups', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Free sign-ups', 'turtlereport' ),
						'events' => array( 'sign_up' ),
					),
					array(
						'label'  => __( 'Trials started', 'turtlereport' ),
						'events' => array( 'trial_start' ),
					),
					array(
						'label'  => __( 'Demo requests', 'turtlereport' ),
						'events' => array( 'generate_lead' ),
					),
					array(
						'label'  => __( 'Paid upgrades', 'turtlereport' ),
						'events' => array( 'purchase' ),
					),
				),
			),
			'b2b'       => array(
				'label'            => __( 'B2B service or agency', 'turtlereport' ),
				'conversion_label' => __( 'Enquiries', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Contact forms', 'turtlereport' ),
						'events' => array( 'generate_lead' ),
					),
					array(
						'label'  => __( 'Meetings booked', 'turtlereport' ),
						'events' => array( 'book_meeting' ),
					),
					array(
						'label'  => __( 'Brochure or case-study downloads', 'turtlereport' ),
						'events' => array( 'file_download' ),
					),
				),
			),
			'product'   => array(
				'label'            => __( 'App or product', 'turtlereport' ),
				'conversion_label' => __( 'Activations', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Sign-ups', 'turtlereport' ),
						'events' => array( 'sign_up' ),
					),
					array(
						'label'  => __( 'App downloads', 'turtlereport' ),
						'events' => array( 'app_download' ),
					),
					array(
						'label'  => __( 'Purchases', 'turtlereport' ),
						'events' => array( 'purchase' ),
					),
				),
			),
			'local'     => array(
				'label'            => __( 'Local business', 'turtlereport' ),
				'conversion_label' => __( 'Leads', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Quote requests', 'turtlereport' ),
						'events' => array(),
					),
					array(
						'label'  => __( 'Contact forms', 'turtlereport' ),
						'events' => array( 'generate_lead' ),
					),
					array(
						'label'  => __( 'Phone-link clicks', 'turtlereport' ),
						'events' => array(),
					),
					array(
						'label'  => __( 'Email-link clicks', 'turtlereport' ),
						'events' => array(),
					),
				),
			),
			'ecommerce' => array(
				'label'            => __( 'Online shop', 'turtlereport' ),
				'conversion_label' => __( 'Sales actions', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Add to cart', 'turtlereport' ),
						'events' => array( 'add_to_cart' ),
					),
					array(
						'label'  => __( 'Checkouts started', 'turtlereport' ),
						'events' => array( 'begin_checkout' ),
					),
					array(
						'label'  => __( 'Purchases', 'turtlereport' ),
						'events' => array( 'purchase' ),
					),
				),
			),
			'content'   => array(
				'label'            => __( 'Blog or publisher', 'turtlereport' ),
				'conversion_label' => __( 'Engagements', 'turtlereport' ),
				'groups'           => array(
					array(
						'label'  => __( 'Newsletter sign-ups', 'turtlereport' ),
						'events' => array( 'sign_up' ),
					),
					array(
						'label'  => __( 'File downloads', 'turtlereport' ),
						'events' => array( 'file_download' ),
					),
					array(
						'label'  => __( 'Shares', 'turtlereport' ),
						'events' => array( 'share' ),
					),
				),
			),
		);

		/**
		 * Filters the conversion presets offered in the site editor.
		 *
		 * @param array $presets Presets keyed by slug.
		 */
		return (array) apply_filters( 'turtlereport_conversion_presets', $presets );
	}

	/**
	 * Groups for a brand-new site.
	 *
	 * @return array[]
	 */
	public static function default_groups() {
		return array(
			array(
				'label'  => __( 'Form submissions', 'turtlereport' ),
				'events' => array( 'generate_lead' ),
			),
		);
	}
}