<?php
/**
 * Onboarding content for AR for WordPress.
 *
 * @package AR_For_WordPress
 */

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

return array(
	'context' => 'wordpress',
	'screens' => array(
		'default'      => array(
			'tourSteps' => array(),
		),
		'settings'     => array(
			'tourSteps' => array(
				array(
					'id'        => 'welcome',
					'title'     => __( 'Welcome to AR for WordPress', 'ar-for-wordpress' ),
					'content'   => __( 'This short tour highlights the essentials: validating your license, uploading 3D models, and placing them on your site.', 'ar-for-wordpress' ),
					'target'    => '.licence_key',
					'placement' => 'center',
				),
				array(
					'id'        => 'license',
					'title'     => __( 'Activate Your License', 'ar-for-wordpress' ),
					'content'   => __( 'Enter your license key to unlock premium model limits, templates, and AI tooling. You can update this key later from the settings page.', 'ar-for-wordpress' ),
					'target'    => '#ar_licence_key',
					'placement' => 'right',
					'actions'   => array(
						array(
							'type'    => 'expand',
							'trigger' => '#ar_plan_acc',
							'panel'   => '#ar_plan_panel',
						),
						array(
							'type'     => 'focus',
							'selector' => '#ar_licence_key',
						),
					),
				),
				array(
					'id'        => 'ai-token',
					'title'     => __( 'Connect AR Display AI', 'ar-for-wordpress' ),
					'content'   => __( 'Paste your AR Display AI site token to sync purchased credits and unlock AI-generated 3D models directly from the plugin.', 'ar-for-wordpress' ),
					'target'    => '#ardisplay_ai_proxy_site_token',
					'placement' => 'right',
					'actions'   => array(
						array(
							'type'    => 'expand',
							'trigger' => '#ar_ai_acc',
							'panel'   => '#ar_ai_panel',
						),
						array(
							'type'     => 'focus',
							'selector' => '#ardisplay_ai_proxy_site_token',
						),
					),
				),
				array(
					'id'        => 'model-library',
					'title'     => __( 'Manage Your AR Models', 'ar-for-wordpress' ),
					'content'   => __( 'Use the AR Models post type to upload GLB/GLTF or USDZ assets, configure posters, and enable QR codes. Each model exposes shortcodes for embedding.', 'ar-for-wordpress' ),
					'target'    => '#menu-posts-armodels',
					'placement' => 'right',
				),
				array(
					'id'        => 'shortcodes',
					'title'     => __( 'Add AR to Any Page', 'ar-for-wordpress' ),
					'content'   => __( 'Copy a shortcode or block to publish the experience. The Shortcodes tab inside each model lists the most common embeds.', 'ar-for-wordpress' ),
					'target'    => '#instructions_tab',
					'placement' => 'left',
				),
			),
			'guides'    => array(
				array(
					'title'  => __( 'Settings Instructions', 'ar-for-wordpress' ),
					'panels' => array(
						array(
							'title' => __( 'Subscription Plan', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Enter your license key and save the page to unlock premium features and validate your plan.', 'ar-for-wordpress' ),
								__( 'Check the renewal date and plan tier so you know when access expires.', 'ar-for-wordpress' ),
								__( 'Review the model count to make sure published entries stay within your allowance.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'AR Display AI', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Paste the AR Display AI site token to sync credits from ardisplay.ai with this site.', 'ar-for-wordpress' ),
								__( 'Use the refresh button after purchasing credits to pull in the latest balance.', 'ar-for-wordpress' ),
								__( 'Check the activity log to confirm AI generations completed successfully.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Options', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Toggle the viewer buttons (View in AR, View in 3D, fullscreen, reset) to match your UX.', 'ar-for-wordpress' ),
								__( 'Customise button labels, poster imagery, and progress bar colours for brand consistency.', 'ar-for-wordpress' ),
								__( 'Choose measurement units and whether to display dimension labels beside the viewer.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Disable/Hide Elements', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Remove UI components such as hotspots, progress bars, or reset buttons for minimalist embeds.', 'ar-for-wordpress' ),
								__( 'Hide AR launch buttons on unsupported devices while keeping the 3D viewer available.', 'ar-for-wordpress' ),
								__( 'Combine with per-model overrides when only specific assets need simplified controls.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Security & Performance', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Enable secure URLs to wrap asset downloads in expiring, tamper-resistant links.', 'ar-for-wordpress' ),
								__( 'Adjust lazy loading and analytics sampling to balance speed with insights.', 'ar-for-wordpress' ),
								__( 'Purge cached AR CSS whenever you change button colours or layout styling.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'QR Code', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Choose the QR code appearance and size used when sharing AR experiences offline.', 'ar-for-wordpress' ),
								__( 'Decide if scans open the AR viewer directly or redirect to a landing page first.', 'ar-for-wordpress' ),
								__( 'Overlay a logo or custom colours to keep printed codes on-brand.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'AR Gallery', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Select which gallery aspect ratios and frame sizes visitors can choose from.', 'ar-for-wordpress' ),
								__( 'Adjust frame spacing, wall orientation, and lighting for multi-frame displays.', 'ar-for-wordpress' ),
								__( 'Enable size selectors so shoppers can preview artwork at different dimensions.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'User Upload', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Activate the `[ar-user-upload]` shortcode and specify accepted file formats.', 'ar-for-wordpress' ),
								__( 'Define default lighting, scale, and background for visitor-submitted assets.', 'ar-for-wordpress' ),
								__( 'Enable moderation or notifications if uploads should be reviewed before going live.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Element Positions and CSS Styles', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Drag buttons into new locations around the viewer overlay without touching code.', 'ar-for-wordpress' ),
								__( 'Store global CSS overrides that apply to every AR embed on the site.', 'ar-for-wordpress' ),
								__( 'Reset customised layouts to the defaults if UI elements become misaligned.', 'ar-for-wordpress' ),
							),
						),
					),
				),
			),
		),
		'modelEditor'  => array(
			'tourSteps' => array(
				array(
					'id'        => 'model-files',
					'title'     => __( 'Upload Model Files', 'ar-for-wordpress' ),
					'content'   => __( 'Use the Model Files tab to upload GLB/GLTF and USDZ assets and configure the model viewer settings.', 'ar-for-wordpress' ),
					'target'    => '#model_files_tab',
					'placement' => 'bottom',
					'actions'   => array(
						array(
							'type'     => 'click',
							'selector' => '#model_files_tab',
							'onlyIfHidden' => '#model_files_content',
						),
					),
				),
				array(
					'id'        => 'gallery-builder',
					'title'     => __( 'Design 3D Gallery Displays', 'ar-for-wordpress' ),
					'content'   => __( 'Build wall previews and set frame sizes from the 3D Gallery Builder tab to showcase image files as artworks in context.', 'ar-for-wordpress' ),
					'target'    => '#asset_builder_tab',
					'placement' => 'bottom',
					'actions'   => array(
						array(
							'type'     => 'click',
							'selector' => '#asset_builder_tab',
							'onlyIfHidden' => '#asset_builder_content',
						),
					),
				),
				array(
					'id'        => 'ai-generator',
					'title'     => __( 'Generate Models with AI', 'ar-for-wordpress' ),
					'content'   => __( 'Launch the AI Model Generator to convert a reference photo into a 3D model, spending credits from your connected account.', 'ar-for-wordpress' ),
					'target'    => '#ai_generator_tab',
					'placement' => 'bottom',
					'actions'   => array(
						array(
							'type'     => 'click',
							'selector' => '#ai_generator_tab',
							'onlyIfHidden' => '#ai_generator_content',
						),
					),
				),
				array(
					'id'        => 'user-upload',
					'title'     => __( 'User Provided Models and Images', 'ar-for-wordpress' ),
					'content'   => __( 'Use the User Upload tab to let clients upload their own 3D files or image file for instant AR previews.', 'ar-for-wordpress' ),
					'target'    => '#user_upload_tab',
					'placement' => 'bottom',
					'actions'   => array(
						array(
							'type'         => 'click',
							'selector'     => '#user_upload_tab',
							'onlyIfHidden' => '#user_upload_content',
						),
					),
				),
				array(
					'id'        => 'shortcode-help',
					'title'     => __( 'Find Shortcodes & Embed Guides', 'ar-for-wordpress' ),
					'content'   => __( 'Open the Shortcodes tab for details of the various shortcodes you can use to embed the AR model in your posts, pages, or theme templates.', 'ar-for-wordpress' ),
					'target'    => '#instructions_tab',
					'placement' => 'bottom',
					'actions'   => array(
						array(
							'type'     => 'click',
							'selector' => '#instructions_tab',
							'onlyIfHidden' => '#instructions_content',
						),
					),
				),
				array(
					'id'        => 'model-shop',
					'title'     => __( 'Source Ready-Made Assets', 'ar-for-wordpress' ),
					'content'   => __( 'Open the AR Model Shop to import curated, AR-ready 3D models directly into your library.', 'ar-for-wordpress' ),
					'target'    => '#support_tab_shop_wp',
					'placement' => 'left',
				),
				array(
					'id'        => 'support-links',
					'title'     => __( 'Access Support Resources', 'ar-for-wordpress' ),
					'content'   => __( 'Visit the Support tab for documentation, tutorials, and help links while you build your AR experience.', 'ar-for-wordpress' ),
					'target'    => '#support_tab_support_wp',
					'placement' => 'left',
				),
				
				array(
					'id'        => 'publish-model',
					'title'     => __( 'Publish Your AR Model', 'ar-for-wordpress' ),
					'content'   => __( 'When you are ready, use the Publish panel to save or update the AR model so it becomes available in shortcodes and blocks.', 'ar-for-wordpress' ),
					'target'    => '#publish',
					'placement' => 'left',
				),
			),
			'guides'    => array(
				array(
					'title'  => __( 'Model Editor Panels', 'ar-for-wordpress' ),
					'panels' => array(
						array(
							'title' => __( 'Display Options', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Set the poster image, viewer aspect ratio, and background colour for first impressions.', 'ar-for-wordpress' ),
								__( 'Adjust lighting, exposure, and shadow settings to flatter the model.', 'ar-for-wordpress' ),
								__( 'Enable or disable autoplay rotation and tweak animation speed.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Rotation Limits', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Restrict horizontal and vertical spin to keep products upright.', 'ar-for-wordpress' ),
								__( 'Lock movement on specific axes when you need fixed viewpoints.', 'ar-for-wordpress' ),
								__( 'Snap rotation to set angles so every interaction ends on a hero shot.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Disable/Hide Elements', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Hide UI buttons, thumbnails, or measurement labels for a minimal experience.', 'ar-for-wordpress' ),
								__( 'Remove hints or instructions once visitors understand the controls.', 'ar-for-wordpress' ),
								__( 'Override global visibility settings just for this model.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Materials & Textures', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Upload updated texture maps without re-importing the base geometry.', 'ar-for-wordpress' ),
								__( 'Switch between texture variants to showcase different finishes.', 'ar-for-wordpress' ),
								__( 'Optimise texture resolution for lightweight mobile experiences.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'QR Code Options', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Generate a QR code for this model and download it for marketing materials.', 'ar-for-wordpress' ),
								__( 'Choose whether the QR link opens AR mode or a detail page.', 'ar-for-wordpress' ),
								__( 'Apply per-model styling overrides for event-specific branding.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Additional Interactions', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Configure hotspots, info labels, or CTA buttons that overlay the model.', 'ar-for-wordpress' ),
								__( 'Trigger animations or play/pause states based on visitor actions.', 'ar-for-wordpress' ),
								__( 'Control which interactions appear on desktop versus mobile.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Alternative Model For Mobile', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Provide a lighter GLB/GLTF file for mobile devices while keeping full quality on desktop.', 'ar-for-wordpress' ),
								__( 'Swap in alternative USDZ files targeted at iOS Quick Look.', 'ar-for-wordpress' ),
								__( 'Preview the fallback asset to verify orientation and scale before publishing.', 'ar-for-wordpress' ),
							),
						),
						array(
							'title' => __( 'Element Positions and CSS Styles', 'ar-for-wordpress' ),
							'items' => array(
								__( 'Move UI buttons for this model without altering global placements.', 'ar-for-wordpress' ),
								__( 'Apply custom CSS rules that only affect this asset.', 'ar-for-wordpress' ),
								__( 'Reset local overrides to permanently revert to site defaults.', 'ar-for-wordpress' ),
							),
						),
					),
				),
			),
		),
	),
	'faqSections' => array(
		array(
			'title' => __( 'Getting Started with your own models', 'ar-for-wordpress' ),
			'items' => array(
				array(
					'text' => __( 'Open the Model Files tab inside a modeland upload a GLB/GLTF file so viewers on Android and iOS can load the experience.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'Set a poster image or use the gallery builder so the preview looks great before visitors launch the AR view.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'Embed the model with the Gutenberg block or copy the shortcode from the model editor and paste it into any page, post, or template.', 'ar-for-wordpress' ),
				),
			),
		),
		array(
			'title' => __( 'AI Tools', 'ar-for-wordpress' ),
			'items' => array(
				array(
					'text' => __( 'Connect your AR Display AI site token in Settings so credits sync automatically from ardisplay.ai.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'Open the AI Model Generator tab inside a model and upload a clear reference photo to generate a new 3D asset.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'After generation completes, review the preview and replace or download assets as needed before publishing.', 'ar-for-wordpress' ),
				),
			),
		),
		array(
			'title' => __( 'Customization', 'ar-for-wordpress' ),
			'items' => array(
				array(
					'text' => __( 'Use the Options panel in Settings to customise viewer labels, button text, and default poster imagery for new models.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'Enable QR codes and secure delivery to share models externally while protecting asset URLs.', 'ar-for-wordpress' ),
				),
				array(
					'text' => __( 'Add custom CSS snippets or per-model tweaks from the Shortcodes tab if you need branded styling.', 'ar-for-wordpress' ),
				),
			),
		),
	),
	'quickLinks' => array(
		array(
			'label' => __( 'Instructions', 'ar-for-wordpress' ),
			'link'  => 'accordion',
		),
		array(
			'label' => __( 'Documentation', 'ar-for-wordpress' ),
			'url'   => 'https://augmentedrealityplugins.com/support/',
		),
		array(
			'label' => __( 'Sample Model Files', 'ar-for-woocommerce' ),
			'url'   => 'https://augmentedrealityplugins.com/support/3d-model-resources/#sample',
		),
		array(
			'label' => __( 'AR Model Shop', 'ar-for-wordpress' ),
			'url'   => 'https://armodelshop.com/',
		),
		array(
			'label' => __( 'Contact support', 'ar-for-wordpress' ),
			'url'   => 'https://augmentedrealityplugins.com/contact/',
		),
	),
);

