@@ -258,7 +258,7 @@ discard block |
||
258 | 258 | * @param int $access_id Public/private etc |
259 | 259 | * @param int $parent_guid Parent post guid (if any) |
260 | 260 | * @param string $method The method (default: 'site') |
261 | - * @return guid or false if failure |
|
261 | + * @return integer or false if failure |
|
262 | 262 | */ |
263 | 263 | function thewire_save_post($text, $userid, $access_id, $parent_guid = 0, $method = "site") { |
264 | 264 | $post = new ElggObject(); |
@@ -473,7 +473,7 @@ discard block |
||
473 | 473 | /** |
474 | 474 | * Runs unit tests for the wire |
475 | 475 | * |
476 | - * @return array |
|
476 | + * @return string[] |
|
477 | 477 | */ |
478 | 478 | function thewire_test($hook, $type, $value, $params) { |
479 | 479 | global $CONFIG; |
@@ -29,7 +29,7 @@ discard block |
||
29 | 29 | * @param string $subject The subject of the message. |
30 | 30 | * @param string $message The message body |
31 | 31 | * @param array $params Optional parameters (not used) |
32 | - * @return bool |
|
32 | + * @return null|boolean |
|
33 | 33 | */ |
34 | 34 | function phpmailer_notify_handler(ElggEntity $from, ElggUser $to, $subject, $message, array $params = NULL) { |
35 | 35 | |
@@ -72,6 +72,7 @@ discard block |
||
72 | 72 | * This is a stupid function pulled from original Elgg code |
73 | 73 | * |
74 | 74 | * @param ElggEntity The entity sending the message |
75 | + * @param ElggEntity $from |
|
75 | 76 | * @return string with email address |
76 | 77 | */ |
77 | 78 | function phpmailer_extract_from_email($from) { |
@@ -98,8 +99,6 @@ discard block |
||
98 | 99 | /** |
99 | 100 | * Send an email using phpmailer |
100 | 101 | * |
101 | - * @param string $from From address |
|
102 | - * @param string $from_name From name |
|
103 | 102 | * @param string $to To address |
104 | 103 | * @param string $to_name To name |
105 | 104 | * @param string $subject The subject of the message. |
@@ -110,7 +109,7 @@ discard block |
||
110 | 109 | * @param array $files Array of file descriptor arrays, each file array |
111 | 110 | * consists of full path and name |
112 | 111 | * @param array $params Additional parameters |
113 | - * @return bool |
|
112 | + * @return null|boolean |
|
114 | 113 | */ |
115 | 114 | function phpmailer_send($to, $to_name, $subject, $body, array $bcc = NULL, $html = true, array $files = NULL, array $params = NULL, $image = NULL) { |
116 | 115 | |
@@ -255,6 +254,9 @@ discard block |
||
255 | 254 | |
256 | 255 | |
257 | 256 | |
257 | +/** |
|
258 | + * @param string $type |
|
259 | + */ |
|
258 | 260 | function phpmailer_logging($errMess, $errStack, $type, $errType) { |
259 | 261 | // logging mechanism |
260 | 262 | if (elgg_is_active_plugin('wet4')) { |
@@ -85,6 +85,9 @@ |
||
85 | 85 | false |
86 | 86 | ); |
87 | 87 | |
88 | +/** |
|
89 | + * @param ElggUser $user_entity |
|
90 | + */ |
|
88 | 91 | function foreach_blogs($blogs, $user_entity, $lang) |
89 | 92 | { |
90 | 93 | foreach ($blogs as $blog_post) { |
@@ -10,6 +10,9 @@ discard block |
||
10 | 10 | /* |
11 | 11 | * Packs the language variables for a single language into a single string. |
12 | 12 | */ |
13 | +/** |
|
14 | + * @param string|null $lang |
|
15 | + */ |
|
13 | 16 | function mm_pack_language($lwc, $lwe, $lop, $lang) |
14 | 17 | { |
15 | 18 | $returner = ''; |
@@ -41,6 +44,9 @@ discard block |
||
41 | 44 | /* |
42 | 45 | * Unpacks a language string into an array of its component variable. |
43 | 46 | */ |
47 | +/** |
|
48 | + * @param string|null $lang |
|
49 | + */ |
|
44 | 50 | function mm_unpack_language($data_string, $lang) |
45 | 51 | { |
46 | 52 | $returner = array(); |
@@ -71,6 +77,11 @@ discard block |
||
71 | 77 | /* |
72 | 78 | * Packs the time (hour and minute) into a single string. |
73 | 79 | */ |
80 | +/** |
|
81 | + * @param string|null $hour |
|
82 | + * @param string|null $min |
|
83 | + * @param string|null $day |
|
84 | + */ |
|
74 | 85 | function mm_pack_time($hour, $min, $day) |
75 | 86 | { |
76 | 87 | $returner = ''; |
@@ -95,6 +106,9 @@ discard block |
||
95 | 106 | /* |
96 | 107 | * Unpacks the time into an array of hour and minute. |
97 | 108 | */ |
109 | +/** |
|
110 | + * @param string|null $day |
|
111 | + */ |
|
98 | 112 | function mm_unpack_time($data_string, $day) |
99 | 113 | { |
100 | 114 | $returner = array(); |
@@ -118,6 +132,9 @@ discard block |
||
118 | 132 | /* |
119 | 133 | * Unpacks every unpackable item within a given entity. |
120 | 134 | */ |
135 | +/** |
|
136 | + * @param ElggEntity $entity |
|
137 | + */ |
|
121 | 138 | function mm_unpack_mission($entity) |
122 | 139 | { |
123 | 140 | $returner = array(); |
@@ -429,6 +446,10 @@ discard block |
||
429 | 446 | * Notify user function which uses messages_send() to send on site notifications and mail() to send e-mail. |
430 | 447 | * This is here because notify_user() is currently not working. |
431 | 448 | */ |
449 | +/** |
|
450 | + * @param string $title_en |
|
451 | + * @param string $title_fr |
|
452 | + */ |
|
432 | 453 | function mm_notify_user($recipient, $sender, $subject, $title_en,$title_fr,$body_en, $body_fr) { |
433 | 454 | //notify_user($recipient, $sender, $subject, $body, array(), 'email'); |
434 | 455 | |
@@ -622,6 +643,9 @@ discard block |
||
622 | 643 | /* |
623 | 644 | * Returns an accept button to a user who has received an offer if the mission is not full. |
624 | 645 | */ |
646 | +/** |
|
647 | + * @param ElggUser|null $applicant |
|
648 | + */ |
|
625 | 649 | function mm_finalize_button($mission, $applicant) { |
626 | 650 | $relationship_count = elgg_get_entities_from_relationship(array( |
627 | 651 | 'relationship' => 'mission_accepted', |
@@ -787,6 +811,9 @@ discard block |
||
787 | 811 | /* |
788 | 812 | * Check if the user is opted in to any of the opt-in options. |
789 | 813 | */ |
814 | +/** |
|
815 | + * @param ElggEntity|null $current_user |
|
816 | + */ |
|
790 | 817 | function check_if_opted_in($current_user) { |
791 | 818 | //Nick - adding additional checks for other opportunity types |
792 | 819 | if($current_user->opt_in_missions == 'gcconnex_profile:opt:yes') { |
@@ -864,6 +891,9 @@ discard block |
||
864 | 891 | return false; |
865 | 892 | } |
866 | 893 | |
894 | +/** |
|
895 | + * @param ElggEntity $mission |
|
896 | + */ |
|
867 | 897 | function mm_complete_mission_inprogress_reports($mission, $if_no_applicants = false) { |
868 | 898 | if ($if_no_applicants) { |
869 | 899 | // Find out how many accepted applicants are on this mission. |
@@ -46,6 +46,9 @@ discard block |
||
46 | 46 | * Function to format the dropdown menu input. |
47 | 47 | * If the input is not an entity then it returns false. |
48 | 48 | */ |
49 | +/** |
|
50 | + * @param integer $input |
|
51 | + */ |
|
49 | 52 | function mo_format_input_node($input) { |
50 | 53 | if(elgg_entity_exists($input)) { |
51 | 54 | return 'MOrg:' . $input; |
@@ -118,6 +121,9 @@ discard block |
||
118 | 121 | /* |
119 | 122 | * Function which gets all the ancestors and then creates a string out of their names. |
120 | 123 | */ |
124 | +/** |
|
125 | + * @param string|false $node_string |
|
126 | + */ |
|
121 | 127 | function mo_string_all_ancestors($node_string) { |
122 | 128 | $ancestor_guids = mo_get_all_ancestors($node_string); |
123 | 129 | $ancestor_names_english = array(); |
@@ -145,6 +151,9 @@ discard block |
||
145 | 151 | /* |
146 | 152 | * Extracts node guid from the stored data. |
147 | 153 | */ |
154 | +/** |
|
155 | + * @return integer |
|
156 | + */ |
|
148 | 157 | function mo_extract_node_guid($node_string) { |
149 | 158 | $node_array = explode(':', $node_string); |
150 | 159 | return $node_array[1]; |
@@ -14,7 +14,7 @@ |
||
14 | 14 | * @param $type |
15 | 15 | * @param $returnvalue |
16 | 16 | * @param $params |
17 | - * @return False to stop processing the response, True will let elgg handle the response |
|
17 | + * @return null|boolean to stop processing the response, True will let elgg handle the response |
|
18 | 18 | */ |
19 | 19 | function global_url_handler($hook, $type, $returnvalue, $params) { |
20 | 20 |
@@ -126,6 +126,9 @@ |
||
126 | 126 | return $bookmarks; |
127 | 127 | }//end get_bookmark |
128 | 128 | |
129 | +/** |
|
130 | + * @param ElggUser $user_entity |
|
131 | + */ |
|
129 | 132 | function foreach_bookmark($bookmarks, $user_entity, $lang) |
130 | 133 | { |
131 | 134 | foreach ($bookmarks as $bookmark){ |
@@ -202,6 +202,9 @@ |
||
202 | 202 | return $event; |
203 | 203 | } |
204 | 204 | |
205 | +/** |
|
206 | + * @param ElggUser $user_entity |
|
207 | + */ |
|
205 | 208 | function foreach_events($params, $from, $to, $user_entity, $lang) |
206 | 209 | { |
207 | 210 | $now = time(); |
@@ -132,7 +132,7 @@ discard block |
||
132 | 132 | * @param mixed $value The current value of the plugin hook |
133 | 133 | * @param mixed $params Data passed from the trigger |
134 | 134 | * |
135 | - * @return mixed if not null, this will be the new value of the plugin hook |
|
135 | + * @return boolean if not null, this will be the new value of the plugin hook |
|
136 | 136 | */ |
137 | 137 | function minor_save_hook_handler($hook, $type, $value, $params) { |
138 | 138 | |
@@ -620,7 +620,6 @@ discard block |
||
620 | 620 | /** |
621 | 621 | * returns the headers for ical |
622 | 622 | * |
623 | - * @param string $type_event |
|
624 | 623 | * @param ElggObject $event |
625 | 624 | * @param string $start_date |
626 | 625 | * @param string $end_date |
@@ -1486,6 +1485,9 @@ discard block |
||
1486 | 1485 | } |
1487 | 1486 | |
1488 | 1487 | |
1488 | +/** |
|
1489 | + * @param string $error_message |
|
1490 | + */ |
|
1489 | 1491 | function notification_logging($error_message) { |
1490 | 1492 | // logging mechanism |
1491 | 1493 | if (elgg_is_active_plugin('wet4')) { |
@@ -1536,8 +1538,6 @@ discard block |
||
1536 | 1538 | * run crontab, retrieve users, send digest, reset timer (update timestamp) |
1537 | 1539 | * |
1538 | 1540 | * @param string $hook The name of the plugin hook |
1539 | - * @param string $type The type of the plugin hook |
|
1540 | - * @param mixed $value The current value of the plugin hook |
|
1541 | 1541 | * @param mixed $params Data passed from the trigger |
1542 | 1542 | */ |
1543 | 1543 | function cp_digest_weekly_cron_handler($hook, $entity_type, $return_value, $params) { |
@@ -1580,6 +1580,7 @@ discard block |
||
1580 | 1580 | * @param string $entity_type The type of the plugin hook |
1581 | 1581 | * @param mixed $return_value The current value of the plugin hook |
1582 | 1582 | * @param mixed $params Data passed from the trigger |
1583 | + * @param string $cron_freq |
|
1583 | 1584 | */ |
1584 | 1585 | function cp_digest_email_handler($hook, $entity_type, $return_value, $params, $cron_freq) { |
1585 | 1586 | $dbprefix = elgg_get_config('dbprefix'); |
@@ -1771,7 +1772,6 @@ discard block |
||
1771 | 1772 | * |
1772 | 1773 | * @param string $hook The name of the plugin hook |
1773 | 1774 | * @param string $type The type of the plugin hook |
1774 | - * @param mixed $value The current value of the plugin hook |
|
1775 | 1775 | * @param mixed $params Data passed from the trigger |
1776 | 1776 | */ |
1777 | 1777 | function cpn_email_handler_hook($hook, $type, $notification, $params) { |
@@ -1785,7 +1785,6 @@ discard block |
||
1785 | 1785 | * |
1786 | 1786 | * @param string $hook The name of the plugin hook |
1787 | 1787 | * @param string $type The type of the plugin hook |
1788 | - * @param mixed $value The current value of the plugin hook |
|
1789 | 1788 | * @param mixed $params Data passed from the trigger |
1790 | 1789 | * |
1791 | 1790 | * @return mixed if not null, this will be the new value of the plugin hook |