<?php
/**
 * Custom Functions
 * @package Solar Energy Engine
 * @since 1.0.0
 */

if( !function_exists('solar_energy_engine_site_logo') ):

    /**
     * Logo & Description
     */
    /**
     * Displays the site logo, either text or image.
     *
     * @param array $solar_energy_engine_args Arguments for displaying the site logo either as an image or text.
     * @param boolean $solar_energy_engine_echo Echo or return the HTML.
     *
     * @return string $solar_energy_engine_html Compiled HTML based on our arguments.
     */
    function solar_energy_engine_site_logo( $solar_energy_engine_args = array(), $solar_energy_engine_echo = true ){
        $solar_energy_engine_logo = get_custom_logo();
        $solar_energy_engine_site_title = get_bloginfo('name');
        $solar_energy_engine_contents = '';
        $solar_energy_engine_classname = '';
        $solar_energy_engine_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(),
        );
        $solar_energy_engine_args = wp_parse_args($solar_energy_engine_args, $solar_energy_engine_defaults);
        /**
         * Filters the arguments for `solar_energy_engine_site_logo()`.
         *
         * @param array $solar_energy_engine_args Parsed arguments.
         * @param array $solar_energy_engine_defaults Function's default arguments.
         */
        $solar_energy_engine_args = apply_filters('solar_energy_engine_site_logo_args', $solar_energy_engine_args, $solar_energy_engine_defaults);
        
        $solar_energy_engine_show_logo  = get_theme_mod('solar_energy_engine_display_logo', false);
        $solar_energy_engine_show_title = get_theme_mod('solar_energy_engine_display_title', true);

        if ( has_custom_logo() && $solar_energy_engine_show_logo ) {
            $solar_energy_engine_contents .= sprintf($solar_energy_engine_args['logo'], $solar_energy_engine_logo, esc_html($solar_energy_engine_site_title));
            $solar_energy_engine_classname = $solar_energy_engine_args['logo_class'];
        }

        if ( $solar_energy_engine_show_title ) {
            $solar_energy_engine_contents .= sprintf($solar_energy_engine_args['title'], esc_url(get_home_url(null, '/')), esc_html($solar_energy_engine_site_title));
            // If logo isn't shown, fallback to title class for wrapper.
            if ( !$solar_energy_engine_show_logo ) {
                $solar_energy_engine_classname = $solar_energy_engine_args['title_class'];
            }
        }

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

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

    }

endif;

if( !function_exists('solar_energy_engine_site_description') ):

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

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

endif;

if( !function_exists('solar_energy_engine_posted_on') ):

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

        $solar_energy_engine_default = solar_energy_engine_get_default_theme_options();
        $solar_energy_engine_post_date = absint( get_theme_mod( 'solar_energy_engine_post_date',$solar_energy_engine_default['solar_energy_engine_post_date'] ) );

        if( $solar_energy_engine_post_date ){

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

            $solar_energy_engine_time_string = sprintf($solar_energy_engine_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())
            );

            $solar_energy_engine_year = get_the_date('Y');
            $solar_energy_engine_month = get_the_date('m');
            $solar_energy_engine_day = get_the_date('d');
            $solar_energy_engine_link = get_day_link($solar_energy_engine_year, $solar_energy_engine_month, $solar_energy_engine_day);

            $solar_energy_engine_posted_on = '<a href="' . esc_url($solar_energy_engine_link) . '" rel="bookmark">' . $solar_energy_engine_time_string . '</a>';

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

            if( $solar_energy_engine_icon ){

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

            }

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

        }

    }

endif;

if( !function_exists('solar_energy_engine_posted_by') ) :

    /**
     * Prints HTML with meta information for the current author.
     */
    function solar_energy_engine_posted_by( $solar_energy_engine_icon = true, $solar_energy_engine_animation_class = '' ){   

        $solar_energy_engine_default = solar_energy_engine_get_default_theme_options();
        $solar_energy_engine_post_author = absint( get_theme_mod( 'solar_energy_engine_post_author',$solar_energy_engine_default['solar_energy_engine_post_author'] ) );

        if( $solar_energy_engine_post_author ){

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

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

            $solar_energy_engine_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"> ' . $solar_energy_engine_byline . '</span>'; // WPCS: XSS OK.
            echo '</div>';
            echo '</div>';

        }

    }

