<?php
/**
 * Custom Functions
 * @package Board Games
 * @since 1.0.0
 */

if( !function_exists('board_games_site_logo') ):

    /**
     * Logo & Description
     */
    /**
     * Displays the site logo, either text or image.
     *
     * @param array $board_games_args Arguments for displaying the site logo either as an image or text.
     * @param boolean $board_games_echo Echo or return the HTML.
     *
     * @return string $board_games_html Compiled HTML based on our arguments.
     */
    function board_games_site_logo( $board_games_args = array(), $board_games_echo = true ){
        $board_games_logo = get_custom_logo();
        $board_games_site_title = get_bloginfo('name');
        $board_games_contents = '';
        $board_games_classname = '';
        $board_games_defaults = array(
            'logo' => '%1$s<span class="screen-reader-text">%2$s</span>',
            'logo_class' => 'site-logo site-branding',
            'title' => '<a href="%1$s" class="custom-logo-name">%2$s</a>',
            'title_class' => 'site-title',
            'home_wrap' => '<h1 class="%1$s">%2$s</h1>',
            'single_wrap' => '<div class="%1$s">%2$s</div>',
            'condition' => (is_front_page() || is_home()) && !is_page(),
        );
        $board_games_args = wp_parse_args($board_games_args, $board_games_defaults);
        /**
         * Filters the arguments for `board_games_site_logo()`.
         *
         * @param array $board_games_args Parsed arguments.
         * @param array $board_games_defaults Function's default arguments.
         */
        $board_games_args = apply_filters('board_games_site_logo_args', $board_games_args, $board_games_defaults);
        
        $board_games_show_logo  = get_theme_mod('board_games_display_logo', false);
        $board_games_show_title = get_theme_mod('board_games_display_title', true);

        if ( has_custom_logo() && $board_games_show_logo ) {
            $board_games_contents .= sprintf($board_games_args['logo'], $board_games_logo, esc_html($board_games_site_title));
            $board_games_classname = $board_games_args['logo_class'];
        }

        if ( $board_games_show_title ) {
            $board_games_contents .= sprintf($board_games_args['title'], esc_url(get_home_url(null, '/')), esc_html($board_games_site_title));
            // If logo isn't shown, fallback to title class for wrapper.
            if ( !$board_games_show_logo ) {
                $board_games_classname = $board_games_args['title_class'];
            }
        }

        // If nothing is shown (logo or title both disabled), exit early
        if ( empty($board_games_contents) ) {
            return;
        }

        $board_games_wrap = $board_games_args['condition'] ? 'home_wrap' : 'single_wrap';
        // $board_games_wrap = 'home_wrap';
        $board_games_html = sprintf($board_games_args[$board_games_wrap], $board_games_classname, $board_games_contents);
        /**
         * Filters the arguments for `board_games_site_logo()`.
         *
         * @param string $board_games_html Compiled html based on our arguments.
         * @param array $board_games_args Parsed arguments.
         * @param string $board_games_classname Class name based on current view, home or single.
         * @param string $board_games_contents HTML for site title or logo.
         */
        $board_games_html = apply_filters('board_games_site_logo', $board_games_html, $board_games_args, $board_games_classname, $board_games_contents);
        if (!$board_games_echo) {
            return $board_games_html;
        }
        echo $board_games_html; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped

    }

endif;

if( !function_exists('board_games_site_description') ):

    /**
     * Displays the site description.
     *
     * @param boolean $board_games_echo Echo or return the html.
     *
     * @return string $board_games_html The HTML to display.
     */
    function board_games_site_description($board_games_echo = true){

        if ( get_theme_mod('board_games_display_header_text', false) == true ) :
        $board_games_description = get_bloginfo('description');
        if (!$board_games_description) {
            return;
        }
        $board_games_wrapper = '<div class="site-description"><span>%s</span></div><!-- .site-description -->';
        $board_games_html = sprintf($board_games_wrapper, esc_html($board_games_description));
        /**
         * Filters the html for the site description.
         *
         * @param string $board_games_html The HTML to display.
         * @param string $board_games_description Site description via `bloginfo()`.
         * @param string $board_games_wrapper The format used in case you want to reuse it in a `sprintf()`.
         * @since 1.0.0
         *
         */
        $board_games_html = apply_filters('board_games_site_description', $board_games_html, $board_games_description, $board_games_wrapper);
        if (!$board_games_echo) {
            return $board_games_html;
        }
        echo $board_games_html; //phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
        endif;
    }

endif;

