@@ -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 |
@@ -6,6 +6,7 @@ discard block |
||
6 | 6 | * @param integer $entity_guid_static |
7 | 7 | * @param integer $entity_guid |
8 | 8 | * |
9 | + * @return integer |
|
9 | 10 | */ |
10 | 11 | function get_forum_in_group($entity_guid_static, $entity_guid) { |
11 | 12 | $entity = get_entity($entity_guid); |
@@ -159,7 +160,7 @@ discard block |
||
159 | 160 | * @param ElggEntity $entity |
160 | 161 | * @param ElggUser $send_to |
161 | 162 | * @param string $entity_url (default value empty) |
162 | - * @return Success true/false |
|
163 | + * @return boolean true/false |
|
163 | 164 | */ |
164 | 165 | function create_digest($invoked_by, $subtype, $entity, $send_to, $entity_url = '') { |
165 | 166 | |
@@ -945,6 +946,7 @@ discard block |
||
945 | 946 | |
946 | 947 | /** |
947 | 948 | * Helper functions for digest processing queue |
949 | + * @param integer $user_guid |
|
948 | 950 | */ |
949 | 951 | function enqueue( $user_guid ) { |
950 | 952 | // add to queue |
@@ -964,6 +966,9 @@ discard block |
||
964 | 966 | * to get closer to 'exactly once', the digest function can enqueue failed attempts |
965 | 967 | * NOTE: this won't work so well with a split read-write db setup, will likely need to be done without using elgg db functions |
966 | 968 | */ |
969 | +/** |
|
970 | + * @return integer |
|
971 | + */ |
|
967 | 972 | function dequeue() { |
968 | 973 | $query_init = "SET @uid := NULL"; // mostly for termination |
969 | 974 | $query_delete = "DELETE FROM notification_digest_queue WHERE user_guid = @uid := user_guid LIMIT 1"; // remove a row from queue and prepare the guid to be returned |
@@ -980,6 +985,9 @@ discard block |
||
980 | 985 | return enqueue(0) == 0; // there is no user with guid = 0, but only one instance will successfuly insert this with user_guid being the primary key |
981 | 986 | } |
982 | 987 | |
988 | +/** |
|
989 | + * @param string $frequency |
|
990 | + */ |
|
983 | 991 | function initialize_queue( $frequency ){ |
984 | 992 | $dbprefix = elgg_get_config('dbprefix'); |
985 | 993 |
@@ -138,6 +138,9 @@ |
||
138 | 138 | |
139 | 139 | }; |
140 | 140 | |
141 | + /** |
|
142 | + * @param string $emailaddress |
|
143 | + */ |
|
141 | 144 | function invitationExists($emailaddress){ |
142 | 145 | $query = "SELECT * FROM email_invitations WHERE `email` = '" . $emailaddress . "'"; |
143 | 146 | $result = get_data($query); |
@@ -182,6 +182,9 @@ |
||
182 | 182 | return str_replace('::version::', self::$version, self::$help); |
183 | 183 | } |
184 | 184 | |
185 | + /** |
|
186 | + * @param string $object_type |
|
187 | + */ |
|
185 | 188 | function __construct($object_type, $subtype = false, $guid = null, |
186 | 189 | $since = null, $before = null, $limit = null, $resume = null, |
187 | 190 | $sort = false, $omit = null, $count = false) { |
@@ -8,6 +8,10 @@ |
||
8 | 8 | } |
9 | 9 | |
10 | 10 | //Generic embed functions - Don't touch here! |
11 | + |
|
12 | + /** |
|
13 | + * @param string $guid |
|
14 | + */ |
|
11 | 15 | function custom_videoembed_create_embed_object($url, $guid, $videowidth=0, $input) { |
12 | 16 | |
13 | 17 | if (!$input) { |
@@ -155,7 +155,7 @@ discard block |
||
155 | 155 | * Returns an ordered list of plugins |
156 | 156 | * |
157 | 157 | * @param string $status The status of the plugins. active, inactive, or all. |
158 | - * @param mixed $site_guid Optional site guid |
|
158 | + * @param integer $site_guid Optional site guid |
|
159 | 159 | * @return \ElggPlugin[] |
160 | 160 | * @since 1.8.0 |
161 | 161 | */ |
@@ -226,7 +226,7 @@ discard block |
||
226 | 226 | * @param string $type The type of provides to return |
227 | 227 | * @param string $name A specific provided name to return. Requires $provide_type. |
228 | 228 | * |
229 | - * @return array |
|
229 | + * @return string|null |
|
230 | 230 | * @since 1.8.0 |
231 | 231 | * @access private |
232 | 232 | */ |
@@ -366,7 +366,7 @@ discard block |
||
366 | 366 | * |
367 | 367 | * @param string $name The name of the setting. |
368 | 368 | * @param string $plugin_id The plugin ID (Required) |
369 | - * @param mixed $default The default value to return if none is set |
|
369 | + * @param integer $default The default value to return if none is set |
|
370 | 370 | * |
371 | 371 | * @return mixed |
372 | 372 | * @since 1.8.0 |
@@ -458,7 +458,7 @@ discard block |
||
458 | 458 | * @param string $event deactivate |
459 | 459 | * @param string $type plugin |
460 | 460 | * @param array $params Parameters array containing entry with ELggPlugin instance under 'plugin_entity' key |
461 | - * @return bool false to block plugin deactivation action |
|
461 | + * @return false|null false to block plugin deactivation action |
|
462 | 462 | * |
463 | 463 | * @access private |
464 | 464 | */ |
@@ -136,6 +136,9 @@ |
||
136 | 136 | return $text; |
137 | 137 | } |
138 | 138 | |
139 | +/** |
|
140 | + * @param string $text |
|
141 | + */ |
|
139 | 142 | function clean_text($text) |
140 | 143 | { |
141 | 144 | return trim(preg_replace('/ +/', ' ', preg_replace('/[^A-Za-z0-9 ]/', ' ', urldecode(html_entity_decode(strip_tags($text)))))); |
@@ -269,7 +269,7 @@ discard block |
||
269 | 269 | * Return the value of an attribute or metadata |
270 | 270 | * |
271 | 271 | * @param string $name Name |
272 | - * @return mixed Returns the value of a given value, or null. |
|
272 | + * @return string Returns the value of a given value, or null. |
|
273 | 273 | * @deprecated 1.9 |
274 | 274 | */ |
275 | 275 | public function get($name) { |
@@ -462,7 +462,7 @@ discard block |
||
462 | 462 | * @warning Calling this with no $name will clear all metadata on the entity. |
463 | 463 | * |
464 | 464 | * @param null|string $name The name of the metadata to remove. |
465 | - * @return bool |
|
465 | + * @return boolean|null |
|
466 | 466 | * @since 1.8 |
467 | 467 | */ |
468 | 468 | public function deleteMetadata($name = null) { |
@@ -487,7 +487,7 @@ discard block |
||
487 | 487 | * If you pass a name, only metadata matching that name will be deleted. |
488 | 488 | * |
489 | 489 | * @param null|string $name The name of metadata to delete. |
490 | - * @return bool |
|
490 | + * @return boolean|null |
|
491 | 491 | * @since 1.8 |
492 | 492 | */ |
493 | 493 | public function deleteOwnedMetadata($name = null) { |
@@ -513,7 +513,7 @@ discard block |
||
513 | 513 | * @warning Calling this with no or empty arguments will clear all metadata on the entity. |
514 | 514 | * |
515 | 515 | * @param string $name The name of the metadata to clear |
516 | - * @return mixed bool |
|
516 | + * @return boolean|null bool |
|
517 | 517 | * @deprecated 1.8 Use deleteMetadata() |
518 | 518 | */ |
519 | 519 | public function clearMetadata($name = '') { |
@@ -525,7 +525,7 @@ discard block |
||
525 | 525 | * Disables metadata for this entity, optionally based on name. |
526 | 526 | * |
527 | 527 | * @param string $name An options name of metadata to disable. |
528 | - * @return bool |
|
528 | + * @return boolean|null |
|
529 | 529 | * @since 1.8 |
530 | 530 | */ |
531 | 531 | public function disableMetadata($name = '') { |
@@ -546,7 +546,7 @@ discard block |
||
546 | 546 | * @warning Before calling this, you must use {@link access_show_hidden_entities()} |
547 | 547 | * |
548 | 548 | * @param string $name An options name of metadata to enable. |
549 | - * @return bool |
|
549 | + * @return boolean|null |
|
550 | 550 | * @since 1.8 |
551 | 551 | */ |
552 | 552 | public function enableMetadata($name = '') { |
@@ -714,7 +714,7 @@ discard block |
||
714 | 714 | * @warning Calling this with no or empty arguments will clear all annotations on the entity. |
715 | 715 | * |
716 | 716 | * @param null|string $name The annotations name to remove. |
717 | - * @return bool |
|
717 | + * @return boolean|null |
|
718 | 718 | * @since 1.8 |
719 | 719 | */ |
720 | 720 | public function deleteAnnotations($name = null) { |
@@ -734,7 +734,7 @@ discard block |
||
734 | 734 | * If you pass a name, only annotations matching that name will be deleted. |
735 | 735 | * |
736 | 736 | * @param null|string $name The name of annotations to delete. |
737 | - * @return bool |
|
737 | + * @return boolean|null |
|
738 | 738 | * @since 1.8 |
739 | 739 | */ |
740 | 740 | public function deleteOwnedAnnotations($name = null) { |
@@ -758,7 +758,7 @@ discard block |
||
758 | 758 | * Disables annotations for this entity, optionally based on name. |
759 | 759 | * |
760 | 760 | * @param string $name An options name of annotations to disable. |
761 | - * @return bool |
|
761 | + * @return boolean|null |
|
762 | 762 | * @since 1.8 |
763 | 763 | */ |
764 | 764 | public function disableAnnotations($name = '') { |
@@ -779,7 +779,7 @@ discard block |
||
779 | 779 | * @warning Before calling this, you must use {@link access_show_hidden_entities()} |
780 | 780 | * |
781 | 781 | * @param string $name An options name of annotations to enable. |
782 | - * @return bool |
|
782 | + * @return boolean|null |
|
783 | 783 | * @since 1.8 |
784 | 784 | */ |
785 | 785 | public function enableAnnotations($name = '') { |
@@ -896,7 +896,7 @@ discard block |
||
896 | 896 | * all annotations on the entity. |
897 | 897 | * |
898 | 898 | * @param string $name Annotation name |
899 | - * @return bool |
|
899 | + * @return boolean|null |
|
900 | 900 | * @deprecated 1.8 Use ->deleteAnnotations() |
901 | 901 | */ |
902 | 902 | public function clearAnnotations($name = "") { |
@@ -1309,7 +1309,7 @@ discard block |
||
1309 | 1309 | * |
1310 | 1310 | * @param int $container_guid The ID of the container. |
1311 | 1311 | * |
1312 | - * @return bool |
|
1312 | + * @return integer |
|
1313 | 1313 | */ |
1314 | 1314 | public function setContainerGUID($container_guid) { |
1315 | 1315 | return $this->container_guid = (int)$container_guid; |
@@ -1320,7 +1320,7 @@ discard block |
||
1320 | 1320 | * |
1321 | 1321 | * @param int $container_guid The ID of the container. |
1322 | 1322 | * |
1323 | - * @return bool |
|
1323 | + * @return integer |
|
1324 | 1324 | * @deprecated 1.8 use setContainerGUID() |
1325 | 1325 | */ |
1326 | 1326 | public function setContainer($container_guid) { |
@@ -1438,7 +1438,7 @@ discard block |
||
1438 | 1438 | * Plugins can register for the 'entity:icon:url', <type> plugin hook |
1439 | 1439 | * to customize the icon for an entity. |
1440 | 1440 | * |
1441 | - * @param mixed $params A string defining the size of the icon (e.g. tiny, small, medium, large) |
|
1441 | + * @param string $params A string defining the size of the icon (e.g. tiny, small, medium, large) |
|
1442 | 1442 | * or an array of parameters including 'size' |
1443 | 1443 | * @return string The URL |
1444 | 1444 | * @since 1.8.0 |
@@ -1822,7 +1822,7 @@ discard block |
||
1822 | 1822 | /** |
1823 | 1823 | * Loads attributes from the entities table into the object. |
1824 | 1824 | * |
1825 | - * @param mixed $guid GUID of entity or \stdClass object from entities table |
|
1825 | + * @param stdClass $guid GUID of entity or \stdClass object from entities table |
|
1826 | 1826 | * |
1827 | 1827 | * @return bool |
1828 | 1828 | */ |
@@ -2295,7 +2295,7 @@ discard block |
||
2295 | 2295 | * @param int $year If ommitted, now is assumed. |
2296 | 2296 | * @param int $duration Duration of event, remainder of the day is assumed. |
2297 | 2297 | * |
2298 | - * @return true |
|
2298 | + * @return boolean |
|
2299 | 2299 | * @deprecated 1.9 |
2300 | 2300 | */ |
2301 | 2301 | public function setCalendarTimeAndDuration($hour = null, $minute = null, $second = null, |
@@ -2343,7 +2343,7 @@ discard block |
||
2343 | 2343 | /** |
2344 | 2344 | * Returns an array of fields which can be exported. |
2345 | 2345 | * |
2346 | - * @return array |
|
2346 | + * @return string[] |
|
2347 | 2347 | * @deprecated 1.9 Use toObject() |
2348 | 2348 | */ |
2349 | 2349 | public function getExportableValues() { |
@@ -2455,7 +2455,7 @@ discard block |
||
2455 | 2455 | * |
2456 | 2456 | * @param ODD $data XML data |
2457 | 2457 | * |
2458 | - * @return true |
|
2458 | + * @return boolean |
|
2459 | 2459 | * |
2460 | 2460 | * @throws InvalidParameterException |
2461 | 2461 | * @deprecated 1.9 Use toObject() |
@@ -2499,7 +2499,7 @@ discard block |
||
2499 | 2499 | * This is used by the system log. It can be called on any Loggable object. |
2500 | 2500 | * |
2501 | 2501 | * @param int $id GUID. |
2502 | - * @return int GUID |
|
2502 | + * @return ElggEntity GUID |
|
2503 | 2503 | */ |
2504 | 2504 | public function getObjectFromID($id) { |
2505 | 2505 | return get_entity($id); |