endif;


if( !function_exists('solar_energy_engine_posted_by_avatar') ) :

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

        $solar_energy_engine_default = solar_energy_engine_get_default_theme_options();
        $solar_energy_engine_post_author = absint( get_theme_mod( 'solar_energy_engine_post_author',$solar_energy_engine_default['solar_energy_engine_post_author'] ) );

        if( $solar_energy_engine_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">';

            $solar_energy_engine_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"> ' . $solar_energy_engine_byline . '</div>';

            if( $solar_energy_engine_date ){
                solar_energy_engine_posted_on($solar_energy_engine_icon = false);
            }
            echo '</div>';

        }

    }

endif;

if( !function_exists('solar_energy_engine_entry_footer') ):

    /**
     * Prints HTML with meta information for the categories, tags and comments.
     */
    function solar_energy_engine_entry_footer( $solar_energy_engine_cats = true, $solar_energy_engine_tags = true, $solar_energy_engine_edits = true){   

        $solar_energy_engine_default = solar_energy_engine_get_default_theme_options();
        $solar_energy_engine_post_category = absint( get_theme_mod( 'solar_energy_engine_post_category',$solar_energy_engine_default['solar_energy_engine_post_category'] ) );
        $solar_energy_engine_post_tags = absint( get_theme_mod( 'solar_energy_engine_post_tags',$solar_energy_engine_default['solar_energy_engine_post_tags'] ) );

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

            if( $solar_energy_engine_cats && $solar_energy_engine_post_category ){

                /* translators: used between list items, there is a space after the comma */
                $solar_energy_engine_categories = get_the_category();
                if ($solar_energy_engine_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( $solar_energy_engine_categories as $solar_energy_engine_category ){

                        $solar_energy_engine_cat_name = $solar_energy_engine_category->name;
                        $solar_energy_engine_cat_slug = $solar_energy_engine_category->slug;
                        $solar_energy_engine_cat_url = get_category_link( $solar_energy_engine_category->term_id );
                        ?>

                        <a class="twp_cat_<?php echo esc_attr( $solar_energy_engine_cat_slug ); ?>" href="<?php echo esc_url( $solar_energy_engine_cat_url ); ?>" rel="category tag"><?php echo esc_html( $solar_energy_engine_cat_name ); ?></a>

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

            }

            if( $solar_energy_engine_tags && $solar_energy_engine_post_tags ){
                /* translators: used between list items, there is a space after the comma */
                $solar_energy_engine_tags_list = get_the_tag_list('', esc_html_x(', ', 'list item separator', 'solar-energy-engine'));
                if( $solar_energy_engine_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($solar_energy_engine_tags_list) . '</span>'; // WPCS: XSS OK.
                    echo '</div>';
                    echo '</div>';

                }

            }

            if( $solar_energy_engine_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>', 'solar-energy-engine'),
                            array(
                                'span' => array(
                                    'class' => array(),
                                ),
                            )
                        ),
                        get_the_title()
                    ),
                    '<span class="edit-link">',
                    '</span>'
                );
            }

        }
    }

endif;

if ( ! function_exists( 'solar_energy_engine_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 solar_energy_engine_post_thumbnail( $solar_energy_engine_image_size = 'medium' ) {

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

        // Fallback image path
        $solar_energy_engine_default_image = get_template_directory_uri() . '/assets/images/slider1.png';

        // Image size → height class map
        $solar_energy_engine_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',
        );

        $solar_energy_engine_class = isset( $solar_energy_engine_size_class_map[ $solar_energy_engine_image_size ] )
            ? $solar_energy_engine_size_class_map[ $solar_energy_engine_image_size ]
            : 'data-bg-medium';

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

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

endif;

if( !function_exists('solar_energy_engine_is_comment_by_post_author') ):

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

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

endif;

if( !function_exists('solar_energy_engine_breadcrumb') ) :

    /**
     * Solar Energy Engine Breadcrumb
     */
    function solar_energy_engine_breadcrumb($solar_energy_engine_comment = null){

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

    }

endif;