<?php
/**
 * Plugin Name: AJB Random Quote Cards
 * Plugin URI:  https://ajb.co/wp-plugins/ajb-random-quote-cards/
 * Description: Display beautifully styled quote cards anywhere on your site using a shortcode or Gutenberg block. Supports categories, CSV import/export, copy to clipboard, and full per-card style overrides.
 * Version:     2.1.0
 * Author:      Andrew J Bruce
 * Author URI:  https://ajb.co/
 * License:     GPL-2.0-or-later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain: ajb-random-quote-cards
 */

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

// =========================================================================
// CONSTANTS
// =========================================================================
define( 'AJBQ_VERSION',    '2.1.0' );
define( 'AJBQ_FILE',       __FILE__ );
define( 'AJBQ_DIR',        plugin_dir_path( __FILE__ ) );
define( 'AJBQ_URL',        plugins_url( '/', __FILE__ ) );
define( 'AJBQ_POST_TYPE',  'ajbq_quote' );
define( 'AJBQ_TAXONOMY',   'ajbq_category' );

// Register uninstall hook here in the main file (more reliable than uninstall.php
// for custom post types, as WordPress loads this file to run the hook).
register_uninstall_hook( AJBQ_FILE, 'ajbq_uninstall' );

/**
 * Full cleanup on plugin deletion via Plugins → Delete.
 * Uses literal strings (not constants) so this works even if WordPress
 * loads the file in an unusual order during uninstall.
 * Uses direct DB queries as a fallback safety net alongside WP functions.
 */
function ajbq_uninstall() {
	global $wpdb;

	// ── 1. Delete all quote posts (and their meta via wp_delete_post) ─────
	$post_ids = $wpdb->get_col(
		$wpdb->prepare( "SELECT ID FROM {$wpdb->posts} WHERE post_type = %s", 'ajbq_quote' )
	);
	foreach ( $post_ids as $id ) {
		wp_delete_post( (int) $id, true );
	}

	// Safety net — direct delete in case wp_delete_post missed anything.
	$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->posts} WHERE post_type = %s", 'ajbq_quote' ) );
	$wpdb->query(
		"DELETE pm FROM {$wpdb->postmeta} pm
		 LEFT JOIN {$wpdb->posts} p ON p.ID = pm.post_id
		 WHERE p.ID IS NULL"
	);

	// ── 2. Delete all ajbq_category taxonomy terms ─────────────────────────
	$term_ids = $wpdb->get_col(
		$wpdb->prepare( "SELECT term_id FROM {$wpdb->term_taxonomy} WHERE taxonomy = %s", 'ajbq_category' )
	);
	foreach ( $term_ids as $tid ) {
		wp_delete_term( (int) $tid, 'ajbq_category' );
	}
	// Direct cleanup of any orphaned rows.
	$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->term_taxonomy} WHERE taxonomy = %s", 'ajbq_category' ) );

	// ── 3. Delete all plugin options ──────────────────────────────────────
	$options = [
		'ajbq_bg_color', 'ajbq_corners', 'ajbq_width', 'ajbq_height',
		'ajbq_show_author', 'ajbq_show_link', 'ajbq_show_copy',
		'ajbq_quote_font', 'ajbq_quote_size', 'ajbq_quote_color', 'ajbq_quote_style', 'ajbq_quote_weight',
		'ajbq_author_font', 'ajbq_author_size', 'ajbq_author_color', 'ajbq_author_style', 'ajbq_author_weight',
		'ajbq_author_prefix', 'ajbq_author_suffix',
		'ajbq_link_font', 'ajbq_link_size', 'ajbq_link_color',
		'ajbq_always_load_assets', 'ajbq_migration_v2_done', 'ajbq_sample_quotes_seeded',
	];
	foreach ( $options as $opt ) {
		delete_option( $opt );
	}

	// ── 4. Delete all transients ──────────────────────────────────────────
	$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", '_transient_rtq_%' ) );
	$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", '_transient_timeout_rtq_%' ) );
}


// =========================================================================
// ACTIVATION — seed sample quotes on first install
// =========================================================================
register_activation_hook( AJBQ_FILE, 'ajbq_on_activation' );
function ajbq_on_activation() {
	// Only seed once, and only if there are no quotes already.
	if ( get_option( 'ajbq_sample_quotes_seeded' ) ) {
		return;
	}
	// Register the CPT so wp_insert_post can use it immediately.
	ajbq_register_cpt();

	$samples = [
		[
			'quote'    => 'The only way to do great work is to love what you do.',
			'author'   => 'Steve Jobs',
			'category' => 'Inspiration',
			'favorite' => '1',
		],
		[
			'quote'    => 'In the middle of every difficulty lies opportunity.',
			'author'   => 'Albert Einstein',
			'category' => 'Inspiration',
			'favorite' => '0',
		],
		[
			'quote'    => 'It does not matter how slowly you go as long as you do not stop.',
			'author'   => 'Confucius',
			'category' => 'Perseverance',
			'favorite' => '1',
		],
		[
			'quote'    => 'Life is what happens when you\'re busy making other plans.',
			'author'   => 'John Lennon',
			'category' => 'Life',
			'favorite' => '0',
		],
		[
			'quote'    => 'The future belongs to those who believe in the beauty of their dreams.',
			'author'   => 'Eleanor Roosevelt',
			'category' => 'Inspiration',
			'favorite' => '0',
		],
		[
			'quote'    => 'Spread love everywhere you go. Let no one ever come to you without leaving happier.',
			'author'   => 'Mother Teresa',
			'category' => 'Kindness',
			'favorite' => '1',
		],
		[
			'quote'    => 'When you reach the end of your rope, tie a knot in it and hang on.',
			'author'   => 'Franklin D. Roosevelt',
			'category' => 'Perseverance',
			'favorite' => '0',
		],
		[
			'quote'    => 'Always remember that you are absolutely unique. Just like everyone else.',
			'author'   => 'Margaret Mead',
			'category' => 'Humour',
			'favorite' => '0',
		],
		[
			'quote'    => 'Do not go where the path may lead, go instead where there is no path and leave a trail.',
			'author'   => 'Ralph Waldo Emerson',
			'category' => 'Inspiration',
			'favorite' => '0',
		],
		[
			'quote'    => 'You will face many defeats in life, but never let yourself be defeated.',
			'author'   => 'Maya Angelou',
			'category' => 'Perseverance',
			'favorite' => '1',
		],
		[
			'quote'    => 'The greatest glory in living lies not in never falling, but in rising every time we fall.',
			'author'   => 'Nelson Mandela',
			'category' => 'Perseverance',
			'favorite' => '0',
		],
		[
			'quote'    => 'In the end, it\'s not the years in your life that count. It\'s the life in your years.',
			'author'   => 'Abraham Lincoln',
			'category' => 'Life',
			'favorite' => '0',
		],
		[
			'quote'    => 'Never let the fear of striking out keep you from playing the game.',
			'author'   => 'Babe Ruth',
			'category' => 'Courage',
			'favorite' => '0',
		],
		[
			'quote'    => 'Life is either a daring adventure or nothing at all.',
			'author'   => 'Helen Keller',
			'category' => 'Life',
			'favorite' => '1',
		],
		[
			'quote'    => 'Many of life\'s failures are people who did not realise how close they were to success when they gave up.',
			'author'   => 'Thomas A. Edison',
			'category' => 'Perseverance',
			'favorite' => '0',
		],
	];

	foreach ( $samples as $s ) {
		$post_id = wp_insert_post( [
			'post_title'   => wp_trim_words( $s['quote'], 10, '…' ),
			'post_content' => $s['quote'],
			'post_status'  => 'publish',
			'post_type'    => AJBQ_POST_TYPE,
		] );
		if ( ! $post_id || is_wp_error( $post_id ) ) {
			continue;
		}
		update_post_meta( $post_id, '_rtq_author',      $s['author'] );
		update_post_meta( $post_id, '_rtq_is_favorite', $s['favorite'] );

		$term = term_exists( $s['category'], AJBQ_TAXONOMY );
		if ( ! $term ) {
			$term = wp_insert_term( $s['category'], AJBQ_TAXONOMY );
		}
		if ( ! is_wp_error( $term ) ) {
			wp_set_post_terms( $post_id, [ (int) $term['term_id'] ], AJBQ_TAXONOMY );
		}
	}

	update_option( 'ajbq_sample_quotes_seeded', '1' );
}


function ajbq_register_cpt() {

	register_post_type( AJBQ_POST_TYPE, [
		'labels' => [
			'name'               => __( 'AJB Quotes',          'ajb-random-quote-cards' ),
			'singular_name'      => __( 'Quote',               'ajb-random-quote-cards' ),
			'menu_name'          => __( 'AJB Quotes',          'ajb-random-quote-cards' ),
			'add_new'            => __( 'Add New',             'ajb-random-quote-cards' ),
			'add_new_item'       => __( 'Add New Quote',       'ajb-random-quote-cards' ),
			'edit_item'          => __( 'Edit Quote',          'ajb-random-quote-cards' ),
			'new_item'           => __( 'New Quote',           'ajb-random-quote-cards' ),
			'view_item'          => __( 'View Quote',          'ajb-random-quote-cards' ),
			'search_items'       => __( 'Search Quotes',       'ajb-random-quote-cards' ),
			'not_found'          => __( 'No quotes found.',    'ajb-random-quote-cards' ),
			'not_found_in_trash' => __( 'No quotes in trash.', 'ajb-random-quote-cards' ),
			'all_items'          => __( 'All Quotes',          'ajb-random-quote-cards' ),
		],
		'public'       => false,
		'show_ui'      => true,
		'show_in_rest' => true,  // Keep true for the Gutenberg block to read categories.
		'has_archive'  => false,
		'menu_icon'    => 'dashicons-editor-quote',
		'supports'     => [ 'title' ],  // Title only — quote text handled by our custom form via post_content.
	] );

	register_taxonomy( AJBQ_TAXONOMY, AJBQ_POST_TYPE, [
		'labels' => [
			'name'          => __( 'Quote Categories', 'ajb-random-quote-cards' ),
			'singular_name' => __( 'Quote Category',   'ajb-random-quote-cards' ),
			'add_new_item'  => __( 'Add New Category', 'ajb-random-quote-cards' ),
			'edit_item'     => __( 'Edit Category',    'ajb-random-quote-cards' ),
		],
		'hierarchical' => true,
		'show_ui'      => true,
		'show_in_rest' => true,
	] );
}
add_action( 'init', 'ajbq_register_cpt' );

// Force the classic editor for ajbq_quote — our custom meta box form is the UI.
add_filter( 'use_block_editor_for_post_type', function( $use, $post_type ) {
	if ( AJBQ_POST_TYPE === $post_type ) return false;
	return $use;
}, 10, 2 );


// =========================================================================
// 2. DATA MIGRATION — post_title → post_content (runs once on upgrade)
// =========================================================================
/**
 * Migrates existing quotes whose quote text is stored only in post_title to
 * post_content. Runs once per site, triggered on plugin load when the
 * migration flag is absent from wp_options.
 *
 * Safe to run multiple times: it checks each post individually and only
 * migrates posts where post_content is still empty.
 */
function ajbq_maybe_migrate_post_title_to_content() {
	if ( get_option( 'ajbq_migration_v2_done' ) ) {
		return;
	}

	$quotes = get_posts( [
		'post_type'      => AJBQ_POST_TYPE,
		'posts_per_page' => -1,
		'post_status'    => 'any',
		'no_found_rows'  => true,
	] );

	foreach ( $quotes as $quote ) {
		// Only migrate posts that still have an empty post_content.
		// If content is already set the migration was already done for this post.
		if ( '' === $quote->post_content && '' !== $quote->post_title ) {
			wp_update_post( [
				'ID'           => $quote->ID,
				'post_content' => $quote->post_title,
				// Give the post a short title for the admin list (truncated to 80 chars).
				'post_title'   => wp_trim_words( $quote->post_title, 12, '…' ),
			] );
		}
	}

	update_option( 'ajbq_migration_v2_done', '1' );
}
add_action( 'init', 'ajbq_maybe_migrate_post_title_to_content', 20 );


// =========================================================================
// 3. ADD / EDIT QUOTE — custom meta box form
//    Replaces the default title+editor with a single clear form.
// =========================================================================
add_action( 'add_meta_boxes', function () {
	add_meta_box(
		'ajbq_quote_form',
		__( 'Quote Details', 'ajb-random-quote-cards' ),
		'ajbq_render_quote_form',
		AJBQ_POST_TYPE,
		'normal',
		'high'
	);
} );

// Hide the default title field and style the quote form — enqueued properly via admin_enqueue_scripts.
// (Inline styles must use wp_add_inline_style, not echo'd <style> tags.)

