From a0b5f2033fa0be91b382dff3755793ab6b69db8b Mon Sep 17 00:00:00 2001
From: skycel <cece.burst@gmail.com>
Date: Wed, 5 Feb 2025 01:03:46 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=9A=F0=9F=93=9D=20-=20R=C3=A9organisat?=
 =?UTF-8?q?ion=20des=20fichiers=20et=20ajout=20de=20documentation=20pour?=
 =?UTF-8?q?=20les=20fonctions=20existantes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../custom-template.inc.php                   | 17 +++++------
 functions.php => includes/functions.inc.php   | 29 +++++++++++++++++++
 2 files changed, 36 insertions(+), 10 deletions(-)
 rename custom-template.php => includes/custom-template.inc.php (59%)
 rename functions.php => includes/functions.inc.php (57%)

diff --git a/custom-template.php b/includes/custom-template.inc.php
similarity index 59%
rename from custom-template.php
rename to includes/custom-template.inc.php
index 13e4c3c..0e49266 100644
--- a/custom-template.php
+++ b/includes/custom-template.inc.php
@@ -1,12 +1,17 @@
 <?php
 // Add some functions to quickly load template
 
+/**
+ * Loads the appropriate topbar template file.
+ *
+ * @param string|null $name Optional. The specific topbar name to load.
+ * @param array $args Optional. Additional arguments to pass to the template.
+ * @return bool True if the template was found and loaded, false otherwise.
+ */
 function tree_get_topbar($name = null, $args = array()) {
 
     do_action("get_topbar", $name, $args);
 
-    return false;
-
     $templates = array();
     $name      = (string) $name;
     if ( '' !== $name ) {
@@ -18,12 +23,4 @@ function tree_get_topbar($name = null, $args = array()) {
     if ( ! locate_template( $templates, true, true, $args ) ) {
         return false;
     }
-}
-
-function get_blog_url($blog_id = null) {
-    if (null === $blog_id) $blog_id = get_current_blog_id();
-
-    if (get_current_blog_id() !== $blog_id && get_blogaddress_by_id($blog_id)) switch_to_blog($blog_id);
-
-    return get_post_type_archive_link( 'post' );
 }
\ No newline at end of file
diff --git a/functions.php b/includes/functions.inc.php
similarity index 57%
rename from functions.php
rename to includes/functions.inc.php
index 8993076..0cd943d 100644
--- a/functions.php
+++ b/includes/functions.inc.php
@@ -1,4 +1,13 @@
 <?php
+
+
+/**
+ * Merges multiple arrays recursively without duplicating scalar values for numeric keys
+ * and overriding values for associative keys.
+ *
+ * @param array ...$arrays Arrays to be merged.
+ * @return array The resulting merged array.
+ */
 function array_merge_recursive_distinct(array ...$arrays): array {
     $merged = [];
 
@@ -27,6 +36,26 @@ function array_merge_recursive_distinct(array ...$arrays): array {
     return $merged;
 }
 
+/**
+ * Checks if a directory is empty.
+ *
+ * @param string $dir Path to the directory to check.
+ * @return bool True if the directory is empty, false otherwise.
+ */
 function is_dir_empty($dir): bool {
     return (count(scandir($dir)) == 2);
+}
+
+/**
+ * Retrieves the URL of the blog archive for the specified blog ID.
+ *
+ * @param int|null $blog_id The ID of the blog. If null, uses the current blog ID.
+ * @return string The URL of the blog archive.
+ */
+function get_blog_url($blog_id = null) {
+    if (null === $blog_id) $blog_id = get_current_blog_id();
+
+    if (get_current_blog_id() !== $blog_id && get_blogaddress_by_id($blog_id)) switch_to_blog($blog_id);
+
+    return get_post_type_archive_link( 'post' );
 }
\ No newline at end of file