X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=CRM%2FActivity%2FBAO%2FActivityContact.php;h=752f442c7aae3412f2f710b0f136ca29c2e0eeef;hb=7a86e9ede3a83491f1e831da64537304e37ee837;hp=b3ae3e2951ab4113bbf887aecf6f18990a9903d5;hpb=2c53a8f729f160b603efc6e8f5eb03c118df6ed3;p=civicrm-core.git

diff --git a/CRM/Activity/BAO/ActivityContact.php b/CRM/Activity/BAO/ActivityContact.php
index b3ae3e2951..752f442c7a 100644
--- a/CRM/Activity/BAO/ActivityContact.php
+++ b/CRM/Activity/BAO/ActivityContact.php
@@ -40,14 +40,14 @@
 class CRM_Activity_BAO_ActivityContact extends CRM_Activity_DAO_ActivityContact {
 
   /**
-   * class constructor
+   * Class constructor
    */
   function __construct() {
     parent::__construct();
   }
 
   /**
-   * funtion to add activity contact
+   * Funtion to add activity contact
    *
    * @param array  $params      the values for this table: activity id, contact id, record type
    *
@@ -66,15 +66,15 @@ class CRM_Activity_BAO_ActivityContact extends CRM_Activity_DAO_ActivityContact
   }
 
   /**
-   * function to retrieve names of contact by activity_id
+   * Retrieve names of contact by activity_id
    *
-   * @param int    $id   ID of the activity
-   * @param string $type type of interaction
+   * @param int $activityID
+   * @param int $recordTypeID
+   * @param bool $alsoIDs
    *
    * @return array
    *
    * @access public
-   *
    */
   static function getNames($activityID, $recordTypeID, $alsoIDs = FALSE) {
     $names = array();
@@ -107,14 +107,14 @@ AND        contact_a.is_deleted = 0
   }
 
   /**
-   * function to retrieve id of target contact by activity_id
+   * Retrieve id of target contact by activity_id
    *
-   * @param int    $id  ID of the activity
+   * @param int $activityID
+   * @param int $recordTypeID
    *
    * @return mixed
    *
    * @access public
-   *
    */
   static function retrieveContactIdsByActivityId($activityID, $recordTypeID) {
     $activityContact = array();
@@ -142,6 +142,25 @@ AND        civicrm_contact.is_deleted = 0
     return $activityContact;
   }
 
+  /**
+   * Get the links associate array  as defined by the links.ini file.
+   *
+   *
+   * Experimental... -
+   * Should look a bit like
+   *       [local_col_name] => "related_tablename:related_col_name"
+   *
+   *
+   * @return   array|null
+   *           array       = if there are links defined for this table.
+   *           empty array - if there is a links.ini file, but no links on this table
+   *           null        - if no links.ini exists for this database (hence try auto_links).
+   * @access   public
+   * @see      DB_DataObject::getLinks(), DB_DataObject::getLink()
+   */
+  /**
+   * @return array|null
+   */
   function links() {
     $link = array('activity_id' => 'civicrm_activity:id');
     return $link;