Sid Gifari File Manager

Sid Gifari File Manager

🏠 Root / home / genremedia08 / thepassage.overlookedtracks.com / wp-content9 / plugins / learnpress / inc / Helpers /

Editing: Template.php

<?php

namespace LearnPress\Helpers;

use LP_Breadcrumb;

/**
 * Class Template
 *
 * @package LearnPress\Helpers
 * @since 1.0.0
 * @version 1.0.2
 */
class Template {
	/**
	 * @var bool
	 */
	protected $include;

protected function __construct() {
	}

/**
	 * Set 1 for include file, 0 for not
	 * Set 1 for separate template is block, 0 for not | use "wp_is_block_theme" function
	 *
	 * @param bool $has_include
	 *
	 * @return self
	 */
	public static function instance( bool $has_include = true ): Template {
		$self          = new self();
		$self->include = $has_include;

return $self;
	}

/**
	 * Get template admin file
	 *
	 * @param string $file_name
	 * @param array $args
	 *
	 * @return void|string
	 * @since 1.0.0
	 * @version 1.0.0
	 */
	public function get_admin_template( string $file_name = '', array $args = array() ) {
		$file_name = str_replace( '.php', '', $file_name );
		$path_file = LP_PLUGIN_PATH . "inc/admin/views/{$file_name}.php";

$template = $this->get_template( $path_file, $args );

if ( ! $this->include ) {
			return $template;
		}
	}

/**
	 * Get template frontend file
	 *
	 * @param string $file_name
	 * @param array $args
	 *
	 * @return void|string
	 * @since 4.2.0
	 * @version 1.0.0
	 */
	public function get_frontend_template( string $file_name = '', array $args = array() ) {
		$default_path          = LP_PLUGIN_PATH . "templates/{$file_name}";
		$folder_name_rewrite   = learn_press_template_path();
		$file_name             = sanitize_text_field( $file_name );
		$from_child_theme_path = sprintf(
			'%s/%s/%s',
			get_stylesheet_directory(),
			$folder_name_rewrite,
			$file_name
		);
		$from_theme_path       = sprintf(
			'%s/%s/%s',
			get_template_directory(),
			$folder_name_rewrite,
			$file_name
		);

$path_load = $default_path;
		if ( file_exists( $from_child_theme_path ) ) {
			$path_load = $from_child_theme_path;
		} elseif ( file_exists( $from_theme_path ) ) {
			$path_load = $from_theme_path;
		}

$template = '';
		if ( realpath( $path_load ) ) {
			$template = $this->get_template( $path_load, $args );
		}

if ( ! $this->include ) {
			return $template;
		}
	}

/**
	 * @param array $file_names
	 * @param array $args
	 *
	 * @return void
	 */
	public function get_frontend_templates( array $file_names = array(), array $args = array() ) {
		foreach ( $file_names as $file_name ) {
			$search_extension = strrpos( $file_name, '.php' );
			if ( ! $search_extension ) {
				$file_name .= '.php';
			}

$this->get_frontend_template( $file_name, $args );
		}
	}

/**
	 * Include path file
	 *
	 * @param string $path_file
	 * @param array $args
	 *
	 * @return string|void
	 * @since 1.0.0
	 * @version 1.0.0
	 */
	public function get_template( string $path_file, array $args = array() ) {
		try {
			extract( $args );

if ( file_exists( $path_file ) ) {
				if ( $this->include ) {
					include $path_file;
				} else {
					return $path_file;
				}
			} else {
				printf( esc_html__( 'Path file %s not exists', 'learnpress' ), $path_file );
				echo '<br>';
			}
		} catch ( \Throwable $e ) {
			error_log( $e->getMessage() );
		}
	}

/**
	 * Get frontend template block file
	 *
	 * @param string $file_name
	 * @param array $args
	 *
	 * @return string|void
	 */
	public function get_frontend_template_type_block( string $file_name = '', array $args = array() ) {
		$file_name = "block/{$file_name}";
		$template  = $this->get_frontend_template( $file_name, $args );

if ( ! $this->include ) {
			return $template;
		}
	}

/**
	 * Check file template is overwritten
	 *
	 * @param string $file_name
	 *
	 * @return bool|string return false if not, path file if yes
	 * @since 4.2.6
	 * @version 1.0.0
	 */
	public static function check_template_is_override( string $file_name = '' ) {
		$default_path          = LP_PLUGIN_PATH . "templates/{$file_name}";
		$folder_name_rewrite   = learn_press_template_path();
		$from_child_theme_path = sprintf(
			'%s/%s/%s',
			get_stylesheet_directory(),
			$folder_name_rewrite,
			$file_name
		);
		$from_theme_path       = sprintf(
			'%s/%s/%s',
			get_template_directory(),
			$folder_name_rewrite,
			$file_name
		);

if ( file_exists( $from_child_theme_path ) ) {
			return $from_child_theme_path;
		} elseif ( file_exists( $from_theme_path ) ) {
			return $from_theme_path;
		}

return false;
	}

/**
	 * Nest elements by tags
	 *
	 * @param array $els [ 'html_tag_open' => 'html_tag_close' ]
	 * @param string $main_content
	 *
	 * @return string
	 */
	public function nest_elements( array $els = [], string $main_content = '' ): string {
		$html = '';
		foreach ( $els as $tag_open => $tag_close ) {
			$html .= $tag_open;
		}

$html .= $main_content;

foreach ( array_reverse( $els, true ) as $tag_close ) {
			$html .= $tag_close;
		}

return $html;
	}

/**
	 * Display sections
	 *
	 * @param array $sections
	 * ['name_section' => [ 'text_html' => '<span>example</span>' ]]
	 * ['name_section' => [ 'link_templates' => 'path_template' ]]
	 *
	 * @return void
	 */
	public function print_sections( array $sections = [], array $args = [] ) {
		foreach ( $sections as $section ) {
			if ( ! is_array( $section ) ) {
				continue;
			}

foreach ( $section as $type => $val ) {
				switch ( $type ) {
					case 'link_templates':
						$this->get_frontend_template( $val, $args );
						break;
					default:
						if ( is_string( $val ) ) {
							//$allow_tag = wp_kses_allowed_html( 'post' );
							//echo wp_kses( $section, $allow_tag );
							echo $val;
						}
						break;
				}
			}
		}
	}

/**
	 * Combine html elements
	 *
	 * @param array $elms
	 *
	 * @return string
	 * @since 4.2.6.9
	 */
	public static function combine_components( array $elms = [] ): string {
		$html = '';
		foreach ( $elms as $tag => $val ) {
			$html .= $val;
		}

return $html;
	}

/**
	 * Insert new key to a position of array
	 *
	 * @param array $old_array
	 * @param string $position after/before
	 * @param string $key_compare key to compare
	 * @param string $key_add
	 * @param string $value
	 *
	 * @return array
	 * @since 4.2.7.2
	 * @version 1.0.1
	 */
	public static function insert_value_to_position_array(
		array $old_array,
		string $position,
		string $key_compare,
		string $key_add,
		string $value
	): array {
		$new_array = [];

foreach ( $old_array as $k => $v ) {
			if ( $position === 'after' ) {
				$new_array[ $k ] = $v;
			}
			if ( $key_compare === $k ) {
				$new_array[ $key_add ] = $value;
			}
			if ( $position === 'before' ) {
				$new_array[ $k ] = $v;
			}
		}

return $new_array;
	}

/**
	 * Print message
	 *
	 * @param string $message
	 * @param string $status 'success', 'warning', 'error, 'info'
	 * @param bool $has_print since 4.2.7.6, true for print, false for return
	 *
	 * @return void|string
	 * @since 4.2.6.9.3
	 * @version 1.0.2
	 */
	public static function print_message( string $message, string $status = 'success', bool $has_print = true ) {
		if ( empty( $message ) ) {
			if ( $has_print ) {
				return;
			} else {
				return '';
			}
		}

$section = [
			'wrapper'     => sprintf( '<div class="learn-press-message %s">', esc_attr( $status ) ),
			'content'     => wp_kses_post( $message ),
			'wrapper_end' => '</div>',
		];

if ( $has_print ) {
			echo Template::combine_components( $section );
		} else {
			return Template::combine_components( $section );
		}
	}

/**
	 * Generate HTML for pagination.
	 *
	 * @param array $data [ 'total_pages' => int, 'paged' => int, 'base' => string ]
	 *
	 * @return string HTML for pagination.
	 * @since 4.2.8.7.4
	 * @version 1.0.1
	 */
	public function html_pagination( array $data = [] ): string {
		$total_pages = $data['total_pages'] ?? 0;
		$paged       = $data['paged'] ?? 1;
		if ( $total_pages <= 1 ) {
			return '';
		}

$html_wrapper = $data['wrapper'] ?? [
			'<nav class="learn-press-pagination navigation pagination">' => '</nav>',
		];

$pagination = paginate_links(
			apply_filters(
				'learn_press_pagination_args',
				array(
					'base'      => $data['base'] ?? '',
					'format'    => '',
					'add_args'  => '',
					'current'   => max( 1, $paged ),
					'total'     => $total_pages,
					'prev_text' => '<i class="lp-icon-arrow-left"></i>',
					'next_text' => '<i class="lp-icon-arrow-right"></i>',
					'type'      => 'list',
					'end_size'  => 3,
					'mid_size'  => 3,
				)
			)
		);

return Template::instance()->nest_elements( $html_wrapper, $pagination );
	}

/**
	 * Convert data to JSON string
	 *
	 * @param array|object|mixed $data
	 *
	 * @return string
	 * @since 4.2.9
	 * @version 1.0.0
	 */
	public static function convert_data_to_json( $data ): string {
		return esc_attr(
			htmlentities2(
				wp_json_encode(
					$data,
					JSON_HEX_QUOT |
					JSON_HEX_TAG |
					JSON_HEX_AMP |
					JSON_HEX_APOS |
					JSON_UNESCAPED_UNICODE |
					JSON_UNESCAPED_SLASHES
				)
			)
		);
	}

/**
	 * Sanitize HTML content by allowing specific tags and attributes.
	 *
	 * @param string $content
	 *
	 * @return string
	 * @since 4.2.9
	 * @version 1.0.0
	 */
	public static function sanitize_html_content( string $content = '' ): string {
		$allowed_tags = wp_kses_allowed_html( 'post' );

$extra_tag = array(
			'iframe' => [
				'src'             => true,
				'width'           => true,
				'height'          => true,
				'frameborder'     => true,
				'allowfullscreen' => true,
				'allow'           => true,
			],
			'audio'  => array(
				'autoplay'         => true,
				'controls'         => true,
				'loop'             => true,
				'muted'            => true,
				'preload'          => true,
				'src'              => true,
				'aria-controls'    => true,
				'aria-current'     => true,
				'aria-describedby' => true,
				'aria-details'     => true,
				'aria-expanded'    => true,
				'aria-hidden'      => true,
				'aria-label'       => true,
				'aria-labelledby'  => true,
				'aria-live'        => true,
				'class'            => true,
				'data-*'           => true,
				'dir'              => true,
				'hidden'           => true,
				'id'               => true,
				'lang'             => true,
				'style'            => true,
				'title'            => true,
				'role'             => true,
				'xml:lang'         => true,
				'controlslist'     => true,
				'crossorigin'      => true,
				'poster'           => true,
			),
			'source' => array(
				'src'   => true,
				'type'  => true,
				'media' => true,
			),
		);

$allowed_tags = array_merge( $allowed_tags, $extra_tag );

return wp_kses( $content, $allowed_tags );
	}

/**
	 * Generate breadcrumb HTML.
	 *
	 * @param array $args
	 *
	 * @return string
	 * @since 4.3.2.6
	 * @version 1.0.0
	 */
	public static function html_breadcrumb( array $args = [] ): string {
		$args = wp_parse_args(
			$args,
			apply_filters(
				'learn_press_breadcrumb_defaults',
				array(
					'delimiter'   => '<li class="breadcrumb-delimiter"><i class="lp-icon-angle-right"></i></li>',
					'wrap_before' => '<ul class="learn-press-breadcrumb">',
					'wrap_after'  => '</ul>',
					'after'       => '',
					'home'        => _x( 'Home', 'breadcrumb', 'learnpress' ),
				)
			)
		);

$breadcrumbs = new LP_Breadcrumb();
		if ( $args['home'] ) {
			$breadcrumbs->add_crumb( $args['home'], apply_filters( 'learn_press_breadcrumb_home_url', home_url() ) );
		}

$args['breadcrumb'] = $breadcrumbs->generate();

$html_content = '';
		foreach ( $args['breadcrumb'] as $key => $crumb ) {
			$html_content .= '<li>';
			if ( ! empty( $crumb[1] ) ) {
				$html_content .= sprintf(
					'<a href="%s"><span>%s</span></a>',
					esc_url_raw( $crumb[1] ),
					esc_html( $crumb[0] )
				);
			} else {
				$html_content .= sprintf(
					'<span>%s</span>',
					esc_html( $crumb[0] )
				);
			}

$html_content .= '</li>';
			if ( sizeof( $args['breadcrumb'] ) !== $key + 1 ) {
				$html_content .= $args['delimiter'];
			}
		}

$section = apply_filters(
			'learn_press/breadcrumb/html-section',
			[
				'wrap'     => $args['wrap_before'],
				'content'  => $html_content,
				'wrap-end' => $args['wrap_after'],
			],
			$args
		);

return Template::combine_components( $section );
	}
}