if( !function_exists('board_games_posted_on') ):

    /**
     * Prints HTML with meta information for the current post-date/time.
     */
    function board_games_posted_on( $board_games_icon = true, $animation_class = '' ){

        $board_games_default = board_games_get_default_theme_options();
        $board_games_post_date = absint( get_theme_mod( 'board_games_post_date',$board_games_default['board_games_post_date'] ) );

        if( $board_games_post_date ){

            $board_games_time_string = '<time class="entry-date published updated" datetime="%1$s">%2$s</time>';
            if (get_the_time('U') !== get_the_modified_time('U')) {
                $board_games_time_string = '<time class="entry-date published" datetime="%1$s">%2$s</time><time class="updated" datetime="%3$s">%4$s</time>';
            }

            $board_games_time_string = sprintf($board_games_time_string,
                esc_attr(get_the_date(DATE_W3C)),
                esc_html(get_the_date()),
                esc_attr(get_the_modified_date(DATE_W3C)),
                esc_html(get_the_modified_date())
            );

            $board_games_year = get_the_date('Y');
            $board_games_month = get_the_date('m');
            $board_games_day = get_the_date('d');
            $board_games_link = get_day_link($board_games_year, $board_games_month, $board_games_day);

            $board_games_posted_on = '<a href="' . esc_url($board_games_link) . '" rel="bookmark">' . $board_games_time_string . '</a>';

            echo '<div class="entry-meta-item entry-meta-date">';
            echo '<div class="entry-meta-wrapper '.esc_attr( $animation_class ).'">';

            if( $board_games_icon ){

                echo '<span class="entry-meta-icon calendar-icon"> ';
                board_games_the_theme_svg('calendar');
                echo '</span>';

            }

            echo '<span class="posted-on">' . $board_games_posted_on . '</span>'; // WPCS: XSS OK.
            echo '</div>';
            echo '</div>';

        }

    }

endif;

if( !function_exists('board_games_posted_by') ) :

    /**
     * Prints HTML with meta information for the current author.
     */
    function board_games_posted_by( $board_games_icon = true, $animation_class = '' ){   

        $board_games_default = board_games_get_default_theme_options();
        $board_games_post_author = absint( get_theme_mod( 'board_games_post_author',$board_games_default['board_games_post_author'] ) );

        if( $board_games_post_author ){

            echo '<div class="entry-meta-item entry-meta-author">';
            echo '<div class="entry-meta-wrapper '.esc_attr( $animation_class ).'">';

            if( $board_games_icon ){
            
                echo '<span class="entry-meta-icon author-icon"> ';
                board_games_the_theme_svg('user');
                echo '</span>';
                
            }

            $board_games_byline = '<span class="author vcard"><a class="url fn n" href="' . esc_url( get_author_posts_url( get_the_author_meta('ID') ) ) . '">' . esc_html(get_the_author()) . '</a></span>';
            echo '<span class="byline"> ' . $board_games_byline . '</span>'; // WPCS: XSS OK.
            echo '</div>';
            echo '</div>';

        }

    }

endif;


if( !function_exists('board_games_posted_by_avatar') ) :

    /**
     * Prints HTML with meta information for the current author.
     */
    function board_games_posted_by_avatar( $board_games_date = false ){

        $board_games_default = board_games_get_default_theme_options();
        $board_games_post_author = absint( get_theme_mod( 'board_games_post_author',$board_games_default['board_games_post_author'] ) );

        if( $board_games_post_author ){



            echo '<div class="entry-meta-left">';
            echo '<div class="entry-meta-item entry-meta-avatar">';
            echo wp_kses_post( get_avatar( get_the_author_meta( 'ID' ) ) );
            echo '</div>';
            echo '</div>';

            echo '<div class="entry-meta-right">';

            $board_games_byline = '<span class="author vcard"><a class="url fn n" href="' . esc_url( get_author_posts_url( get_the_author_meta('ID') ) ) . '">' . esc_html(get_the_author()) . '</a></span>';

            echo '<div class="entry-meta-item entry-meta-byline"> ' . $board_games_byline . '</div>';

            if( $board_games_date ){
                board_games_posted_on($board_games_icon = false);
            }
            echo '</div>';

        }

    }

endif;

