skycel/Wordpress_CustomThemeTree
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

📝 - Ajout de commentaires PHPDoc pour améliorer la documentation du code

Browse Source
This commit is contained in:
skycel
2025-02-05 01:07:25 +01:00
parent a0b5f2033f
commit 4256b12555
3 changed files with 165 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

123
TemplateLoader.php
View File

@@ -5,10 +5,20 @@ namespace Skycel\CustomTree;
use Error;
use WP_Error;
/**
* Handles loading and rendering of WordPress templates based on their type
* and subdirectories. Supports various template types, such as pages, archives,
* taxonomies, components, and more.
*/
class TemplateLoader {
static array $templates_parts;
/**
* Initializes the template rendering process.
*
* @return void
*/
protected function init() {
add_filter("template_render", function ($templates_path, $type) {
foreach ($templates_path as $path) {
@@ -22,6 +32,15 @@ class TemplateLoader {
}, 10, 2);
}
/**
* Retrieves and processes templates based on the specified type and template data.
*
* @param string $template The primary template name or path.
* @param string $type The type of template being requested (e.g., "home", "frontpage").
* @param array $templates A list of additional template names or paths.
*
* @return void
*/
public static function getTemplates($template, $type, $templates) {
if ($type === "home" || $type === "frontpage") $type = "page";
$key = (int)$type !== 0 ? "errors" : preg_replace("/y$/m", "ie", $type)."s";
@@ -36,6 +55,14 @@ class TemplateLoader {
do_action("template_render", self::$templates_parts, $type);
}
/**
* Processes templates and builds template parts based on the given type and path.
*
* @param string $template_path The base path for the templates.
* @param string $type The type prefix to be removed from template names.
* @param array $templates List of templates to process.
* @return void
*/
public static function getDefault($template_path, $type, $templates): void {
foreach ($templates as $t) {
$t = preg_replace("/^$type-/m", "", $t);
@@ -44,26 +71,74 @@ class TemplateLoader {
}
/**
* Retrieves pages based on the provided template path, type, and templates.
*
* @param string $template_path The path to the template.
* @param string $type The type of the template.
* @param array $templates The list of templates.
* @return void
*/
public static function getPages($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Retrieves and processes archive templates.
*
* @param string $template_path Path to the template.
* @param string $type Type of template.
* @param array $templates List of templates.
* @return void
*/
public static function getArchives($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Retrieves authors based on the provided parameters.
*
* @param string $template_path The path of the template.
* @param string $type The type of the template.
* @param array $templates The list of templates.
* @return void
*/
public static function getAuthors($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Retrieves errors by processing templates with a default method.
*
* @param string $template_path Path to the template directory.
* @param string $type Type of templates being processed.
* @param array $templates List of template files.
* @return void
*/
public static function getErrors($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Retrieves and processes category templates.
*
* @param string $template_path Path to the template directory.
* @param string $type Type of the template.
* @param array $templates List of templates to process.
* @return void
*/
public static function getCategories($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Generates an array of single templates with processed paths and stores them in the template parts.
*
* @param string $template_path The base path to the templates.
* @param string $type The type of template being processed.
* @param array $templates A list of template names to process.
* @return void
*/
public static function getSingles($template_path, $type, $templates): void {
$tmpl = [];
@@ -83,6 +158,14 @@ class TemplateLoader {
self::$templates_parts = $tmpl;
}
/**
* Generates and sets attachment file paths based on provided templates.
*
* @param string $template_path Base path for the templates.
* @param string $type Type of attachment (not explicitly used in method logic).
* @param array $templates List of template filenames.
* @return void
*/
public static function getAttachments($template_path, $type, $templates): void {
foreach($templates as $i => $t) {
$folder = "";
@@ -94,6 +177,15 @@ class TemplateLoader {
}
}
/**
* Updates the list of templates with taxonomy-specific paths based on the provided data.
*
* @param string $template_path The base path to the templates.
* @param string $type The type of taxonomy being processed.
* @param array $templates An array of template file names to process.
*
* @return void
*/
public static function getTaxonomies($template_path, $type, $templates): void {
$tmpl = [];
@@ -112,19 +204,50 @@ class TemplateLoader {
self::$templates_parts = $tmpl;
}
/**
* Retrieves tags based on the provided parameters.
*
* @param string $template_path The path to the template.
* @param string $type The type of the template.
* @param array $templates The list of templates.
* @return void
*/
public static function getTags($template_path, $type, $templates): void {
self::getDefault($template_path, $type, $templates);
}
/**
* Generates date-based template paths and appends them to the templates parts list.
*
* @param string $template_path The base path for the templates.
* @param string $type The type of template to append.
* @param array $templates Not used in this method.
* @return void
*/
public static function getDates($template_path, $type, $templates): void {
self::$templates_parts[] = is_year() ? $template_path . "/year.php" : (is_month() ? $template_path ."/month.php" : $template_path . "/day.php");
self::$templates_parts[] = $template_path . "/$type.php";
}
/**
* Appends a search template path to the templates array.
*
* @param string $template_path The base path to the templates.
* @param string $type The type of the search template.
* @param array $templates The list of existing templates.
* @return void
*/
public static function getSearchs($template_path, $type, $templates): void {
self::$templates_parts[] = $template_path . "/$type.php";
}
/**
* Retrieves and processes the components associated with the current filter hook.
*
* @param string $name The name of the component being retrieved.
* @param mixed|null $args Optional. Additional arguments passed to the component.
* @return void
*/
public static function getComponents($name, $args = null) {
$hook_name = current_filter();