From e6afcad2fa521004f5e1188f5fcfbec36624e95a Mon Sep 17 00:00:00 2001
From: sparkyx <danydb@noalyss.eu>
Date: Thu, 25 Jul 2024 17:54:33 +0200
Subject: [PATCH] Documentation + Tag::display

---
 include/class/tag.class.php        | 19 ++++++++++++++++---
 include/class/tag_action.class.php | 10 +++++-----
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/include/class/tag.class.php b/include/class/tag.class.php
index 568b36d90..eeeedd984 100644
--- a/include/class/tag.class.php
+++ b/include/class/tag.class.php
@@ -50,7 +50,7 @@ class Tag
     }
 
     /**
-     * Show the list of available tag
+     * @brief Show the list of available tag
      * @return HTML
      */
     function show_list()
@@ -61,7 +61,7 @@ class Tag
     }
     
     /**
-     * Display a inner window with the detail of a tag
+     * @brief Display a inner window with the detail of a tag
      */
     function form_add()
     {
@@ -93,7 +93,7 @@ class Tag
         $this->data->delete();
     }
     /***
-     * query the active tag and returns the database handler
+     *@brief  query the active tags and returns the database handler
      */
     function query_active_tag()
     {  
@@ -104,6 +104,19 @@ class Tag
                 select tg_id,tg_name ,'G','g' ,1 from tag_group order by 2");
         return $ret;
     }
+    /**
+     * @brief  return the HTML string display the tag
+     * @returns HTML string
+     */
+    function display()
+    {
+        $data=$this->get_data();
+        $ret="";
+        $ret.=sprintf ('<span id="tagdis_%s" class="tagcell tagcell-color%s">',$data->t_id,$data->t_color);
+        $ret.= h($data->t_tag);
+        $ret.= '</span>';
+        return $ret;
+    }
 }
 
 ?>
diff --git a/include/class/tag_action.class.php b/include/class/tag_action.class.php
index cef954309..212a2316e 100644
--- a/include/class/tag_action.class.php
+++ b/include/class/tag_action.class.php
@@ -40,7 +40,7 @@ class Tag_Action extends Tag
     }
 
     /**
-     * let select a tag to add
+     * @brief let select a tag to add
      */
     function select($p_prefix="")
     {
@@ -49,7 +49,7 @@ class Tag_Action extends Tag
     }
 
     /**
-     * Show a button to select tag for Search
+     * @brief Show a button to select tag for Search
      * @return HTML
      */
     static function select_tag_search($p_prefix)
@@ -61,7 +61,7 @@ class Tag_Action extends Tag
     }
 
     /**
-     * clear the search cell
+     * @brief clear the search cell
      */
     static function add_clear_button($p_prefix)
     {
@@ -71,7 +71,7 @@ class Tag_Action extends Tag
     }
 
     /**
-     * In the screen search add this data to the cell
+     *@brief  In the screen search add this data to the cell
      */
     function update_search_cell($p_prefix)
     {
@@ -85,7 +85,7 @@ class Tag_Action extends Tag
     }
 
     /**
-     * let select a tag to add to the search
+     * @brief let select a tag to add to the search
      */
     function select_search($p_prefix,$title=true)
     {