Maintenance: CommonCartridge: Add configuration setting 'commoncartridge_path_token' to allow for the previously recommended special path token when exporting to Common Cartridge packages - refs BT#21709

Author: ywarnier

main/common_cartridge/export/src/utils/CcHelpers.php

@@ -288,6 +288,10 @@ public static function processLinkedFiles(
         $courseDir = $internalCourseDocumentsPath = null;
         $courseInfo = api_get_course_info();
         $replaceprefix = '$1EdTech-CC-FILEBASE$';
+        $tokenSyntax = api_get_configuration_value('commoncartridge_path_token');
+        if (!empty($tokenSyntax)) {
+            $replaceprefix = $tokenSyntax;
+        }
         if (!empty($courseInfo)) {
             $courseDir = $courseInfo['directory'];
             $internalCourseDocumentsPath = '/courses/'.$courseDir.'/document';

main/install/configuration.dist.php

@@ -2561,3 +2561,9 @@
 
 // Define the default time in seconds to be registered if the user does logout from a course and there is no recent entry in track_e_course_access.
 //$_configuration['tracking_default_course_extra_time_on_logout'] = 600;
+
+// Define a special path token for the Common Cartridge export content.
+// Due to changes in naming by the responsible organization, the Chamilo default
+// is '$1EdTech-CC-FILEBASE$' (the latest), but previous versions of the standard
+// recommended '$IMS-CC-FILEBASE$', so you might want to use that for greater compatibility.
+//$_configuration['commoncartridge_path_token'] = '$IMS-CC-FILEBASE$';