/**
 * Increase the truncated title length in the admin bar.
 *
 * @param int $length The default truncated length.
 *
 * @return int Modified truncated length.
 */
add_filter( 'helpdocs_admin_bar_truncated_title_length', function( $length ) {
    return 100;
}, 10 );

/**
 * Restrict Help Docs admin access to a custom role.
 *
 * @param string $role The default admin role.
 *
 * @return string Modified role.
 */
add_filter( 'helpdocs_admin_role', function( $role ) {
    return 'site_manager';
}, 10 );

/**
 * Allow additional media-related tags in Admin Help Docs content.
 *
 * @param array $tags The default allowed HTML tags and attributes.
 *
 * @return array Modified set including additional safe tags.
 */
add_filter( 'helpdocs_allowed_html', function( $tags ) {
    return array_merge( $tags, [

        // Enable <audio> tag with common attributes
        'audio' => [
            'src'       => true,
            'controls'  => true,
            'autoplay'  => true,
            'loop'      => true,
            'muted'     => true,
            'preload'   => true,
        ],

        // Enable <track> inside media for subtitles or captions
        'track' => [
            'src'        => true,
            'kind'       => true,
            'srclang'    => true,
            'label'      => true,
            'default'    => true,
        ],

    ] );
}, 10 );

/**
 * Modify default colors and add a new custom color option.
 *
 * @param array $defaults The default color definitions.
 *
 * @return array Modified color definitions.
 */
add_filter( 'helpdocs_color_defaults', function( $defaults ) {
    // Override an existing default color
    if ( isset( $defaults[ 'doc_accent' ] ) ) {
        $defaults[ 'doc_accent' ][ 'color' ] = '#FF5722';
        $defaults[ 'doc_accent' ][ 'label' ] = __( 'Primary Accent Color', 'admin-help-docs' );
    }

    // Add a new custom color option
    $defaults[ 'custom_border' ] = [
        'color' => '#CCCCCC',
        'label' => __( 'Custom Border Color', 'admin-help-docs' ),
    ];

    return $defaults;
}, 10 );

/**
 * Add a custom dark theme and modify an existing theme.
 *
 * @param array $themes The default themes array.
 *
 * @return array Modified themes array.
 */
add_filter( 'helpdocs_color_themes', function( $themes ) {
    // Add a new custom theme
    $themes[ 'dark_mode' ] = [
        'label'  => __( 'Dark Mode', 'admin-help-docs' ),
        'colors' => [
            'doc_accent'      => '#BB86FC',
            'doc_bg'          => '#121212',
            'doc_title'       => '#FFFFFF',
            'doc_font'        => '#E0E0E0',
            'doc_link'        => '#03DAC6',
            'header_bg'       => '#1F1F1F',
            'header_font'     => '#FFFFFF',
            'header_tab'      => '#BB86FC',
            'header_tab_link' => '#E0E0E0',
            'subheader_bg'    => '#1A1A1A',
            'subheader_font'  => '#FFFFFF',
            'button'          => '#BB86FC',
            'button_font'     => '#000000',
            'button_hover'    => '#9A67EA',
        ],
    ];

    // Modify an existing theme
    if ( isset( $themes[ 'corporate' ] ) ) {
        $themes[ 'corporate' ][ 'colors' ][ 'doc_link' ] = '#FF5722';
    }

    return $themes;
}, 10 );

/**
 * Customize the "no docs available" dashboard message.
 *
 * @param string $text The default no-docs text.
 *
 * @return string Modified no-docs text.
 */
add_filter( 'helpdocs_dashboard_no_docs_text', function( $text ) {
    return 'No documentation is available right now. Please check back later or contact support.';
}, 10 );

/**
 * Add additional post type supports to Help Documents.
 *
 * @param array $supports The default supported features (e.g., title, editor, revisions).
 *
 * @return array Modified array including extra supported features.
 */
add_filter( 'helpdocs_post_type_supports', function( $supports ) {
    // Enable featured images
    $supports[] = 'thumbnail';

    // Enable comment support
    $supports[] = 'comments';

    return $supports;
}, 10 );

/**
 * Register additional taxonomies for Help Documents.
 *
 * @param array $taxonomies The default taxonomies attached to the post type (usually empty).
 *
 * @return array Modified array of taxonomy slugs.
 */
add_filter( 'helpdocs_post_type_taxonomies', function( $taxonomies ) {
    // Attach the default 'category' taxonomy
    $taxonomies[] = 'category';

    // Optionally add a custom taxonomy if registered elsewhere
    $taxonomies[] = 'helpdoc_tag';

    return $taxonomies;
}, 10 );

/**
 * Add additional post type supports to Imports CPT.
 *
 * @param array $supports The default supported features (e.g., title, excerpt).
 *
 * @return array Modified array including extra supported features.
 */
add_filter( 'helpdocs_imports_supports', function( $supports ) {
    // Enable featured images
    $supports[] = 'thumbnail';

    // Enable comments support
    $supports[] = 'comments';

    return $supports;
}, 10 );

/**
 * Register additional taxonomies for Imports CPT.
 *
 * @param array $taxonomies The default taxonomies attached to the post type (usually empty).
 *
 * @return array Modified array of taxonomy slugs.
 */
