Add "user_certificate" extra field + add "downloaded_at" field

See BT#12910

Author: jmontoyaa

main/inc/lib/certificate.lib.php

@@ -73,9 +73,8 @@ public function __construct($certificate_id = 0, $userId = 0)
             }
         }
 
-        //Setting the qr and html variables
-        if (
-            isset($certificate_id) &&
+        // Setting the qr and html variables
+        if (isset($certificate_id) &&
             !empty($this->certification_user_path) &&
             isset($this->certificate_data['path_certificate'])
         ) {
@@ -92,7 +91,7 @@ public function check_certificate_path()
     {
         $this->certification_user_path = null;
 
-        //Setting certification path
+        // Setting certification path
         $path_info = UserManager::getUserPathById($this->user_id, 'system');
         $web_path_info = UserManager::getUserPathById($this->user_id, 'web');
 
@@ -212,7 +211,10 @@ public function generate($params = array())
 
                             $my_new_content_html = str_replace(
                                 '((certificate_barcode))',
-                                Display::img($this->certification_web_user_path.$file_info['filename'].'_qr.png', 'QR'),
+                                Display::img(
+                                    $this->certification_web_user_path.$file_info['filename'].'_qr.png',
+                                    'QR'
+                                ),
                                 $new_content_html['content']
                             );
 
@@ -262,10 +264,10 @@ public function update_user_info_about_certificate(
         $user_id,
         $path_certificate
     ) {
-        $table_certificate = Database::get_main_table(TABLE_MAIN_GRADEBOOK_CERTIFICATE);
+        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_CERTIFICATE);
         $now = api_get_utc_datetime();
         if (!UserManager::is_user_certified($cat_id, $user_id)) {
-            $sql = 'UPDATE '.$table_certificate.' SET 
+            $sql = 'UPDATE '.$table.' SET 
                         path_certificate="'.Database::escape_string($path_certificate).'",
                         created_at = "'.$now.'"
                     WHERE cat_id="'.intval($cat_id).'" AND user_id="'.intval($user_id).'" ';
@@ -295,9 +297,10 @@ public function html_file_is_generated()
 
     /**
      * Generates a QR code for the certificate. The QR code embeds the text given
-     * @param    string    $text Text to be added in the QR code
-     * @param    string    $path file path of the image
-     * */
+     * @param string $text Text to be added in the QR code
+     * @param string $path file path of the image
+     * @return bool
+     **/
     public function generate_qr($text, $path)
     {
         //Make sure HTML certificate is generated
@@ -427,6 +430,23 @@ public function show()
         $user_certificate = $this->certification_user_path.basename($this->certificate_data['path_certificate']);
         if (file_exists($user_certificate)) {
             $certificateContent = (string) file_get_contents($user_certificate);
+
+            if ($this->user_id == api_get_user_id() && !empty($this->certificate_data)) {
+                $certificateId = $this->certificate_data['id'];
+                $extraFieldValue = new ExtraFieldValue('user_certificate');
+                $value = $extraFieldValue->get_values_by_handler_and_field_variable(
+                    $certificateId,
+                    'downloaded_at'
+                );
+                if (empty($value)) {
+                    $params = [
+                        'item_id' => $this->certificate_data['id'],
+                        'extra_downloaded_at' => api_get_utc_datetime(),
+                    ];
+                    $extraFieldValue->saveFieldValues($params);
+                }
+            }
+
             echo $certificateContent;
             exit;
         }

main/inc/lib/extra_field.lib.php

@@ -132,6 +132,9 @@ public function __construct($type)
             case 'career':
                 $this->extraFieldType = EntityExtraField::CAREER_FIELD_TYPE;
                 break;
+            case 'user_certificate':
+                $this->extraFieldType = EntityExtraField::USER_CERTIFICATE;
+                break;
         }
 
         $this->pageUrl  = 'extra_fields.php?type='.$this->type;
@@ -162,7 +165,8 @@ public static function getValidExtraFieldTypes()
             'lp_item',
             'skill',
             'work',
-            'career'
+            'career',
+            'user_certificate'
         );
     }