function ajbq_render_quote_form( $post ) {
	wp_nonce_field( 'ajbq_save_quote_form', 'ajbq_form_nonce' );

	$quote_text  = $post->post_content;
	$admin_label = $post->post_title;
	$author      = get_post_meta( $post->ID, '_rtq_author',      true );
	$link_ext    = get_post_meta( $post->ID, '_rtq_link_ext',    true );
	$is_favorite = get_post_meta( $post->ID, '_rtq_is_favorite', true );
	$post_cats   = wp_get_post_terms( $post->ID, AJBQ_TAXONOMY, [ 'fields' => 'ids' ] );
	$all_cats    = get_terms( [ 'taxonomy' => AJBQ_TAXONOMY, 'hide_empty' => false ] );
	?>
	<table class="ajbq-form-table">
		<tr>
			<th scope="row">
				<label for="ajbq_quote_text"><?php esc_html_e( 'Quote Text', 'ajb-random-quote-cards' ); ?></label>
			</th>
			<td>
				<textarea id="ajbq_quote_text" name="ajbq_quote_text" rows="5"
					placeholder="<?php esc_attr_e( 'Enter the full quote text here…', 'ajb-random-quote-cards' ); ?>"
				><?php echo esc_textarea( $quote_text ); ?></textarea>
				<p class="ajbq-form-note"><?php esc_html_e( 'The full quote as it will appear on your site. No need to add quotation marks — those are added automatically.', 'ajb-random-quote-cards' ); ?></p>
			</td>
		</tr>
		<tr>
			<th scope="row">
				<label for="ajbq_admin_label"><?php esc_html_e( 'Admin Label', 'ajb-random-quote-cards' ); ?></label>
			</th>
			<td>
				<input type="text" id="ajbq_admin_label" name="ajbq_admin_label"
					value="<?php echo esc_attr( $admin_label ); ?>"
					placeholder="<?php esc_attr_e( 'Short name for the quotes list, e.g. Einstein — opportunity', 'ajb-random-quote-cards' ); ?>">
				<p class="ajbq-form-note"><?php esc_html_e( 'Only shown in the admin quotes list — not displayed on your site. Leave blank to auto-generate from the quote text.', 'ajb-random-quote-cards' ); ?></p>
			</td>
		</tr>
		<tr>
			<th scope="row">
				<label for="ajbq_author"><?php esc_html_e( 'Author', 'ajb-random-quote-cards' ); ?></label>
			</th>
			<td>
				<input type="text" id="ajbq_author" name="ajbq_author"
					value="<?php echo esc_attr( $author ); ?>"
					placeholder="<?php esc_attr_e( 'Albert Einstein', 'ajb-random-quote-cards' ); ?>">
				<p class="ajbq-form-note"><?php esc_html_e( 'Shown below the quote. Leave blank if unknown.', 'ajb-random-quote-cards' ); ?></p>
			</td>
		</tr>
		<tr>
			<th scope="row">
				<label for="ajbq_link_ext"><?php esc_html_e( 'External Link', 'ajb-random-quote-cards' ); ?></label>
			</th>
			<td>
				<input type="url" id="ajbq_link_ext" name="ajbq_link_ext"
					value="<?php echo esc_url( $link_ext ); ?>"
					placeholder="https://">
				<p class="ajbq-form-note"><?php esc_html_e( 'Optional. Adds a "Learn More" link to the quote card.', 'ajb-random-quote-cards' ); ?></p>
			</td>
		</tr>
		<tr>
			<th scope="row"><?php esc_html_e( 'Categories', 'ajb-random-quote-cards' ); ?></th>
			<td>
				<?php if ( ! empty( $all_cats ) && ! is_wp_error( $all_cats ) ) : ?>
					<ul class="ajbq-cat-list">
						<?php foreach ( $all_cats as $cat ) : ?>
						<li>
							<label>
								<input type="checkbox" name="ajbq_categories[]"
									value="<?php echo esc_attr( $cat->term_id ); ?>"
									<?php checked( in_array( $cat->term_id, (array) $post_cats, false ) ); ?>>
								<?php echo esc_html( $cat->name ); ?>
							</label>
						</li>
						<?php endforeach; ?>
					</ul>
				<?php else : ?>
					<p class="ajbq-form-note"><?php esc_html_e( 'No categories yet. ', 'ajb-random-quote-cards' ); ?>
					<a href="<?php echo esc_url( admin_url( 'edit-tags.php?taxonomy=' . AJBQ_TAXONOMY . '&post_type=' . AJBQ_POST_TYPE ) ); ?>"><?php esc_html_e( 'Add a category', 'ajb-random-quote-cards' ); ?></a>.</p>
				<?php endif; ?>
			</td>
		</tr>
		<tr>
			<th scope="row"><?php esc_html_e( 'Favourite', 'ajb-random-quote-cards' ); ?></th>
			<td>
				<label class="ajbq-fav-label">
					<input type="checkbox" name="ajbq_is_favorite" value="1"
						<?php checked( $is_favorite, '1' ); ?>>
					<span class="ajbq-fav-star">⭐</span>
					<?php esc_html_e( 'Mark as a favourite', 'ajb-random-quote-cards' ); ?>
				</label>
				<p class="ajbq-form-note"><?php esc_html_e( 'Use source="favorites" in the shortcode or block to show only favourited quotes.', 'ajb-random-quote-cards' ); ?></p>
			</td>
		</tr>
	</table>
	<?php
}

function ajbq_save_quote_form( $post_id ) {
	if ( ! isset( $_POST['ajbq_form_nonce'] ) ) return;
	if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['ajbq_form_nonce'] ) ), 'ajbq_save_quote_form' ) ) return;
	if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) return;
	if ( ! current_user_can( 'edit_post', $post_id ) ) return;

	// Quote text → post_content.
	$quote_text = sanitize_textarea_field( $_POST['ajbq_quote_text'] ?? '' );

	// Admin label → post_title. Auto-generate from quote if left blank.
	$admin_label = sanitize_text_field( $_POST['ajbq_admin_label'] ?? '' );
	if ( '' === $admin_label && '' !== $quote_text ) {
		$admin_label = wp_trim_words( $quote_text, 12, '…' );
	}

	// Update post — unhook save_post to avoid recursion.
	remove_action( 'save_post_' . AJBQ_POST_TYPE, 'ajbq_save_quote_form' );
	wp_update_post( [
		'ID'           => $post_id,
		'post_content' => $quote_text,
		'post_title'   => $admin_label,
	] );
	add_action( 'save_post_' . AJBQ_POST_TYPE, 'ajbq_save_quote_form' );

	// Meta.
	update_post_meta( $post_id, '_rtq_author',      sanitize_text_field( $_POST['ajbq_author'] ?? '' ) );
	update_post_meta( $post_id, '_rtq_link_ext',    esc_url_raw( $_POST['ajbq_link_ext'] ?? '' ) );
	update_post_meta( $post_id, '_rtq_is_favorite', isset( $_POST['ajbq_is_favorite'] ) ? '1' : '0' );

	// Categories.
	$term_ids = [];
	if ( ! empty( $_POST['ajbq_categories'] ) && is_array( $_POST['ajbq_categories'] ) ) {
		$term_ids = array_map( 'intval', $_POST['ajbq_categories'] );
	}
	wp_set_post_terms( $post_id, $term_ids, AJBQ_TAXONOMY );
}
add_action( 'save_post_' . AJBQ_POST_TYPE, 'ajbq_save_quote_form' );


// =========================================================================
// 4. ADMIN MENU — four submenu pages
// =========================================================================
add_action( 'admin_menu', function () {

	// Shortcode Builder.
	add_submenu_page(
		'edit.php?post_type=' . AJBQ_POST_TYPE,
		__( 'Shortcode Builder', 'ajb-random-quote-cards' ),
		__( 'Shortcode Builder', 'ajb-random-quote-cards' ),
		'manage_options',
		'ajbq-builder',
		'ajbq_builder_page'
	);

	// Global Settings.
	add_submenu_page(
		'edit.php?post_type=' . AJBQ_POST_TYPE,
		__( 'Global Settings', 'ajb-random-quote-cards' ),
		__( 'Settings',        'ajb-random-quote-cards' ),
		'manage_options',
		'ajbq-settings',
		'ajbq_settings_page'
	);

	// Import / Export.
	add_submenu_page(
		'edit.php?post_type=' . AJBQ_POST_TYPE,
		__( 'Import & Export', 'ajb-random-quote-cards' ),
		__( 'Import / Export', 'ajb-random-quote-cards' ),
		'manage_options',
		'ajbq-import-export',
		'ajbq_import_export_page'
	);

	// Help & Tips.
	add_submenu_page(
		'edit.php?post_type=' . AJBQ_POST_TYPE,
		__( 'Help & Tips', 'ajb-random-quote-cards' ),
		__( 'Help & Tips',  'ajb-random-quote-cards' ),
		'manage_options',
		'ajbq-help',
		'ajbq_help_page'
	);
} );

