aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoricewing <icewing@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-04-23 17:23:03 +0000
committericewing <icewing@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-04-23 17:23:03 +0000
commit33962198a853f02497f72266ebf3fa692abd6976 (patch)
treeefa45a7a5582395e6934169a7b3a66c67c30e24a
parent00ba1e82ea439557764d17fab1ec11f4b2e58d07 (diff)
downloadelgg-33962198a853f02497f72266ebf3fa692abd6976.tar.gz
elgg-33962198a853f02497f72266ebf3fa692abd6976.tar.bz2
Marcus Povey <marcus@dushka.co.uk>
* Improved documentation git-svn-id: https://code.elgg.org/elgg/trunk@513 36083f99-b078-4883-b0ff-0f9b5a30f544
-rw-r--r--engine/lib/filestore.php12
1 files changed, 12 insertions, 0 deletions
diff --git a/engine/lib/filestore.php b/engine/lib/filestore.php
index 98cba7ade..afc924099 100644
--- a/engine/lib/filestore.php
+++ b/engine/lib/filestore.php
@@ -234,6 +234,18 @@
/**
* @class ElggFile
* This class represents a physical file.
+ *
+ * Usage:
+ * Create a new ElggFile object and specify a filename, and optionally a FileStore (if one isn't specified
+ * then the default is assumed.
+ *
+ * Open the file using the appropriate mode, and you will be able to read and write to the file.
+ *
+ * Optionally, you can also call the file's save() method, this will turn the file into an entity in the
+ * system and permit you to do things like attach tags to the file etc. This is not done automatically since
+ * there are many occasions where you may want access to file data on datastores using the ElggFile interface
+ * but do not want to create an Entity reference to it in the system (temporary files for example).
+ *
* @author Marcus Povey
*/
class ElggFile extends ElggObject