From c0381e22da2cf2ecf8b17ffc55462a68cf84c6aa Mon Sep 17 00:00:00 2001
From: sam_marshall <sam_marshall>
Date: Thu, 9 Mar 2006 13:14:33 +0000
Subject: [PATCH] Added way to get a textual description of a file (e.g. 'Word
 document') based on its MIME type.

---
 lang/en_utf8/mimetypes.php | 26 ++++++++++++++++++++++++++
 lib/filelib.php            | 20 ++++++++++++++++++++
 2 files changed, 46 insertions(+)
 create mode 100644 lang/en_utf8/mimetypes.php

diff --git a/lang/en_utf8/mimetypes.php b/lang/en_utf8/mimetypes.php
new file mode 100644
index 0000000000..0982b02e24
--- /dev/null
+++ b/lang/en_utf8/mimetypes.php
@@ -0,0 +1,26 @@
+<?PHP 
+
+// These should be accessed using get_mimetype_description in filelib.php.
+// They correspond to a (currently small) subset of the MIME types that Moodle
+// supports, which are also listed in filelib.php. Descriptions for other types
+// should be added here.
+
+// Style: initial lower-case letter, except as required for product names etc.
+  
+$string['text/plain'] = 'text file';
+$string['application/pdf'] = 'PDF document';
+$string['application/msword'] = 'Word document';
+$string['text/rtf'] = 'RTF document';
+$string['application/vnd.ms-excel'] = 'Excel spreadsheet';
+$string['audio/wav'] = 'sound file';
+$string['audio/mp3'] = 'MP3 audio file';
+$string['application/vnd.ms-powerpoint'] = 'Powerpoint presentation';
+$string['application/zip'] = 'zip archive';
+$string['image/jpeg'] = 'JPEG image';
+$string['image/gif'] = 'GIF image';
+$string['image/bmp'] = 'uncompressed BMP image';
+
+// Moodle default MIME type used for all types not described 
+$string['document/unknown'] = 'file'; 
+
+?>
diff --git a/lib/filelib.php b/lib/filelib.php
index bb52b411f7..7224a36e5c 100644
--- a/lib/filelib.php
+++ b/lib/filelib.php
@@ -182,6 +182,26 @@ function mimeinfo_from_type($element, $mimetype) {
     return $mimeinfo['xxx'][$element]; // Default
 }
 
+/**
+ * Obtains descriptions for file types (e.g. 'Microsoft Word document') from the 
+ * mimetypes.php language file. 
+ * @param string $mimetype MIME type (can be obtained using the mimeinfo function)
+ * @param bool $capitalise If true, capitalises first character of result
+ * @return string Text description 
+ */
+function get_mimetype_description($mimetype,$capitalise=false) {
+    $result=get_string($mimetype,'mimetypes');
+    // Surrounded by square brackets indicates that there isn't a string for that
+    // (maybe there is a better way to find this out?)
+    if(strpos($result,'[')===0) {
+        $result=get_string('document/unknown','mimetypes');
+    } 
+    if($capitalise) {
+        $result=ucfirst($result);
+    }
+    return $result;
+}
+
 /** 
  * @PARAM $filter int 0=no filtering, 1=all files, 2=html files only
  */
-- 
2.39.5