Index: DEVELOPER.txt
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/activity/Attic/DEVELOPER.txt,v
retrieving revision 1.1.2.1
diff -u -p -r1.1.2.1 DEVELOPER.txt
--- DEVELOPER.txt	5 Mar 2009 05:23:21 -0000	1.1.2.1
+++ DEVELOPER.txt	20 Apr 2009 18:11:26 -0000
@@ -6,7 +6,7 @@ Development specifications and integrati
  *for more details please see the handbook at http://drupal.org/node/328429
 
 _Hooks:
-
+------------------------------------------
 hook_activity_info()
   Register a module to work with Activity's hook_action_info() implementation.
 
@@ -26,7 +26,7 @@ hook_activity_info()
 
   Example:
     @see any file with the activity/modules directory.
-
+------------------------------------------
 hook_activity_grants($activity)
   Provides a means to record what should have access to any particular message.
 
@@ -49,9 +49,9 @@ hook_activity_grants($activity)
         $activity->uid, // the module_id that will be used
       );
     }
-
+------------------------------------------
 hook_activity_access_grants($account)
-  Proivde a means for other modules to determine who can have access to any
+  Provide a means for other modules to determine who can have access to any
   given activity message.
 
   Parameters:
@@ -74,3 +74,65 @@ hook_activity_access_grants($account)
       }
       return $realm_ids;
     }
+------------------------------------------
+hook_activity_records_alter(&$record, $context)
+  Provide a means to alter an activity record before it is inserted into the db.
+
+  Parameters:
+    $record - the record for insertion, containing uid, op, type, author_message,
+      everyone_message, nid, and created.
+    $context - the context from the trigger, containing hook, op, object,
+      author-pattern, and everyone-pattern
+
+  Return value:
+    $record is passed by reference in order to make changes to it before insert
+
+  Example:
+    /**
+     * Implementation of hook_activity_records_alter().
+     */
+    function example_activity_records_alter(&$record, $context) {
+      // If we have a story node rather than another type, we can change the
+      // token pattern.
+      if ($object->type == 'story') {
+        $author_pattern = $context['author-pattern'] .' - [node-type]';
+        $record->author_message = token_replace($author_pattern, $record->type, $context[$record->type]);
+      }
+    }
+------------------------------------------
+hook_activity_message_recorded($record, $context)
+  Provides a means to do something with a record after it has been saved.
+
+  Parameters:
+    These are the same as hook_activity_records_alter() except that since the
+    $record has been saved, it now has a $record->amid.
+
+  Example:
+    /**
+     * Implementation of hook_activity_message_recorded().
+     */
+    function activity_user_status_activity_message_recorded($record) {
+      // After a message has been recorded with activity, we then save it's id so
+      // that we can reference it as a foreign key.
+      if ($record->type == 'activity_user_status') {
+        db_query("UPDATE {activity_user_status} SET amid = %d WHERE uid = %d", $record->amid, $record->uid);
+      }
+    }
+------------------------------------------
+hook_activity_access_records_alter(&$grants, $context)
+  Provides a mean to alter the grants that are recorded to the activity_access
+  table.
+
+  Parameters:
+    $grants - These are the grants that come back from other modules whom have
+      implemented hook_activity_grants().
+    $context - the context from the trigger, containing hook, op, object,
+      author-pattern, and everyone-pattern
+
+  Example:
+    /**
+     * Implementation of hook_activity_access_records_alter().
+     */
+    function example_activity_access_records_alter(&$grants, $context) {
+      
+    }
\ No newline at end of file