gctools-outilsgc / gcconnex

mod/missions/lib/missions.php

Doc Comments +30 added lines

@@ -10,6 +10,9 @@ 
 /*
  * Packs the language variables for a single language into a single string.
  */
+/**
+ * @param string|null $lang
+ */
 function mm_pack_language($lwc, $lwe, $lop, $lang)
 {
     $returner = '';
@@ -41,6 +44,9 @@ 
 /*
  * Unpacks a language string into an array of its component variable.
  */
+/**
+ * @param string|null $lang
+ */
 function mm_unpack_language($data_string, $lang)
 {
     $returner = array();
@@ -71,6 +77,11 @@ 
 /*
  * Packs the time (hour and minute) into a single string.
  */
+/**
+ * @param string|null $hour
+ * @param string|null $min
+ * @param string|null $day
+ */
 function mm_pack_time($hour, $min, $day)
 {
     $returner = '';
@@ -95,6 +106,9 @@ 
 /*
  * Unpacks the time into an array of hour and minute.
  */
+/**
+ * @param string|null $day
+ */
 function mm_unpack_time($data_string, $day)
 {
     $returner = array();
@@ -118,6 +132,9 @@ 
 /*
  * Unpacks every unpackable item within a given entity.
  */
+/**
+ * @param ElggEntity $entity
+ */
 function mm_unpack_mission($entity)
 {
     $returner = array();
@@ -429,6 +446,10 @@ 
  * Notify user function which uses messages_send() to send on site notifications and mail() to send e-mail.
  * This is here because notify_user() is currently not working.
  */
+/**
+ * @param string $title_en
+ * @param string $title_fr
+ */
 function mm_notify_user($recipient, $sender, $subject, $title_en,$title_fr,$body_en, $body_fr) {
 	//notify_user($recipient, $sender, $subject, $body, array(), 'email');
 
@@ -622,6 +643,9 @@ 
 /*
  * Returns an accept button to a user who has received an offer if the mission is not full.
  */
+/**
+ * @param ElggUser|null $applicant
+ */
 function mm_finalize_button($mission, $applicant) {
 	$relationship_count = elgg_get_entities_from_relationship(array(
 			'relationship' => 'mission_accepted',
@@ -787,6 +811,9 @@ 
 /*
  * Check if the user is opted in to any of the opt-in options.
  */
+/**
+ * @param ElggEntity|null $current_user
+ */
 function check_if_opted_in($current_user) {
     //Nick - adding additional checks for other opportunity types
 	if($current_user->opt_in_missions == 'gcconnex_profile:opt:yes') {
@@ -864,6 +891,9 @@ 
 	return false;
 }
 
+/**
+ * @param ElggEntity $mission
+ */
 function mm_complete_mission_inprogress_reports($mission, $if_no_applicants = false) {
 		if ($if_no_applicants) {
 				// Find out how many accepted applicants are on this mission.