@@ -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); |