@@ -82,7 +82,7 @@ |
||
| 82 | 82 | * |
| 83 | 83 | * @param int $guid The GUID |
| 84 | 84 | * |
| 85 | - * @return \ElggUser|false |
|
| 85 | + * @return ElggEntity |
|
| 86 | 86 | */ |
| 87 | 87 | function get_user($guid) { |
| 88 | 88 | return _elgg_services()->entityTable->get($guid, 'user'); |
@@ -69,6 +69,10 @@ |
||
| 69 | 69 | return delete_data("DELETE FROM pleio_request_access WHERE id = {$this->id}"); |
| 70 | 70 | } |
| 71 | 71 | |
| 72 | + /** |
|
| 73 | + * @param string $subject |
|
| 74 | + * @param string $body |
|
| 75 | + */ |
|
| 72 | 76 | private function sendEmail($subject, $body, $params = null) { |
| 73 | 77 | $site = elgg_get_site_entity(); |
| 74 | 78 | |
@@ -2,6 +2,10 @@ |
||
| 2 | 2 | namespace ModPleio; |
| 3 | 3 | |
| 4 | 4 | class Helpers { |
| 5 | + |
|
| 6 | + /** |
|
| 7 | + * @return string |
|
| 8 | + */ |
|
| 5 | 9 | public static function generateUsername($username) { |
| 6 | 10 | $hidden = access_show_hidden_entities(true); |
| 7 | 11 | |
@@ -109,6 +109,9 @@ |
||
| 109 | 109 | false |
| 110 | 110 | ); |
| 111 | 111 | |
| 112 | +/** |
|
| 113 | + * @param ElggUser $user_entity |
|
| 114 | + */ |
|
| 112 | 115 | function wires_foreach($wire_posts, $user_entity) |
| 113 | 116 | { |
| 114 | 117 | foreach ($wire_posts as $wire_post) { |
@@ -48,7 +48,7 @@ |
||
| 48 | 48 | * @param mixed $var Anything that does not include an object (strings, ints, arrays) |
| 49 | 49 | * This includes multi-dimensional arrays. |
| 50 | 50 | * |
| 51 | - * @return mixed The filtered result - everything will be strings |
|
| 51 | + * @return string The filtered result - everything will be strings |
|
| 52 | 52 | */ |
| 53 | 53 | function filter_tags($var) { |
| 54 | 54 | return elgg_trigger_plugin_hook('validate', 'input', null, $var); |
@@ -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. |