add_filter( 'helpdocs_imports_taxonomies', function( $taxonomies ) {
    // Attach the default 'category' taxonomy
    $taxonomies[] = 'category';

    // Optionally, add a custom taxonomy
    $taxonomies[] = 'import_tag';

    return $taxonomies;
}, 10 );

/**
 * Increase the cache duration for imported Help Docs data.
 *
 * @param int    $duration     The default cache duration in seconds.
 * @param string $website_url  The remote website URL being queried.
 *
 * @return int Modified cache duration.
 */
add_filter( 'helpdocs_import_cache_duration', function( $duration, $website_url ) {
    return DAY_IN_SECONDS;
}, 10, 2 );

/**
 * Add a custom field to the support form and modify an existing field.
 *
 * @param array      $fields The default form fields.
 * @param WP_User    $user   The current user object.
 *
 * @return array Modified form fields.
 */
add_filter( 'helpdocs_support_form_fields', function( $fields, $user ) {
    // Add a custom field
    $fields[] = [
        'name'     => 'order_id',
        'type'     => 'text',
        'label'    => __( 'Order ID', 'admin-help-docs' ),
        'desc'     => __( 'If your issue is related to an order, enter the ID here.', 'admin-help-docs' ),
        'sanitize' => 'sanitize_text_field',
    ];

    // Modify an existing field
    foreach ( $fields as &$field ) {
        if ( $field[ 'name' ] === 'subject' ) {
            $field[ 'label' ] = __( 'Support Subject', 'admin-help-docs' );
        }
    }

    return $fields;
}, 10, 2 );

/**
 * Change the support form heading label.
 *
 * @param string $label Default label text.
 *
 * @return string Modified label text.
 */
add_filter( 'helpdocs_support_form_box_label', function( $label ) {
    return __( 'Contact Our Support Team', 'text-domain' );
} );

/**
 * Change the submit button label.
 *
 * @param string $label Default button text.
 *
 * @return string Modified button text.
 */
add_filter( 'helpdocs_support_form_submit_label', function( $label ) {
    return __( 'Submit Ticket', 'text-domain' );
} );

/**
 * Output content before the support form.
 *
 * @param array $contact_info Contact information array.
 */
add_action( 'helpdocs_before_support_form', function( $contact_info ) {
    echo '<p>Please include as much detail as possible.</p>';
} );

/**
 * Output content after the support form.
 *
 * @param array $contact_info Contact information array.
 */
add_action( 'helpdocs_after_support_form', function( $contact_info ) {
    echo '<p>We typically respond within 24 hours.</p>';
} );

/**
 * Dynamically adjust support contact info based on the current user.
 *
 * @param array $contact_info The default contact information.
 *
 * @return array Modified contact information.
 */
add_filter( 'helpdocs_support_contact_info', function( $contact_info ) {
    $user = wp_get_current_user();

    // Example: route support emails differently for administrators
    if ( in_array( 'administrator', (array) $user->roles, true ) ) {
        $contact_info[ 'emails' ] = [ 'admin-support@example.com' ];
    }

    return $contact_info;
}, 10 );

/**
 * Customize the support contact details box output.
 *
 * @param string $content      The default HTML content of the details box.
 * @param array  $contact_info The contact information array.
 *
 * @return string Modified HTML content.
 */
add_filter( 'helpdocs_support_details_box_content', function( $content, $contact_info ) {
    // Example: Append additional support instructions
    $content .= '<div class="helpdocs-support-note">' . esc_html__( 'For urgent issues, contact us directly.', 'admin-help-docs' ) . '</div>';

    return $content;
}, 10, 2 );

/**
 * Increase the maximum allowed attachment size for support form uploads.
 *
 * @param int $size The default maximum size in MB.
 *
 * @return int Modified maximum size in MB.
 */
add_filter( 'helpdocs_support_max_attachment_size', function( $size ) {
    return 25;
}, 10 );

/**
 * Modify the support email arguments before sending.
 *
 * @param array $email_args {
 *     Email arguments.
 *
 *     @type array  $to          Recipient email addresses.
 *     @type string $subject     Email subject.
 *     @type string $message     Email body content.
 *     @type array  $headers     Email headers.
 *     @type array  $attachments File attachments.
 * }
 *
 * @param array $data_to_send Sanitized form data.
 *
 * @return array Modified email arguments.
 */
add_filter( 'helpdocs_support_email_args', function( $email_args, $data_to_send ) {

    // Example: Add a BCC recipient
    $email_args[ 'headers' ][] = 'Bcc: admin@site.com';

    return $email_args;

}, 10, 2 );

/**
 * Disable support logging.
 *
 * @param bool $enabled Whether logging is enabled by default.
 *
 * @return bool Modified logging state.
 */
add_filter( 'helpdocs_support_logging_enabled', '__return_false' );

/**
 * Change the date format used in support logs.
 *
 * @param string $format The default date format.
 *
 * @return string Modified date format.
 */
add_filter( 'helpdocs_support_log_date_format', function( $format ) {
    return 'Y-m-d H:i:s';
}, 10 );

/**
 * Disable support logging.
 *
 * @param bool $enabled Whether logging is enabled by default.
 *
 * @return bool Modified logging state.
 */
add_filter( 'helpdocs_support_logging_enabled', '__return_false' );