if( !function_exists('board_games_entry_footer') ):

    /**
     * Prints HTML with meta information for the categories, tags and comments.
     */
    function board_games_entry_footer( $board_games_cats = true, $board_games_tags = true, $board_games_edits = true){   

        $board_games_default = board_games_get_default_theme_options();
        $board_games_post_category = absint( get_theme_mod( 'board_games_post_category',$board_games_default['board_games_post_category'] ) );
        $board_games_post_tags = absint( get_theme_mod( 'board_games_post_tags',$board_games_default['board_games_post_tags'] ) );

        // Hide category and tag text for pages.
        if ('post' === get_post_type()) {

            if( $board_games_cats && $board_games_post_category ){

                /* translators: used between list items, there is a space after the comma */
                $board_games_categories = get_the_category();
                if ($board_games_categories) {
                    echo '<div class="entry-meta-item entry-meta-categories">';
                    echo '<div class="entry-meta-wrapper">';
                
                    /* translators: 1: list of categories. */
                    echo '<span class="cat-links">';
                    foreach( $board_games_categories as $board_games_category ){

                        $board_games_cat_name = $board_games_category->name;
                        $board_games_cat_slug = $board_games_category->slug;
                        $board_games_cat_url = get_category_link( $board_games_category->term_id );
                        ?>

                        <a class="twp_cat_<?php echo esc_attr( $board_games_cat_slug ); ?>" href="<?php echo esc_url( $board_games_cat_url ); ?>" rel="category tag"><?php echo esc_html( $board_games_cat_name ); ?></a>

                    <?php }
                    echo '</span>'; // WPCS: XSS OK.
                    echo '</div>';
                    echo '</div>';
                }

            }

            if( $board_games_tags && $board_games_post_tags ){
                /* translators: used between list items, there is a space after the comma */
                $board_games_tags_list = get_the_tag_list('', esc_html_x(', ', 'list item separator', 'board-games'));
                if( $board_games_tags_list ){

                    echo '<div class="entry-meta-item entry-meta-tags">';
                    echo '<div class="entry-meta-wrapper">';

                    /* translators: 1: list of tags. */
                    echo '<span class="tags-links">';
                    echo wp_kses_post($board_games_tags_list) . '</span>'; // WPCS: XSS OK.
                    echo '</div>';
                    echo '</div>';

                }

            }

            if( $board_games_edits ){

                edit_post_link(
                    sprintf(
                        wp_kses(
                        /* translators: %s: Name of current post. Only visible to screen readers */
                            __('Edit <span class="screen-reader-text">%s</span>', 'board-games'),
                            array(
                                'span' => array(
                                    'class' => array(),
                                ),
                            )
                        ),
                        get_the_title()
                    ),
                    '<span class="edit-link">',
                    '</span>'
                );
            }

        }
    }

endif;

if ( ! function_exists( 'board_games_post_thumbnail' ) ) :

    /**
     * Displays an optional post thumbnail.
     *
     * Shows background style image with height class on archive/search/front,
     * and a normal inline image on single post/page views.
     */
    function board_games_post_thumbnail( $board_games_image_size = 'medium' ) {

        if ( post_password_required() || is_attachment() ) {
            return;
        }

        // Fallback image path
        $board_games_default_image = get_template_directory_uri() . '/assets/images/default.png';

        // Image size → height class map
        $board_games_size_class_map = array(
            'full'      => 'data-bg-large',
            'large'     => 'data-bg-big',
            'medium'    => 'data-bg-medium',
            'small'     => 'data-bg-small',
            'xsmall'    => 'data-bg-xsmall',
            'thumbnail' => 'data-bg-thumbnail',
        );

        $board_games_class = isset( $board_games_size_class_map[ $board_games_image_size ] )
            ? $board_games_size_class_map[ $board_games_image_size ]
            : 'data-bg-medium';

        if ( is_singular() ) {
            the_post_thumbnail();
        } else {
            // 🔵 On archives → use background image style
            $board_games_image = has_post_thumbnail()
                ? wp_get_attachment_image_src( get_post_thumbnail_id(), $board_games_image_size )
                : array( $board_games_default_image );

            $board_games_bg_image = isset( $board_games_image[0] ) ? $board_games_image[0] : $board_games_default_image;
            ?>
            <div class="post-thumbnail data-bg <?php echo esc_attr( $board_games_class ); ?>"
                 data-background="<?php echo esc_url( $board_games_bg_image ); ?>">
                <a href="<?php the_permalink(); ?>" class="theme-image-responsive" tabindex="0"></a>
            </div>
            <?php
        }
    }

endif;

if( !function_exists('board_games_is_comment_by_post_author') ):

    /**
     * Comments
     */
    /**
     * Check if the specified comment is written by the author of the post commented on.
     *
     * @param object $board_games_comment Comment data.
     *
     * @return bool
     */
    function board_games_is_comment_by_post_author($board_games_comment = null){

        if (is_object($board_games_comment) && $board_games_comment->user_id > 0) {
            $board_games_user = get_userdata($board_games_comment->user_id);
            $post = get_post($board_games_comment->comment_post_ID);
            if (!empty($board_games_user) && !empty($post)) {
                return $board_games_comment->user_id === $post->post_author;
            }
        }
        return false;
    }

endif;

if( !function_exists('board_games_breadcrumb') ) :

    /**
     * Board Games Breadcrumb
     */
    function board_games_breadcrumb($board_games_comment = null){

        echo '<div class="entry-breadcrumb">';
        board_games_breadcrumb_trail();
        echo '</div>';

    }

endif;