From 705dd3b7dd286e54022675399dcf522599c35ca3 Mon Sep 17 00:00:00 2001
From: Alexander O'Neill <al.oneill@unb.ca>
Date: Fri, 25 Feb 2011 15:58:15 -0400
Subject: [PATCH] ISLANDORA-214 initial definition of
 fedora_repository_check_for_required_fedora_objects() function.

---
 fedora_repository.install | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/fedora_repository.install b/fedora_repository.install
index de8f31e8..a90e33fc 100644
--- a/fedora_repository.install
+++ b/fedora_repository.install
@@ -93,4 +93,27 @@ function fedora_repository_requirements($phase) {
   }
  
   return $requirements;
+}
+
+/**
+ * Invokes a hook to any dependent modules asking them if their installations require
+ * any fedora objects to be present. Modules implementing this hook should return an array
+ * of arrays of the form:
+ * 
+ * array( 'pid', 'path-to-foxml-file', 'dsid', 'path-to-datastream-file', int dsversion)
+ * 
+ * where the last three options are optional. A module can either point to a simple
+ * foxml file to install, or can specify a datastreamstream to check for, with a 
+ * path to load the datastream from if it isn't there. Optionally a version number
+ * can be included, to enable updating of content model or collection policy streams
+ * that may have been updated. THis is a simple whole number that should be incremented
+ * when changed.  This value appears in as an attribute of the topmost element of the stream, 
+ * e.g.,:
+ * 
+ * <?xml version="1.0" encoding="utf-8"?> <content_model name="Collection" version="2" ...
+ * 
+ * Datastreams which don't have this element are assumed to be at version 0.
+ */
+function fedora_repository_check_for_required_fedora_objects() {
+  $required_objects = module_invoke_all('required_fedora_objects');
 }
\ No newline at end of file