# betterdocs/4.9.2/includes/Editors/Elementor/Traits/TemplateQuery.php

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

- Page: https://pluginprobe.com/plugins/betterdocs/4.9.2/code/includes/Editors/Elementor/Traits/TemplateQuery.php
- Raw: https://pluginprobe.com/plugins/betterdocs/4.9.2/raw/includes/Editors/Elementor/Traits/TemplateQuery.php
- Modified: 2024-12-09T12:10:16+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.9.2/code/includes/Editors/Elementor/Traits/TemplateQuery.php#L10-L20`.

```php
<?php
namespace WPDeveloper\BetterDocs\Editors\Elementor\Traits;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly
}

trait TemplateQuery {
	public $current_widget_name = '';

	public function set_widget_name( $name = '' ) {
		$this->current_widget_name = $name;
	}

	/**
	 * Retrieves Template name from file header.
	 *
	 * @array
	 */
	private $template_headers = [
		'Template Name' => 'Template Name'
	];

	/**
	 * Prepare the directory name from the following widget name.
	 *
	 * @access private
	 *
	 *
	 * @return  string  $widget_name
	 */
	private function process_directory_name() {
		if ( empty( $this->current_widget_name ) ) {
			$this->current_widget_name = $this->get_name();
		}

		$widget_name = str_replace( 'betterdocs-', '', $this->current_widget_name );
		$widget_name = str_replace( '-', ' ', $widget_name );
		$widget_name = ucwords( $widget_name );
		$widget_name = str_replace( ' ', '-', $widget_name );

		return $widget_name;
	}

	/**
	 * Retrieve `Theme Template Directory`
	 *
	 * @return string templates directory from the active theme.
	 */
	private function theme_templates_dir() {
		$current_theme = wp_get_theme();

		$dir = sprintf(
			'%s/%s/Template/%s',
			$current_theme->theme_root,
			$current_theme->stylesheet,
			$this->process_directory_name()
		);

		if ( is_dir( $dir ) ) {
			$file = scandir( $dir );
			$file = array_pop( $file );

			return pathinfo( $file, PATHINFO_EXTENSION ) === 'php' ? $dir : false;
		}

		return false;
	}

	/**
	 * Retrieves the lite plugin template directory path.
	 *
	 * @return  string  templates directory path of lite version.
	 */
	private function get_template_dir() {
		return \sprintf(
			'%sincludes/elementor/Template/%s',
			BETTERDOCS_ABSPATH,
			$this->process_directory_name()
		);
	}

	/**
	 * Retrieves the pro plugin template directory path.
	 *
	 * @return  string  templates directory path of pro version.
	 */
	private function get_pro_template_dir() {
		include_once ABSPATH . 'wp-admin/includes/plugin.php';
		if ( ! is_plugin_active( 'betterdocs-pro/betterdocs-pro.php' ) ) {
			return false;
		}

		return \sprintf(
			'%sincludes/elementor/Template/%s',
			BETTERDOCS_PRO_ROOT_DIR_PATH,
			$this->process_directory_name()
		);
	}

	/**
	 * Collecting templates from different sources.
	 *
	 * @return array
	 */
	private function get_template_files() {
		$templates = [];

		if ( is_dir( $this->get_template_dir() ) ) {
			$templates['lite'] = scandir( $this->get_template_dir(), 1 );
		}

		if ( is_dir( $this->get_pro_template_dir() ) ) {
			$templates['pro'] = scandir( $this->get_pro_template_dir(), 1 );
		}

		if ( $this->theme_templates_dir() ) {
			$templates['theme'] = scandir( $this->theme_templates_dir(), 1 );
		}

		return $templates;
	}

	/**
	 * Retrieves template list from template directory.
	 *
	 * @return array template list.
	 */
	protected function get_template_list() {
		$files = [];

		if ( $this->get_template_files() ) {
			foreach ( $this->get_template_files() as $key => $handler ) {
				foreach ( $handler as $handle ) {
					if ( strpos( $handle, '.php' ) !== false ) {
						if ( $key === 'lite' ) {
							$path = sprintf( '%s/%s', $this->get_template_dir(), $handle );
						} elseif ( $key === 'pro' ) {
							$path = sprintf( '%s/%s', $this->get_pro_template_dir(), $handle );
						} elseif ( $key === 'theme' ) {
							$path = sprintf( '%s/%s', $this->theme_templates_dir(), $handle );
						}

						$template_info = get_file_data( $path, $this->template_headers );
						$template_name = $template_info['Template Name'];

						if ( $template_name ) {
							$files[ $template_name ] = $path;
						}
					}
				}
			}
		}

		return $files;
	}

	/**
	 * Retrieves template list from template directory.
	 *
	 * @return array template list.
	 */
	public function get_template_list_for_dropdown() {
		$files = [];
		if ( $this->get_template_files() ) {
			foreach ( $this->get_template_files() as $key => $handler ) {
				foreach ( $handler as $handle ) {
					if ( strpos( $handle, '.php' ) !== false ) {
						$path          = $this->_get_path( $key, $handle );
						$template_info = get_file_data( $path, $this->template_headers );
						$template_name = $template_info['Template Name'];
						$template_key  = str_replace( ' ', '-', strtolower( $template_name ) );
						if ( $template_name ) {
							$files[ $template_key ] = sprintf( '%s (%s)', ucfirst( $template_name ), ucfirst( $key ) );
						}
					}
				}
			}
		}
		return $files;
	}

	public function _get_path( $key, $handle ) {
		$path = '';
		if ( $key === 'lite' ) {
			$path = sprintf( '%s/%s', $this->get_template_dir(), $handle );
		} elseif ( $key === 'pro' ) {
			$path = sprintf( '%s/%s', $this->get_pro_template_dir(), $handle );
		} elseif ( $key === 'theme' ) {
			$path = sprintf( '%s/%s', $this->theme_templates_dir(), $handle );
		}
		return $path;
	}

	/**
	 * Preparing template options for frontend select
	 *
	 * @return array teplate select options.
	 */
	private function get_template_options() {
		$files = [];

		if ( $this->get_template_list() ) {
			foreach ( $this->get_template_list() as $filename => $path ) {
				$filename = \str_replace( ' ', '-', $filename );

				$files[ strtolower( $filename ) ] = $path;
			}
		}

		return $files;
	}

	/**
	 * Adding key value pairs in template options.
	 *
	 * @return array
	 */
	private function template_options() {
		$keys   = array_keys( $this->get_template_options() );
		$values = array_keys( $this->get_template_list() );

		return array_combine( $keys, $values );
	}

	/**
	 * Retrieve template
	 *
	 * @param string $filename
	 *
	 * @return string include-able full template path.
	 */
	public function get_template( $filename ) {
		if ( in_array( $filename, array_keys( $this->get_template_options() ) ) ) {
			return $this->get_template_options()[ $filename ];
		}

		return false;
	}

	/**
	 * Set default option in frontend select control.
	 *
	 * @return string first option.
	 */
	public function get_default() {
		$dt = array_reverse( $this->template_options() );

		return strtolower( array_pop( $dt ) );
	}
}

```