// Enqueue assets on the correct hook — admin_enqueue_scripts gives us
// reliable screen detection and ensures dependencies are registered first.
add_action( 'admin_enqueue_scripts', 'ajbq_enqueue_admin_assets' );
function ajbq_enqueue_admin_assets( $hook ) {

	// Quote add/edit screen — register a placeholder style and attach inline CSS to it.
	// This replaces the old admin_head echo approach so assets are properly enqueued.
	if ( in_array( $hook, [ 'post.php', 'post-new.php' ], true ) ) {
		global $post_type;
		if ( AJBQ_POST_TYPE === $post_type ) {
			wp_register_style( 'ajbq-admin-post-form', false, [], AJBQ_VERSION );
			wp_enqueue_style( 'ajbq-admin-post-form' );
			wp_add_inline_style( 'ajbq-admin-post-form',
				'#titlediv { display:none; }
				#ajbq_quote_form .inside { padding: 0; }
				.ajbq-form-table { width:100%; border-collapse:collapse; }
				.ajbq-form-table th { width:160px; padding:14px 16px; text-align:left; vertical-align:top; font-weight:600; color:#1d2327; border-bottom:1px solid #f0f0f1; }
				.ajbq-form-table td { padding:12px 16px; border-bottom:1px solid #f0f0f1; vertical-align:top; }
				.ajbq-form-table tr:last-child th,
				.ajbq-form-table tr:last-child td { border-bottom:none; }
				.ajbq-form-table textarea { width:100%; min-height:100px; resize:vertical; font-size:14px; line-height:1.6; }
				.ajbq-form-table input[type=text],
				.ajbq-form-table input[type=url] { width:100%; }
				.ajbq-fav-label { display:flex; align-items:center; gap:8px; cursor:pointer; font-size:14px; }
				.ajbq-fav-label input { margin:0; width:18px; height:18px; cursor:pointer; }
				.ajbq-fav-star { font-size:20px; line-height:1; }
				.ajbq-cat-list { margin:0; padding:0; list-style:none; column-count:2; column-gap:20px; }
				.ajbq-cat-list li { padding:3px 0; }
				.ajbq-cat-list label { display:flex; align-items:center; gap:6px; cursor:pointer; font-size:13px; }
				.ajbq-form-note { color:#646970; font-size:12px; margin-top:5px; }
				@media(max-width:600px){ .ajbq-cat-list { column-count:1; } }'
			);
		}
	}

	// Settings page — colour picker + admin.js.
	if ( 'ajbq_quote_page_ajbq-settings' === $hook ) {
		wp_enqueue_style( 'wp-color-picker' );
		wp_enqueue_script(
			'ajbq-admin',
			AJBQ_URL . 'assets/admin.js',
			[ 'wp-color-picker', 'jquery' ],
			AJBQ_VERSION,
			true   // Load in footer so DOM is ready.
		);
	}

	// Shortcode Builder page — builder.js + localised category data.
	if ( 'ajbq_quote_page_ajbq-builder' === $hook ) {
		$categories = get_terms( [ 'taxonomy' => AJBQ_TAXONOMY, 'hide_empty' => false ] );
		$cat_data   = [];
		if ( ! is_wp_error( $categories ) ) {
			foreach ( $categories as $cat ) {
				$cat_data[] = [ 'slug' => $cat->slug, 'name' => $cat->name ];
			}
		}
		wp_enqueue_style( 'wp-color-picker' );
		wp_enqueue_script(
			'ajbq-builder',
			AJBQ_URL . 'assets/builder.js',
			[ 'wp-color-picker', 'jquery' ],
			AJBQ_VERSION,
			true
		);
		wp_localize_script( 'ajbq-builder', 'ajbqBuilder', [
			'categories'  => $cat_data,
			'ajaxurl'     => admin_url( 'admin-ajax.php' ),
			'previewNonce'=> wp_create_nonce( 'ajbq_builder_preview' ),
			'strings'     => [
				'loading'  => __( 'Loading preview…', 'ajb-random-quote-cards' ),
				'noQuotes' => __( 'No quotes found matching those settings.', 'ajb-random-quote-cards' ),
				'error'    => __( 'Preview unavailable.', 'ajb-random-quote-cards' ),
				'refresh'  => __( '🔄 Refresh Preview', 'ajb-random-quote-cards' ),
			],
		] );
	}
}


// =========================================================================
// 5. SETTINGS REGISTRATION
// =========================================================================
add_action( 'admin_init', 'ajbq_register_settings' );
function ajbq_register_settings() {
	$dim    = 'ajbq_sanitize_dimension_cb';
	$font   = 'ajbq_sanitize_font_name_cb';
	$color  = 'sanitize_hex_color';
	$check  = 'ajbq_sanitize_checkbox';

	$settings = [
		// Container defaults.
		'ajbq_bg_color'      => $color,
		'ajbq_corners'       => 'ajbq_sanitize_corners',
		'ajbq_width'         => $dim,
		'ajbq_height'        => $dim,
		// Visibility defaults.
		'ajbq_show_author'   => $check,
		'ajbq_show_link'     => $check,
		'ajbq_show_copy'     => $check,
		// Quote typography defaults.
		'ajbq_quote_font'    => $font,
		'ajbq_quote_size'    => $dim,
		'ajbq_quote_color'   => $color,
		'ajbq_quote_style'   => 'ajbq_sanitize_font_style',
		'ajbq_quote_weight'  => 'ajbq_sanitize_font_weight',
		// Author typography defaults.
		'ajbq_author_font'   => $font,
		'ajbq_author_size'   => $dim,
		'ajbq_author_color'  => $color,
		'ajbq_author_style'  => 'ajbq_sanitize_font_style',
		'ajbq_author_weight' => 'ajbq_sanitize_font_weight',
		'ajbq_author_prefix' => 'ajbq_sanitize_prefix_suffix',
		'ajbq_author_suffix' => 'ajbq_sanitize_prefix_suffix',
		// Link / icon defaults.
		'ajbq_link_font'     => $font,
		'ajbq_link_size'     => $dim,
		'ajbq_link_color'    => $color,
	];
	foreach ( $settings as $key => $cb ) {
		register_setting( 'ajbq_settings_group', $key, [ 'sanitize_callback' => $cb ] );
	}
}
function ajbq_sanitize_checkbox( $v ) { return $v ? '1' : '0'; }

/**
 * Sanitize a Google Font name for safe use inside CSS string context.
 * Strips characters that could break out of a CSS quoted string.
 *
 * @param string $v        Raw value.
 * @param string $fallback Returned when value is empty/invalid.
 * @return string
 */
function ajbq_sanitize_font_name( $v, $fallback = 'Roboto' ) {
	$v = sanitize_text_field( $v );
	// Strip anything that could escape a CSS quoted string or inject rules.
	$v = preg_replace( "/['\";{}\\\\]/", '', $v );
	return ( '' !== $v ) ? $v : $fallback;
}
// Single-arg wrapper for use as register_setting sanitize_callback.
function ajbq_sanitize_font_name_cb( $v ) { return ajbq_sanitize_font_name( $v, '' ); }

/** Whitelist-sanitize corner style. */
function ajbq_sanitize_corners( $v ) {
	return in_array( $v, [ 'square', 'round', 'very-round' ], true ) ? $v : 'square';
}

/** Whitelist-sanitize font-style (italic / normal). */
function ajbq_sanitize_font_style( $v ) {
	return in_array( $v, [ 'italic', 'normal' ], true ) ? $v : 'normal';
}

/** Whitelist-sanitize font-weight (normal / 500 / bold). */
function ajbq_sanitize_font_weight( $v ) {
	return in_array( $v, [ 'normal', '500', 'bold' ], true ) ? $v : 'normal';
}

// Single-arg wrapper for ajbq_sanitize_dimension() used as register_setting sanitize_callback.
function ajbq_sanitize_dimension_cb( $v ) { return ajbq_sanitize_dimension( $v, '' ); }

/**
 * Sanitize a CSS dimension value.
 * - If the value is a bare integer or float, appends 'px'.
 * - If the value contains letters after digits (e.g. "20upx", "30 px"), strips
 *   everything after the number and appends the correct unit.
 * - Passes through recognised units: px, em, rem, %, vw, vh, pt, cm, mm, ex, ch.
 * - Returns the fallback if the value is empty or unrecognisable.
 *
 * @param string $v        Raw value from shortcode attr or option.
 * @param string $fallback Returned when value is empty/invalid.
 * @return string
 */
function ajbq_sanitize_dimension( $v, $fallback = '' ) {
	$v = trim( sanitize_text_field( $v ) );
	if ( '' === $v ) return $fallback;
	// Already has a valid CSS unit — pass through.
	if ( preg_match( '/^[\d.]+\s*(px|em|rem|%|vw|vh|pt|cm|mm|ex|ch)$/i', $v ) ) {
		return $v;
	}
	// Special keyword values.
	if ( in_array( strtolower( $v ), [ 'auto', 'inherit', 'initial', 'unset', '0' ], true ) ) {
		return $v;
	}
	// Bare number — append px.
	if ( preg_match( '/^[\d.]+$/', $v ) ) {
		return $v . 'px';
	}
	// Number followed by garbage — extract the number and append px.
	if ( preg_match( '/^([\d.]+)/', $v, $m ) ) {
		return $m[1] . 'px';
	}
	return $fallback;
}

/**
 * Sanitize prefix/suffix fields.
 * WordPress's update_option() won't update an option to '' if the old value
 * was a non-empty string. We work around this by storing a sentinel value
 * 'ajbq_empty' when the field is blank, and converting back on read.
 * ajbq_get_prefix_suffix() handles the conversion transparently.
 */
function ajbq_sanitize_prefix_suffix( $v ) {
	$v = wp_strip_all_tags( $v );
	$v = preg_replace( '/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $v );
	// Store sentinel so empty string is persisted reliably.
	return ( '' === $v ) ? 'ajbq_empty' : $v;
}

/**
 * Read a prefix/suffix option, converting the sentinel back to empty string.
 *
 * @param string $option  Option name (ajbq_author_prefix or ajbq_author_suffix).
 * @param string $default Hard default if option has never been saved.
 * @return string
 */
function ajbq_get_prefix_suffix( $option, $default ) {
	$v = get_option( $option, $default );
	return ( 'ajbq_empty' === $v ) ? '' : $v;
}


/**
 * Sanitize a CSS colour value entered by the user.
 * - Prepends # if the user typed a hex value without it (e.g. "ffffff").
 * - Passes through anything sanitize_hex_color accepts.
 * - Returns $fallback for anything unrecognisable.
 *
 * @param string $v        Raw value.
 * @param string $fallback Returned when value is empty/invalid.
 * @return string
 */
function ajbq_sanitize_color( $v, $fallback = '' ) {
	$v = trim( sanitize_text_field( $v ) );
	if ( '' === $v ) return $fallback;
	// Prepend # if it looks like a hex value without one.
	if ( preg_match( '/^[0-9a-fA-F]{3}$|^[0-9a-fA-F]{6}$/', $v ) ) {
		$v = '#' . $v;
	}
	$clean = sanitize_hex_color( $v );
	return $clean ? $clean : $fallback;
}


function ajbq_settings_page() {
	// Handle manual cache clear.
	if ( isset( $_POST['ajbq_clear_cache'] ) && check_admin_referer( 'ajbq_clear_cache' ) ) {
		global $wpdb;
		$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", '_transient_rtq_daily_%' ) );
		$wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", '_transient_timeout_rtq_daily_%' ) );
		echo '<div class="notice notice-success is-dismissible"><p>' . esc_html__( 'Daily quote cache cleared.', 'ajb-random-quote-cards' ) . '</p></div>';
	}
	?>
	<div class="wrap">
		<h1><?php esc_html_e( 'Global Default Settings', 'ajb-random-quote-cards' ); ?></h1>
		<p class="description"><?php esc_html_e( 'These are the default styles used by every quote card. You can override any of these per card inside the shortcode itself — see the Shortcode Builder tab for details.', 'ajb-random-quote-cards' ); ?></p>
		<hr>

		<form method="post" action="options.php" style="max-width:680px;">
			<?php settings_fields( 'ajbq_settings_group' ); ?>

			<h2><?php esc_html_e( 'Container', 'ajb-random-quote-cards' ); ?></h2>
			<table class="form-table" role="presentation">
				<tr>
					<th scope="row"><?php esc_html_e( 'Background Colour', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_bg_color" class="ajbq-color-picker"
						value="<?php echo esc_attr( get_option( 'ajbq_bg_color', '#f9f9f9' ) ); ?>"></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Width', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<input type="text" name="ajbq_width" class="regular-text"
							placeholder="450px"
							value="<?php echo esc_attr( get_option( 'ajbq_width', '450px' ) ); ?>">
						<p class="description"><?php esc_html_e( 'Use px for fixed width or 100% to fill the column.', 'ajb-random-quote-cards' ); ?></p>
					</td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Height', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<input type="text" name="ajbq_height" class="regular-text"
							placeholder="auto"
							value="<?php echo esc_attr( get_option( 'ajbq_height', 'auto' ) ); ?>">
						<p class="description"><?php esc_html_e( 'Leave as "auto" to grow with the content.', 'ajb-random-quote-cards' ); ?></p>
					</td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Corner Style', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<select name="ajbq_corners">
							<?php foreach ( [ 'square' => 'Square', 'round' => 'Round (8px)', 'very-round' => 'Very Round (25px)' ] as $v => $l ) {
								printf( '<option value="%s" %s>%s</option>', esc_attr( $v ), selected( get_option( 'ajbq_corners', 'square' ), $v, false ), esc_html( $l ) );
							} ?>
						</select>
					</td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Show Elements', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<?php ajbq_checkbox_row( 'ajbq_show_author', '1', __( 'Show Author', 'ajb-random-quote-cards' ) ); ?>
						<?php ajbq_checkbox_row( 'ajbq_show_link',   '1', __( 'Show External Link', 'ajb-random-quote-cards' ) ); ?>
					</td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Actions', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<?php ajbq_checkbox_row( 'ajbq_show_copy', '1', __( 'Enable Copy to Clipboard button', 'ajb-random-quote-cards' ) ); ?>
					</td>
				</tr>
			</table>

			<hr>
			<h2><?php esc_html_e( 'Quote Typography', 'ajb-random-quote-cards' ); ?></h2>
			<?php ajbq_font_note(); ?>
			<table class="form-table" role="presentation">
				<?php ajbq_font_row( 'ajbq_quote_font', 'Roboto' ); ?>
				<tr>
					<th scope="row"><?php esc_html_e( 'Style & Weight', 'ajb-random-quote-cards' ); ?></th>
					<td><?php ajbq_style_weight( 'ajbq_quote_style', 'italic', 'ajbq_quote_weight', '500' ); ?></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Font Size', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_quote_size" class="small-text"
						value="<?php echo esc_attr( get_option( 'ajbq_quote_size', '18px' ) ); ?>">
					</td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Text Colour', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_quote_color" class="ajbq-color-picker"
						value="<?php echo esc_attr( get_option( 'ajbq_quote_color', '#333333' ) ); ?>"></td>
				</tr>
			</table>

			<hr>
			<h2><?php esc_html_e( 'Author Typography', 'ajb-random-quote-cards' ); ?></h2>
			<?php ajbq_font_note(); ?>
			<table class="form-table" role="presentation">
				<?php ajbq_font_row( 'ajbq_author_font', 'Roboto' ); ?>
				<tr>
					<th scope="row"><?php esc_html_e( 'Style & Weight', 'ajb-random-quote-cards' ); ?></th>
					<td><?php ajbq_style_weight( 'ajbq_author_style', 'normal', 'ajbq_author_weight', 'bold' ); ?></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Font Size', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_author_size" class="small-text"
						value="<?php echo esc_attr( get_option( 'ajbq_author_size', '14px' ) ); ?>"></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Text Colour', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_author_color" class="ajbq-color-picker"
						value="<?php echo esc_attr( get_option( 'ajbq_author_color', '#666666' ) ); ?>"></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Prefix / Suffix', 'ajb-random-quote-cards' ); ?></th>
					<td>
						<input type="text" name="ajbq_author_prefix" class="small-text"
							placeholder="<?php esc_attr_e( '— ', 'ajb-random-quote-cards' ); ?>"
							value="<?php echo esc_attr( ajbq_get_prefix_suffix( 'ajbq_author_prefix', '— ' ) ); ?>">
						<span class="description" style="margin-right:20px;"><?php esc_html_e( 'Before name', 'ajb-random-quote-cards' ); ?></span>
						<input type="text" name="ajbq_author_suffix" class="small-text"
							placeholder="<?php esc_attr_e( '☘️', 'ajb-random-quote-cards' ); ?>"
							value="<?php echo esc_attr( ajbq_get_prefix_suffix( 'ajbq_author_suffix', '' ) ); ?>">
						<span class="description"><?php esc_html_e( 'After name', 'ajb-random-quote-cards' ); ?></span>
						<p class="description" style="margin-top:6px;"><?php esc_html_e( 'Leave either field completely blank to show no prefix or suffix. The placeholder text is just an example — it is not saved unless you type it in.', 'ajb-random-quote-cards' ); ?></p>
					</td>
				</tr>
			</table>

			<hr>
			<h2><?php esc_html_e( 'Link & Icon Typography', 'ajb-random-quote-cards' ); ?></h2>
			<?php ajbq_font_note(); ?>
			<table class="form-table" role="presentation">
				<?php ajbq_font_row( 'ajbq_link_font', 'Roboto' ); ?>
				<tr>
					<th scope="row"><?php esc_html_e( 'Font Size', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_link_size" class="small-text"
						value="<?php echo esc_attr( get_option( 'ajbq_link_size', '13px' ) ); ?>"></td>
				</tr>
				<tr>
					<th scope="row"><?php esc_html_e( 'Icon / Link Colour', 'ajb-random-quote-cards' ); ?></th>
					<td><input type="text" name="ajbq_link_color" class="ajbq-color-picker"
						value="<?php echo esc_attr( get_option( 'ajbq_link_color', '#0073aa' ) ); ?>"></td>
				</tr>
			</table>

			<?php submit_button(); ?>
		</form>

		<hr>
		<h2><?php esc_html_e( 'Daily Quote Cache', 'ajb-random-quote-cards' ); ?></h2>
		<p class="description"><?php esc_html_e( 'If you\'ve added or changed quotes and want the "Quote of the Day" to refresh straight away, use this button to clear the cache.', 'ajb-random-quote-cards' ); ?></p>
		<form method="post">
			<?php wp_nonce_field( 'ajbq_clear_cache' ); ?>
			<?php submit_button( __( 'Clear Daily Quote Cache', 'ajb-random-quote-cards' ), 'secondary', 'ajbq_clear_cache', false ); ?>
		</form>
	</div>
	<?php
}

/** Small helper: renders a checkbox row. */
function ajbq_checkbox_row( $option, $default, $label ) {
	printf(
		'<label><input type="checkbox" name="%s" value="1" %s> %s</label><br>',
		esc_attr( $option ),
		checked( get_option( $option, $default ), '1', false ),
		esc_html( $label )
	);
}

/** Renders the Google Fonts helper note shown under each font section. */
function ajbq_font_note() {
	echo '<p class="description" style="margin-bottom:8px;">';
	esc_html_e( 'Type the exact font name from ', 'ajb-random-quote-cards' );
	echo '<a href="https://fonts.google.com" target="_blank" rel="noopener noreferrer">fonts.google.com</a>';
	esc_html_e( ' — e.g. Roboto, Merriweather, Lato. Copy it exactly as shown on the site.', 'ajb-random-quote-cards' );
	echo '</p>';
}

/** Renders font family row. */
function ajbq_font_row( $option, $default ) {
	?>
	<tr>
		<th scope="row"><?php esc_html_e( 'Font Family', 'ajb-random-quote-cards' ); ?></th>
		<td>
			<input type="text" name="<?php echo esc_attr( $option ); ?>" class="regular-text"
				value="<?php echo esc_attr( get_option( $option, $default ) ); ?>">
		</td>
	</tr>
	<?php
}

/** Renders paired style / weight selects. */
function ajbq_style_weight( $style_name, $style_default, $weight_name, $weight_default ) {
	$styles  = [ 'italic' => 'Italic', 'normal' => 'Normal' ];
	$weights = [ 'normal' => 'Regular (400)', '500' => 'Medium (500)', 'bold' => 'Bold (700)' ];
	echo '<select name="' . esc_attr( $style_name ) . '" style="margin-right:10px;">';
	foreach ( $styles as $v => $l ) {
		printf( '<option value="%s" %s>%s</option>', esc_attr( $v ), selected( get_option( $style_name, $style_default ), $v, false ), esc_html( $l ) );
	}
	echo '</select>';
	echo '<select name="' . esc_attr( $weight_name ) . '">';
	foreach ( $weights as $v => $l ) {
		printf( '<option value="%s" %s>%s</option>', esc_attr( $v ), selected( get_option( $weight_name, $weight_default ), $v, false ), esc_html( $l ) );
	}
	echo '</select>';
}


// =========================================================================
// 7. SHORTCODE BUILDER PAGE
// =========================================================================
function ajbq_builder_page() {
	?>
	<div class="wrap">
		<h1><?php esc_html_e( 'Shortcode Builder', 'ajb-random-quote-cards' ); ?></h1>
		<p class="description"><?php esc_html_e( 'Build your shortcode below. Your settings are saved automatically — they will still be here when you come back. Any option left on "Use Global Default" will inherit from the Settings page.', 'ajb-random-quote-cards' ); ?></p>
		<p><button type="button" id="ajbq-reset-btn" class="button button-small" style="color:#b32d2e;"><?php esc_html_e( 'Reset Builder', 'ajb-random-quote-cards' ); ?></button> <span class="description"><?php esc_html_e( 'Clears all saved settings and starts fresh.', 'ajb-random-quote-cards' ); ?></span></p>
		<div class="notice notice-info inline" style="margin:12px 0;">
			<p>
				<strong><?php esc_html_e( 'Prefer the block editor?', 'ajb-random-quote-cards' ); ?></strong>
				<?php esc_html_e( 'AJB Random Quote Cards includes a native Gutenberg block — search for "Random Quote" in the block inserter (under Widgets). All the same options are available directly in the block\'s Inspector sidebar, no shortcode needed.', 'ajb-random-quote-cards' ); ?>
			</p>
		</div>
		<hr>

		<div style="display:flex; gap:30px; flex-wrap:wrap; align-items:flex-start;">

			<!-- Controls -->
			<div style="flex:1; min-width:300px; max-width:500px;">

				<h3><?php esc_html_e( 'Source & Display', 'ajb-random-quote-cards' ); ?></h3>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row"><?php esc_html_e( 'Source', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_source">
								<option value="all"><?php esc_html_e( 'Everything in database', 'ajb-random-quote-cards' ); ?></option>
								<option value="favorites"><?php esc_html_e( 'Admin Favourites only', 'ajb-random-quote-cards' ); ?></option>
								<!-- Categories added by builder.js -->
							</select>
						</td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Display Mode', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_mode">
								<option value="random"><?php esc_html_e( 'Random on every page load', 'ajb-random-quote-cards' ); ?></option>
								<option value="daily"><?php esc_html_e( 'Quote of the Day (changes at midnight)', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Layout', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_layout">
								<option value="block_center"><?php esc_html_e( 'Block — Centre aligned', 'ajb-random-quote-cards' ); ?></option>
								<option value="block_left"><?php esc_html_e( 'Block — Left aligned',   'ajb-random-quote-cards' ); ?></option>
								<option value="block_right"><?php esc_html_e( 'Block — Right aligned',  'ajb-random-quote-cards' ); ?></option>
								<option value="inline"><?php esc_html_e( 'Inline (flows with text)',   'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
				</table>

				<h3><?php esc_html_e( 'Card Style Overrides', 'ajb-random-quote-cards' ); ?></h3>
				<p class="description"><?php esc_html_e( 'Leave any field blank to use the global default from Settings. Colour fields require a full hex value including the # symbol — e.g. #ffffff. These overrides apply to all layouts including Inline.', 'ajb-random-quote-cards' ); ?></p>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row"><?php esc_html_e( 'Background Colour', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_bg" class="ajbq-builder-color small-text" placeholder="#f9f9f9"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Width', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_width" class="regular-text" placeholder="450px"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Corner Style', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_corners">
								<option value=""><?php esc_html_e( 'Use Global Default', 'ajb-random-quote-cards' ); ?></option>
								<option value="square"><?php esc_html_e( 'Square', 'ajb-random-quote-cards' ); ?></option>
								<option value="round"><?php esc_html_e( 'Round (8px)', 'ajb-random-quote-cards' ); ?></option>
								<option value="very-round"><?php esc_html_e( 'Very Round (25px)', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Quote Font', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_qfont" class="regular-text" placeholder="Merriweather"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Quote Size', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_qsize" class="small-text" placeholder="20px"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Quote Colour', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_qcolor" class="ajbq-builder-color small-text" placeholder="#333333"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Quote Weight', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_qweight">
								<option value=""><?php esc_html_e( 'Use Global Default', 'ajb-random-quote-cards' ); ?></option>
								<option value="normal"><?php esc_html_e( 'Regular (400)', 'ajb-random-quote-cards' ); ?></option>
								<option value="500"><?php esc_html_e( 'Medium (500)', 'ajb-random-quote-cards' ); ?></option>
								<option value="bold"><?php esc_html_e( 'Bold (700)', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Author Style', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_astyle">
								<option value=""><?php esc_html_e( 'Use Global Default', 'ajb-random-quote-cards' ); ?></option>
								<option value="normal"><?php esc_html_e( 'Normal', 'ajb-random-quote-cards' ); ?></option>
								<option value="italic"><?php esc_html_e( 'Italic', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Author Colour', 'ajb-random-quote-cards' ); ?></th>
						<td><input type="text" id="sc_acolor" class="ajbq-builder-color small-text" placeholder="#666666"></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Prefix Override', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_prefix_sel">
								<option value=""><?php esc_html_e( 'Keep Global Setting', 'ajb-random-quote-cards' ); ?></option>
								<option value="none"><?php esc_html_e( 'None — clear prefix & suffix', 'ajb-random-quote-cards' ); ?></option>
								<option value="dot"><?php esc_html_e( 'Dot  ( • )', 'ajb-random-quote-cards' ); ?></option>
								<option value="shamrock"><?php esc_html_e( 'Shamrock  ( ☘️ )', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
				</table>

				<h3><?php esc_html_e( 'Copy Button Override', 'ajb-random-quote-cards' ); ?></h3>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row"><?php esc_html_e( 'Copy to Clipboard', 'ajb-random-quote-cards' ); ?></th>
						<td>
							<select id="sc_copy">
								<option value=""><?php esc_html_e( 'Use Global Default', 'ajb-random-quote-cards' ); ?></option>
								<option value="1"><?php esc_html_e( 'Force ON',  'ajb-random-quote-cards' ); ?></option>
								<option value="0"><?php esc_html_e( 'Force OFF', 'ajb-random-quote-cards' ); ?></option>
							</select>
						</td>
					</tr>
				</table>
			</div>

			<!-- Output panel -->
			<div style="position:sticky; top:40px; width:380px; flex-shrink:0;">

				<div class="postbox">
					<div class="postbox-header">
						<h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( 'Live Preview', 'ajb-random-quote-cards' ); ?></h2>
					</div>
					<div class="inside">
						<p class="description" style="margin-bottom:10px;"><?php esc_html_e( 'Shows a real quote card using your current settings. Updates when you click Refresh.', 'ajb-random-quote-cards' ); ?></p>
						<div id="ajbq-preview-frame" style="min-height:80px; padding:12px; background:#fff; border:1px solid #ddd; border-radius:4px; margin-bottom:10px; font-style:italic; color:#999; font-size:13px;">
							<?php esc_html_e( 'Click Refresh Preview to see your card.', 'ajb-random-quote-cards' ); ?>
						</div>
						<button type="button" id="ajbq-preview-btn" class="button button-secondary" style="width:100%;">
							<?php esc_html_e( '🔄 Refresh Preview', 'ajb-random-quote-cards' ); ?>
						</button>
					</div>
				</div>

				<div class="postbox">
					<div class="postbox-header">
						<h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( 'Your Shortcode', 'ajb-random-quote-cards' ); ?></h2>
					</div>
					<div class="inside">
						<p class="description"><?php esc_html_e( 'This updates live as you make changes above.', 'ajb-random-quote-cards' ); ?></p>
						<code id="ajbq-shortcode-output"
							style="display:block; padding:12px; background:#f0f0f1; font-size:13px; font-weight:600; word-break:break-all; border-radius:4px; min-height:40px; margin-bottom:12px;"
						>[ajbq_quote]</code>
						<button type="button" id="ajbq-copy-btn" class="button button-primary" style="width:100%;">
							<?php esc_html_e( '📋 Copy Shortcode', 'ajb-random-quote-cards' ); ?>
						</button>
						<p id="ajbq-copy-confirm" style="color:green; margin-top:8px; display:none; font-weight:600;">
							✓ <?php esc_html_e( 'Copied to clipboard!', 'ajb-random-quote-cards' ); ?>
						</p>
					</div>
				</div>

				<div class="postbox" style="margin-top:0;">
					<div class="postbox-header">
						<h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( 'Quick Tips', 'ajb-random-quote-cards' ); ?></h2>
					</div>
					<div class="inside" style="font-size:13px; line-height:1.7;">
						<p>💡 <strong><?php esc_html_e( 'Two different cards on one page?', 'ajb-random-quote-cards' ); ?></strong><br>
						<?php esc_html_e( 'Use this builder twice with different style overrides and place both shortcodes on your page.', 'ajb-random-quote-cards' ); ?></p>
						<p>💡 <strong><?php esc_html_e( 'Inline quote in a paragraph?', 'ajb-random-quote-cards' ); ?></strong><br>
						<?php esc_html_e( 'Set Layout to Inline and the quote will flow naturally within your page text, styled by your theme.', 'ajb-random-quote-cards' ); ?></p>
						<p>💡 <strong><?php esc_html_e( 'Quote of the Day not refreshing?', 'ajb-random-quote-cards' ); ?></strong><br>
						<?php esc_html_e( 'Go to Settings and use the Clear Cache button to force a fresh pick immediately.', 'ajb-random-quote-cards' ); ?></p>
					</div>
				</div>
			</div>

		</div>
	</div>
	<?php
}


// =========================================================================
// 8. SHORTCODE BUILDER — AJAX LIVE PREVIEW
// =========================================================================

// Register AJAX handlers.
add_action( 'wp_ajax_ajbq_preview', 'ajbq_ajax_preview' );

function ajbq_ajax_preview() {
	check_ajax_referer( 'ajbq_builder_preview', 'nonce' );
	if ( ! current_user_can( 'manage_options' ) ) {
		wp_send_json_error( 'Unauthorised' );
	}

	// Build atts from posted values — sanitize everything.
	$atts = [
		'source'        => sanitize_text_field( $_POST['source']        ?? 'all' ),
		'category'      => sanitize_text_field( $_POST['category']      ?? '' ),
		'mode'          => 'random', // Always random in preview.
		'layout'        => sanitize_text_field( $_POST['layout']        ?? 'block_center' ),
		'bg_color'      => sanitize_text_field( $_POST['bg_color']      ?? '' ),
		'width'         => sanitize_text_field( $_POST['width']         ?? '' ),
		'corners'       => sanitize_text_field( $_POST['corners']       ?? '' ),
		'quote_font'    => sanitize_text_field( $_POST['quote_font']    ?? '' ),
		'quote_size'    => sanitize_text_field( $_POST['quote_size']    ?? '' ),
		'quote_color'   => sanitize_text_field( $_POST['quote_color']   ?? '' ),
		'quote_style'   => sanitize_text_field( $_POST['quote_style']   ?? '' ),
		'quote_weight'  => sanitize_text_field( $_POST['quote_weight']  ?? '' ),
		'author_font'   => sanitize_text_field( $_POST['author_font']   ?? '' ),
		'author_size'   => sanitize_text_field( $_POST['author_size']   ?? '' ),
		'author_color'  => sanitize_text_field( $_POST['author_color']  ?? '' ),
		'author_style'  => sanitize_text_field( $_POST['author_style']  ?? '' ),
		'author_weight' => sanitize_text_field( $_POST['author_weight'] ?? '' ),
		'author_prefix' => '[DEFAULT]',
		'author_suffix' => '[DEFAULT]',
		'show_copy'     => '0', // No copy button in preview.
	];

	// Pick a random published quote.
	$query_args = [
		'post_type'      => AJBQ_POST_TYPE,
		'posts_per_page' => 1,
		'orderby'        => 'rand',
		'post_status'    => 'publish',
		'no_found_rows'  => true,
	];

	if ( 'favorites' === $atts['source'] ) {
		$query_args['meta_query'] = [ [ 'key' => '_rtq_is_favorite', 'value' => '1' ] ];
	}
	if ( ! empty( $atts['category'] ) ) {
		$query_args['tax_query'] = [ [
			'taxonomy' => AJBQ_TAXONOMY,
			'field'    => 'slug',
			'terms'    => sanitize_title( $atts['category'] ),
		] ];
	}

	$posts = get_posts( $query_args );
	if ( empty( $posts ) ) {
		wp_send_json_error( __( 'No quotes found matching those settings. Try changing the source or category.', 'ajb-random-quote-cards' ) );
	}

	$post     = $posts[0];
	$text     = ! empty( $post->post_content ) ? $post->post_content : $post->post_title;
	$author   = get_post_meta( $post->ID, '_rtq_author',   true );
	$link_ext = get_post_meta( $post->ID, '_rtq_link_ext', true );

	// Get the CSS that would normally be enqueued — build it inline for the preview.
	$bg     = ajbq_sanitize_color( get_option( 'ajbq_bg_color',    '#f9f9f9' ), '#f9f9f9' );
	$qcolor = ajbq_sanitize_color( get_option( 'ajbq_quote_color', '#333333' ), '#333333' );
	$acolor = ajbq_sanitize_color( get_option( 'ajbq_author_color','#666666' ), '#666666' );
	$icolor = ajbq_sanitize_color( get_option( 'ajbq_link_color',  '#0073aa' ), '#0073aa' );
	$qfont  = ajbq_sanitize_font_name( get_option( 'ajbq_quote_font',  'Roboto' ), 'Roboto' );
	$afont  = ajbq_sanitize_font_name( get_option( 'ajbq_author_font', 'Roboto' ), 'Roboto' );
	$qsize  = ajbq_sanitize_dimension( get_option( 'ajbq_quote_size',  '18px' ), '18px' );
	$asize  = ajbq_sanitize_dimension( get_option( 'ajbq_author_size', '14px' ), '14px' );
	$w      = ajbq_sanitize_dimension( get_option( 'ajbq_width', '450px' ), '450px' );

	$corners_val = get_option( 'ajbq_corners', 'square' );
	$radius = ( 'round' === $corners_val ) ? '8px' : ( ( 'very-round' === $corners_val ) ? '25px' : '0px' );

	// Return CSS as a plain string — no <style> tag in PHP.
	// builder.js injects this into a <style> element it owns in the preview area,
	// which keeps PHP free of raw HTML tag output in AJAX responses.
	$css = "
	.ajbq-preview-wrap{font-family:sans-serif;}
	.ajbq-block-container{background-color:{$bg};border-radius:{$radius};width:{$w};max-width:100%;padding:20px;margin:0 auto;box-sizing:border-box;border:1px solid rgba(0,0,0,.08);word-wrap:break-word;overflow-wrap:break-word;}
	.ajbq-block-container.align-center{text-align:center;}
	.ajbq-block-container.align-left{text-align:left;}
	.ajbq-block-container.align-right{text-align:right;}
	.ajbq-quote-text-wrapper{display:block;margin-bottom:8px;position:relative;}
	.ajbq-quote-text{font-family:'{$qfont}',sans-serif;font-size:{$qsize};color:{$qcolor};}
	.ajbq-author{font-family:'{$afont}',sans-serif;font-size:{$asize};color:{$acolor};display:block;margin-top:6px;}
	.ajbq-footer-controls{margin-top:10px;}
	.ajbq-link{font-size:13px;color:{$icolor};text-decoration:underline;}
	.ajbq-inline{font-family:'{$qfont}',sans-serif;font-size:{$qsize};color:{$qcolor};}
	.ajbq-inline-author{font-family:'{$afont}',sans-serif;font-size:{$asize};color:{$acolor};}
	";

	$html = ajbq_build_output( $text, $author, $link_ext, $atts );

	wp_send_json_success( [ 'css' => $css, 'html' => '<div class="ajbq-preview-wrap">' . $html . '</div>' ] );
}


// =========================================================================
// 9. CSV IMPORT & EXPORT
// =========================================================================
add_action( 'admin_init', 'ajbq_handle_csv_export' );
function ajbq_handle_csv_export() {
	if ( ! isset( $_POST['ajbq_export_csv'] ) ) return;
	if ( ! current_user_can( 'manage_options' ) ) return;
	check_admin_referer( 'ajbq_csv_export_nonce' );

	$filename = 'wp-quotes-export-' . gmdate( 'Y-m-d' ) . '.csv';
	header( 'Content-Type: text/csv; charset=utf-8' );
	header( 'Content-Disposition: attachment; filename=' . $filename );
	header( 'Pragma: no-cache' );

	$out = fopen( 'php://output', 'w' );
	fputcsv( $out, [ 'Quote', 'Author', 'External Link', 'Category', 'Is Favourite' ] );

	$quotes = get_posts( [
		'post_type'      => AJBQ_POST_TYPE,
		'posts_per_page' => -1,
		'post_status'    => 'publish',
		'no_found_rows'  => true,
	] );

	foreach ( $quotes as $q ) {
		$cats = wp_get_post_terms( $q->ID, AJBQ_TAXONOMY, [ 'fields' => 'names' ] );
		// Export from post_content (the canonical quote text location since v2).
		$quote_text = ! empty( $q->post_content ) ? $q->post_content : $q->post_title;
		fputcsv( $out, [
			$quote_text,
			get_post_meta( $q->ID, '_rtq_author',      true ),
			get_post_meta( $q->ID, '_rtq_link_ext',    true ),
			! empty( $cats ) ? $cats[0] : '',
			get_post_meta( $q->ID, '_rtq_is_favorite', true ),
		] );
	}
	fclose( $out );
	exit;
}

function ajbq_import_export_page() {
	$imported = 0;
	$skipped  = 0;
	$error    = '';
	$done     = false;

	if ( isset( $_POST['ajbq_import_csv'] ) && check_admin_referer( 'ajbq_csv_import_nonce' ) ) {

		if ( empty( $_FILES['csv_file']['tmp_name'] ) ) {
			$error = __( 'Please choose a CSV file to upload.', 'ajb-random-quote-cards' );
		} else {
			$handle = fopen( $_FILES['csv_file']['tmp_name'], 'r' );
			if ( ! $handle ) {
				$error = __( 'Could not open the uploaded file.', 'ajb-random-quote-cards' );
			} else {
				fgetcsv( $handle ); // skip header

				// Build a list of existing quote texts for duplicate checking.
				// Check post_content (new location). Fall back to post_title for
				// quotes not yet migrated.
				$existing = get_posts( [
					'post_type'      => AJBQ_POST_TYPE,
					'posts_per_page' => -1,
					'post_status'    => 'any',
					'no_found_rows'  => true,
				] );
				$existing_texts = array_map( function( $p ) {
					$text = ! empty( $p->post_content ) ? $p->post_content : $p->post_title;
					return strtolower( trim( $text ) );
				}, $existing );

				while ( ( $row = fgetcsv( $handle, 2000, ',' ) ) !== false ) {
					$quote_text = sanitize_textarea_field( wp_check_invalid_utf8( isset( $row[0] ) ? $row[0] : '', true ) );
					$author     = sanitize_text_field( wp_check_invalid_utf8( isset( $row[1] ) ? $row[1] : '', true ) );
					$link_ext   = ! empty( $row[2] ) ? esc_url_raw( $row[2] ) : '';
					$category   = ! empty( $row[3] ) ? sanitize_text_field( $row[3] ) : '';
					$is_fav     = ( isset( $row[4] ) && '1' === $row[4] ) ? '1' : '0';

					if ( empty( $quote_text ) ) continue;

					// Skip duplicates.
					if ( in_array( strtolower( trim( $quote_text ) ), $existing_texts, true ) ) {
						$skipped++;
						continue;
					}

					// Store quote text in post_content; use a truncated version as title.
					$post_id = wp_insert_post( [
						'post_title'   => wp_trim_words( $quote_text, 12, '…' ),
						'post_content' => $quote_text,
						'post_status'  => 'publish',
						'post_type'    => AJBQ_POST_TYPE,
					] );

					if ( is_wp_error( $post_id ) || ! $post_id ) continue;

					update_post_meta( $post_id, '_rtq_author',      $author );
					update_post_meta( $post_id, '_rtq_link_ext',    $link_ext );
					update_post_meta( $post_id, '_rtq_is_favorite', $is_fav );

					// Categories: support pipe (|) or comma (,) as separator for multiple values.
					if ( ! empty( $category ) ) {
						// Normalise — replace pipe with comma, then split.
						$cat_names = array_filter( array_map( 'trim', explode( ',', str_replace( '|', ',', $category ) ) ) );
						$term_ids  = [];
						foreach ( $cat_names as $cat_name ) {
							$cat_name = sanitize_text_field( $cat_name );
							if ( '' === $cat_name ) continue;
							$term = term_exists( $cat_name, AJBQ_TAXONOMY );
							if ( ! $term ) {
								$term = wp_insert_term( $cat_name, AJBQ_TAXONOMY );
							}
							if ( ! is_wp_error( $term ) ) {
								$term_ids[] = (int) $term['term_id'];
							}
						}
						if ( ! empty( $term_ids ) ) {
							wp_set_post_terms( $post_id, $term_ids, AJBQ_TAXONOMY );
						}
					}

					// Add to known list so duplicates within the same file are caught too.
					$existing_texts[] = strtolower( trim( $quote_text ) );
					$imported++;
				}
				fclose( $handle );
				$done = true;
			}
		}
	}
	?>
	<div class="wrap">
		<h1><?php esc_html_e( 'Import & Export Quotes', 'ajb-random-quote-cards' ); ?></h1>

		<?php if ( $done ) : ?>
			<div class="notice notice-success is-dismissible"><p>
				<?php printf(
					esc_html__( 'Import complete. %1$d quote(s) added, %2$d duplicate(s) skipped.', 'ajb-random-quote-cards' ),
					$imported, $skipped
				); ?>
			</p></div>
		<?php elseif ( $error ) : ?>
			<div class="notice notice-error is-dismissible"><p><?php echo esc_html( $error ); ?></p></div>
		<?php endif; ?>

		<div class="postbox" style="max-width:600px; margin-bottom:20px;">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( 'Import Quotes from CSV', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside">
				<p><?php esc_html_e( 'Upload a CSV file to add quotes in bulk. Duplicates are detected and skipped automatically.', 'ajb-random-quote-cards' ); ?></p>

				<table class="widefat striped" style="margin-bottom:16px;">
					<thead>
						<tr>
							<th><?php esc_html_e( 'Column', 'ajb-random-quote-cards' ); ?></th>
							<th><?php esc_html_e( 'Required?', 'ajb-random-quote-cards' ); ?></th>
							<th><?php esc_html_e( 'Notes', 'ajb-random-quote-cards' ); ?></th>
						</tr>
					</thead>
					<tbody>
						<tr><td><strong>Quote</strong></td><td><?php esc_html_e( 'Yes', 'ajb-random-quote-cards' ); ?></td><td><?php esc_html_e( 'The quote text. Wrap in double-quotes if it contains commas.', 'ajb-random-quote-cards' ); ?></td></tr>
						<tr><td><strong>Author</strong></td><td><?php esc_html_e( 'No', 'ajb-random-quote-cards' ); ?></td><td><?php esc_html_e( 'Author name. Leave blank if unknown.', 'ajb-random-quote-cards' ); ?></td></tr>
						<tr><td><strong>External Link</strong></td><td><?php esc_html_e( 'No', 'ajb-random-quote-cards' ); ?></td><td><?php esc_html_e( 'Full URL including https://. Leave blank if none.', 'ajb-random-quote-cards' ); ?></td></tr>
						<tr><td><strong>Category</strong></td><td><?php esc_html_e( 'No', 'ajb-random-quote-cards' ); ?></td><td><?php esc_html_e( 'Category name. Separate multiple categories with a pipe | or comma ,. Created automatically if they do not exist.', 'ajb-random-quote-cards' ); ?></td></tr>
						<tr><td><strong>Is Favourite</strong></td><td><?php esc_html_e( 'No', 'ajb-random-quote-cards' ); ?></td><td><?php esc_html_e( '1 = mark as favourite, 0 or blank = not a favourite.', 'ajb-random-quote-cards' ); ?></td></tr>
					</tbody>
				</table>

				<p class="description" style="margin-bottom:12px;"><?php esc_html_e( 'Example row:', 'ajb-random-quote-cards' ); ?><br>
				<code>"Be yourself; everyone else is already taken.",Oscar Wilde,,Inspiration|Humour,1</code></p>

				<form method="post" enctype="multipart/form-data" style="margin-top:12px;">
					<?php wp_nonce_field( 'ajbq_csv_import_nonce' ); ?>
					<input type="file" name="csv_file" accept=".csv" required>
					<br><br>
					<?php submit_button( __( 'Import CSV', 'ajb-random-quote-cards' ), 'primary', 'ajbq_import_csv', false ); ?>
				</form>
			</div>
		</div>

		<div class="postbox" style="max-width:600px;">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( 'Export Quotes to CSV', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside">
				<p><?php esc_html_e( 'Download all your quotes as a CSV file — useful for backups or moving to another site.', 'ajb-random-quote-cards' ); ?></p>
				<form method="post" style="margin-top:12px;">
					<?php wp_nonce_field( 'ajbq_csv_export_nonce' ); ?>
					<?php submit_button( __( 'Download Quotes CSV', 'ajb-random-quote-cards' ), 'secondary', 'ajbq_export_csv', false ); ?>
				</form>
			</div>
		</div>
	</div>
	<?php
}


// =========================================================================
// 9. HELP & TIPS PAGE
// =========================================================================
function ajbq_help_page() {
	?>
	<div class="wrap">
		<h1><?php esc_html_e( 'Help & Tips', 'ajb-random-quote-cards' ); ?></h1>

		<!-- Getting Started -->
		<div class="postbox">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( '🚀 Getting Started', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside" style="line-height:1.8;">
				<ol>
					<li><?php esc_html_e( 'Go to AJB Quotes → Add New. Fill in the Quote Text, Author, and any other details in the form, then click Publish.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Visit Settings to set your global defaults — colours, fonts, and whether to show the copy button.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Add a quote to any page or post in one of two ways:', 'ajb-random-quote-cards' ); ?>
						<ul style="list-style:disc; margin-left:24px; margin-top:6px;">
							<li><strong><?php esc_html_e( 'Block editor:', 'ajb-random-quote-cards' ); ?></strong> <?php esc_html_e( 'Search for "Random Quote" in the block inserter (Widgets section) and add it directly. Configure all options in the block\'s Inspector sidebar on the right.', 'ajb-random-quote-cards' ); ?></li>
							<li><strong><?php esc_html_e( 'Shortcode:', 'ajb-random-quote-cards' ); ?></strong> <?php esc_html_e( 'Use the Shortcode Builder tab to generate a shortcode, then paste it into any page, post, or widget.', 'ajb-random-quote-cards' ); ?></li>
						</ul>
					</li>
					<li><?php esc_html_e( 'Save and preview your page. Done!', 'ajb-random-quote-cards' ); ?></li>
				</ol>
			</div>
		</div>

		<!-- Gutenberg Block -->
		<div class="postbox">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( '🧱 Using the Gutenberg Block', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside" style="line-height:1.8;">
				<p><?php esc_html_e( 'AJB Random Quote Cards includes a native block for the WordPress block editor. It gives you the same output as the shortcode, with all settings available as visual controls — no code required.', 'ajb-random-quote-cards' ); ?></p>
				<ol>
					<li><?php esc_html_e( 'Open a page or post in the block editor.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Click the + icon to open the block inserter. Search for "Random Quote". It appears under the Widgets category.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Click the block to select it and open its settings in the Inspector sidebar on the right.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Use the Source & Display panel to choose which quotes to show and whether to use random or daily mode.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Use the Card Style Overrides panel to set a custom background, width, corner style, font, or colours for this block only.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Use the Copy Button Override to force the copy button on or off for this block.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Save and preview — the quote renders on the front end. The editor shows a placeholder to keep things tidy.', 'ajb-random-quote-cards' ); ?></li>
				</ol>
				<p class="description"><?php esc_html_e( 'Tip: you can add multiple Random Quote blocks to a single page, each configured differently — just like using multiple shortcodes.', 'ajb-random-quote-cards' ); ?></p>
			</div>
		</div>

		<!-- Google Fonts -->
		<div class="postbox">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( '🔤 Using Google Fonts', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside" style="line-height:1.8;">
				<p><?php esc_html_e( 'This plugin loads fonts automatically from Google Fonts — you just need the font name.', 'ajb-random-quote-cards' ); ?></p>
				<ol>
					<li><?php esc_html_e( 'Visit ', 'ajb-random-quote-cards' ); ?><a href="https://fonts.google.com" target="_blank" rel="noopener noreferrer">fonts.google.com</a></li>
					<li><?php esc_html_e( 'Search for and click on the font you want.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Copy the font name exactly as shown at the top of the page — e.g. Merriweather, Playfair Display, Lato.', 'ajb-random-quote-cards' ); ?></li>
					<li><?php esc_html_e( 'Paste it into the Font Family field in Settings. The plugin handles the rest.', 'ajb-random-quote-cards' ); ?></li>
				</ol>
				<p class="description"><?php esc_html_e( 'Tip: spelling and capitalisation must match exactly — "playfair display" will not work but "Playfair Display" will.', 'ajb-random-quote-cards' ); ?></p>
			</div>
		</div>

		<!-- Full Shortcode Reference -->
		<div class="postbox">
			<div class="postbox-header"><h2 class="hndle" style="padding-left:12px;"><?php esc_html_e( '📋 Full Shortcode Reference', 'ajb-random-quote-cards' ); ?></h2></div>
			<div class="inside">
				<p><?php esc_html_e( 'Every attribute is optional. Missing attributes fall back to your global Settings.', 'ajb-random-quote-cards' ); ?></p>
				<p><code>[ajbq_quote]</code> — <?php esc_html_e( 'simplest possible usage, all defaults apply.', 'ajb-random-quote-cards' ); ?></p>
				<table class="widefat striped" style="margin-top:16px;">
					<thead>
						<tr>
							<th><?php esc_html_e( 'Attribute', 'ajb-random-quote-cards' ); ?></th>
							<th><?php esc_html_e( 'Values', 'ajb-random-quote-cards' ); ?></th>
							<th><?php esc_html_e( 'What it does', 'ajb-random-quote-cards' ); ?></th>
						</tr>
					</thead>
					<tbody>
						<?php
						$ref = [
							[ 'source',        '"all" · "favorites"',                      'Which quotes to pick from. Defaults to all.' ],
							[ 'category',      '"slug-name"',                               'Show quotes from one category only. Use the category slug.' ],
							[ 'mode',          '"random" · "daily"',                        'Random picks a new quote on every load. Daily picks once at midnight and caches it.' ],
							[ 'layout',        '"block_center" · "block_left" · "block_right" · "inline"', 'How the quote is rendered on the page.' ],
							[ 'bg_color',      '"#ffffff"',                                 'Background colour of this card only.' ],
							[ 'width',         '"100%" · "400px"',                          'Width of this card only.' ],
							[ 'corners',       '"square" · "round" · "very-round"',         'Corner style of this card only.' ],
							[ 'quote_font',    '"Merriweather"',                            'Font for the quote text on this card.' ],
							[ 'quote_size',    '"20px"',                                    'Font size for the quote text on this card.' ],
							[ 'quote_color',   '"#222222"',                                 'Text colour for the quote on this card.' ],
							[ 'quote_style',   '"italic" · "normal"',                       'Italic or normal for the quote text.' ],
							[ 'quote_weight',  '"normal" · "500" · "bold"',                 'Font weight for the quote text.' ],
							[ 'author_font',   '"Lato"',                                    'Font for the author name on this card.' ],
							[ 'author_size',   '"14px"',                                    'Font size for the author name.' ],
							[ 'author_color',  '"#555555"',                                 'Text colour for the author name.' ],
							[ 'author_style',  '"normal" · "italic"',                       'Italic or normal for the author name.' ],
							[ 'author_weight', '"normal" · "500" · "bold"',                 'Font weight for the author name.' ],
							[ 'author_prefix', '"— " · "• " · ""',                         'Text or symbol shown before the author name. Use "" to remove.' ],
							[ 'author_suffix', '"" · " ☘️"',                               'Text or symbol shown after the author name.' ],
							[ 'show_copy',     '"0" · "1"',                                 'Force the copy button off (0) or on (1) for this card.' ],
						];
						foreach ( $ref as $row ) {
							printf(
								'<tr><td><code>%s</code></td><td style="white-space:nowrap;font-size:12px;">%s</td><td>%s</td></tr>',
								esc_html( $row[0] ),
								esc_html( $row[1] ),
								esc_html( $row[2] )
							);
						}
						?>
					</tbody>
				</table>

				<h3 style="margin-top:24px;"><?php esc_html_e( 'Examples', 'ajb-random-quote-cards' ); ?></h3>
				<p><strong><?php esc_html_e( 'A dark card with a different font:', 'ajb-random-quote-cards' ); ?></strong></p>
				<code style="display:block;padding:10px;background:#f0f0f1;margin-bottom:16px;">[ajbq_quote bg_color="#1a1a2e" quote_color="#ffffff" author_color="#aaaaaa" quote_font="Playfair Display" corners="round"]</code>
				<p><strong><?php esc_html_e( 'A favourites-only card, Quote of the Day:', 'ajb-random-quote-cards' ); ?></strong></p>
				<code style="display:block;padding:10px;background:#f0f0f1;margin-bottom:16px;">[ajbq_quote source="favorites" mode="daily"]</code>
				<p><strong><?php esc_html_e( 'Two different cards on the same page:', 'ajb-random-quote-cards' ); ?></strong></p>
				<code style="display:block;padding:10px;background:#f0f0f1;margin-bottom:16px;">[ajbq_quote bg_color="#fff" quote_font="Roboto" corners="square"]<br><br>[ajbq_quote bg_color="#2c3e50" quote_color="#ecf0f1" author_color="#bdc3c7" corners="very-round" width="100%"]</code>
			</div>
		</div>

	</div>
	<?php
}


// =========================================================================
// 10. ADMIN LIST COLUMNS + AUTHOR FILTER
// =========================================================================
add_filter( 'manage_' . AJBQ_POST_TYPE . '_posts_columns', function ( $columns ) {
	unset( $columns['date'] );
	$columns['title']          = __( 'Admin Label',  'ajb-random-quote-cards' );
	$columns['quote_preview']  = __( 'Quote',        'ajb-random-quote-cards' );
	$columns['quote_author']   = __( 'Author',       'ajb-random-quote-cards' );
	$columns['ajbq_category']   = __( 'Categories',   'ajb-random-quote-cards' );
	$columns['quote_favorite'] = __( 'Favourite',    'ajb-random-quote-cards' );
	return $columns;
} );

add_action( 'manage_' . AJBQ_POST_TYPE . '_posts_custom_column', function ( $column, $post_id ) {
	switch ( $column ) {
		case 'quote_preview':
			$post = get_post( $post_id );
			$text = ! empty( $post->post_content ) ? $post->post_content : $post->post_title;
			echo esc_html( wp_trim_words( $text, 15, '…' ) );
			break;
		case 'quote_author':
			$a = get_post_meta( $post_id, '_rtq_author', true );
			echo $a ? esc_html( $a ) : '<span style="color:#bbb;">—</span>';
			break;
		case 'ajbq_category':
			$terms = get_the_term_list( $post_id, AJBQ_TAXONOMY, '', ', ', '' );
			echo ( $terms && ! is_wp_error( $terms ) )
				? wp_kses_post( $terms )
				: '<span style="color:#bbb;">' . esc_html__( 'Uncategorised', 'ajb-random-quote-cards' ) . '</span>';
			break;
		case 'quote_favorite':
			$fav = get_post_meta( $post_id, '_rtq_is_favorite', true );
			echo ( '1' === $fav )
				? '<span class="dashicons dashicons-star-filled" style="color:#ffb900;"></span>'
				: '<span class="dashicons dashicons-star-empty" style="color:#ccc;"></span>';
			break;
	}
}, 10, 2 );

// Author search filter above the list table.
add_action( 'restrict_manage_posts', function ( $post_type ) {
	if ( AJBQ_POST_TYPE !== $post_type ) return;

	$filter = isset( $_GET['ajbq_author_filter'] ) ? sanitize_text_field( $_GET['ajbq_author_filter'] ) : '';
	echo '<input type="text" name="ajbq_author_filter" placeholder="'
		. esc_attr__( 'Filter by author…', 'ajb-random-quote-cards' )
		. '" value="' . esc_attr( $filter ) . '" style="margin-right:6px;">';
} );

add_action( 'pre_get_posts', function ( $query ) {
	if ( ! is_admin() || ! $query->is_main_query() ) return;
	if ( $query->get( 'post_type' ) !== AJBQ_POST_TYPE ) return;
	if ( empty( $_GET['ajbq_author_filter'] ) ) return;

	$query->set( 'meta_query', [ [
		'key'     => '_rtq_author',
		'value'   => sanitize_text_field( $_GET['ajbq_author_filter'] ),
		'compare' => 'LIKE',
	] ] );
} );


// =========================================================================
// 11. FRONTEND STYLES & JAVASCRIPT
//     Assets are only enqueued when the shortcode (or block) is used on
//     the current page — avoids loading CSS/JS on every page site-wide.
// =========================================================================

/**
 * Flag set to true by the shortcode renderer and block render callback when
 * they run on a given request. wp_enqueue_scripts fires before shortcodes
 * are processed, so we use wp_footer to enqueue late when the flag is set.
 */
$GLOBALS['ajbq_assets_needed'] = false;

/**
 * On pages that use the block editor, WordPress renders blocks early and
 * calls wp_enqueue_scripts afterwards, so the footer hook covers both cases.
 *
 * For pages served via full-page caching the flag will always be false on
 * cached requests; in that case users can tick "Always load assets" in
 * Settings as a fallback (see option ajbq_always_load_assets).
 */
add_action( 'wp_footer', 'ajbq_maybe_enqueue_frontend_assets', 1 );
function ajbq_maybe_enqueue_frontend_assets() {
	// Honour the "always load" override (useful with full-page caches).
	if ( ! $GLOBALS['ajbq_assets_needed'] && ! get_option( 'ajbq_always_load_assets', '0' ) ) {
		return;
	}
	ajbq_enqueue_frontend_assets();
}

/**
 * The actual asset enqueueing, extracted so it can be called from the
 * footer hook above or directly if needed.
 */
function ajbq_enqueue_frontend_assets() {
	static $done = false;
	if ( $done ) return;
	$done = true;

	wp_register_style( 'ajbq-styles', false, [], AJBQ_VERSION );
	wp_enqueue_style( 'ajbq-styles' );

	// Google Fonts — collect unique fonts, load once with v2 API.
	$fonts = array_unique( array_filter( [
		get_option( 'ajbq_quote_font',  'Roboto' ),
		get_option( 'ajbq_author_font', 'Roboto' ),
		get_option( 'ajbq_link_font',   'Roboto' ),
	] ) );
	if ( $fonts ) {
		$families = implode( '&family=', array_map( function ( $f ) {
			return urlencode( $f ) . ':ital,wght@0,400;0,500;0,700;1,400;1,500;1,700';
		}, $fonts ) );
		wp_enqueue_style( 'ajbq-google-fonts', 'https://fonts.googleapis.com/css2?family=' . $families . '&display=swap', [], null );
	}

	// Build CSS from options — all values are sanitised and escaped for CSS context before use.
	$bg     = sanitize_hex_color( get_option( 'ajbq_bg_color',    '#f9f9f9' ) );
	$qcolor = sanitize_hex_color( get_option( 'ajbq_quote_color', '#333333' ) );
	$acolor = sanitize_hex_color( get_option( 'ajbq_author_color','#666666' ) );
	$icolor = sanitize_hex_color( get_option( 'ajbq_link_color',  '#0073aa' ) );
	$qfont  = ajbq_sanitize_font_name( get_option( 'ajbq_quote_font',  'Roboto' ), 'Roboto' );
	$afont  = ajbq_sanitize_font_name( get_option( 'ajbq_author_font', 'Roboto' ), 'Roboto' );
	$lfont  = ajbq_sanitize_font_name( get_option( 'ajbq_link_font',   'Roboto' ), 'Roboto' );
	$qsize  = ajbq_sanitize_dimension( get_option( 'ajbq_quote_size',  '18px' ), '18px' );
	$asize  = ajbq_sanitize_dimension( get_option( 'ajbq_author_size', '14px' ), '14px' );
	$lsize  = ajbq_sanitize_dimension( get_option( 'ajbq_link_size',   '13px' ), '13px' );
	$w      = ajbq_sanitize_dimension( get_option( 'ajbq_width',  '450px' ), '450px' );
	$h      = ajbq_sanitize_dimension( get_option( 'ajbq_height', 'auto' ), 'auto' );

	$corners_val = get_option( 'ajbq_corners', 'square' );
	$radius = ( 'round' === $corners_val ) ? '8px' : ( ( 'very-round' === $corners_val ) ? '25px' : '0px' );

	wp_add_inline_style( 'ajbq-styles', "
.ajbq-block-container{background-color:{$bg};border-radius:{$radius};width:{$w};max-width:100%;height:{$h};padding:20px;margin:15px 0;box-sizing:border-box;border:1px solid rgba(0,0,0,.05);position:relative;word-wrap:break-word;overflow-wrap:break-word;}
.ajbq-block-container.align-center{margin-left:auto;margin-right:auto;text-align:center;}
.ajbq-block-container.align-left{margin-right:auto;text-align:left;}
.ajbq-block-container.align-right{margin-left:auto;text-align:right;}
.ajbq-quote-text-wrapper{position:relative;display:block;margin-bottom:8px;padding-right:25px;}
.align-center .ajbq-quote-text-wrapper{padding-right:0;}
.ajbq-quote-text{font-family:'{$qfont}',sans-serif;font-size:{$qsize};color:{$qcolor};}
.ajbq-author{font-family:'{$afont}',sans-serif;font-size:{$asize};color:{$acolor};display:block;}
.ajbq-action-btn{background:none;border:none;cursor:pointer;padding:3px;display:inline-flex;align-items:center;justify-content:center;color:{$icolor};transition:opacity .2s;vertical-align:middle;}
.ajbq-action-btn:hover{opacity:.7;}
.ajbq-action-btn svg{width:16px;height:16px;fill:currentColor;}
.ajbq-copy-btn{position:absolute;right:0;top:2px;}
.align-center .ajbq-copy-btn{position:relative;display:inline-flex;margin-left:6px;top:-2px;}
.ajbq-footer-controls{margin-top:12px;display:flex;align-items:center;gap:10px;flex-wrap:wrap;}
.align-center .ajbq-footer-controls{justify-content:center;}
.align-left   .ajbq-footer-controls{justify-content:flex-start;}
.align-right  .ajbq-footer-controls{justify-content:flex-end;}
.ajbq-link{font-family:'{$lfont}',sans-serif;font-size:{$lsize};color:{$icolor};text-decoration:underline;margin-right:5px;}
.ajbq-inline{font-family:'{$qfont}',sans-serif;font-size:{$qsize};color:{$qcolor};}
.ajbq-inline-author{font-family:'{$afont}',sans-serif;font-size:{$asize};color:{$acolor};}
" );

	// Copy-to-clipboard JS.
	wp_register_script( 'ajbq-frontend', false, [], AJBQ_VERSION, true );
	wp_enqueue_script( 'ajbq-frontend' );
	wp_add_inline_script( 'ajbq-frontend', "
document.addEventListener('click',function(e){
	var btn=e.target.closest('.ajbq-copy-btn');
	if(!btn||!navigator.clipboard)return;
	navigator.clipboard.writeText(btn.getAttribute('data-quote')).then(function(){
		var orig=btn.innerHTML;
		btn.innerHTML='<svg viewBox=\"0 0 24 24\" style=\"color:green\"><path d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"/></svg>';
		setTimeout(function(){btn.innerHTML=orig;},1500);
	});
});
" );
}


// =========================================================================
// 12. SHORTCODE
// =========================================================================
add_shortcode( 'ajbq_quote', 'ajbq_render_shortcode' );

function ajbq_render_shortcode( $atts ) {

	// Signal that assets are needed on this page.
	$GLOBALS['ajbq_assets_needed'] = true;

	$atts = shortcode_atts( [
		// Source / display.
		'source'        => 'all',
		'category'      => '',
		'mode'          => 'random',
		'layout'        => 'block_center',
		// Per-card container overrides.
		'bg_color'      => '',
		'width'         => '',
		'corners'       => '',
		// Per-card typography overrides.
		'quote_font'    => '',
		'quote_size'    => '',
		'quote_color'   => '',
		'quote_style'   => '',
		'quote_weight'  => '',
		'author_font'   => '',
		'author_size'   => '',
		'author_color'  => '',
		'author_style'  => '',
		'author_weight' => '',
		'author_prefix' => '[DEFAULT]',
		'author_suffix' => '[DEFAULT]',
		// Per-card action override.
		'show_copy'     => '',
	], $atts );

	// ── Build the query ───────────────────────────────────────────────────
	$query_args = [
		'post_type'      => AJBQ_POST_TYPE,
		'posts_per_page' => -1,
		'post_status'    => 'publish',
		'no_found_rows'  => true,
	];

	if ( 'favorites' === $atts['source'] ) {
		$query_args['meta_query'] = [ [ 'key' => '_rtq_is_favorite', 'value' => '1' ] ];
	}
	if ( ! empty( $atts['category'] ) ) {
		$query_args['tax_query'] = [ [
			'taxonomy' => AJBQ_TAXONOMY,
			'field'    => 'slug',
			'terms'    => sanitize_title( $atts['category'] ),
		] ];
	}

	// ── Pick the quote ────────────────────────────────────────────────────
	if ( 'daily' === $atts['mode'] ) {
		$tk      = 'ajbq_daily_' . md5( serialize( $query_args ) );
		$qid     = get_transient( $tk );
		if ( false === $qid ) {
			$pool = get_posts( $query_args );
			if ( ! empty( $pool ) ) {
				$qid = $pool[ array_rand( $pool ) ]->ID;
				set_transient( $tk, $qid, DAY_IN_SECONDS );
			}
		}
		$quote = $qid ? get_post( $qid ) : null;
	} else {
		$query_args['posts_per_page'] = 1;
		$query_args['orderby']        = 'rand';
		$pool  = get_posts( $query_args );
		$quote = ! empty( $pool ) ? $pool[0] : null;
	}

	if ( ! $quote ) return '';

	// ── Data — quote text is now in post_content ──────────────────────────
	$text     = ! empty( $quote->post_content ) ? $quote->post_content : $quote->post_title;
	$author   = get_post_meta( $quote->ID, '_rtq_author',   true );
	$link_ext = get_post_meta( $quote->ID, '_rtq_link_ext', true );

	return ajbq_build_output( $text, $author, $link_ext, $atts );
}

/**
 * Shared output builder used by both the shortcode and the Gutenberg block
 * render callback. Accepts the resolved quote text, author, link, and the
 * full atts/attributes array.
 */
function ajbq_build_output( $text, $author, $link_ext, $atts ) {

	// ── Resolve typography — shortcode attr → global option → hard default ─
	$q_font   = ! empty( $atts['quote_font'] )    ? $atts['quote_font']    : get_option( 'ajbq_quote_font',    'Roboto' );
	$q_size   = ajbq_sanitize_dimension( ! empty( $atts['quote_size'] )   ? $atts['quote_size']   : get_option( 'ajbq_quote_size',   '18px' ), '18px' );
	$q_color  = ajbq_sanitize_color( ! empty( $atts['quote_color'] )  ? $atts['quote_color']  : get_option( 'ajbq_quote_color',  '#333333' ), '#333333' );
	$q_style  = ! empty( $atts['quote_style'] )   ? $atts['quote_style']   : get_option( 'ajbq_quote_style',   'italic' );
	$q_weight = ! empty( $atts['quote_weight'] )  ? $atts['quote_weight']  : get_option( 'ajbq_quote_weight',  '500' );

	$a_font   = ! empty( $atts['author_font'] )   ? $atts['author_font']   : get_option( 'ajbq_author_font',   'Roboto' );
	$a_size   = ajbq_sanitize_dimension( ! empty( $atts['author_size'] )  ? $atts['author_size']  : get_option( 'ajbq_author_size',  '14px' ), '14px' );
	$a_color  = ajbq_sanitize_color( ! empty( $atts['author_color'] ) ? $atts['author_color'] : get_option( 'ajbq_author_color', '#666666' ), '#666666' );
	$a_style  = ! empty( $atts['author_style'] )  ? $atts['author_style']  : get_option( 'ajbq_author_style',  'normal' );
	$a_weight = ! empty( $atts['author_weight'] ) ? $atts['author_weight'] : get_option( 'ajbq_author_weight', 'bold' );

	$prefix = ( '[DEFAULT]' !== $atts['author_prefix'] ) ? $atts['author_prefix'] : ajbq_get_prefix_suffix( 'ajbq_author_prefix', '— ' );
	$suffix = ( '[DEFAULT]' !== $atts['author_suffix'] ) ? $atts['author_suffix'] : ajbq_get_prefix_suffix( 'ajbq_author_suffix', '' );

	// ── Resolve container — shortcode attr → global option ────────────────
	$bg     = ajbq_sanitize_color( ! empty( $atts['bg_color'] ) ? $atts['bg_color'] : get_option( 'ajbq_bg_color', '#f9f9f9' ), '#f9f9f9' );
	$c_val  = ! empty( $atts['corners'] ) ? $atts['corners'] : get_option( 'ajbq_corners', 'square' );
	$radius = ( 'round' === $c_val ) ? '8px' : ( ( 'very-round' === $c_val ) ? '25px' : '0px' );

	// Width is irrelevant for inline layout — ignore it entirely.
	$is_inline = ( 'inline' === $atts['layout'] );
	$width = $is_inline ? '' : ajbq_sanitize_dimension(
		! empty( $atts['width'] ) ? $atts['width'] : get_option( 'ajbq_width', '450px' ),
		'450px'
	);

	// ── Resolve show/hide flags ────────────────────────────────────────────
	$show_author = '1' === get_option( 'ajbq_show_author', '1' );
	$show_link   = '1' === get_option( 'ajbq_show_link',   '1' );
	$show_copy   = ajbq_resolve_flag( $atts['show_copy'], 'ajbq_show_copy', '1' );

	// ── Build inline style strings ────────────────────────────────────────
	$width_css    = $is_inline ? '' : "width:{$width};";
	$card_style   = esc_attr( "background-color:{$bg}; border-radius:{$radius}; {$width_css}" );
	$q_inline     = esc_attr( "font-family:'{$q_font}',sans-serif; font-size:{$q_size}; color:{$q_color}; font-style:{$q_style}; font-weight:{$q_weight};" );
	$a_inline     = esc_attr( "font-family:'{$a_font}',sans-serif; font-size:{$a_size}; color:{$a_color}; font-style:{$a_style}; font-weight:{$a_weight};" );

	$plain_text   = '"' . $text . '"' . ( ! empty( $author ) ? ' — ' . $author : '' );

	// ── Render ────────────────────────────────────────────────────────────
	ob_start();

	if ( 'inline' === $atts['layout'] ) {
		echo '<span class="ajbq-inline" style="' . $q_inline . '">';
		echo '"' . esc_html( $text ) . '"';
		if ( $show_author && ! empty( $author ) ) {
			echo ' <span class="ajbq-inline-author" style="' . $a_inline . '">' . esc_html( $prefix . $author . $suffix ) . '</span>';
		}
		echo '</span>';

	} else {
		$align = 'align-center';
		if ( 'block_left'  === $atts['layout'] ) $align = 'align-left';
		if ( 'block_right' === $atts['layout'] ) $align = 'align-right';

		echo '<div class="ajbq-block-container ' . esc_attr( $align ) . '" style="' . $card_style . '">';

		echo '<div class="ajbq-quote-text-wrapper">';
		echo '<span class="ajbq-quote-text" style="' . $q_inline . '">"' . esc_html( $text ) . '"</span>';
		if ( $show_copy ) {
			echo '<button class="ajbq-action-btn ajbq-copy-btn" data-quote="' . esc_attr( $plain_text ) . '" title="' . esc_attr__( 'Copy to clipboard', 'ajb-random-quote-cards' ) . '">';
			echo '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z"/></svg>';
			echo '</button>';
		}
		echo '</div>';

		if ( $show_author && ! empty( $author ) ) {
			echo '<span class="ajbq-author" style="' . $a_inline . '">' . esc_html( $prefix . $author . $suffix ) . '</span>';
		}

		$has_social = false; // Social sharing removed — copy to clipboard only.
		if ( ( $show_link && ! empty( $link_ext ) ) ) {
			echo '<div class="ajbq-footer-controls">';
			echo '<a href="' . esc_url( $link_ext ) . '" class="ajbq-link" target="_blank" rel="noopener noreferrer">' . esc_html__( 'Learn More', 'ajb-random-quote-cards' ) . '</a>';
			echo '</div>';
		}
		echo '</div>';
	}

	return ob_get_clean();
}

function ajbq_resolve_flag( $attr, $option, $default ) {
	return '' !== $attr ? ( '1' === $attr ) : ( '1' === get_option( $option, $default ) );
}


// =========================================================================
// 13. GUTENBERG BLOCK  — "Random Quote" (ajbq/random-quote)
// =========================================================================
add_action( 'init', 'ajbq_register_block' );
function ajbq_register_block() {
	if ( ! function_exists( 'register_block_type' ) ) {
		return;
	}

	register_block_type( 'ajbq/random-quote', [
		'render_callback' => 'ajbq_block_render_callback',
		'attributes'      => [
			'source'       => [ 'type' => 'string', 'default' => 'all' ],
			'category'     => [ 'type' => 'string', 'default' => '' ],
			'mode'         => [ 'type' => 'string', 'default' => 'random' ],
			'layout'       => [ 'type' => 'string', 'default' => 'block_center' ],
			'bg_color'     => [ 'type' => 'string', 'default' => '' ],
			'width'        => [ 'type' => 'string', 'default' => '' ],
			'corners'      => [ 'type' => 'string', 'default' => '' ],
			'quote_font'   => [ 'type' => 'string', 'default' => '' ],
			'quote_size'   => [ 'type' => 'string', 'default' => '' ],
			'quote_color'  => [ 'type' => 'string', 'default' => '' ],
			'quote_style'  => [ 'type' => 'string', 'default' => '' ],
			'quote_weight' => [ 'type' => 'string', 'default' => '' ],
			'author_color' => [ 'type' => 'string', 'default' => '' ],
			'show_copy'    => [ 'type' => 'string', 'default' => '' ],
		],
	] );
}

// Enqueue the block editor script separately — this hook only fires in the
// block editor context so we know wp.blocks etc are available.
add_action( 'enqueue_block_editor_assets', 'ajbq_enqueue_block_editor_assets' );
function ajbq_enqueue_block_editor_assets() {
	$block_js = <<<'JS'
( function() {
	var blocks     = window.wp.blocks;
	var element    = window.wp.element;
	var components = window.wp.components;
	var blockEditor = window.wp.blockEditor;
	var data       = window.wp.data;

	if ( ! blocks || ! element || ! components || ! blockEditor ) return;

	var el                = element.createElement;
	var useSelect         = data.useSelect;
	var InspectorControls = blockEditor.InspectorControls;
	var PanelBody         = components.PanelBody;
	var SelectControl     = components.SelectControl;
	var TextControl       = components.TextControl;

	blocks.registerBlockType( 'ajbq/random-quote', {
		title:       'Random Quote',
		description: 'Display a randomly selected AJB quote card.',
		icon:        'format-quote',
		category:    'widgets',
		attributes: {
			source:       { type: 'string', default: 'all' },
			category:     { type: 'string', default: '' },
			mode:         { type: 'string', default: 'random' },
			layout:       { type: 'string', default: 'block_center' },
			bg_color:     { type: 'string', default: '' },
			width:        { type: 'string', default: '' },
			corners:      { type: 'string', default: '' },
			quote_font:   { type: 'string', default: '' },
			quote_size:   { type: 'string', default: '' },
			quote_color:  { type: 'string', default: '' },
			quote_style:  { type: 'string', default: '' },
			quote_weight: { type: 'string', default: '' },
			author_color: { type: 'string', default: '' },
			show_copy:    { type: 'string', default: '' },
		},

		edit: function( props ) {
			var attributes    = props.attributes;
			var setAttributes = props.setAttributes;

			var categories = useSelect( function( select ) {
				return select( 'core' ).getEntityRecords( 'taxonomy', 'ajbq_category', { per_page: -1 } ) || [];
			}, [] );

			var catOptions = [ { label: '— All —', value: '' } ].concat(
				categories.map( function( c ) { return { label: c.name, value: c.slug }; } )
			);

			var flagOptions = [
				{ label: 'Use Global Default', value: '' },
				{ label: 'Force ON',           value: '1' },
				{ label: 'Force OFF',          value: '0' },
			];

			return [
				el( InspectorControls, { key: 'inspector' },
					el( PanelBody, { title: 'Source & Display', initialOpen: true },
						el( SelectControl, {
							label: 'Source',
							value: attributes.source,
							options: [
								{ label: 'All Quotes',      value: 'all' },
								{ label: 'Favourites Only', value: 'favorites' },
							],
							onChange: function( v ) { setAttributes( { source: v } ); },
						} ),
						el( SelectControl, {
							label: 'Category',
							value: attributes.category,
							options: catOptions,
							onChange: function( v ) { setAttributes( { category: v } ); },
						} ),
						el( SelectControl, {
							label: 'Display Mode',
							value: attributes.mode,
							options: [
								{ label: 'Random (each load)', value: 'random' },
								{ label: 'Quote of the Day',   value: 'daily' },
							],
							onChange: function( v ) { setAttributes( { mode: v } ); },
						} ),
						el( SelectControl, {
							label: 'Layout',
							value: attributes.layout,
							options: [
								{ label: 'Block — Centre', value: 'block_center' },
								{ label: 'Block — Left',   value: 'block_left' },
								{ label: 'Block — Right',  value: 'block_right' },
								{ label: 'Inline',         value: 'inline' },
							],
							onChange: function( v ) { setAttributes( { layout: v } ); },
						} )
					),
					el( PanelBody, { title: 'Style Overrides (all layouts)', initialOpen: false },
						el( 'p', { style: { fontSize: '12px', color: '#757575', margin: '0 0 8px' } },
							'Leave blank to use global Settings defaults. Colours must include # e.g. #ffffff.'
						),
						el( TextControl, {
							label: 'Background Colour',
							value: attributes.bg_color,
							placeholder: '#f9f9f9',
							onChange: function( v ) { setAttributes( { bg_color: v } ); },
						} ),
						el( TextControl, {
							label: 'Width',
							value: attributes.width,
							placeholder: '450px',
							onChange: function( v ) { setAttributes( { width: v } ); },
						} ),
						el( SelectControl, {
							label: 'Corners',
							value: attributes.corners,
							options: [
								{ label: 'Use Global Default', value: '' },
								{ label: 'Square',             value: 'square' },
								{ label: 'Round (8px)',        value: 'round' },
								{ label: 'Very Round (25px)',  value: 'very-round' },
							],
							onChange: function( v ) { setAttributes( { corners: v } ); },
						} ),
						el( TextControl, {
							label: 'Quote Font',
							value: attributes.quote_font,
							placeholder: 'Merriweather',
							onChange: function( v ) { setAttributes( { quote_font: v } ); },
						} ),
						el( TextControl, {
							label: 'Quote Size',
							value: attributes.quote_size,
							placeholder: '20px',
							onBlur: function() {
								var v = attributes.quote_size;
								if ( v && /^\d+(\.\d+)?$/.test( v.trim() ) ) {
									setAttributes( { quote_size: v.trim() + 'px' } );
								}
							},
							onChange: function( v ) { setAttributes( { quote_size: v } ); },
						} ),
						el( TextControl, {
							label: 'Quote Colour',
							value: attributes.quote_color,
							placeholder: '#333333',
							onChange: function( v ) { setAttributes( { quote_color: v } ); },
						} ),
						el( TextControl, {
							label: 'Author Colour',
							value: attributes.author_color,
							placeholder: '#666666',
							onChange: function( v ) { setAttributes( { author_color: v } ); },
						} )
					),
					el( PanelBody, { title: 'Copy Button Override', initialOpen: false },
						el( SelectControl, {
							label: 'Copy to Clipboard',
							value: attributes.show_copy,
							options: flagOptions,
							onChange: function( v ) { setAttributes( { show_copy: v } ); },
						} )
					)
				),
				el( 'div', {
					key: 'preview',
					style: { padding: '12px', background: '#f0f0f1', borderRadius: '4px', fontStyle: 'italic', color: '#555', fontSize: '13px' }
				}, '📖 Random Quote block — configure in the sidebar. Quote renders on the front end.' )
			];
		},

		save: function() {
			return null;
		},
	} );
} )();
JS;

	wp_register_script(
		'ajbq-block-editor',
		false,
		[ 'wp-blocks', 'wp-element', 'wp-components', 'wp-block-editor', 'wp-data' ],
		AJBQ_VERSION,
		true
	);
	wp_add_inline_script( 'ajbq-block-editor', $block_js );
	wp_enqueue_script( 'ajbq-block-editor' );
}

/**
 * Server-side render callback for the Gutenberg block. Delegates to the same
 * ajbq_build_output() used by the shortcode so the two are always in sync.
 */
function ajbq_block_render_callback( $attributes ) {

	// Signal that frontend assets are needed on this page.
	$GLOBALS['ajbq_assets_needed'] = true;

	// Normalise attribute keys to match the shortcode atts array shape.
	$atts = wp_parse_args( $attributes, [
		'source'        => 'all',
		'category'      => '',
		'mode'          => 'random',
		'layout'        => 'block_center',
		'bg_color'      => '',
		'width'         => '',
		'corners'       => '',
		'quote_font'    => '',
		'quote_size'    => '',
		'quote_color'   => '',
		'quote_style'   => '',
		'quote_weight'  => '',
		'author_font'   => '',
		'author_size'   => '',
		'author_color'  => '',
		'author_style'  => '',
		'author_weight' => '',
		'author_prefix' => '[DEFAULT]',
		'author_suffix' => '[DEFAULT]',
		'show_copy'     => '',
	] );

	// ── Build the query ───────────────────────────────────────────────────
	$query_args = [
		'post_type'      => AJBQ_POST_TYPE,
		'posts_per_page' => -1,
		'post_status'    => 'publish',
		'no_found_rows'  => true,
	];

	if ( 'favorites' === $atts['source'] ) {
		$query_args['meta_query'] = [ [ 'key' => '_rtq_is_favorite', 'value' => '1' ] ];
	}
	if ( ! empty( $atts['category'] ) ) {
		$query_args['tax_query'] = [ [
			'taxonomy' => AJBQ_TAXONOMY,
			'field'    => 'slug',
			'terms'    => sanitize_title( $atts['category'] ),
		] ];
	}

	// ── Pick the quote ────────────────────────────────────────────────────
	if ( 'daily' === $atts['mode'] ) {
		$tk    = 'ajbq_daily_' . md5( serialize( $query_args ) );
		$qid   = get_transient( $tk );
		if ( false === $qid ) {
			$pool = get_posts( $query_args );
			if ( ! empty( $pool ) ) {
				$qid = $pool[ array_rand( $pool ) ]->ID;
				set_transient( $tk, $qid, DAY_IN_SECONDS );
			}
		}
		$quote = $qid ? get_post( $qid ) : null;
	} else {
		$query_args['posts_per_page'] = 1;
		$query_args['orderby']        = 'rand';
		$pool  = get_posts( $query_args );
		$quote = ! empty( $pool ) ? $pool[0] : null;
	}

	if ( ! $quote ) return '';

	$text     = ! empty( $quote->post_content ) ? $quote->post_content : $quote->post_title;
	$author   = get_post_meta( $quote->ID, '_rtq_author',   true );
	$link_ext = get_post_meta( $quote->ID, '_rtq_link_ext', true );

	return ajbq_build_output( $text, $author, $link_ext, $atts );
}

// ── Add "always load assets" option to Settings page ─────────────────────────
// Registered above with the other settings.
add_filter( 'ajbq_register_settings_extra', function( $s ) {
	$s['ajbq_always_load_assets'] = 'ajbq_sanitize_checkbox';
	return $s;
} );
// Actually register it now (the filter above is illustrative — register directly):
add_action( 'admin_init', function() {
	register_setting( 'ajbq_settings_group', 'ajbq_always_load_assets', [ 'sanitize_callback' => 'ajbq_sanitize_checkbox' ] );
} );