# betterdocs/4.2.0/includes/FrontEnd/TemplateLoader.php

BetterDocs – AI Documentation, Knowledge Base, MCP Server, Docs, Wikis, FAQ & Chatbot, version 4.2.0. 228 lines.

- Page: https://pluginprobe.com/plugins/betterdocs/4.2.0/code/includes/FrontEnd/TemplateLoader.php
- Raw: https://pluginprobe.com/plugins/betterdocs/4.2.0/raw/includes/FrontEnd/TemplateLoader.php
- Modified: 2025-09-09T12:07:38+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/betterdocs/4.2.0/code/includes/FrontEnd/TemplateLoader.php#L10-L20`.

```php
<?php

namespace WPDeveloper\BetterDocs\FrontEnd;

use WPDeveloper\BetterDocs\Utils\Base;
use WPDeveloper\BetterDocs\Utils\Views;
use WPDeveloper\BetterDocs\Utils\Database;
use WPDeveloper\BetterDocs\Dependencies\DI\Container;

class TemplateLoader extends Base {
	public $is_fse_theme = false;
	private $templates_dir;
	private $block_templates_dir;
	private $container;
	private $database;
	private $views;

	public function __construct( Container $container ) {
		$this->container = $container;
		$this->database  = $this->container->get( Database::class );
		$this->views     = $this->container->get( Views::class );
	}

	public function init() {
		$this->is_fse_theme = $this->is_fse_theme();

		if ( $this->is_fse_theme ) {
			// @todo: for FSE theme
		}

		if ( ! $this->is_fse_theme ) {
			add_filter( 'archive_template', [ $this, 'archive_template' ] );
			add_filter( 'single_template', [ $this, 'single_template' ] );
		}
	}

	/**
	 * Render Thrive Header Markup
	 *
	 * Outputs the header section and starts the main container for the page content.
	 *
	 * @return void
	 */
	public function render_thrive_header() {
		// Retrieve and sanitize the header content allowing limited HTML
		$header_content = thrive_template()->render_theme_hf_section( THRIVE_HEADER_SECTION );
		echo '<div id="wrapper">' . wp_kses_post( $header_content ) . '<div id="content"><div class="main-container">';
	}

	/**
	 * Render Thrive Footer Markup
	 *
	 * Outputs the footer section and closes the main content container.
	 *
	 * @return void
	 */
	public function render_thrive_footer() {
		// Retrieve and sanitize the footer content allowing limited HTML
		$footer_content = thrive_template()->render_theme_hf_section( THRIVE_FOOTER_SECTION );
		echo '</div></div>' . wp_kses_post( $footer_content ) . '</div>';
	}


	/**
	 * Returns the archive template for the 'docs' custom post type.
	 * If the post type is not 'docs' or it's an embed request, returns the original template.
	 * If custom archive templates are found in the theme, returns the appropriate template.
	 * Otherwise, returns the default archive template based on the selected layout.
	 * @param string $template The original template.
	 * @return string The archive template.
	 */
	public function archive_template( $template ) {
		if( is_tax('doc_category') ) {
			// If 'archive-doc_category.php' exists in the theme, return it
			$theme_template = locate_template( 'archive-doc_category.php' );
			if ( $theme_template ) {
				return $theme_template;
			}
		}

		if ( is_tax( 'glossaries' ) ) {
			// Use a custom taxonomy template for your custom taxonomy

			$_default_template = 'templates/single/layout-1';
			$layout            = 'templates/single/layout-7';

			$eligible_template = $this->views->path( $layout, $_default_template );

			if ( file_exists( $eligible_template ) ) {
				$template = &$eligible_template;
			}

			return apply_filters( 'betterdocs_archives_template', $template, $layout, $_default_template, $this->views );
		}

		if ( get_post_type() !== 'docs' && ! is_tax('doc_category') && ! is_tax( 'doc_tag' ) && ! is_tax( 'knowledge_base' ) ) {
			return $template;
		}

		if ( is_embed() ) {
			return $template;
		}

		if ( $this->locate_archives() ) {
			return $this->locate_archives();
		}

		$_default_template = 'templates/archives/layout-1';
		$layout            = $this->database->get_theme_mod( 'betterdocs_docs_layout_select', 'layout-7' );
		$_template         = 'templates/archives/' . $layout;
		
		if ( is_tax( 'doc_category' ) ) {
			$category_layout = $this->database->get_theme_mod( 'betterdocs_archive_layout_select', 'layout-7' );
			if ( $category_layout == 'layout-7' || $category_layout == 'layout-8' ) {
				$_template = 'templates/archives/categories/' . $category_layout;
			} else {
				$_template = 'templates/taxonomy-doc_category';
			}
			$_default_template = $_template;
		} elseif ( is_tax( 'doc_tag' ) ) {
			$_template         = 'templates/taxonomy-doc_tag';
			$_default_template = $_template;
		}

		$eligible_template = $this->views->path( $_template, $_default_template );

		//Render The Header Footer When Thrive Builder Theme Is Activated
		if ( wp_get_theme() == 'Thrive Theme Builder' ) {
			$this->render_thrive_header_footer();
		}

		if ( file_exists( $eligible_template ) ) {
			$template = &$eligible_template;
		}

		return apply_filters( 'betterdocs_archives_template', $template, $layout, $_default_template, $this->views );
	}

	/**
	 * Locates custom archive templates from the theme.
	 * Checks for 'archive-docs.php', 'taxonomy-doc_category.php', 'taxonomy-doc_tag.php', and 'taxonomy-knowledge_base.php'.
	 * Returns the template path if found, otherwise returns false.
	 * @return string|false The template path or false if not found.
	 */
	public function locate_archives() {
		$archive_docs   = locate_template( 'archive-docs.php' );
		$doc_category   = locate_template( 'taxonomy-doc_category.php' );
		$doc_tag        = locate_template( 'taxonomy-doc_tag.php' );
		$knowledge_base = locate_template( 'taxonomy-knowledge_base.php' );

		if ( is_post_type_archive( 'docs' ) && $archive_docs ) {
			return $archive_docs;
		} elseif ( is_tax( 'doc_category' ) && $doc_category ) {
			return $doc_category;
		} elseif ( is_tax( 'doc_tag' ) && $doc_tag ) {
			return $doc_tag;
		} elseif ( is_tax( 'knowledge_base' ) && $archive_docs ) {
			return $knowledge_base;
		}

		return false;
	}

	/**
	 * Render Thriver Header Footer When Thrive Theme Is Activated
	 *
	 * @return void
	 */
	public function render_thrive_header_footer() {
		add_action( 'get_header', [ $this, 'render_thrive_header' ], 10 );
		add_action( 'get_footer', [ $this, 'render_thrive_footer' ], 10 );
	}

	/**
	 * Returns the template for single 'docs' custom post type.
	 * If the current post type is not 'docs', returns the original template.
	 * If 'single-docs.php' exists in the theme, returns it.
	 * Otherwise, returns the default single template based on the selected layout.
	 * @param string $template The original template.
	 * @return string The single template.
	 */
	public function single_template( $template ) {
		if ( ! is_singular( 'docs' ) ) {
			return $template;
		}

		// If 'single-docs.php' exists in the theme, return it
		$theme_template = locate_template( 'single-docs.php' );
		if ( $theme_template ) {
			return $theme_template;
		}

		//Render The Header Footer When Thrive Builder Theme Is Activated
		if ( wp_get_theme() == 'Thrive Theme Builder' ) {
			$this->render_thrive_header_footer();
		}

		$_default_template = 'templates/single/layout-1';
		$layout            = $this->database->get_theme_mod( 'betterdocs_single_layout_select', 'layout-8' );
		$layout            = 'templates/single/' . $layout;

		$eligible_template = $this->views->path( $layout, $_default_template );

		if ( file_exists( $eligible_template ) ) {
			$template = &$eligible_template;
		}

		return apply_filters( 'betterdocs_single_template', $template, $layout, $_default_template, $this->views );
	}

	/**
	 * Summary of is_fse_theme
	 * @return bool
	 *
	 * @suppress PHP0417
	 */
	private function is_fse_theme() {
		if ( function_exists( 'wp_is_block_theme' ) ) {
			return (bool) wp_is_block_theme();
		}
		if ( function_exists( 'gutenberg_is_fse_theme' ) ) {
			return (bool) gutenberg_is_fse_theme();
		}

		return false;
	}
}

```