<?php
/**
 * Tab — Help (getting started). Same layout in all the plugins of the publisher.
 *
 * A guide in seven steps, each one with the place in the menu where it is done, then the features to
 * go further. Every screen also has its own contextual Help (see VEFMB_Admin_Help).
 *
 * @package VEFmultiBooking
 */

defined( 'ABSPATH' ) || exit;

/**
 * One step of the guide: its title, the place in the menu, the text and an optional list.
 *
 * @var array<int,array<string,mixed>> $vefmb_steps
 */
$vefmb_steps = array(
	array(
		'title' => __( 'Create a resource', 'vefmultibooking' ),
		'where' => array( 'resources', __( 'Catalog › Resources', 'vefmultibooking' ) ),
		'text'  => __( 'Add what you offer for booking (a room, a bed, a guide, an activity…) and choose whether it is individual or has a numeric capacity.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Set its availability', 'vefmultibooking' ),
		'where' => array( 'availability', __( 'Catalog › Availability', 'vefmultibooking' ) ),
		'text'  => __( 'Create a recurring rule and generate the slots or nights: this is what makes the resource bookable.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Create an offer', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'An offer is what the customer buys. Link its resources, set its price and options, then publish it: a warning tells you what still prevents online booking.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Add the booking widget to your site', 'vefmultibooking' ),
		'where' => array( '', __( 'Your page builder', 'vefmultibooking' ) ),
		'text'  => __( 'Add the "VEF Booking" block, module or widget to a page (Gutenberg, Divi 5 or Elementor). Leave the offer empty to present all your published offers.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Configure payments', 'vefmultibooking' ),
		'where' => array( 'settings', __( 'Settings › Settings', 'vefmultibooking' ) ),
		'text'  => __( 'Choose the currency first (prices are never converted afterwards), then enter your Stripe and/or PayPal keys. Start with the test keys.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Customize the automatic emails (optional)', 'vefmultibooking' ),
		'where' => array( 'emails', __( 'Settings › Emails', 'vefmultibooking' ) ),
		'text'  => __( 'Adjust the wording of the emails sent to your customers and to you, using the tokens in curly braces.', 'vefmultibooking' ),
	),
	array(
		'title' => __( 'Adjust the look (optional)', 'vefmultibooking' ),
		'where' => array( 'style', __( 'Settings › Style', 'vefmultibooking' ) ),
		'text'  => __( 'By default the widgets follow your theme. The Style tab sets the look of all the widgets at once; each block can override it in your page builder.', 'vefmultibooking' ),
	),
);

/**
 * The features to discover once the first offer works: a title, a one-line text and the place where each is set up.
 *
 * @var array<int,array<string,mixed>> $vefmb_more
 */
$vefmb_more = array(
	array(
		'icon'  => '🛏️',
		'title' => __( 'Nights, stays and minimums', 'vefmultibooking' ),
		'where' => array( 'resources', __( 'Catalog › Resources', 'vefmultibooking' ) ),
		'text'  => __( 'Time slots make an activity, nights make an accommodation.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '🛎️',
		'title' => __( 'Several resources in one offer', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'Link identical resources, rooms for example, to one offer.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '❄️',
		'title' => __( 'Prices by season', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'Give each price a period, repeated every year if you wish.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '❓',
		'title' => __( 'Questions for the visitor', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'Ask for a text, a number or a confirmation to tick.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '🚦',
		'title' => __( 'Shared daily limits', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'Several offers can share a maximum number of departures per day.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '🗝️',
		'title' => __( 'Owner validation', 'vefmultibooking' ),
		'where' => array( 'offers', __( 'Catalog › Offers', 'vefmultibooking' ) ),
		'text'  => __( 'You validate each paid booking, or decline it and refund.', 'vefmultibooking' ),
	),
	array(
		'icon'  => '🔓',
		'title' => __( 'Nothing blocked without a payment', 'vefmultibooking' ),
		'where' => array( 'settings', __( 'Settings › Settings', 'vefmultibooking' ) ),
		'text'  => __( 'An unpaid online booking is cancelled after the delay you set.', 'vefmultibooking' ),
	),
);
$vefmb_help_body = static function () use ( $vefmb_steps, $vefmb_more ) {
	?>
<div class="vefmb-panel vefmb-guide" id="vefmb-panel-help">
	<h2><?php esc_html_e( 'Getting started', 'vefmultibooking' ); ?></h2>
	<p><?php esc_html_e( 'Follow these steps in order the first time: each one builds on the previous. The “Set up an offer” guide in the Catalog page does it for you and points out what to correct; nothing is ever blocked.', 'vefmultibooking' ); ?></p>

	<p><a href="<?php echo esc_url( VEFMB_Admin_Help::online_url( 'help' ) ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Read the full help online', 'vefmultibooking' ); ?></a></p>

	<ol class="vefmb-guide__steps">
		<?php foreach ( $vefmb_steps as $vefmb_step ) : ?>
			<li class="vefmb-guide__step">
				<h3><?php echo esc_html( $vefmb_step['title'] ); ?></h3>
				<p class="vefmb-guide__where">
					<span class="dashicons dashicons-location" aria-hidden="true"></span>
					<?php if ( '' !== $vefmb_step['where'][0] ) : ?>
						<a href="<?php echo esc_url( VEFMB_Admin_Tabs::tab_url( $vefmb_step['where'][0] ) ); ?>"><?php echo esc_html( $vefmb_step['where'][1] ); ?></a>
					<?php else : ?>
						<?php echo esc_html( $vefmb_step['where'][1] ); ?>
					<?php endif; ?>
				</p>
				<p><?php echo esc_html( $vefmb_step['text'] ); ?></p>
				<?php if ( '' !== $vefmb_step['where'][0] ) : ?>
					<p><a href="<?php echo esc_url( VEFMB_Admin_Help::online_url( $vefmb_step['where'][0] ) ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Read the full help online', 'vefmultibooking' ); ?></a></p>
				<?php endif; ?>
			</li>
		<?php endforeach; ?>
	</ol>

	<h2><?php esc_html_e( 'The blocks', 'vefmultibooking' ); ?></h2>
	<p><?php esc_html_e( 'Blocks in Gutenberg, modules in Divi 5, widgets in Elementor, with the same settings. Only the booking block is needed.', 'vefmultibooking' ); ?></p>

	<div class="vefmb-about__cards vefmb-guide__blocks">
		<?php foreach ( VEFMB_Admin_Help::blocks() as $vefmb_block ) : ?>
			<div class="vefmb-about__card">
				<h4><?php echo esc_html( $vefmb_block['title'] ); ?></h4>
				<p><?php echo esc_html( $vefmb_block['purpose'] ); ?></p>
			</div>
		<?php endforeach; ?>
	</div>

	<h2><?php esc_html_e( 'Going further', 'vefmultibooking' ); ?></h2>
	<p><?php esc_html_e( 'Once your first offer works, these features save you time and protect your places. The full help online explains each of them.', 'vefmultibooking' ); ?></p>

	<div class="vefmb-about__cards vefmb-guide__more">
		<?php foreach ( $vefmb_more as $vefmb_card ) : ?>
			<div class="vefmb-about__card">
				<h4><?php echo esc_html( $vefmb_card['icon'] . ' ' . $vefmb_card['title'] ); ?></h4>
				<?php if ( ! empty( $vefmb_card['where'] ) ) : ?>
					<p class="vefmb-guide__where">
						<span class="dashicons dashicons-location" aria-hidden="true"></span>
						<a href="<?php echo esc_url( VEFMB_Admin_Tabs::tab_url( $vefmb_card['where'][0] ) ); ?>"><?php echo esc_html( $vefmb_card['where'][1] ); ?></a>
					</p>
				<?php endif; ?>
				<p><?php echo esc_html( $vefmb_card['text'] ); ?></p>
			</div>
		<?php endforeach; ?>
	</div>

	<h2><?php esc_html_e( 'Several languages: what depends on what', 'vefmultibooking' ); ?></h2>
	<p><?php esc_html_e( 'Three different things are translated in three different places: this tells you where to look when a text stays in the wrong language.', 'vefmultibooking' ); ?></p>

	<div class="vefmb-about__cards vefmb-guide__languages">
		<?php foreach ( VEFMB_Admin_Help::languages_guide() as $vefmb_language_card ) : ?>
			<div class="vefmb-about__card">
				<h4><?php echo esc_html( $vefmb_language_card[0] ); ?></h4>
				<p><?php echo esc_html( $vefmb_language_card[1] ); ?></p>
			</div>
		<?php endforeach; ?>
	</div>

	<p class="description"><?php esc_html_e( 'A question or a bug to report? Use the Diagnostic and support tab: your technical information is attached automatically. Every screen also has its own Help at the top right.', 'vefmultibooking' ); ?></p>
</div>
	<?php
};

// One screen for the guide: with VEFmultiBooking Pro active, a second part presents the Pro features.
VEFMB_Admin_UI::render_subpanels(
	'help',
	array(
		'free' => array(
			'label'    => __( 'VEFmultiBooking', 'vefmultibooking' ),
			'callback' => $vefmb_help_body,
		),
	)
);