bitPickups/friendica_2020-09-1_sharedHosting
1
0
Fork 0
Code Pull requests Activity

@brief is removed completely

Browse source
This commit is contained in:
Michael 2020-01-19 06:05:23 +00:00
commit 0a4119adaf
170 changed files with 901 additions and 962 deletions
Download patch file Download diff file Expand all files Collapse all files

2
bin/worker.php
View file

@ -2,7 +2,7 @@
<?php <?php
/** /**
* @file bin/worker.php * @file bin/worker.php
* @brief Starts the background processing * Starts the background processing
*/ */
use Dice\Dice; use Dice\Dice;

18
boot.php
View file

@ -34,7 +34,7 @@ define('DFRN_PROTOCOL_VERSION', '2.23');
define('NEW_UPDATE_ROUTINE_VERSION', 1170); define('NEW_UPDATE_ROUTINE_VERSION', 1170);
/** /**
* @brief Constant with a HTML line break. * Constant with a HTML line break.
* *
* Contains a HTML line break (br) element and a real carriage return with line * Contains a HTML line break (br) element and a real carriage return with line
* feed for the source. * feed for the source.
@ -43,7 +43,7 @@ define('NEW_UPDATE_ROUTINE_VERSION', 1170);
define('EOL', "<br />\r\n"); define('EOL', "<br />\r\n");
/** /**
* @brief Image storage quality. * Image storage quality.
* *
* Lower numbers save space at cost of image detail. * Lower numbers save space at cost of image detail.
* For ease of upgrade, please do not change here. Set system.jpegquality = n in config/local.config.php, * For ease of upgrade, please do not change here. Set system.jpegquality = n in config/local.config.php,
@ -233,7 +233,7 @@ if (!defined('CURLE_OPERATION_TIMEDOUT')) {
} }
/** /**
* @brief Returns the user id of locally logged in user or false. * Returns the user id of locally logged in user or false.
* *
* @return int|bool user id or false * @return int|bool user id or false
*/ */
@ -246,7 +246,7 @@ function local_user()
} }
/** /**
* @brief Returns the public contact id of logged in user or false. * Returns the public contact id of logged in user or false.
* *
* @return int|bool public contact id or false * @return int|bool public contact id or false
*/ */
@ -270,7 +270,7 @@ function public_contact()
} }
/** /**
* @brief Returns contact id of authenticated site visitor or false * Returns contact id of authenticated site visitor or false
* *
* @return int|bool visitor_id or false * @return int|bool visitor_id or false
*/ */
@ -288,7 +288,7 @@ function remote_user()
} }
/** /**
* @brief Show an error message to user. * Show an error message to user.
* *
* This function save text in session, to be shown to the user at next page load * This function save text in session, to be shown to the user at next page load
* *
@ -310,7 +310,7 @@ function notice($s)
} }
/** /**
* @brief Show an info message to user. * Show an info message to user.
* *
* This function save text in session, to be shown to the user at next page load * This function save text in session, to be shown to the user at next page load
* *
@ -375,7 +375,7 @@ function feed_birthday($uid, $tz)
} }
/** /**
* @brief Check if current user has admin role. * Check if current user has admin role.
* *
* @return bool true if user is an admin * @return bool true if user is an admin
*/ */
@ -571,7 +571,7 @@ function get_itemcachepath()
} }
/** /**
* @brief Returns the path where spool files are stored * Returns the path where spool files are stored
* *
* @return string Spool path * @return string Spool path
*/ */

104
include/api.php
View file

@ -65,11 +65,11 @@ $API = [];
$called_api = []; $called_api = [];
/** /**
* Auth API user
*
* It is not sufficient to use local_user() to check whether someone is allowed to use the API, * It is not sufficient to use local_user() to check whether someone is allowed to use the API,
* because this will open CSRF holes (just embed an image with src=friendicasite.com/api/statuses/update?status=CSRF * because this will open CSRF holes (just embed an image with src=friendicasite.com/api/statuses/update?status=CSRF
* into a page, and visitors will post something without noticing it). * into a page, and visitors will post something without noticing it).
*
* @brief Auth API user
*/ */
function api_user() function api_user()
{ {
@ -81,13 +81,13 @@ function api_user()
} }
/** /**
* Get source name from API client
*
* Clients can send 'source' parameter to be show in post metadata * Clients can send 'source' parameter to be show in post metadata
* as "sent via <source>". * as "sent via <source>".
* Some clients doesn't send a source param, we support ones we know * Some clients doesn't send a source param, we support ones we know
* (only Twidere, atm) * (only Twidere, atm)
* *
* @brief Get source name from API client
*
* @return string * @return string
* Client source name, default to "api" if unset/unknown * Client source name, default to "api" if unset/unknown
* @throws Exception * @throws Exception
@ -113,7 +113,7 @@ function api_source()
} }
/** /**
* @brief Format date for API * Format date for API
* *
* @param string $str Source date, as UTC * @param string $str Source date, as UTC
* @return string Date in UTC formatted as "D M d H:i:s +0000 Y" * @return string Date in UTC formatted as "D M d H:i:s +0000 Y"
@ -128,8 +128,6 @@ function api_date($str)
/** /**
* Register a function to be the endpoint for defined API path. * Register a function to be the endpoint for defined API path.
* *
* @brief Register API endpoint
*
* @param string $path API URL path, relative to DI::baseUrl() * @param string $path API URL path, relative to DI::baseUrl()
* @param string $func Function name to call on path request * @param string $func Function name to call on path request
* @param bool $auth API need logged user * @param bool $auth API need logged user
@ -161,8 +159,6 @@ function api_register_func($path, $func, $auth = false, $method = API_METHOD_ANY
* Log in user via OAuth1 or Simple HTTP Auth. * Log in user via OAuth1 or Simple HTTP Auth.
* Simple Auth allow username in form of <pre>user@server</pre>, ignoring server part * Simple Auth allow username in form of <pre>user@server</pre>, ignoring server part
* *
* @brief Login API user
*
* @param App $a App * @param App $a App
* @throws ForbiddenException * @throws ForbiddenException
* @throws InternalServerErrorException * @throws InternalServerErrorException
@ -260,12 +256,12 @@ function api_login(App $a)
} }
/** /**
* Check HTTP method of called API
*
* API endpoints can define which HTTP method to accept when called. * API endpoints can define which HTTP method to accept when called.
* This function check the current HTTP method agains endpoint * This function check the current HTTP method agains endpoint
* registered method. * registered method.
* *
* @brief Check HTTP method of called API
*
* @param string $method Required methods, uppercase, separated by comma * @param string $method Required methods, uppercase, separated by comma
* @return bool * @return bool
*/ */
@ -278,9 +274,9 @@ function api_check_method($method)
} }
/** /**
* Authenticate user, call registered API function, set HTTP headers * Main API entry point
* *
* @brief Main API entry point * Authenticate user, call registered API function, set HTTP headers
* *
* @param App $a App * @param App $a App
* @param App\Arguments $args The app arguments (optional, will retrieved by the DI-Container in case of missing) * @param App\Arguments $args The app arguments (optional, will retrieved by the DI-Container in case of missing)
@ -379,7 +375,7 @@ function api_call(App $a, App\Arguments $args = null)
} }
/** /**
* @brief Format API error string * Format API error string
* *
* @param string $type Return type (xml, json, rss, as) * @param string $type Return type (xml, json, rss, as)
* @param object $e HTTPException Error object * @param object $e HTTPException Error object
@ -417,7 +413,7 @@ function api_error($type, $e, App\Arguments $args)
} }
/** /**
* @brief Set values for RSS template * Set values for RSS template
* *
* @param App $a * @param App $a
* @param array $arr Array to be passed to template * @param array $arr Array to be passed to template
@ -451,7 +447,7 @@ function api_rss_extra(App $a, $arr, $user_info)
/** /**
* @brief Unique contact to contact url. * Unique contact to contact url.
* *
* @param int $id Contact id * @param int $id Contact id
* @return bool|string * @return bool|string
@ -470,7 +466,7 @@ function api_unique_id_to_nurl($id)
} }
/** /**
* @brief Get user info array. * Get user info array.
* *
* @param App $a App * @param App $a App
* @param int|string $contact_id Contact ID or URL * @param int|string $contact_id Contact ID or URL
@ -759,7 +755,7 @@ function api_get_user(App $a, $contact_id = null)
} }
/** /**
* @brief return api-formatted array for item's author and owner * return api-formatted array for item's author and owner
* *
* @param App $a App * @param App $a App
* @param array $item item from db * @param array $item item from db
@ -787,7 +783,7 @@ function api_item_get_user(App $a, $item)
} }
/** /**
* @brief walks recursively through an array with the possibility to change value and key * walks recursively through an array with the possibility to change value and key
* *
* @param array $array The array to walk through * @param array $array The array to walk through
* @param callable $callback The callback function * @param callable $callback The callback function
@ -815,7 +811,7 @@ function api_walk_recursive(array &$array, callable $callback)
} }
/** /**
* @brief Callback function to transform the array in an array that can be transformed in a XML file * Callback function to transform the array in an array that can be transformed in a XML file
* *
* @param mixed $item Array item value * @param mixed $item Array item value
* @param string $key Array key * @param string $key Array key
@ -841,7 +837,7 @@ function api_reformat_xml(&$item, &$key)
} }
/** /**
* @brief Creates the XML from a JSON style array * Creates the XML from a JSON style array
* *
* @param array $data JSON style array * @param array $data JSON style array
* @param string $root_element Name of the root element * @param string $root_element Name of the root element
@ -886,7 +882,7 @@ function api_create_xml(array $data, $root_element)
} }
/** /**
* @brief Formats the data according to the data type * Formats the data according to the data type
* *
* @param string $root_element Name of the root element * @param string $root_element Name of the root element
* @param string $type Return type (atom, rss, xml, json) * @param string $type Return type (atom, rss, xml, json)
@ -1777,8 +1773,6 @@ api_register_func('api/statuses/public_timeline', 'api_statuses_public_timeline'
/** /**
* Returns the most recent statuses posted by users this node knows about. * Returns the most recent statuses posted by users this node knows about.
* *
* @brief Returns the list of public federated posts this node knows about
*
* @param string $type Return format: json, xml, atom, rss * @param string $type Return format: json, xml, atom, rss
* @return array|string * @return array|string
* @throws BadRequestException * @throws BadRequestException
@ -2209,8 +2203,6 @@ api_register_func('api/statuses/replies', 'api_statuses_mentions', true);
/** /**
* Returns the most recent statuses posted by the user. * Returns the most recent statuses posted by the user.
* *
* @brief Returns a user's public timeline
*
* @param string $type Either "json" or "xml" * @param string $type Either "json" or "xml"
* @return string|array * @return string|array
* @throws BadRequestException * @throws BadRequestException
@ -2812,7 +2804,7 @@ function api_format_items_embeded_images($item, $text)
} }
/** /**
* @brief return <a href='url'>name</a> as array * return <a href='url'>name</a> as array
* *
* @param string $txt text * @param string $txt text
* @return array * @return array
@ -2839,7 +2831,7 @@ function api_contactlink_to_array($txt)
/** /**
* @brief return likes, dislikes and attend status for item * return likes, dislikes and attend status for item
* *
* @param array $item array * @param array $item array
* @param string $type Return type (atom, rss, xml, json) * @param string $type Return type (atom, rss, xml, json)
@ -2919,7 +2911,7 @@ function api_format_items_activities($item, $type = "json")
/** /**
* @brief return data from profiles * return data from profiles
* *
* @param array $profile_row array containing data from db table 'profile' * @param array $profile_row array containing data from db table 'profile'
* @return array * @return array
@ -2972,7 +2964,7 @@ function api_format_items_profiles($profile_row)
} }
/** /**
* @brief format items to be returned by api * format items to be returned by api
* *
* @param array $items array of items * @param array $items array of items
* @param array $user_info * @param array $user_info
@ -3387,11 +3379,11 @@ function api_lists_statuses($type)
api_register_func('api/lists/statuses', 'api_lists_statuses', true); api_register_func('api/lists/statuses', 'api_lists_statuses', true);
/** /**
* Returns either the friends of the follower list
*
* Considers friends and followers lists to be private and won't return * Considers friends and followers lists to be private and won't return
* anything if any user_id parameter is passed. * anything if any user_id parameter is passed.
* *
* @brief Returns either the friends of the follower list
*
* @param string $qtype Either "friends" or "followers" * @param string $qtype Either "friends" or "followers"
* @return boolean|array * @return boolean|array
* @throws BadRequestException * @throws BadRequestException
@ -3478,9 +3470,7 @@ function api_statuses_f($qtype)
/** /**
* Returns the user's friends. * Returns the list of friends of the provided user
*
* @brief Returns the list of friends of the provided user
* *
* @deprecated By Twitter API in favor of friends/list * @deprecated By Twitter API in favor of friends/list
* *
@ -3499,9 +3489,7 @@ function api_statuses_friends($type)
} }
/** /**
* Returns the user's followers. * Returns the list of followers of the provided user
*
* @brief Returns the list of followers of the provided user
* *
* @deprecated By Twitter API in favor of friends/list * @deprecated By Twitter API in favor of friends/list
* *
@ -3818,9 +3806,7 @@ function api_direct_messages_new($type)
api_register_func('api/direct_messages/new', 'api_direct_messages_new', true, API_METHOD_POST); api_register_func('api/direct_messages/new', 'api_direct_messages_new', true, API_METHOD_POST);
/** /**
* Destroys a direct message. * delete a direct_message from mail table through api
*
* @brief delete a direct_message from mail table through api
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -3906,8 +3892,6 @@ api_register_func('api/direct_messages/destroy', 'api_direct_messages_destroy',
/** /**
* Unfollow Contact * Unfollow Contact
* *
* @brief unfollow contact
*
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
* @throws BadRequestException * @throws BadRequestException
@ -4203,7 +4187,7 @@ api_register_func('api/oauth/access_token', 'api_oauth_access_token', false);
/** /**
* @brief delete a complete photoalbum with all containing photos from database through api * delete a complete photoalbum with all containing photos from database through api
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4258,7 +4242,7 @@ function api_fr_photoalbum_delete($type)
} }
/** /**
* @brief update the name of the album for all photos of an album * update the name of the album for all photos of an album
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4300,7 +4284,7 @@ function api_fr_photoalbum_update($type)
/** /**
* @brief list all photos of the authenticated user * list all photos of the authenticated user
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4348,7 +4332,7 @@ function api_fr_photos_list($type)
} }
/** /**
* @brief upload a new photo or change an existing photo * upload a new photo or change an existing photo
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4487,7 +4471,7 @@ function api_fr_photo_create_update($type)
} }
/** /**
* @brief delete a single photo from the database through api * delete a single photo from the database through api
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4540,7 +4524,7 @@ function api_fr_photo_delete($type)
/** /**
* @brief returns the details of a specified photo id, if scale is given, returns the photo data in base 64 * returns the details of a specified photo id, if scale is given, returns the photo data in base 64
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -4569,9 +4553,7 @@ function api_fr_photo_detail($type)
/** /**
* Updates the user’s profile image. * updates the profile image for the user (either a specified profile or the default profile)
*
* @brief updates the profile image for the user (either a specified profile or the default profile)
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* *
@ -5180,7 +5162,7 @@ function api_get_announce($item)
} }
/** /**
* @brief Return the item shared, if the item contains only the [share] tag * Return the item shared, if the item contains only the [share] tag
* *
* @param array $item Sharer item * @param array $item Sharer item
* @return array|false Shared item or false if not a reshare * @return array|false Shared item or false if not a reshare
@ -5907,7 +5889,7 @@ api_register_func('api/friendica/activity/unattendno', 'api_friendica_activity',
api_register_func('api/friendica/activity/unattendmaybe', 'api_friendica_activity', true, API_METHOD_POST); api_register_func('api/friendica/activity/unattendmaybe', 'api_friendica_activity', true, API_METHOD_POST);
/** /**
* @brief Returns notifications * Returns notifications
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -5941,9 +5923,9 @@ function api_friendica_notification($type)
} }
/** /**
* POST request with 'id' param as notification id * Set notification as seen and returns associated item (if possible)
* *
* @brief Set notification as seen and returns associated item (if possible) * POST request with 'id' param as notification id
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -5993,7 +5975,7 @@ api_register_func('api/friendica/notification/seen', 'api_friendica_notification
api_register_func('api/friendica/notification', 'api_friendica_notification', true, API_METHOD_GET); api_register_func('api/friendica/notification', 'api_friendica_notification', true, API_METHOD_GET);
/** /**
* @brief update a direct_message to seen state * update a direct_message to seen state
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array (success result=ok, error result=error with error message) * @return string|array (success result=ok, error result=error with error message)
@ -6044,7 +6026,7 @@ function api_friendica_direct_messages_setseen($type)
api_register_func('api/friendica/direct_messages_setseen', 'api_friendica_direct_messages_setseen', true); api_register_func('api/friendica/direct_messages_setseen', 'api_friendica_direct_messages_setseen', true);
/** /**
* @brief search for direct_messages containing a searchstring through api * search for direct_messages containing a searchstring through api
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @param string $box * @param string $box
@ -6115,7 +6097,7 @@ function api_friendica_direct_messages_search($type, $box = "")
api_register_func('api/friendica/direct_messages_search', 'api_friendica_direct_messages_search', true); api_register_func('api/friendica/direct_messages_search', 'api_friendica_direct_messages_search', true);
/** /**
* @brief return data of all the profiles a user has to the client * return data of all the profiles a user has to the client
* *
* @param string $type Known types are 'atom', 'rss', 'xml' and 'json' * @param string $type Known types are 'atom', 'rss', 'xml' and 'json'
* @return string|array * @return string|array
@ -6221,9 +6203,9 @@ function api_saved_searches_list($type)
api_register_func('api/saved_searches/list', 'api_saved_searches_list', true); api_register_func('api/saved_searches/list', 'api_saved_searches_list', true);
/* /*
* Bind comment numbers(friendica_comments: Int) on each statuses page of *_timeline / favorites / search * Number of comments
* *
* @brief Number of comments * Bind comment numbers(friendica_comments: Int) on each statuses page of *_timeline / favorites / search
* *
* @param object $data [Status, Status] * @param object $data [Status, Status]
* *

28
include/conversation.php
View file

@ -837,7 +837,7 @@ function conversation_fetch_comments($thread_items, $pinned) {
} }
/** /**
* @brief Add comments to top level entries that had been fetched before * Add comments to top level entries that had been fetched before
* *
* The system will fetch the comments for the local user whenever possible. * The system will fetch the comments for the local user whenever possible.
* This behaviour is currently needed to allow commenting on Friendica posts. * This behaviour is currently needed to allow commenting on Friendica posts.
@ -987,7 +987,8 @@ function item_photo_menu($item) {
} }
/** /**
* @brief Checks item to see if it is one of the builtin activities (like/dislike, event attendance, consensus items, etc.) * Checks item to see if it is one of the builtin activities (like/dislike, event attendance, consensus items, etc.)
*
* Increments the count of each matching activity and adds a link to the author as needed. * Increments the count of each matching activity and adds a link to the author as needed.
* *
* @param array $item * @param array $item
@ -1281,8 +1282,6 @@ function status_editor(App $a, $x, $notes_cid = 0, $popup = false)
/** /**
* Plucks the children of the given parent from a given item list. * Plucks the children of the given parent from a given item list.
* *
* @brief Plucks all the children in the given item list of the given parent
*
* @param array $item_list * @param array $item_list
* @param array $parent * @param array $parent
* @param bool $recursive * @param bool $recursive
@ -1315,7 +1314,7 @@ function get_item_children(array &$item_list, array $parent, $recursive = true)
} }
/** /**
* @brief Recursively sorts a tree-like item array * Recursively sorts a tree-like item array
* *
* @param array $items * @param array $items
* @return array * @return array
@ -1333,7 +1332,7 @@ function sort_item_children(array $items)
} }
/** /**
* @brief Recursively add all children items at the top level of a list * Recursively add all children items at the top level of a list
* *
* @param array $children List of items to append * @param array $children List of items to append
* @param array $item_list * @param array $item_list
@ -1349,6 +1348,8 @@ function add_children_to_list(array $children, array &$item_list)
} }
/** /**
* Selectively flattens a tree-like item structure to prevent threading stairs
*
* This recursive function takes the item tree structure created by conv_sort() and * This recursive function takes the item tree structure created by conv_sort() and
* flatten the extraneous depth levels when people reply sequentially, removing the * flatten the extraneous depth levels when people reply sequentially, removing the
* stairs effect in threaded conversations limiting the available content width. * stairs effect in threaded conversations limiting the available content width.
@ -1359,8 +1360,6 @@ function add_children_to_list(array $children, array &$item_list)
* This process is rendered somewhat more complicated because items can be either * This process is rendered somewhat more complicated because items can be either
* replies or likes, and these don't factor at all in the reply count/last reply. * replies or likes, and these don't factor at all in the reply count/last reply.
* *
* @brief Selectively flattens a tree-like item structure to prevent threading stairs
*
* @param array $parent A tree-like array of items * @param array $parent A tree-like array of items
* @return array * @return array
*/ */
@ -1407,12 +1406,11 @@ function smart_flatten_conversation(array $parent)
/** /**
* Expands a flat list of items into corresponding tree-like conversation structures, * Expands a flat list of items into corresponding tree-like conversation structures.
*
* sort the top-level posts either on "received" or "commented", and finally * sort the top-level posts either on "received" or "commented", and finally
* append all the items at the top level (???) * append all the items at the top level (???)
* *
* @brief Expands a flat item list into a conversation array for display
*
* @param array $item_list A list of items belonging to one or more conversations * @param array $item_list A list of items belonging to one or more conversations
* @param string $order Either on "received" or "commented" * @param string $order Either on "received" or "commented"
* @return array * @return array
@ -1486,7 +1484,7 @@ function conv_sort(array $item_list, $order)
} }
/** /**
* @brief usort() callback to sort item arrays by pinned and the received key * usort() callback to sort item arrays by pinned and the received key
* *
* @param array $a * @param array $a
* @param array $b * @param array $b
@ -1504,7 +1502,7 @@ function sort_thr_pinned_received(array $a, array $b)
} }
/** /**
* @brief usort() callback to sort item arrays by the received key * usort() callback to sort item arrays by the received key
* *
* @param array $a * @param array $a
* @param array $b * @param array $b
@ -1516,7 +1514,7 @@ function sort_thr_received(array $a, array $b)
} }
/** /**
* @brief usort() callback to reverse sort item arrays by the received key * usort() callback to reverse sort item arrays by the received key
* *
* @param array $a * @param array $a
* @param array $b * @param array $b
@ -1528,7 +1526,7 @@ function sort_thr_received_rev(array $a, array $b)
} }
/** /**
* @brief usort() callback to sort item arrays by the commented key * usort() callback to sort item arrays by the commented key
* *
* @param array $a * @param array $a
* @param array $b * @param array $b

2
include/dba.php
View file

@ -3,7 +3,7 @@
use Friendica\Database\DBA; use Friendica\Database\DBA;
/** /**
* @brief execute SQL query with printf style args - deprecated * execute SQL query with printf style args - deprecated
* *
* Please use the DBA:: functions instead: * Please use the DBA:: functions instead:
* DBA::select, DBA::exists, DBA::insert * DBA::select, DBA::exists, DBA::insert

8
include/enotify.php
View file

@ -23,7 +23,7 @@ use Friendica\Util\Emailer;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief Creates a notification entry and possibly sends a mail * Creates a notification entry and possibly sends a mail
* *
* @param array $params Array with the elements: * @param array $params Array with the elements:
* uid, item, parent, type, otype, verb, event, * uid, item, parent, type, otype, verb, event,
@ -652,7 +652,7 @@ function notification($params)
} }
/** /**
* @brief Checks for users who should be notified * Checks for users who should be notified
* *
* @param int $itemid ID of the item for which the check should be done * @param int $itemid ID of the item for which the check should be done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -667,7 +667,7 @@ function check_user_notification($itemid) {
} }
/** /**
* @brief Checks for item related notifications and sends them * Checks for item related notifications and sends them
* *
* @param int $itemid ID of the item for which the check should be done * @param int $itemid ID of the item for which the check should be done
* @param int $uid User ID * @param int $uid User ID
@ -738,7 +738,7 @@ function check_item_notification($itemid, $uid, $notification_type) {
} }
/** /**
* @brief Formats a notification message with the notification author * Formats a notification message with the notification author
* *
* Replace the name with {0} but ensure to make that only once. The {0} is used * Replace the name with {0} but ensure to make that only once. The {0} is used
* later and prints the name in bold. * later and prints the name in bold.

7
mod/cal.php
View file

@ -1,9 +1,10 @@
<?php <?php
/** /**
* @file mod/cal.php * @file mod/cal.php
* @brief The calendar module * The calendar module
* This calendar is for profile visitors and contains only the events *
* of the profile owner * This calendar is for profile visitors and contains only the events
* of the profile owner
*/ */
use Friendica\App; use Friendica\App;

3
mod/dfrn_confirm.php
View file

@ -1,7 +1,8 @@
<?php <?php
/** /**
* @file mod/dfrn_confirm.php * @file mod/dfrn_confirm.php
* @brief Module: dfrn_confirm * Module: dfrn_confirm
*
* Purpose: Friendship acceptance for DFRN contacts * Purpose: Friendship acceptance for DFRN contacts
* *
* There are two possible entry points and three scenarios. * There are two possible entry points and three scenarios.

2
mod/dfrn_notify.php
View file

@ -2,7 +2,7 @@
/** /**
* @file mod/dfrn_notify.php * @file mod/dfrn_notify.php
* @brief The dfrn notify endpoint * The dfrn notify endpoint
* @see PDF with dfrn specs: https://github.com/friendica/friendica/blob/master/spec/dfrn2.pdf * @see PDF with dfrn specs: https://github.com/friendica/friendica/blob/master/spec/dfrn2.pdf
*/ */

2
mod/dfrn_request.php
View file

@ -2,7 +2,7 @@
/** /**
* @file mod/dfrn_request.php * @file mod/dfrn_request.php
* @brief Module: dfrn_request * Module: dfrn_request
* *
* Purpose: Handles communication associated with the issuance of * Purpose: Handles communication associated with the issuance of
* friend requests. * friend requests.

2
mod/events.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file mod/events.php * @file mod/events.php
* @brief The events module * The events module
*/ */
use Friendica\App; use Friendica\App;

2
mod/match.php
View file

@ -17,7 +17,7 @@ use Friendica\Util\Network;
use Friendica\Util\Proxy as ProxyUtils; use Friendica\Util\Proxy as ProxyUtils;
/** /**
* @brief Controller for /match. * Controller for /match.
* *
* It takes keywords from your profile and queries the directory server for * It takes keywords from your profile and queries the directory server for
* matching keywords from other profiles. * matching keywords from other profiles.

12
mod/network.php
View file

@ -200,7 +200,7 @@ function network_query_get_sel_group(App $a)
} }
/** /**
* @brief Sets the pager data and returns SQL * Sets the pager data and returns SQL
* *
* @param App $a The global App * @param App $a The global App
* @param Pager $pager * @param Pager $pager
@ -237,7 +237,7 @@ function networkPager(App $a, Pager $pager, $update)
} }
/** /**
* @brief Sets items as seen * Sets items as seen
* *
* @param array $condition The array with the SQL condition * @param array $condition The array with the SQL condition
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -256,7 +256,7 @@ function networkSetSeen($condition)
} }
/** /**
* @brief Create the conversation HTML * Create the conversation HTML
* *
* @param App $a The global App * @param App $a The global App
* @param array $items Items of the conversation * @param array $items Items of the conversation
@ -315,7 +315,7 @@ function network_content(App $a, $update = 0, $parent = 0)
} }
/** /**
* @brief Get the network content in flat view * Get the network content in flat view
* *
* @param App $a The global App * @param App $a The global App
* @param integer $update Used for the automatic reloading * @param integer $update Used for the automatic reloading
@ -401,7 +401,7 @@ function networkFlatView(App $a, $update = 0)
} }
/** /**
* @brief Get the network content in threaded view * Get the network content in threaded view
* *
* @param App $a The global App * @param App $a The global App
* @param integer $update Used for the automatic reloading * @param integer $update Used for the automatic reloading
@ -871,7 +871,7 @@ function networkThreadedView(App $a, $update, $parent)
} }
/** /**
* @brief Get the network tabs menu * Get the network tabs menu
* *
* @param App $a The global App * @param App $a The global App
* @return string Html of the networktab * @return string Html of the networktab

2
mod/notifications.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file mod/notifications.php * @file mod/notifications.php
* @brief The notifications module * The notifications module
*/ */
use Friendica\App; use Friendica\App;

4
mod/parse_url.php
View file

@ -2,7 +2,7 @@
/** /**
* @file mod/parse_url.php * @file mod/parse_url.php
* @brief The parse_url module * The parse_url module
* *
* This module does parse an url for embeddable content (audio, video, image files or link) * This module does parse an url for embeddable content (audio, video, image files or link)
* information and does format this information to BBCode * information and does format this information to BBCode
@ -172,7 +172,7 @@ function parse_url_content(App $a)
} }
/** /**
* @brief Legacy function to call ParseUrl::getSiteinfoCached * Legacy function to call ParseUrl::getSiteinfoCached
* *
* Note: We have moved the function to ParseUrl.php. This function is only for * Note: We have moved the function to ParseUrl.php. This function is only for
* legacy support and will be remove in the future * legacy support and will be remove in the future

6
mod/ping.php
View file

@ -21,7 +21,7 @@ use Friendica\Util\Proxy as ProxyUtils;
use Friendica\Util\XML; use Friendica\Util\XML;
/** /**
* @brief Outputs the counts and the lists of various notifications * Outputs the counts and the lists of various notifications
* *
* The output format can be controlled via the GET parameter 'format'. It can be * The output format can be controlled via the GET parameter 'format'. It can be
* - xml (deprecated legacy default) * - xml (deprecated legacy default)
@ -382,7 +382,7 @@ function ping_init(App $a)
} }
/** /**
* @brief Retrieves the notifications array for the given user ID * Retrieves the notifications array for the given user ID
* *
* @param int $uid User id * @param int $uid User id
* @return array Associative array of notifications * @return array Associative array of notifications
@ -465,7 +465,7 @@ function ping_get_notifications($uid)
} }
/** /**
* @brief Backward-compatible XML formatting for ping.php output * Backward-compatible XML formatting for ping.php output
* @deprecated * @deprecated
* *
* @param array $data The initial ping data array * @param array $data The initial ping data array

2
mod/uimport.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file mod/uimport.php * @file mod/uimport.php
* @brief View for user import * View for user import
*/ */
use Friendica\App; use Friendica\App;

2
mod/wall_upload.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file mod/wall_upload.php * @file mod/wall_upload.php
* @brief Module for uploading a picture to the profile wall * Module for uploading a picture to the profile wall
* *
* By default the picture will be stored in the photo album with the name Wall Photos. * By default the picture will be stored in the photo album with the name Wall Photos.
* You can specify a different album by adding an optional query string "album=" * You can specify a different album by adding an optional query string "album="

2
mod/worker.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file mod/worker.php * @file mod/worker.php
* @brief Module for running the worker as frontend process * Module for running the worker as frontend process
*/ */
use Friendica\Core\Config; use Friendica\Core\Config;

4
src/App.php
View file

@ -28,7 +28,7 @@ use Psr\Log\LoggerInterface;
* *
* class: App * class: App
* *
* @brief Our main application structure for the life of this page. * Our main application structure for the life of this page.
* *
* Primarily deals with the URL that got us here * Primarily deals with the URL that got us here
* and tries to make some sense of it, and * and tries to make some sense of it, and
@ -393,8 +393,6 @@ class App
} }
/** /**
* @brief Return full URL to theme which is currently in effect.
*
* Provide a sane default if nothing is chosen or the specified theme does not exist. * Provide a sane default if nothing is chosen or the specified theme does not exist.
* *
* @return string * @return string

4
src/App/Authentication.php
View file

@ -76,7 +76,7 @@ class Authentication
} }
/** /**
* @brief Tries to auth the user from the cookie or session * Tries to auth the user from the cookie or session
* *
* @param App $a The Friendica Application context * @param App $a The Friendica Application context
* *
@ -283,7 +283,7 @@ class Authentication
} }
/** /**
* @brief Sets the provided user's authenticated session * Sets the provided user's authenticated session
* *
* @param App $a The Friendica application context * @param App $a The Friendica application context
* @param array $user_record The current "user" record * @param array $user_record The current "user" record

10
src/BaseModule.php
View file

@ -17,7 +17,7 @@ use Friendica\Core\Logger;
abstract class BaseModule abstract class BaseModule
{ {
/** /**
* @brief Initialization method common to both content() and post() * Initialization method common to both content() and post()
* *
* Extend this method if you need to do any shared processing before both * Extend this method if you need to do any shared processing before both
* content() or post() * content() or post()
@ -27,7 +27,7 @@ abstract class BaseModule
} }
/** /**
* @brief Module GET method to display raw content from technical endpoints * Module GET method to display raw content from technical endpoints
* *
* Extend this method if the module is supposed to return communication data, * Extend this method if the module is supposed to return communication data,
* e.g. from protocol implementations. * e.g. from protocol implementations.
@ -39,7 +39,7 @@ abstract class BaseModule
} }
/** /**
* @brief Module GET method to display any content * Module GET method to display any content
* *
* Extend this method if the module is supposed to return any display * Extend this method if the module is supposed to return any display
* through a GET request. It can be an HTML page through templating or a * through a GET request. It can be an HTML page through templating or a
@ -55,7 +55,7 @@ abstract class BaseModule
} }
/** /**
* @brief Module POST method to process submitted data * Module POST method to process submitted data
* *
* Extend this method if the module is supposed to process POST requests. * Extend this method if the module is supposed to process POST requests.
* Doesn't display any content * Doesn't display any content
@ -67,7 +67,7 @@ abstract class BaseModule
} }
/** /**
* @brief Called after post() * Called after post()
* *
* Unknown purpose * Unknown purpose
*/ */

2
src/Console/ArchiveContact.php
View file

@ -9,7 +9,7 @@ use Friendica\Util\Strings;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to archive a contact on the server * tool to archive a contact on the server
* *
* With this tool you can archive a contact when you know that it isn't existing anymore. * With this tool you can archive a contact when you know that it isn't existing anymore.
* Normally this does happen automatically after a few days. * Normally this does happen automatically after a few days.

2
src/Console/Cache.php
View file

@ -9,7 +9,7 @@ use Friendica\Core\Cache\ICache;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to access the cache from the CLI * tool to access the cache from the CLI
* *
* With this script you can access the cache of your node from the CLI. * With this script you can access the cache of your node from the CLI.
* You can read current values stored in the cache and set new values * You can read current values stored in the cache and set new values

2
src/Console/Config.php
View file

@ -8,7 +8,7 @@ use Friendica\Core\Config\IConfiguration;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to access the system config from the CLI * tool to access the system config from the CLI
* *
* With this script you can access the system configuration of your node from * With this script you can access the system configuration of your node from
* the CLI. You can do both, reading current values stored in the database and * the CLI. You can do both, reading current values stored in the database and

4
src/Console/CreateDoxygen.php
View file

@ -105,7 +105,7 @@ HELP;
} }
/** /**
* @brief Adds a doxygen header * Adds a doxygen header
* *
* @param string $line The current line of the document * @param string $line The current line of the document
* *
@ -118,7 +118,7 @@ HELP;
$space = substr($line, 0, $length); $space = substr($line, 0, $length);
$block = $space . "/**\n" . $block = $space . "/**\n" .
$space . " * @brief \n" . $space . " * \n" .
$space . " *\n"; /**/ $space . " *\n"; /**/

2
src/Console/DatabaseStructure.php
View file

@ -9,7 +9,7 @@ use Friendica\Database\DBStructure;
use RuntimeException; use RuntimeException;
/** /**
* @brief Performs database updates from the command line * Performs database updates from the command line
* *
* @author Hypolite Petovan <hypolite@mrpetovan.com> * @author Hypolite Petovan <hypolite@mrpetovan.com>
*/ */

2
src/Console/GlobalCommunityBlock.php
View file

@ -7,7 +7,7 @@ use Friendica\Core\L10n;
use Friendica\Model\Contact; use Friendica\Model\Contact;
/** /**
* @brief tool to block an account from the node * tool to block an account from the node
* *
* With this tool, you can block an account in such a way, that no postings * With this tool, you can block an account in such a way, that no postings
* or comments this account writes are accepted to the node. * or comments this account writes are accepted to the node.

2
src/Console/GlobalCommunitySilence.php
View file

@ -8,7 +8,7 @@ use Friendica\Model\Contact;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to silence accounts on the global community page * tool to silence accounts on the global community page
* *
* With this tool, you can silence an account on the global community page. * With this tool, you can silence an account on the global community page.
* Postings from silenced accounts will not be displayed on the community * Postings from silenced accounts will not be displayed on the community

2
src/Console/Lock.php
View file

@ -8,7 +8,7 @@ use Friendica\Core\Lock\ILock;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to access the locks from the CLI * tool to access the locks from the CLI
* *
* With this script you can access the locks of your node from the CLI. * With this script you can access the locks of your node from the CLI.
* You can read current locks and set/remove locks. * You can read current locks and set/remove locks.

2
src/Console/Maintenance.php
View file

@ -6,7 +6,7 @@ use Friendica\App;
use Friendica\Core\Config\IConfiguration; use Friendica\Core\Config\IConfiguration;
/** /**
* @brief Sets maintenance mode for this node * Sets maintenance mode for this node
* *
* @author Hypolite Petovan <hypolite@mrpetovan.com> * @author Hypolite Petovan <hypolite@mrpetovan.com>
*/ */

2
src/Console/NewPassword.php
View file

@ -9,7 +9,7 @@ use Friendica\Model\User;
use RuntimeException; use RuntimeException;
/** /**
* @brief tool to set a new password for a user * tool to set a new password for a user
* *
* With this tool, you can set a new password for a user * With this tool, you can set a new password for a user
* *

2
src/Console/ServerBlock.php
View file

@ -8,7 +8,7 @@ use Console_Table;
use Friendica\Core\Config\IConfiguration; use Friendica\Core\Config\IConfiguration;
/** /**
* @brief Manage blocked servers * Manage blocked servers
* *
* With this tool, you can list the current blocked servers * With this tool, you can list the current blocked servers
* or you can add / remove a blocked server from the list * or you can add / remove a blocked server from the list

2
src/Console/Storage.php
View file

@ -6,7 +6,7 @@ use Asika\SimpleConsole\CommandArgsException;
use Friendica\Core\StorageManager; use Friendica\Core\StorageManager;
/** /**
* @brief tool to manage storage backend and stored data from CLI * tool to manage storage backend and stored data from CLI
* *
*/ */
class Storage extends \Asika\SimpleConsole\Console class Storage extends \Asika\SimpleConsole\Console

2
src/Content/ContactSelector.php
View file

@ -12,7 +12,7 @@ use Friendica\Util\Network;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief ContactSelector class * ContactSelector class
*/ */
class ContactSelector class ContactSelector
{ {

8
src/Content/Feature.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Content/Feature.php * @file src/Content/Feature.php
* @brief Features management * Features management
*/ */
namespace Friendica\Content; namespace Friendica\Content;
@ -13,7 +13,7 @@ use Friendica\DI;
class Feature class Feature
{ {
/** /**
* @brief check if feature is enabled * check if feature is enabled
* *
* @param integer $uid user id * @param integer $uid user id
* @param string $feature feature * @param string $feature feature
@ -42,7 +42,7 @@ class Feature
} }
/** /**
* @brief check if feature is enabled or disabled by default * check if feature is enabled or disabled by default
* *
* @param string $feature feature * @param string $feature feature
* @return boolean * @return boolean
@ -62,7 +62,7 @@ class Feature
} }
/** /**
* @brief Get a list of all available features * Get a list of all available features
* *
* The array includes the setting group, the setting name, * The array includes the setting group, the setting name,
* explainations for the setting and if it's enabled or disabled * explainations for the setting and if it's enabled or disabled

12
src/Content/ForumManager.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Content/ForumManager.php * @file src/Content/ForumManager.php
* @brief ForumManager class with its methods related to forum functionality * ForumManager class with its methods related to forum functionality
*/ */
namespace Friendica\Content; namespace Friendica\Content;
@ -15,12 +15,12 @@ use Friendica\Model\Contact;
use Friendica\Util\Proxy as ProxyUtils; use Friendica\Util\Proxy as ProxyUtils;
/** /**
* @brief This class handles methods related to the forum functionality * This class handles methods related to the forum functionality
*/ */
class ForumManager class ForumManager
{ {
/** /**
* @brief Function to list all forums a user is connected with * Function to list all forums a user is connected with
* *
* @param int $uid of the profile owner * @param int $uid of the profile owner
* @param boolean $lastitem Sort by lastitem * @param boolean $lastitem Sort by lastitem
@ -80,7 +80,7 @@ class ForumManager
/** /**
* @brief Forumlist widget * Forumlist widget
* *
* Sidebar widget to show subcribed friendica forums. If activated * Sidebar widget to show subcribed friendica forums. If activated
* in the settings, it appears at the notwork page sidebar * in the settings, it appears at the notwork page sidebar
@ -140,7 +140,7 @@ class ForumManager
} }
/** /**
* @brief Format forumlist as contact block * Format forumlist as contact block
* *
* This function is used to show the forumlist in * This function is used to show the forumlist in
* the advanced profile. * the advanced profile.
@ -184,7 +184,7 @@ class ForumManager
} }
/** /**
* @brief count unread forum items * count unread forum items
* *
* Count unread items of connected forums and private groups * Count unread items of connected forums and private groups
* *

1
src/Content/Nav.php
View file

@ -119,7 +119,6 @@ class Nav
/** /**
* Prepares a list of navigation links * Prepares a list of navigation links
* *
* @brief Prepares a list of navigation links
* @param App $a * @param App $a
* @return array Navigation links * @return array Navigation links
* string 'sitelocation' => The webbie (username@site.com) * string 'sitelocation' => The webbie (username@site.com)

11
src/Content/OEmbed.php
View file

@ -45,7 +45,7 @@ class OEmbed
} }
/** /**
* @brief Get data from an URL to embed its content. * Get data from an URL to embed its content.
* *
* @param string $embedurl The URL from which the data should be fetched. * @param string $embedurl The URL from which the data should be fetched.
* @param bool $no_rich_type If set to true rich type content won't be fetched. * @param bool $no_rich_type If set to true rich type content won't be fetched.
@ -297,7 +297,6 @@ class OEmbed
/** /**
* Determines if rich content OEmbed is allowed for the provided URL * Determines if rich content OEmbed is allowed for the provided URL
* *
* @brief Determines if rich content OEmbed is allowed for the provided URL
* @param string $url * @param string $url
* @return boolean * @return boolean
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -345,7 +344,7 @@ class OEmbed
} }
/** /**
* @brief Generates the iframe HTML for an oembed attachment. * Generates the iframe HTML for an oembed attachment.
* *
* Width and height are given by the remote, and are regularly too small for * Width and height are given by the remote, and are regularly too small for
* the generated iframe. * the generated iframe.
@ -378,11 +377,11 @@ class OEmbed
} }
/** /**
* Generates attribute search XPath string
*
* Generates an XPath query to select elements whose provided attribute contains * Generates an XPath query to select elements whose provided attribute contains
* the provided value in a space-separated list. * the provided value in a space-separated list.
* *
* @brief Generates attribute search XPath string
*
* @param string $attr Name of the attribute to seach * @param string $attr Name of the attribute to seach
* @param string $value Value to search in a space-separated list * @param string $value Value to search in a space-separated list
* @return string * @return string
@ -396,8 +395,6 @@ class OEmbed
/** /**
* Returns the inner XML string of a provided DOMNode * Returns the inner XML string of a provided DOMNode
* *
* @brief Returns the inner XML string of a provided DOMNode
*
* @param DOMNode $node * @param DOMNode $node
* @return string * @return string
*/ */

4
src/Content/Pager.php
View file

@ -124,7 +124,7 @@ class Pager
} }
/** /**
* @brief Minimal pager (newer/older) * Minimal pager (newer/older)
* *
* This mode is intended for reverse chronological pages and presents only two links, newer (previous) and older (next). * This mode is intended for reverse chronological pages and presents only two links, newer (previous) and older (next).
* The itemCount is the number of displayed items. If no items are displayed, the older button is disabled. * The itemCount is the number of displayed items. If no items are displayed, the older button is disabled.
@ -165,7 +165,7 @@ class Pager
} }
/** /**
* @brief Full pager (first / prev / 1 / 2 / ... / 14 / 15 / next / last) * Full pager (first / prev / 1 / 2 / ... / 14 / 15 / next / last)
* *
* This mode presents page numbers as well as first, previous, next and last links. * This mode presents page numbers as well as first, previous, next and last links.
* The itemCount is the total number of items including those not displayed. * The itemCount is the total number of items including those not displayed.

9
src/Content/Smilies.php
View file

@ -2,7 +2,7 @@
/** /**
* @file src/Content/Smilies.php * @file src/Content/Smilies.php
* @brief This file contains the Smilies class which contains functions to handle smiles * This file contains the Smilies class which contains functions to handle smiles
* *
* @todo Use the shortcodes from here: * @todo Use the shortcodes from here:
* https://github.com/iamcal/emoji-data/blob/master/emoji_pretty.json?raw=true * https://github.com/iamcal/emoji-data/blob/master/emoji_pretty.json?raw=true
@ -26,7 +26,7 @@ use Friendica\Util\Strings;
class Smilies class Smilies
{ {
/** /**
* @brief Replaces/adds the emoticon list * Replaces/adds the emoticon list
* *
* This function should be used whenever emoticons are added * This function should be used whenever emoticons are added
* *
@ -49,7 +49,7 @@ class Smilies
} }
/** /**
* @brief Function to list all smilies * Function to list all smilies
* *
* Get an array of all smilies, both internal and from addons. * Get an array of all smilies, both internal and from addons.
* *
@ -179,7 +179,6 @@ class Smilies
* function from being executed by the prepare_text() routine when preparing * function from being executed by the prepare_text() routine when preparing
* bbcode source for HTML display * bbcode source for HTML display
* *
* @brief Replaces text emoticons with graphical images
* @param string $s Text that should be replaced * @param string $s Text that should be replaced
* @param boolean $no_images Only replace emoticons without images * @param boolean $no_images Only replace emoticons without images
* *
@ -261,7 +260,7 @@ class Smilies
/** /**
* @brief expand <3333 to the correct number of hearts * expand <3333 to the correct number of hearts
* *
* @param string $x string * @param string $x string
* *

25
src/Content/Text/BBCode.php
View file

@ -35,7 +35,7 @@ use Friendica\Util\XML;
class BBCode class BBCode
{ {
/** /**
* @brief Fetches attachment data that were generated the old way * Fetches attachment data that were generated the old way
* *
* @param string $body Message body * @param string $body Message body
* @return array * @return array
@ -106,7 +106,7 @@ class BBCode
} }
/** /**
* @brief Fetches attachment data that were generated with the "attachment" element * Fetches attachment data that were generated with the "attachment" element
* *
* @param string $body Message body * @param string $body Message body
* @return array * @return array
@ -411,7 +411,7 @@ class BBCode
} }
/** /**
* @brief Converts a BBCode text into plaintext * Converts a BBCode text into plaintext
* *
* @param $text * @param $text
* @param bool $keep_urls Whether to keep URLs in the resulting plaintext * @param bool $keep_urls Whether to keep URLs in the resulting plaintext
@ -486,10 +486,11 @@ class BBCode
} }
/** /**
* Truncates imported message body string length to max_import_size
*
* The purpose of this function is to apply system message length limits to * The purpose of this function is to apply system message length limits to
* imported messages without including any embedded photos in the length * imported messages without including any embedded photos in the length
* *
* @brief Truncates imported message body string length to max_import_size
* @param string $body * @param string $body
* @return string * @return string
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -578,7 +579,6 @@ class BBCode
* *
* Note: Can produce a [bookmark] tag in the returned string * Note: Can produce a [bookmark] tag in the returned string
* *
* @brief Processes [attachment] tags
* @param string $text * @param string $text
* @param bool|int $simplehtml * @param bool|int $simplehtml
* @param bool $tryoembed * @param bool $tryoembed
@ -691,7 +691,6 @@ class BBCode
/** /**
* Converts [url] BBCodes in a format that looks fine on Mastodon. (callback function) * Converts [url] BBCodes in a format that looks fine on Mastodon. (callback function)
* *
* @brief Converts [url] BBCodes in a format that looks fine on Mastodon. (callback function)
* @param array $match Array with the matching values * @param array $match Array with the matching values
* @return string reformatted link including HTML codes * @return string reformatted link including HTML codes
*/ */
@ -712,7 +711,7 @@ class BBCode
} }
/** /**
* @brief Converts [url] BBCodes in a format that looks fine on ActivityPub systems. * Converts [url] BBCodes in a format that looks fine on ActivityPub systems.
* @param string $url URL that is about to be reformatted * @param string $url URL that is about to be reformatted
* @return string reformatted link including HTML codes * @return string reformatted link including HTML codes
*/ */
@ -1206,7 +1205,7 @@ class BBCode
} }
/** /**
* @brief Converts a BBCode message to HTML message * Converts a BBCode message to HTML message
* *
* BBcode 2 HTML was written by WAY2WEB.net * BBcode 2 HTML was written by WAY2WEB.net
* extended to work with Mistpark/Friendica - Mike Macgirvin * extended to work with Mistpark/Friendica - Mike Macgirvin
@ -1906,7 +1905,7 @@ class BBCode
} }
/** /**
* @brief Strips the "abstract" tag from the provided text * Strips the "abstract" tag from the provided text
* *
* @param string $text The text with BBCode * @param string $text The text with BBCode
* @return string The same text - but without "abstract" element * @return string The same text - but without "abstract" element
@ -1920,7 +1919,7 @@ class BBCode
} }
/** /**
* @brief Returns the value of the "abstract" element * Returns the value of the "abstract" element
* *
* @param string $text The text that maybe contains the element * @param string $text The text that maybe contains the element
* @param string $addon The addon for which the abstract is meant for * @param string $addon The addon for which the abstract is meant for
@ -1950,7 +1949,7 @@ class BBCode
} }
/** /**
* @brief Callback function to replace a Friendica style mention in a mention for Diaspora * Callback function to replace a Friendica style mention in a mention for Diaspora
* *
* @param array $match Matching values for the callback * @param array $match Matching values for the callback
* [1] = Mention type (! or @) * [1] = Mention type (! or @)
@ -1977,7 +1976,7 @@ class BBCode
} }
/** /**
* @brief Converts a BBCode text into Markdown * Converts a BBCode text into Markdown
* *
* This function converts a BBCode item body to be sent to Markdown-enabled * This function converts a BBCode item body to be sent to Markdown-enabled
* systems like Diaspora and Libertree * systems like Diaspora and Libertree
@ -2064,7 +2063,7 @@ class BBCode
} }
/** /**
* @brief Pull out all #hashtags and @person tags from $string. * Pull out all #hashtags and @person tags from $string.
* *
* We also get @person@domain.com - which would make * We also get @person@domain.com - which would make
* the regex quite complicated as tags can also * the regex quite complicated as tags can also

11
src/Content/Text/HTML.php
View file

@ -137,11 +137,12 @@ class HTML
} }
/** /**
* Converter for HTML to BBCode
*
* Made by: ike@piratenpartei.de * Made by: ike@piratenpartei.de
* Originally made for the syncom project: http://wiki.piratenpartei.de/Syncom * Originally made for the syncom project: http://wiki.piratenpartei.de/Syncom
* https://github.com/annando/Syncom * https://github.com/annando/Syncom
* *
* @brief Converter for HTML to BBCode
* @param string $message * @param string $message
* @param string $basepath * @param string $basepath
* @return string * @return string
@ -411,7 +412,7 @@ class HTML
} }
/** /**
* @brief Sub function to complete incomplete URL * Sub function to complete incomplete URL
* *
* @param array $matches Result of preg_replace_callback * @param array $matches Result of preg_replace_callback
* @param string $basepath Basepath that is used to complete the URL * @param string $basepath Basepath that is used to complete the URL
@ -438,7 +439,7 @@ class HTML
} }
/** /**
* @brief Complete incomplete URLs in BBCode * Complete incomplete URLs in BBCode
* *
* @param string $body Body with URLs * @param string $body Body with URLs
* @param string $basepath Base path that is used to complete the URL * @param string $basepath Base path that is used to complete the URL
@ -710,7 +711,7 @@ class HTML
} }
/** /**
* @brief Convert video HTML to BBCode tags * Convert video HTML to BBCode tags
* *
* @param string $s * @param string $s
* @return string * @return string
@ -820,7 +821,7 @@ class HTML
} }
/** /**
* @brief Format contacts as picture links or as text links * Format contacts as picture links or as text links
* *
* @param array $contact Array with contacts which contains an array with * @param array $contact Array with contacts which contains an array with
* int 'id' => The ID of the contact * int 'id' => The ID of the contact

3
src/Content/Text/Markdown.php
View file

@ -21,7 +21,6 @@ class Markdown
* Converts a Markdown string into HTML. The hardwrap parameter maximizes * Converts a Markdown string into HTML. The hardwrap parameter maximizes
* compatibility with Diaspora in spite of the Markdown standard. * compatibility with Diaspora in spite of the Markdown standard.
* *
* @brief Converts a Markdown string into HTML
* @param string $text * @param string $text
* @param bool $hardwrap * @param bool $hardwrap
* @return string * @return string
@ -49,7 +48,7 @@ class Markdown
} }
/** /**
* @brief Callback function to replace a Diaspora style mention in a mention for Friendica * Callback function to replace a Diaspora style mention in a mention for Friendica
* *
* @param array $match Matching values for the callback * @param array $match Matching values for the callback
* [1] = mention type (@ or !) * [1] = mention type (@ or !)

1
src/Content/Widget.php
View file

@ -411,7 +411,6 @@ class Widget
/** /**
* Insert a tag cloud widget for the present profile. * Insert a tag cloud widget for the present profile.
* *
* @brief Insert a tag cloud widget for the present profile.
* @param int $limit Max number of displayed tags. * @param int $limit Max number of displayed tags.
* @return string HTML formatted output. * @return string HTML formatted output.
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

2
src/Content/Widget/CalendarExport.php
View file

@ -19,7 +19,7 @@ use Friendica\DI;
class CalendarExport class CalendarExport
{ {
/** /**
* @brief Get the events widget. * Get the events widget.
* *
* @return string Formated HTML of the calendar widget. * @return string Formated HTML of the calendar widget.
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

5
src/Content/Widget/TagCloud.php
View file

@ -22,7 +22,6 @@ class TagCloud
/** /**
* Construct a tag/term cloud block for an user. * Construct a tag/term cloud block for an user.
* *
* @brief Construct a tag/term cloud block for an user.
* @param int $uid The user ID. * @param int $uid The user ID.
* @param int $count Max number of displayed tags/terms. * @param int $count Max number of displayed tags/terms.
* @param int $owner_id The contact ID of the owner of the tagged items. * @param int $owner_id The contact ID of the owner of the tagged items.
@ -62,8 +61,6 @@ class TagCloud
* Get alphabetical sorted array of used tags/terms of an user including * Get alphabetical sorted array of used tags/terms of an user including
* a weighting by frequency of use. * a weighting by frequency of use.
* *
* @brief Get alphabetical sorted array of used tags/terms of an user including
* a weighting by frequency of use.
* @param int $uid The user ID. * @param int $uid The user ID.
* @param int $count Max number of displayed tags/terms. * @param int $count Max number of displayed tags/terms.
* @param int $owner_id The contact id of the owner of the tagged items. * @param int $owner_id The contact id of the owner of the tagged items.
@ -112,7 +109,6 @@ class TagCloud
/** /**
* Calculate weighting of tags according to the frequency of use. * Calculate weighting of tags according to the frequency of use.
* *
* @brief Calculate weighting of tags according to the frequency of use.
* @param array $arr Array of tags/terms with tag/term name and total count of use. * @param array $arr Array of tags/terms with tag/term name and total count of use.
* @return array Alphabetical sorted array of used tags/terms of an user. * @return array Alphabetical sorted array of used tags/terms of an user.
*/ */
@ -149,7 +145,6 @@ class TagCloud
/** /**
* Compare function to sort tags/terms alphabetically. * Compare function to sort tags/terms alphabetically.
* *
* @brief Compare function to sort tags/terms alphabetically.
* @param string $a * @param string $a
* @param string $b * @param string $b
* *

8
src/Core/Addon.php
View file

@ -83,7 +83,7 @@ class Addon
/** /**
* @brief Synchronize addons: * Synchronize addons:
* *
* system.addon contains a comma-separated list of names * system.addon contains a comma-separated list of names
* of addons which are used on this system. * of addons which are used on this system.
@ -130,7 +130,7 @@ class Addon
} }
/** /**
* @brief uninstalls an addon. * uninstalls an addon.
* *
* @param string $addon name of the addon * @param string $addon name of the addon
* @return void * @return void
@ -157,7 +157,7 @@ class Addon
} }
/** /**
* @brief installs an addon. * installs an addon.
* *
* @param string $addon name of the addon * @param string $addon name of the addon
* @return bool * @return bool
@ -249,7 +249,7 @@ class Addon
} }
/** /**
* @brief Parse addon comment in search of addon infos. * Parse addon comment in search of addon infos.
* *
* like * like
* \code * \code

13
src/Core/Config.php
View file

@ -4,14 +4,14 @@
* *
* @file include/Core/Config.php * @file include/Core/Config.php
* *
* @brief Contains the class with methods for system configuration * Contains the class with methods for system configuration
*/ */
namespace Friendica\Core; namespace Friendica\Core;
use Friendica\DI; use Friendica\DI;
/** /**
* @brief Arbitrary system configuration storage * Arbitrary system configuration storage
* *
* Note: * Note:
* If we ever would decide to return exactly the variable type as entered, * If we ever would decide to return exactly the variable type as entered,
@ -20,7 +20,7 @@ use Friendica\DI;
class Config class Config
{ {
/** /**
* @brief Loads all configuration values of family into a cached storage. * Loads all configuration values of family into a cached storage.
* *
* @param string $cat The category of the configuration value * @param string $cat The category of the configuration value
* *
@ -32,8 +32,7 @@ class Config
} }
/** /**
* @brief Get a particular user's config variable given the category name * Get a particular user's config variable given the category name ($family) and a key.
* ($family) and a key.
* *
* @param string $cat The category of the configuration value * @param string $cat The category of the configuration value
* @param string $key The configuration key to query * @param string $key The configuration key to query
@ -48,8 +47,6 @@ class Config
} }
/** /**
* @brief Sets a configuration value for system config
*
* Stores a config value ($value) in the category ($cat) under the key ($key) * Stores a config value ($value) in the category ($cat) under the key ($key)
* *
* Note: Please do not store booleans - convert to 0/1 integer values! * Note: Please do not store booleans - convert to 0/1 integer values!
@ -66,7 +63,7 @@ class Config
} }
/** /**
* @brief Deletes the given key from the system configuration. * Deletes the given key from the system configuration.
* *
* @param string $cat The category of the configuration value * @param string $cat The category of the configuration value
* @param string $key The configuration key to delete * @param string $key The configuration key to delete

8
src/Core/Config/IConfiguration.php
View file

@ -9,7 +9,7 @@ interface IConfiguration
{ {
/** /**
* @brief Loads all configuration values of family into a cached storage. * Loads all configuration values of family into a cached storage.
* *
* All configuration values of the system are stored in the cache ( @see ConfigCache ) * All configuration values of the system are stored in the cache ( @see ConfigCache )
* *
@ -20,7 +20,7 @@ interface IConfiguration
function load(string $cat = 'config'); function load(string $cat = 'config');
/** /**
* @brief Get a particular user's config variable given the category name * Get a particular user's config variable given the category name
* ($cat) and a $key. * ($cat) and a $key.
* *
* Get a particular config value from the given category ($cat) * Get a particular config value from the given category ($cat)
@ -37,7 +37,7 @@ interface IConfiguration
function get(string $cat, string $key, $default_value = null, bool $refresh = false); function get(string $cat, string $key, $default_value = null, bool $refresh = false);
/** /**
* @brief Sets a configuration value for system config * Sets a configuration value for system config
* *
* Stores a config value ($value) in the category ($cat) under the key ($key) * Stores a config value ($value) in the category ($cat) under the key ($key)
* *
@ -52,7 +52,7 @@ interface IConfiguration
function set(string $cat, string $key, $value); function set(string $cat, string $key, $value);
/** /**
* @brief Deletes the given key from the system configuration. * Deletes the given key from the system configuration.
* *
* Removes the configured value from the stored cache in $this->configCache * Removes the configured value from the stored cache in $this->configCache
* (@see ConfigCache) and removes it from the database (@see IConfigAdapter). * (@see ConfigCache) and removes it from the database (@see IConfigAdapter).

10
src/Core/Hook.php
View file

@ -45,7 +45,7 @@ class Hook
} }
/** /**
* @brief Adds a new hook to the hooks array. * Adds a new hook to the hooks array.
* *
* This function is meant to be called by modules on each page load as it works after loadHooks has been called. * This function is meant to be called by modules on each page load as it works after loadHooks has been called.
* *
@ -62,7 +62,7 @@ class Hook
} }
/** /**
* @brief Registers a hook. * Registers a hook.
* *
* This function is meant to be called once when an addon is enabled for example as it doesn't add to the current hooks. * This function is meant to be called once when an addon is enabled for example as it doesn't add to the current hooks.
* *
@ -127,7 +127,7 @@ class Hook
} }
/** /**
* @brief Forks a hook. * Forks a hook.
* *
* Use this function when you want to fork a hook via the worker. * Use this function when you want to fork a hook via the worker.
* *
@ -162,7 +162,7 @@ class Hook
} }
/** /**
* @brief Calls a hook. * Calls a hook.
* *
* Use this function when you want to be able to allow a hook to manipulate * Use this function when you want to be able to allow a hook to manipulate
* the provided data. * the provided data.
@ -181,7 +181,7 @@ class Hook
} }
/** /**
* @brief Calls a single hook. * Calls a single hook.
* *
* @param App $a * @param App $a
* @param string $name of the hook to call * @param string $name of the hook to call

10
src/Core/L10n.php
View file

@ -36,7 +36,7 @@ class L10n
} }
/** /**
* @brief Return the localized version of the provided string with optional string interpolation * Return the localized version of the provided string with optional string interpolation
* *
* This function takes a english string as parameter, and if a localized version * This function takes a english string as parameter, and if a localized version
* exists for the current language, substitutes it before performing an eventual * exists for the current language, substitutes it before performing an eventual
@ -58,7 +58,7 @@ class L10n
} }
/** /**
* @brief Return the localized version of a singular/plural string with optional string interpolation * Return the localized version of a singular/plural string with optional string interpolation
* *
* This function takes two english strings as parameters, singular and plural, as * This function takes two english strings as parameters, singular and plural, as
* well as a count. If a localized version exists for the current language, they * well as a count. If a localized version exists for the current language, they
@ -83,7 +83,7 @@ class L10n
} }
/** /**
* @brief Return installed languages codes as associative array * Return installed languages codes as associative array
* *
* Scans the view/lang directory for the existence of "strings.php" files, and * Scans the view/lang directory for the existence of "strings.php" files, and
* returns an alphabetical list of their folder names (@-char language codes). * returns an alphabetical list of their folder names (@-char language codes).
@ -99,7 +99,7 @@ class L10n
} }
/** /**
* @brief Translate days and months names. * Translate days and months names.
* *
* @param string $s String with day or month name. * @param string $s String with day or month name.
* *
@ -111,7 +111,7 @@ class L10n
} }
/** /**
* @brief Translate short days and months names. * Translate short days and months names.
* *
* @param string $s String with short day or month name. * @param string $s String with short day or month name.
* *

6
src/Core/L10n/L10n.php
View file

@ -132,7 +132,7 @@ class L10n
} }
/** /**
* @brief Returns the preferred language from the HTTP_ACCEPT_LANGUAGE header * Returns the preferred language from the HTTP_ACCEPT_LANGUAGE header
* *
* @param string $sysLang The default fallback language * @param string $sysLang The default fallback language
* @param array $server The $_SERVER array * @param array $server The $_SERVER array
@ -210,7 +210,7 @@ class L10n
} }
/** /**
* @brief Return the localized version of the provided string with optional string interpolation * Return the localized version of the provided string with optional string interpolation
* *
* This function takes a english string as parameter, and if a localized version * This function takes a english string as parameter, and if a localized version
* exists for the current language, substitutes it before performing an eventual * exists for the current language, substitutes it before performing an eventual
@ -245,7 +245,7 @@ class L10n
} }
/** /**
* @brief Return the localized version of a singular/plural string with optional string interpolation * Return the localized version of a singular/plural string with optional string interpolation
* *
* This function takes two english strings as parameters, singular and plural, as * This function takes two english strings as parameters, singular and plural, as
* well as a count. If a localized version exists for the current language, they * well as a count. If a localized version exists for the current language, they

9
src/Core/Logger.php
View file

@ -10,7 +10,7 @@ use Psr\Log\LoggerInterface;
use Psr\Log\LogLevel; use Psr\Log\LogLevel;
/** /**
* @brief Logger functions * Logger functions
*/ */
class Logger class Logger
{ {
@ -231,8 +231,8 @@ class Logger
self::getWorker()->debug($message, $context); self::getWorker()->debug($message, $context);
} }
/** /**
* @brief Logs the given message at the given log level * Logs the given message at the given log level
* *
* @param string $msg * @param string $msg
* @param string $level * @param string $level
@ -246,7 +246,8 @@ class Logger
} }
/** /**
* @brief An alternative logger for development. * An alternative logger for development.
*
* Works largely as log() but allows developers * Works largely as log() but allows developers
* to isolate particular elements they are targetting * to isolate particular elements they are targetting
* personally without background noise * personally without background noise

6
src/Core/Process.php
View file

@ -46,7 +46,7 @@ final class Process
} }
/** /**
* @brief Checks if the maximum number of database processes is reached * Checks if the maximum number of database processes is reached
* *
* @return bool Is the limit reached? * @return bool Is the limit reached?
*/ */
@ -86,7 +86,7 @@ final class Process
} }
/** /**
* @brief Checks if the minimal memory is reached * Checks if the minimal memory is reached
* *
* @return bool Is the memory limit reached? * @return bool Is the memory limit reached?
*/ */
@ -130,7 +130,7 @@ final class Process
} }
/** /**
* @brief Checks if the maximum load is reached * Checks if the maximum load is reached
* *
* @return bool Is the load reached? * @return bool Is the load reached?
*/ */

18
src/Core/Renderer.php
View file

@ -11,22 +11,22 @@ use Friendica\Render\FriendicaSmarty;
use Friendica\Render\ITemplateEngine; use Friendica\Render\ITemplateEngine;
/** /**
* @brief This class handles Renderer related functions. * This class handles Renderer related functions.
*/ */
class Renderer class Renderer
{ {
/** /**
* @brief An array of registered template engines ('name'=>'class name') * An array of registered template engines ('name'=>'class name')
*/ */
public static $template_engines = []; public static $template_engines = [];
/** /**
* @brief An array of instanced template engines ('name'=>'instance') * An array of instanced template engines ('name'=>'instance')
*/ */
public static $template_engine_instance = []; public static $template_engine_instance = [];
/** /**
* @brief An array for all theme-controllable parameters * An array for all theme-controllable parameters
* *
* Mostly unimplemented yet. Only options 'template_engine' and * Mostly unimplemented yet. Only options 'template_engine' and
* beyond are used. * beyond are used.
@ -50,7 +50,7 @@ class Renderer
]; ];
/** /**
* @brief This is our template processor * This is our template processor
* *
* @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty * @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty
* @param array $vars Key value pairs (search => replace) * @param array $vars Key value pairs (search => replace)
@ -80,7 +80,7 @@ class Renderer
} }
/** /**
* @brief Load a given template $s * Load a given template $s
* *
* @param string $s Template to load. * @param string $s Template to load.
* @param string $root Optional. * @param string $root Optional.
@ -107,7 +107,7 @@ class Renderer
} }
/** /**
* @brief Register template engine class * Register template engine class
* *
* @param string $class * @param string $class
*/ */
@ -126,7 +126,7 @@ class Renderer
} }
/** /**
* @brief Return template engine instance. * Return template engine instance.
* *
* If $name is not defined, return engine defined by theme, * If $name is not defined, return engine defined by theme,
* or default * or default
@ -153,7 +153,7 @@ class Renderer
} }
/** /**
* @brief Returns the active template engine. * Returns the active template engine.
* *
* @return string the active template engine * @return string the active template engine
*/ */

1
src/Core/Search.php
View file

@ -245,7 +245,6 @@ class Search
/** /**
* Searching for global contacts for autocompletion * Searching for global contacts for autocompletion
* *
* @brief Searching for global contacts for autocompletion
* @param string $search Name or part of a name or nick * @param string $search Name or part of a name or nick
* @param string $mode Search mode (e.g. "community") * @param string $mode Search mode (e.g. "community")
* @param int $page Page number (starts at 1) * @param int $page Page number (starts at 1)

2
src/Core/Session/Handler/Cache.php
View file

@ -51,7 +51,7 @@ final class Cache implements SessionHandlerInterface
} }
/** /**
* @brief Standard PHP session write callback * Standard PHP session write callback
* *
* This callback updates the stored session data and/or the expiration depending * This callback updates the stored session data and/or the expiration depending
* on the case. Uses the Session::expire for existing session, 5 minutes * on the case. Uses the Session::expire for existing session, 5 minutes

2
src/Core/Session/Handler/Database.php
View file

@ -58,7 +58,7 @@ final class Database implements SessionHandlerInterface
} }
/** /**
* @brief Standard PHP session write callback * Standard PHP session write callback
* *
* This callback updates the DB-stored session data and/or the expiration depending * This callback updates the DB-stored session data and/or the expiration depending
* on the case. Uses the Session::expire global for existing session, 5 minutes * on the case. Uses the Session::expire global for existing session, 5 minutes

14
src/Core/StorageManager.php
View file

@ -11,7 +11,7 @@ use Psr\Log\LoggerInterface;
/** /**
* @brief Manage storage backends * Manage storage backends
* *
* Core code uses this class to get and set current storage backend class. * Core code uses this class to get and set current storage backend class.
* Addons use this class to register and unregister additional backends. * Addons use this class to register and unregister additional backends.
@ -67,7 +67,7 @@ class StorageManager
} }
/** /**
* @brief Return current storage backend class * Return current storage backend class
* *
* @return Storage\IStorage|null * @return Storage\IStorage|null
*/ */
@ -77,7 +77,7 @@ class StorageManager
} }
/** /**
* @brief Return storage backend class by registered name * Return storage backend class by registered name
* *
* @param string|null $name Backend name * @param string|null $name Backend name
* @param boolean $onlyUserBackend True, if just user specific instances should be returrned (e.g. not SystemResource) * @param boolean $onlyUserBackend True, if just user specific instances should be returrned (e.g. not SystemResource)
@ -163,7 +163,7 @@ class StorageManager
} }
/** /**
* @brief Set current storage backend class * Set current storage backend class
* *
* @param string $name Backend class name * @param string $name Backend class name
* *
@ -184,7 +184,7 @@ class StorageManager
} }
/** /**
* @brief Get registered backends * Get registered backends
* *
* @return array * @return array
*/ */
@ -222,7 +222,7 @@ class StorageManager
} }
/** /**
* @brief Unregister a storage backend class * Unregister a storage backend class
* *
* @param string $class Backend class name * @param string $class Backend class name
* *
@ -247,7 +247,7 @@ class StorageManager
} }
/** /**
* @brief Move up to 5000 resources to storage $dest * Move up to 5000 resources to storage $dest
* *
* Copy existing data to destination storage and delete from source. * Copy existing data to destination storage and delete from source.
* This method cannot move to legacy in-table `data` field. * This method cannot move to legacy in-table `data` field.

14
src/Core/System.php
View file

@ -11,17 +11,17 @@ use Friendica\Util\XML;
/** /**
* @file include/Core/System.php * @file include/Core/System.php
* *
* @brief Contains the class with system relevant stuff * Contains the class with system relevant stuff
*/ */
/** /**
* @brief System methods * System methods
*/ */
class System class System
{ {
/** /**
* @brief Returns a string with a callstack. Can be used for logging. * Returns a string with a callstack. Can be used for logging.
* @param integer $depth optional, default 4 * @param integer $depth optional, default 4
* @return string * @return string
*/ */
@ -93,7 +93,7 @@ class System
} }
/** /**
* @brief Send HTTP status header and exit. * Send HTTP status header and exit.
* *
* @param integer $val HTTP status result value * @param integer $val HTTP status result value
* @param string $message Error message. Optional. * @param string $message Error message. Optional.
@ -117,7 +117,7 @@ class System
} }
/** /**
* @brief Encodes content to json. * Encodes content to json.
* *
* This function encodes an array to json format * This function encodes an array to json format
* and adds an application/json HTTP header to the output. * and adds an application/json HTTP header to the output.
@ -227,7 +227,7 @@ class System
} }
/** /**
* @brief Returns the system user that is executing the script * Returns the system user that is executing the script
* *
* This mostly returns something like "www-data". * This mostly returns something like "www-data".
* *
@ -244,7 +244,7 @@ class System
} }
/** /**
* @brief Checks if a given directory is usable for the system * Checks if a given directory is usable for the system
* *
* @param $directory * @param $directory
* @param bool $check_writable * @param bool $check_writable

8
src/Core/Theme.php
View file

@ -40,7 +40,7 @@ class Theme
} }
/** /**
* @brief Parse theme comment in search of theme infos. * Parse theme comment in search of theme infos.
* *
* like * like
* \code * \code
@ -110,7 +110,7 @@ class Theme
} }
/** /**
* @brief Returns the theme's screenshot. * Returns the theme's screenshot.
* *
* The screenshot is expected as view/theme/$theme/screenshot.[png|jpg]. * The screenshot is expected as view/theme/$theme/screenshot.[png|jpg].
* *
@ -182,7 +182,7 @@ class Theme
} }
/** /**
* @brief Get the full path to relevant theme files by filename * Get the full path to relevant theme files by filename
* *
* This function searches in order in the current theme directory, in the current theme parent directory, and lastly * This function searches in order in the current theme directory, in the current theme parent directory, and lastly
* in the base view/ folder. * in the base view/ folder.
@ -215,7 +215,7 @@ class Theme
} }
/** /**
* @brief Return relative path to theme stylesheet file * Return relative path to theme stylesheet file
* *
* Provide a sane default if nothing is chosen or the specified theme does not exist. * Provide a sane default if nothing is chosen or the specified theme does not exist.
* *

2
src/Core/Update.php
View file

@ -14,7 +14,7 @@ class Update
const FAILED = 1; const FAILED = 1;
/** /**
* @brief Function to check if the Database structure needs an update. * Function to check if the Database structure needs an update.
* *
* @param string $basePath The base path of this application * @param string $basePath The base path of this application
* @param boolean $via_worker Is the check run via the worker? * @param boolean $via_worker Is the check run via the worker?

4
src/Core/UserImport.php
View file

@ -14,7 +14,7 @@ use Friendica\Util\Strings;
use Friendica\Worker\Delivery; use Friendica\Worker\Delivery;
/** /**
* @brief UserImport class * UserImport class
*/ */
class UserImport class UserImport
{ {
@ -84,7 +84,7 @@ class UserImport
} }
/** /**
* @brief Import account file exported from mod/uexport * Import account file exported from mod/uexport
* *
* @param array $file array from $_FILES * @param array $file array from $_FILES
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

57
src/Core/Worker.php
View file

@ -14,11 +14,11 @@ use Friendica\Util\Network;
/** /**
* @file src/Core/Worker.php * @file src/Core/Worker.php
* *
* @brief Contains the class for the worker background job processing * Contains the class for the worker background job processing
*/ */
/** /**
* @brief Worker methods * Worker methods
*/ */
class Worker class Worker
{ {
@ -40,7 +40,7 @@ class Worker
private static $state; private static $state;
/** /**
* @brief Processes the tasks that are in the workerqueue table * Processes the tasks that are in the workerqueue table
* *
* @param boolean $run_cron Should the cron processes be executed? * @param boolean $run_cron Should the cron processes be executed?
* @return void * @return void
@ -163,7 +163,7 @@ class Worker
} }
/** /**
* @brief Check if non executed tasks do exist in the worker queue * Check if non executed tasks do exist in the worker queue
* *
* @return boolean Returns "true" if tasks are existing * @return boolean Returns "true" if tasks are existing
* @throws \Exception * @throws \Exception
@ -177,7 +177,7 @@ class Worker
} }
/** /**
* @brief Returns the number of deferred entries in the worker queue * Returns the number of deferred entries in the worker queue
* *
* @return integer Number of deferred entries in the worker queue * @return integer Number of deferred entries in the worker queue
* @throws \Exception * @throws \Exception
@ -192,7 +192,7 @@ class Worker
} }
/** /**
* @brief Returns the number of non executed entries in the worker queue * Returns the number of non executed entries in the worker queue
* *
* @return integer Number of non executed entries in the worker queue * @return integer Number of non executed entries in the worker queue
* @throws \Exception * @throws \Exception
@ -207,7 +207,7 @@ class Worker
} }
/** /**
* @brief Returns the highest priority in the worker queue that isn't executed * Returns the highest priority in the worker queue that isn't executed
* *
* @return integer Number of active worker processes * @return integer Number of active worker processes
* @throws \Exception * @throws \Exception
@ -226,7 +226,7 @@ class Worker
} }
/** /**
* @brief Returns if a process with the given priority is running * Returns if a process with the given priority is running
* *
* @param integer $priority The priority that should be checked * @param integer $priority The priority that should be checked
* *
@ -240,7 +240,7 @@ class Worker
} }
/** /**
* @brief Execute a worker entry * Execute a worker entry
* *
* @param array $queue Workerqueue entry * @param array $queue Workerqueue entry
* *
@ -359,7 +359,7 @@ class Worker
} }
/** /**
* @brief Execute a function from the queue * Execute a function from the queue
* *
* @param array $queue Workerqueue entry * @param array $queue Workerqueue entry
* @param string $funcname name of the function * @param string $funcname name of the function
@ -450,7 +450,7 @@ class Worker
} }
/** /**
* @brief Checks if the number of database connections has reached a critical limit. * Checks if the number of database connections has reached a critical limit.
* *
* @return bool Are more than 3/4 of the maximum connections used? * @return bool Are more than 3/4 of the maximum connections used?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -533,7 +533,7 @@ class Worker
} }
/** /**
* @brief fix the queue entry if the worker process died * fix the queue entry if the worker process died
* @return void * @return void
* @throws \Exception * @throws \Exception
*/ */
@ -605,7 +605,7 @@ class Worker
} }
/** /**
* @brief Checks if the number of active workers exceeds the given limits * Checks if the number of active workers exceeds the given limits
* *
* @return bool Are there too much workers running? * @return bool Are there too much workers running?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -735,7 +735,7 @@ class Worker
} }
/** /**
* @brief Returns the number of active worker processes * Returns the number of active worker processes
* *
* @return integer Number of active worker processes * @return integer Number of active worker processes
* @throws \Exception * @throws \Exception
@ -749,7 +749,7 @@ class Worker
} }
/** /**
* @brief Returns waiting jobs for the current process id * Returns waiting jobs for the current process id
* *
* @return array waiting workerqueue jobs * @return array waiting workerqueue jobs
* @throws \Exception * @throws \Exception
@ -768,7 +768,7 @@ class Worker
} }
/** /**
* @brief Returns the next jobs that should be executed * Returns the next jobs that should be executed
* *
* @return array array with next jobs * @return array array with next jobs
* @throws \Exception * @throws \Exception
@ -803,7 +803,7 @@ class Worker
} }
/** /**
* @brief Returns the priority of the next workerqueue job * Returns the priority of the next workerqueue job
* *
* @return string priority * @return string priority
* @throws \Exception * @throws \Exception
@ -876,7 +876,7 @@ class Worker
} }
/** /**
* @brief Find and claim the next worker process for us * Find and claim the next worker process for us
* *
* @return boolean Have we found something? * @return boolean Have we found something?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -919,7 +919,7 @@ class Worker
} }
/** /**
* @brief Returns the next worker process * Returns the next worker process
* *
* @return string SQL statement * @return string SQL statement
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -952,7 +952,7 @@ class Worker
} }
/** /**
* @brief Removes a workerqueue entry from the current process * Removes a workerqueue entry from the current process
* @return void * @return void
* @throws \Exception * @throws \Exception
*/ */
@ -967,7 +967,7 @@ class Worker
} }
/** /**
* @brief Call the front end worker * Call the front end worker
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
@ -982,7 +982,7 @@ class Worker
} }
/** /**
* @brief Call the front end worker if there aren't any active * Call the front end worker if there aren't any active
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
@ -1033,7 +1033,7 @@ class Worker
} }
/** /**
* @brief Removes long running worker processes * Removes long running worker processes
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
@ -1051,7 +1051,7 @@ class Worker
} }
/** /**
* @brief Runs the cron processes * Runs the cron processes
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
@ -1070,7 +1070,7 @@ class Worker
} }
/** /**
* @brief Spawns a new worker * Spawns a new worker
* @param bool $do_cron * @param bool $do_cron
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -1092,7 +1092,7 @@ class Worker
} }
/** /**
* @brief Adds tasks to the worker queue * Adds tasks to the worker queue
* *
* @param (integer|array) priority or parameter array, strings are deprecated and are ignored * @param (integer|array) priority or parameter array, strings are deprecated and are ignored
* *
@ -1272,8 +1272,6 @@ class Worker
/** /**
* Log active processes into the "process" table * Log active processes into the "process" table
*
* @brief Log active processes into the "process" table
*/ */
public static function startProcess() public static function startProcess()
{ {
@ -1289,7 +1287,6 @@ class Worker
/** /**
* Remove the active process from the "process" table * Remove the active process from the "process" table
* *
* @brief Remove the active process from the "process" table
* @return bool * @return bool
* @throws \Exception * @throws \Exception
*/ */
@ -1301,7 +1298,6 @@ class Worker
/** /**
* Set the flag if some job is waiting * Set the flag if some job is waiting
* *
* @brief Set the flag if some job is waiting
* @param boolean $jobs Is there a waiting job? * @param boolean $jobs Is there a waiting job?
* @throws \Exception * @throws \Exception
*/ */
@ -1316,7 +1312,6 @@ class Worker
/** /**
* Checks if some worker job waits to be executed * Checks if some worker job waits to be executed
* *
* @brief Checks if some worker job waits to be executed
* @return bool * @return bool
* @throws \Exception * @throws \Exception
*/ */

6
src/Database/DBA.php
View file

@ -207,7 +207,6 @@ class DBA
* *
* Please use DBA::selectFirst or DBA::exists whenever this is possible. * Please use DBA::selectFirst or DBA::exists whenever this is possible.
* *
* @brief Fetches the first row
* @param string $sql SQL statement * @param string $sql SQL statement
* @return array first row of query * @return array first row of query
* @throws \Exception * @throws \Exception
@ -360,7 +359,9 @@ class DBA
} }
/** /**
* Updates rows in the database. When $old_fields is set to an array, * Updates rows in the database.
*
* When $old_fields is set to an array,
* the system will only do an update if the fields in that array changed. * the system will only do an update if the fields in that array changed.
* *
* Attention: * Attention:
@ -378,7 +379,6 @@ class DBA
* Only set $old_fields to a boolean value when you are sure that you will update a single row. * Only set $old_fields to a boolean value when you are sure that you will update a single row.
* When you set $old_fields to "true" then $fields must contain all relevant fields! * When you set $old_fields to "true" then $fields must contain all relevant fields!
* *
* @brief Updates rows
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $fields contains the fields that are updated * @param array $fields contains the fields that are updated
* @param array $condition condition array with the key values * @param array $condition condition array with the key values

4
src/Database/DBStructure.php
View file

@ -15,8 +15,6 @@ use Friendica\Util\DateTimeFormat;
require_once __DIR__ . '/../../include/dba.php'; require_once __DIR__ . '/../../include/dba.php';
/** /**
* @brief This class contain functions for the database management
*
* This class contains functions that doesn't need to know if pdo, mysqli or whatever is used. * This class contains functions that doesn't need to know if pdo, mysqli or whatever is used.
*/ */
class DBStructure class DBStructure
@ -63,7 +61,7 @@ class DBStructure
} }
/** /**
* @brief Print out database error messages * Print out database error messages
* *
* @param string $message Message to be added to the error message * @param string $message Message to be added to the error message
* *

70
src/Database/Database.php
View file

@ -226,7 +226,7 @@ class Database
} }
/** /**
* @brief Returns the MySQL server version string * Returns the MySQL server version string
* *
* This function discriminate between the deprecated mysql API and the current * This function discriminate between the deprecated mysql API and the current
* object-oriented mysqli API. Example of returned string: 5.5.46-0+deb8u1 * object-oriented mysqli API. Example of returned string: 5.5.46-0+deb8u1
@ -249,7 +249,7 @@ class Database
} }
/** /**
* @brief Returns the selected database name * Returns the selected database name
* *
* @return string * @return string
* @throws \Exception * @throws \Exception
@ -262,7 +262,7 @@ class Database
} }
/** /**
* @brief Analyze a database query and log this if some conditions are met. * Analyze a database query and log this if some conditions are met.
* *
* @param string $query The database query that will be analyzed * @param string $query The database query that will be analyzed
* *
@ -378,8 +378,8 @@ class Database
} }
/** /**
* @brief Replaces ANY_VALUE() function by MIN() function, * Replaces ANY_VALUE() function by MIN() function,
* if the database server does not support ANY_VALUE(). * if the database server does not support ANY_VALUE().
* *
* Considerations for Standard SQL, or MySQL with ONLY_FULL_GROUP_BY (default since 5.7.5). * Considerations for Standard SQL, or MySQL with ONLY_FULL_GROUP_BY (default since 5.7.5).
* ANY_VALUE() is available from MySQL 5.7.5 https://dev.mysql.com/doc/refman/5.7/en/miscellaneous-functions.html * ANY_VALUE() is available from MySQL 5.7.5 https://dev.mysql.com/doc/refman/5.7/en/miscellaneous-functions.html
@ -400,7 +400,7 @@ class Database
} }
/** /**
* @brief Replaces the ? placeholders with the parameters in the $args array * Replaces the ? placeholders with the parameters in the $args array
* *
* @param string $sql SQL query * @param string $sql SQL query
* @param array $args The parameters that are to replace the ? placeholders * @param array $args The parameters that are to replace the ? placeholders
@ -427,7 +427,7 @@ class Database
} }
/** /**
* @brief Executes a prepared statement that returns data * Executes a prepared statement that returns data
* @usage Example: $r = p("SELECT * FROM `item` WHERE `guid` = ?", $guid); * @usage Example: $r = p("SELECT * FROM `item` WHERE `guid` = ?", $guid);
* *
* Please only use it with complicated queries. * Please only use it with complicated queries.
@ -667,7 +667,7 @@ class Database
} }
/** /**
* @brief Executes a prepared statement like UPDATE or INSERT that doesn't return data * Executes a prepared statement like UPDATE or INSERT that doesn't return data
* *
* Please use DBA::delete, DBA::insert, DBA::update, ... instead * Please use DBA::delete, DBA::insert, DBA::update, ... instead
* *
@ -733,7 +733,7 @@ class Database
} }
/** /**
* @brief Check if data exists * Check if data exists
* *
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $condition array of fields for condition * @param array $condition array of fields for condition
@ -777,7 +777,7 @@ class Database
* *
* Please use DBA::selectFirst or DBA::exists whenever this is possible. * Please use DBA::selectFirst or DBA::exists whenever this is possible.
* *
* @brief Fetches the first row * Fetches the first row
* *
* @param string $sql SQL statement * @param string $sql SQL statement
* *
@ -802,7 +802,7 @@ class Database
} }
/** /**
* @brief Returns the number of affected rows of the last statement * Returns the number of affected rows of the last statement
* *
* @return int Number of rows * @return int Number of rows
*/ */
@ -812,7 +812,7 @@ class Database
} }
/** /**
* @brief Returns the number of columns of a statement * Returns the number of columns of a statement
* *
* @param object Statement object * @param object Statement object
* *
@ -833,7 +833,7 @@ class Database
} }
/** /**
* @brief Returns the number of rows of a statement * Returns the number of rows of a statement
* *
* @param PDOStatement|mysqli_result|mysqli_stmt Statement object * @param PDOStatement|mysqli_result|mysqli_stmt Statement object
* *
@ -854,7 +854,7 @@ class Database
} }
/** /**
* @brief Fetch a single row * Fetch a single row
* *
* @param mixed $stmt statement object * @param mixed $stmt statement object
* *
@ -914,7 +914,7 @@ class Database
} }
/** /**
* @brief Insert a row into a table * Insert a row into a table
* *
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $param parameter array * @param array $param parameter array
@ -951,7 +951,7 @@ class Database
} }
/** /**
* @brief Fetch the id of the last insert command * Fetch the id of the last insert command
* *
* @return integer Last inserted id * @return integer Last inserted id
*/ */
@ -969,7 +969,7 @@ class Database
} }
/** /**
* @brief Locks a table for exclusive write access * Locks a table for exclusive write access
* *
* This function can be extended in the future to accept a table array as well. * This function can be extended in the future to accept a table array as well.
* *
@ -1007,7 +1007,7 @@ class Database
} }
/** /**
* @brief Unlocks all locked tables * Unlocks all locked tables
* *
* @return boolean was the unlock successful? * @return boolean was the unlock successful?
* @throws \Exception * @throws \Exception
@ -1035,7 +1035,7 @@ class Database
} }
/** /**
* @brief Starts a transaction * Starts a transaction
* *
* @return boolean Was the command executed successfully? * @return boolean Was the command executed successfully?
*/ */
@ -1081,7 +1081,7 @@ class Database
} }
/** /**
* @brief Does a commit * Does a commit
* *
* @return boolean Was the command executed successfully? * @return boolean Was the command executed successfully?
*/ */
@ -1095,7 +1095,7 @@ class Database
} }
/** /**
* @brief Does a rollback * Does a rollback
* *
* @return boolean Was the command executed successfully? * @return boolean Was the command executed successfully?
*/ */
@ -1121,7 +1121,7 @@ class Database
} }
/** /**
* @brief Build the array with the table relations * Build the array with the table relations
* *
* The array is build from the database definitions in DBStructure.php * The array is build from the database definitions in DBStructure.php
* *
@ -1143,7 +1143,7 @@ class Database
} }
/** /**
* @brief Delete a row from a table * Delete a row from a table
* *
* Note: this methods does NOT accept schema => table arrays because of the complex relation stuff. * Note: this methods does NOT accept schema => table arrays because of the complex relation stuff.
* *
@ -1292,7 +1292,7 @@ class Database
} }
/** /**
* @brief Updates rows * Updates rows
* *
* Updates rows in the database. When $old_fields is set to an array, * Updates rows in the database. When $old_fields is set to an array,
* the system will only do an update if the fields in that array changed. * the system will only do an update if the fields in that array changed.
@ -1374,8 +1374,6 @@ class Database
/** /**
* Retrieve a single record from a table and returns it in an associative array * Retrieve a single record from a table and returns it in an associative array
* *
* @brief Retrieve a single record from a table
*
* @param string|array $table * @param string|array $table
* @param array $fields * @param array $fields
* @param array $condition * @param array $condition
@ -1400,7 +1398,7 @@ class Database
} }
/** /**
* @brief Select rows from a table and fills an array with the data * Select rows from a table and fills an array with the data
* *
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
@ -1417,7 +1415,7 @@ class Database
} }
/** /**
* @brief Select rows from a table * Select rows from a table
* *
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
@ -1465,7 +1463,7 @@ class Database
} }
/** /**
* @brief Counts the rows from a table satisfying the provided condition * Counts the rows from a table satisfying the provided condition
* *
* @param string|array $table Table name or array [schema => table] * @param string|array $table Table name or array [schema => table]
* @param array $condition Array of fields for condition * @param array $condition Array of fields for condition
@ -1509,7 +1507,7 @@ class Database
} }
/** /**
* @brief Fills an array with data from a query * Fills an array with data from a query
* *
* @param object $stmt statement object * @param object $stmt statement object
* @param bool $do_close * @param bool $do_close
@ -1535,7 +1533,7 @@ class Database
} }
/** /**
* @brief Returns the error number of the last query * Returns the error number of the last query
* *
* @return string Error number (0 if no error) * @return string Error number (0 if no error)
*/ */
@ -1545,7 +1543,7 @@ class Database
} }
/** /**
* @brief Returns the error message of the last query * Returns the error message of the last query
* *
* @return string Error message ('' if no error) * @return string Error message ('' if no error)
*/ */
@ -1555,7 +1553,7 @@ class Database
} }
/** /**
* @brief Closes the current statement * Closes the current statement
* *
* @param object $stmt statement object * @param object $stmt statement object
* *
@ -1596,7 +1594,7 @@ class Database
} }
/** /**
* @brief Return a list of database processes * Return a list of database processes
* *
* @return array * @return array
* 'list' => List of processes, separated in their different states * 'list' => List of processes, separated in their different states
@ -1652,7 +1650,7 @@ class Database
} }
/** /**
* @brief Callback function for "esc_array" * Callback function for "esc_array"
* *
* @param mixed $value Array value * @param mixed $value Array value
* @param string $key Array key * @param string $key Array key
@ -1681,7 +1679,7 @@ class Database
} }
/** /**
* @brief Escapes a whole array * Escapes a whole array
* *
* @param mixed $arr Array with values to be escaped * @param mixed $arr Array with values to be escaped
* @param boolean $add_quotation add quotation marks for string values * @param boolean $add_quotation add quotation marks for string values

12
src/Database/PostUpdate.php
View file

@ -19,7 +19,7 @@ use Friendica\Model\PermissionSet;
class PostUpdate class PostUpdate
{ {
/** /**
* @brief Calls the post update functions * Calls the post update functions
*/ */
public static function update() public static function update()
{ {
@ -49,7 +49,7 @@ class PostUpdate
} }
/** /**
* @brief Updates the "global" field in the item table * Updates the "global" field in the item table
* *
* @return bool "true" when the job is done * @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -118,7 +118,7 @@ class PostUpdate
} }
/** /**
* @brief update the "last-item" field in the "self" contact * update the "last-item" field in the "self" contact
* *
* This field avoids cost intensive calls in the admin panel and in "nodeinfo" * This field avoids cost intensive calls in the admin panel and in "nodeinfo"
* *
@ -153,7 +153,7 @@ class PostUpdate
} }
/** /**
* @brief update the item related tables * update the item related tables
* *
* @return bool "true" when the job is done * @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -305,7 +305,7 @@ class PostUpdate
} }
/** /**
* @brief update item-uri data. Prerequisite for the next item structure update. * update item-uri data. Prerequisite for the next item structure update.
* *
* @return bool "true" when the job is done * @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -459,7 +459,7 @@ class PostUpdate
} }
/** /**
* @brief update user-item data with notifications * update user-item data with notifications
* *
* @return bool "true" when the job is done * @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

2
src/Factory/LockFactory.php
View file

@ -87,7 +87,7 @@ class LockFactory
} }
/** /**
* @brief This method tries to find the best - local - locking method for Friendica * This method tries to find the best - local - locking method for Friendica
* *
* The following sequence will be tried: * The following sequence will be tried:
* 1. Semaphore Locking * 1. Semaphore Locking

24
src/Model/Attach.php
View file

@ -2,7 +2,7 @@
/** /**
* @file src/Model/Attach.php * @file src/Model/Attach.php
* @brief This file contains the Attach class for database interface * This file contains the Attach class for database interface
*/ */
namespace Friendica\Model; namespace Friendica\Model;
@ -22,7 +22,7 @@ class Attach
{ {
/** /**
* @brief Return a list of fields that are associated with the attach table * Return a list of fields that are associated with the attach table
* *
* @return array field list * @return array field list
* @throws \Exception * @throws \Exception
@ -36,7 +36,7 @@ class Attach
} }
/** /**
* @brief Select rows from the attach table and return them as array * Select rows from the attach table and return them as array
* *
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
* @param array $conditions Array of fields for conditions * @param array $conditions Array of fields for conditions
@ -57,7 +57,7 @@ class Attach
} }
/** /**
* @brief Retrieve a single record from the attach table * Retrieve a single record from the attach table
* *
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
* @param array $conditions Array of fields for conditions * @param array $conditions Array of fields for conditions
@ -78,7 +78,7 @@ class Attach
} }
/** /**
* @brief Check if attachment with given conditions exists * Check if attachment with given conditions exists
* *
* @param array $conditions Array of extra conditions * @param array $conditions Array of extra conditions
* *
@ -91,7 +91,7 @@ class Attach
} }
/** /**
* @brief Retrive a single record given the ID * Retrive a single record given the ID
* *
* @param int $id Row id of the record * @param int $id Row id of the record
* *
@ -106,7 +106,7 @@ class Attach
} }
/** /**
* @brief Retrive a single record given the ID * Retrive a single record given the ID
* *
* @param int $id Row id of the record * @param int $id Row id of the record
* *
@ -135,7 +135,7 @@ class Attach
} }
/** /**
* @brief Get file data for given row id. null if row id does not exist * Get file data for given row id. null if row id does not exist
* *
* @param array $item Attachment data. Needs at least 'id', 'backend-class', 'backend-ref' * @param array $item Attachment data. Needs at least 'id', 'backend-class', 'backend-ref'
* *
@ -159,7 +159,7 @@ class Attach
} }
/** /**
* @brief Store new file metadata in db and binary in default backend * Store new file metadata in db and binary in default backend
* *
* @param string $data Binary data * @param string $data Binary data
* @param integer $uid User ID * @param integer $uid User ID
@ -215,7 +215,7 @@ class Attach
} }
/** /**
* @brief Store new file metadata in db and binary in default backend from existing file * Store new file metadata in db and binary in default backend from existing file
* *
* @param $src * @param $src
* @param $uid * @param $uid
@ -240,7 +240,7 @@ class Attach
/** /**
* @brief Update an attached file * Update an attached file
* *
* @param array $fields Contains the fields that are updated * @param array $fields Contains the fields that are updated
* @param array $conditions Condition array with the key values * @param array $conditions Condition array with the key values
@ -275,7 +275,7 @@ class Attach
/** /**
* @brief Delete info from table and data from storage * Delete info from table and data from storage
* *
* @param array $conditions Field condition(s) * @param array $conditions Field condition(s)
* @param array $options Options array, Optional * @param array $options Options array, Optional

84
src/Model/Contact.php
View file

@ -29,7 +29,7 @@ use Friendica\Util\Network;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief functions for interacting with a contact * functions for interacting with a contact
*/ */
class Contact class Contact
{ {
@ -174,7 +174,7 @@ class Contact
} }
/** /**
* @brief Tests if the given contact is a follower * Tests if the given contact is a follower
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -199,7 +199,7 @@ class Contact
} }
/** /**
* @brief Tests if the given contact url is a follower * Tests if the given contact url is a follower
* *
* @param string $url Contact URL * @param string $url Contact URL
* @param int $uid User ID * @param int $uid User ID
@ -220,7 +220,7 @@ class Contact
} }
/** /**
* @brief Tests if the given user follow the given contact * Tests if the given user follow the given contact
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -245,7 +245,7 @@ class Contact
} }
/** /**
* @brief Tests if the given user follow the given contact url * Tests if the given user follow the given contact url
* *
* @param string $url Contact URL * @param string $url Contact URL
* @param int $uid User ID * @param int $uid User ID
@ -266,7 +266,7 @@ class Contact
} }
/** /**
* @brief Get the basepath for a given contact link * Get the basepath for a given contact link
* *
* @param string $url The contact link * @param string $url The contact link
* @param boolean $dont_update Don't update the contact * @param boolean $dont_update Don't update the contact
@ -355,7 +355,7 @@ class Contact
} }
/** /**
* @brief Returns the contact id for the user and the public contact id for a given contact id * Returns the contact id for the user and the public contact id for a given contact id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -417,7 +417,7 @@ class Contact
} }
/** /**
* @brief Block contact id for user id * Block contact id for user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -439,7 +439,7 @@ class Contact
} }
/** /**
* @brief Returns "block" state for contact id and user id * Returns "block" state for contact id and user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -480,7 +480,7 @@ class Contact
} }
/** /**
* @brief Ignore contact id for user id * Ignore contact id for user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -502,7 +502,7 @@ class Contact
} }
/** /**
* @brief Returns "ignore" state for contact id and user id * Returns "ignore" state for contact id and user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -543,7 +543,7 @@ class Contact
} }
/** /**
* @brief Set "collapsed" for contact id and user id * Set "collapsed" for contact id and user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -561,7 +561,7 @@ class Contact
} }
/** /**
* @brief Returns "collapsed" state for contact id and user id * Returns "collapsed" state for contact id and user id
* *
* @param int $cid Either public contact id or user's contact id * @param int $cid Either public contact id or user's contact id
* @param int $uid User ID * @param int $uid User ID
@ -590,7 +590,7 @@ class Contact
} }
/** /**
* @brief Returns a list of contacts belonging in a group * Returns a list of contacts belonging in a group
* *
* @param int $gid * @param int $gid
* @return array * @return array
@ -625,7 +625,7 @@ class Contact
} }
/** /**
* @brief Returns the count of OStatus contacts in a group * Returns the count of OStatus contacts in a group
* *
* @param int $gid * @param int $gid
* @return int * @return int
@ -807,7 +807,7 @@ class Contact
} }
/** /**
* @brief Marks a contact for removal * Marks a contact for removal
* *
* @param int $id contact id * @param int $id contact id
* @return null * @return null
@ -829,7 +829,7 @@ class Contact
} }
/** /**
* @brief Sends an unfriend message. Does not remove the contact * Sends an unfriend message. Does not remove the contact
* *
* @param array $user User unfriending * @param array $user User unfriending
* @param array $contact Contact unfriended * @param array $contact Contact unfriended
@ -878,7 +878,7 @@ class Contact
} }
/** /**
* @brief Marks a contact for archival after a communication issue delay * Marks a contact for archival after a communication issue delay
* *
* Contact has refused to recognise us as a friend. We will start a countdown. * Contact has refused to recognise us as a friend. We will start a countdown.
* If they still don't recognise us in 32 days, the relationship is over, * If they still don't recognise us in 32 days, the relationship is over,
@ -936,7 +936,7 @@ class Contact
} }
/** /**
* @brief Cancels the archival countdown * Cancels the archival countdown
* *
* @see Contact::markForArchival() * @see Contact::markForArchival()
* *
@ -979,7 +979,7 @@ class Contact
} }
/** /**
* @brief Get contact data for a given profile link * Get contact data for a given profile link
* *
* The function looks at several places (contact table and gcontact table) for the contact * The function looks at several places (contact table and gcontact table) for the contact
* It caches its result for the same script execution to prevent duplicate calls * It caches its result for the same script execution to prevent duplicate calls
@ -1126,7 +1126,7 @@ class Contact
} }
/** /**
* @brief Get contact data for a given address * Get contact data for a given address
* *
* The function looks at several places (contact table and gcontact table) for the contact * The function looks at several places (contact table and gcontact table) for the contact
* *
@ -1184,7 +1184,7 @@ class Contact
} }
/** /**
* @brief Returns the data array for the photo menu of a given contact * Returns the data array for the photo menu of a given contact
* *
* @param array $contact contact * @param array $contact contact
* @param int $uid optional, default 0 * @param int $uid optional, default 0
@ -1313,7 +1313,7 @@ class Contact
} }
/** /**
* @brief Returns ungrouped contact count or list for user * Returns ungrouped contact count or list for user
* *
* Returns either the total number of ungrouped contacts for the given user * Returns either the total number of ungrouped contacts for the given user
* id or a paginated list of ungrouped contacts. * id or a paginated list of ungrouped contacts.
@ -1424,7 +1424,7 @@ class Contact
} }
/** /**
* @brief Fetch the contact id for a given URL and user * Fetch the contact id for a given URL and user
* *
* First lookup in the contact table to find a record matching either `url`, `nurl`, * First lookup in the contact table to find a record matching either `url`, `nurl`,
* `addr` or `alias`. * `addr` or `alias`.
@ -1662,7 +1662,7 @@ class Contact
} }
/** /**
* @brief Checks if the contact is archived * Checks if the contact is archived
* *
* @param int $cid contact id * @param int $cid contact id
* *
@ -1706,7 +1706,7 @@ class Contact
} }
/** /**
* @brief Checks if the contact is blocked * Checks if the contact is blocked
* *
* @param int $cid contact id * @param int $cid contact id
* *
@ -1732,7 +1732,7 @@ class Contact
} }
/** /**
* @brief Checks if the contact is hidden * Checks if the contact is hidden
* *
* @param int $cid contact id * @param int $cid contact id
* *
@ -1753,7 +1753,7 @@ class Contact
} }
/** /**
* @brief Returns posts from a given contact url * Returns posts from a given contact url
* *
* @param string $contact_url Contact URL * @param string $contact_url Contact URL
* *
@ -1816,7 +1816,7 @@ class Contact
} }
/** /**
* @brief Returns the account type name * Returns the account type name
* *
* The function can be called with either the user or the contact array * The function can be called with either the user or the contact array
* *
@ -1871,7 +1871,7 @@ class Contact
} }
/** /**
* @brief Blocks a contact * Blocks a contact
* *
* @param int $cid * @param int $cid
* @return bool * @return bool
@ -1885,7 +1885,7 @@ class Contact
} }
/** /**
* @brief Unblocks a contact * Unblocks a contact
* *
* @param int $cid * @param int $cid
* @return bool * @return bool
@ -1899,7 +1899,7 @@ class Contact
} }
/** /**
* @brief Updates the avatar links in a contact only if needed * Updates the avatar links in a contact only if needed
* *
* @param string $avatar Link to avatar picture * @param string $avatar Link to avatar picture
* @param int $uid User id of contact owner * @param int $uid User id of contact owner
@ -1949,8 +1949,8 @@ class Contact
return $data; return $data;
} }
/** /**
* @brief Helper function for "updateFromProbe". Updates personal and public contact * Helper function for "updateFromProbe". Updates personal and public contact
* *
* @param integer $id contact id * @param integer $id contact id
* @param integer $uid user id * @param integer $uid user id
@ -2008,8 +2008,8 @@ class Contact
DBA::update('contact', $fields, $condition); DBA::update('contact', $fields, $condition);
} }
/** /**
* @brief Remove duplicated contacts * Remove duplicated contacts
* *
* @param string $nurl Normalised contact url * @param string $nurl Normalised contact url
* @param integer $uid User id * @param integer $uid User id
@ -2244,7 +2244,7 @@ class Contact
* $return['success'] boolean true if successful * $return['success'] boolean true if successful
* $return['message'] error text if success is false. * $return['message'] error text if success is false.
* *
* @brief Takes a $uid and a url/handle and adds a new contact * Takes a $uid and a url/handle and adds a new contact
* @param int $uid * @param int $uid
* @param string $url * @param string $url
* @param bool $interactive * @param bool $interactive
@ -2474,7 +2474,7 @@ class Contact
} }
/** /**
* @brief Updated contact's SSL policy * Updated contact's SSL policy
* *
* @param array $contact Contact array * @param array $contact Contact array
* @param string $new_policy New policy, valid: self,full * @param string $new_policy New policy, valid: self,full
@ -2677,7 +2677,7 @@ class Contact
} }
/** /**
* @brief Create a birthday event. * Create a birthday event.
* *
* Update the year and the birthday. * Update the year and the birthday.
*/ */
@ -2739,7 +2739,7 @@ class Contact
} }
/** /**
* @brief Returns a magic link to authenticate remote visitors * Returns a magic link to authenticate remote visitors
* *
* @todo check if the return is either a fully qualified URL or a relative path to Friendica basedir * @todo check if the return is either a fully qualified URL or a relative path to Friendica basedir
* *
@ -2768,7 +2768,7 @@ class Contact
} }
/** /**
* @brief Returns a magic link to authenticate remote visitors * Returns a magic link to authenticate remote visitors
* *
* @param integer $cid The contact id of the target contact profile * @param integer $cid The contact id of the target contact profile
* @param string $url An url that we will be redirected to after the authentication * @param string $url An url that we will be redirected to after the authentication
@ -2785,7 +2785,7 @@ class Contact
} }
/** /**
* @brief Returns a magic link to authenticate remote visitors * Returns a magic link to authenticate remote visitors
* *
* @param array $contact The contact array with "uid", "network" and "url" * @param array $contact The contact array with "uid", "network" and "url"
* @param string $url An url that we will be redirected to after the authentication * @param string $url An url that we will be redirected to after the authentication

2
src/Model/Conversation.php
View file

@ -31,7 +31,7 @@ class Conversation
} }
/** /**
* @brief Store the conversation data * Store the conversation data
* *
* @param array $arr Item array with conversation data * @param array $arr Item array with conversation data
* @return array Item array with removed conversation data * @return array Item array with removed conversation data

30
src/Model/Event.php
View file

@ -20,7 +20,7 @@ use Friendica\Util\Strings;
use Friendica\Util\XML; use Friendica\Util\XML;
/** /**
* @brief functions for interacting with the event database table * functions for interacting with the event database table
*/ */
class Event class Event
{ {
@ -110,7 +110,7 @@ class Event
} }
/** /**
* @brief Convert an array with event data to bbcode. * Convert an array with event data to bbcode.
* *
* @param array $event Array which contains the event data. * @param array $event Array which contains the event data.
* @return string The event as a bbcode formatted string. * @return string The event as a bbcode formatted string.
@ -147,7 +147,7 @@ class Event
} }
/** /**
* @brief Extract bbcode formatted event data from a string. * Extract bbcode formatted event data from a string.
* *
* @params: string $s The string which should be parsed for event data. * @params: string $s The string which should be parsed for event data.
* @param $text * @param $text
@ -211,7 +211,7 @@ class Event
} }
/** /**
* @brief Delete an event from the event table. * Delete an event from the event table.
* *
* Note: This function does only delete the event from the event table not its * Note: This function does only delete the event from the event table not its
* related entry in the item table. * related entry in the item table.
@ -231,7 +231,7 @@ class Event
} }
/** /**
* @brief Store the event. * Store the event.
* *
* Store the event in the event table and create an event item in the item table. * Store the event in the event table and create an event item in the item table.
* *
@ -370,7 +370,7 @@ class Event
} }
/** /**
* @brief Create an array with translation strings used for events. * Create an array with translation strings used for events.
* *
* @return array Array with translations strings. * @return array Array with translations strings.
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -441,7 +441,7 @@ class Event
} }
/** /**
* @brief Removes duplicated birthday events. * Removes duplicated birthday events.
* *
* @param array $dates Array of possibly duplicated events. * @param array $dates Array of possibly duplicated events.
* @return array Cleaned events. * @return array Cleaned events.
@ -463,7 +463,7 @@ class Event
} }
/** /**
* @brief Get an event by its event ID. * Get an event by its event ID.
* *
* @param int $owner_uid The User ID of the owner of the event * @param int $owner_uid The User ID of the owner of the event
* @param int $event_id The ID of the event in the event table * @param int $event_id The ID of the event in the event table
@ -496,7 +496,7 @@ class Event
} }
/** /**
* @brief Get all events in a specific time frame. * Get all events in a specific time frame.
* *
* @param int $owner_uid The User ID of the owner of the events. * @param int $owner_uid The User ID of the owner of the events.
* @param array $event_params An associative array with * @param array $event_params An associative array with
@ -546,7 +546,7 @@ class Event
} }
/** /**
* @brief Convert an array query results in an array which could be used by the events template. * Convert an array query results in an array which could be used by the events template.
* *
* @param array $event_result Event query array. * @param array $event_result Event query array.
* @return array Event array for the template. * @return array Event array for the template.
@ -631,7 +631,7 @@ class Event
} }
/** /**
* @brief Format event to export format (ical/csv). * Format event to export format (ical/csv).
* *
* @param array $events Query result for events. * @param array $events Query result for events.
* @param string $format The output format (ical/csv). * @param string $format The output format (ical/csv).
@ -738,7 +738,7 @@ class Event
} }
/** /**
* @brief Get all events for a user ID. * Get all events for a user ID.
* *
* The query for events is done permission sensitive. * The query for events is done permission sensitive.
* If the user is the owner of the calendar they * If the user is the owner of the calendar they
@ -832,7 +832,7 @@ class Event
} }
/** /**
* @brief Format an item array with event data to HTML. * Format an item array with event data to HTML.
* *
* @param array $item Array with item and event data. * @param array $item Array with item and event data.
* @return string HTML output. * @return string HTML output.
@ -941,7 +941,7 @@ class Event
} }
/** /**
* @brief Format a string with map bbcode to an array with location data. * Format a string with map bbcode to an array with location data.
* *
* Note: The string must only contain location data. A string with no bbcode will be * Note: The string must only contain location data. A string with no bbcode will be
* handled as location name. * handled as location name.
@ -992,7 +992,7 @@ class Event
} }
/** /**
* @brief Add new birthday event for this person * Add new birthday event for this person
* *
* @param array $contact Contact array, expects: id, uid, url, name * @param array $contact Contact array, expects: id, uid, url, name
* @param string $birthday Birthday of the contact * @param string $birthday Birthday of the contact

18
src/Model/FileTag.php
View file

@ -10,7 +10,7 @@ use Friendica\Database\DBA;
use Friendica\DI; use Friendica\DI;
/** /**
* @brief This class handles FileTag related functions * This class handles FileTag related functions
* *
* post categories and "save to file" use the same item.file table for storage. * post categories and "save to file" use the same item.file table for storage.
* We will differentiate the different uses by wrapping categories in angle brackets * We will differentiate the different uses by wrapping categories in angle brackets
@ -20,7 +20,7 @@ use Friendica\DI;
class FileTag class FileTag
{ {
/** /**
* @brief URL encode <, >, left and right brackets * URL encode <, >, left and right brackets
* *
* @param string $s String to be URL encoded. * @param string $s String to be URL encoded.
* *
@ -32,7 +32,7 @@ class FileTag
} }
/** /**
* @brief URL decode <, >, left and right brackets * URL decode <, >, left and right brackets
* *
* @param string $s The URL encoded string to be decoded * @param string $s The URL encoded string to be decoded
* *
@ -44,7 +44,7 @@ class FileTag
} }
/** /**
* @brief Query files for tag * Query files for tag
* *
* @param string $table The table to be queired. * @param string $table The table to be queired.
* @param string $s The search term * @param string $s The search term
@ -124,7 +124,7 @@ class FileTag
} }
/** /**
* @brief Get file tags from list * Get file tags from list
* *
* ex. given music,video return <music><video> or [music][video] * ex. given music,video return <music><video> or [music][video]
* @param string $list A comma delimited list of tags. * @param string $list A comma delimited list of tags.
@ -141,7 +141,7 @@ class FileTag
} }
/** /**
* @brief Get list from file tags * Get list from file tags
* *
* ex. given <music><video>[friends], return music,video or friends * ex. given <music><video>[friends], return music,video or friends
* @param string $file File tags * @param string $file File tags
@ -156,7 +156,7 @@ class FileTag
} }
/** /**
* @brief Update file tags in PConfig * Update file tags in PConfig
* *
* @param int $uid Unique Identity. * @param int $uid Unique Identity.
* @param string $file_old Categories previously associated with an item * @param string $file_old Categories previously associated with an item
@ -234,7 +234,7 @@ class FileTag
} }
/** /**
* @brief Add tag to file * Add tag to file
* *
* @param int $uid Unique identity. * @param int $uid Unique identity.
* @param int $item_id Item identity. * @param int $item_id Item identity.
@ -269,7 +269,7 @@ class FileTag
} }
/** /**
* @brief Remove tag from file * Remove tag from file
* *
* @param int $uid Unique identity. * @param int $uid Unique identity.
* @param int $item_id Item identity. * @param int $item_id Item identity.

32
src/Model/GContact.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Model/GlobalContact.php * @file src/Model/GlobalContact.php
* @brief This file includes the GlobalContact class with directory related functions * This file includes the GlobalContact class with directory related functions
*/ */
namespace Friendica\Model; namespace Friendica\Model;
@ -23,12 +23,12 @@ use Friendica\Util\Network;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief This class handles GlobalContact related functions * This class handles GlobalContact related functions
*/ */
class GContact class GContact
{ {
/** /**
* @brief Search global contact table by nick or name * Search global contact table by nick or name
* *
* @param string $search Name or nick * @param string $search Name or nick
* @param string $mode Search mode (e.g. "community") * @param string $mode Search mode (e.g. "community")
@ -88,7 +88,7 @@ class GContact
} }
/** /**
* @brief Link the gcontact entry with user, contact and global contact * Link the gcontact entry with user, contact and global contact
* *
* @param integer $gcid Global contact ID * @param integer $gcid Global contact ID
* @param integer $uid User ID * @param integer $uid User ID
@ -108,7 +108,7 @@ class GContact
} }
/** /**
* @brief Sanitize the given gcontact data * Sanitize the given gcontact data
* *
* Generation: * Generation:
* 0: No definition * 0: No definition
@ -537,7 +537,7 @@ class GContact
} }
/** /**
* @brief Removes unwanted parts from a contact url * Removes unwanted parts from a contact url
* *
* @param string $url Contact url * @param string $url Contact url
* *
@ -570,7 +570,7 @@ class GContact
} }
/** /**
* @brief Fetch the gcontact id, add an entry if not existed * Fetch the gcontact id, add an entry if not existed
* *
* @param array $contact contact array * @param array $contact contact array
* *
@ -635,7 +635,7 @@ class GContact
} }
/** /**
* @brief Updates the gcontact table from a given array * Updates the gcontact table from a given array
* *
* @param array $contact contact array * @param array $contact contact array
* *
@ -947,7 +947,7 @@ class GContact
DBA::update('gcontact', $fields, ['nurl' => Strings::normaliseLink($data['url'])]); DBA::update('gcontact', $fields, ['nurl' => Strings::normaliseLink($data['url'])]);
} }
/** /**
* @brief Updates the gcontact entry from a given public contact id * Updates the gcontact entry from a given public contact id
* *
* @param integer $cid contact id * @param integer $cid contact id
* @return void * @return void
@ -960,7 +960,7 @@ class GContact
} }
/** /**
* @brief Updates the gcontact entry from a given public contact url * Updates the gcontact entry from a given public contact url
* *
* @param string $url contact url * @param string $url contact url
* @return integer gcontact id * @return integer gcontact id
@ -973,7 +973,7 @@ class GContact
} }
/** /**
* @brief Helper function for updateFromPublicContactID and updateFromPublicContactURL * Helper function for updateFromPublicContactID and updateFromPublicContactURL
* *
* @param array $condition contact condition * @param array $condition contact condition
* @return integer gcontact id * @return integer gcontact id
@ -1058,7 +1058,7 @@ class GContact
} }
/** /**
* @brief Updates the gcontact entry from probe * Updates the gcontact entry from probe
* *
* @param string $url profile link * @param string $url profile link
* @param boolean $force Optional forcing of network probing (otherwise we use the cached data) * @param boolean $force Optional forcing of network probing (otherwise we use the cached data)
@ -1090,7 +1090,7 @@ class GContact
} }
/** /**
* @brief Update the gcontact entry for a given user id * Update the gcontact entry for a given user id
* *
* @param int $uid User ID * @param int $uid User ID
* @return bool * @return bool
@ -1130,7 +1130,7 @@ class GContact
} }
/** /**
* @brief Get the basepath for a given contact link * Get the basepath for a given contact link
* *
* @param string $url The gcontact link * @param string $url The gcontact link
* @param boolean $dont_update Don't update the contact * @param boolean $dont_update Don't update the contact
@ -1162,7 +1162,7 @@ class GContact
} }
/** /**
* @brief Fetches users of given GNU Social server * Fetches users of given GNU Social server
* *
* If the "Statistics" addon is enabled (See http://gstools.org/ for details) we query user data with this. * If the "Statistics" addon is enabled (See http://gstools.org/ for details) we query user data with this.
* *
@ -1227,7 +1227,7 @@ class GContact
} }
/** /**
* @brief Asking GNU Social server on a regular base for their user data * Asking GNU Social server on a regular base for their user data
* @return void * @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
* @throws \ImagickException * @throws \ImagickException

26
src/Model/Group.php
View file

@ -13,7 +13,7 @@ use Friendica\Core\Renderer;
use Friendica\Database\DBA; use Friendica\Database\DBA;
/** /**
* @brief functions for interacting with the group database table * functions for interacting with the group database table
*/ */
class Group class Group
{ {
@ -50,7 +50,7 @@ class Group
} }
/** /**
* @brief Create a new contact group * Create a new contact group
* *
* Note: If we found a deleted group with the same name, we restore it * Note: If we found a deleted group with the same name, we restore it
* *
@ -101,7 +101,7 @@ class Group
} }
/** /**
* @brief Get a list of group ids a contact belongs to * Get a list of group ids a contact belongs to
* *
* @param int $cid * @param int $cid
* @return array * @return array
@ -121,7 +121,7 @@ class Group
} }
/** /**
* @brief count unread group items * count unread group items
* *
* Count unread items of each groups of the local user * Count unread items of each groups of the local user
* *
@ -152,7 +152,7 @@ class Group
} }
/** /**
* @brief Get the group id for a user/name couple * Get the group id for a user/name couple
* *
* Returns false if no group has been found. * Returns false if no group has been found.
* *
@ -176,7 +176,7 @@ class Group
} }
/** /**
* @brief Mark a group as deleted * Mark a group as deleted
* *
* @param int $gid * @param int $gid
* @return boolean * @return boolean
@ -226,7 +226,7 @@ class Group
} }
/** /**
* @brief Mark a group as deleted based on its name * Mark a group as deleted based on its name
* *
* @param int $uid * @param int $uid
* @param string $name * @param string $name
@ -248,7 +248,7 @@ class Group
} }
/** /**
* @brief Adds a contact to a group * Adds a contact to a group
* *
* @param int $gid * @param int $gid
* @param int $cid * @param int $cid
@ -273,7 +273,7 @@ class Group
} }
/** /**
* @brief Removes a contact from a group * Removes a contact from a group
* *
* @param int $gid * @param int $gid
* @param int $cid * @param int $cid
@ -292,7 +292,7 @@ class Group
} }
/** /**
* @brief Removes a contact from a group based on its name * Removes a contact from a group based on its name
* *
* @param int $uid * @param int $uid
* @param string $name * @param string $name
@ -312,7 +312,7 @@ class Group
} }
/** /**
* @brief Returns the combined list of contact ids from a group id list * Returns the combined list of contact ids from a group id list
* *
* @param int $uid * @param int $uid
* @param array $group_ids * @param array $group_ids
@ -391,7 +391,7 @@ class Group
} }
/** /**
* @brief Returns a templated group selection list * Returns a templated group selection list
* *
* @param int $uid * @param int $uid
* @param int $gid An optional pre-selected group * @param int $gid An optional pre-selected group
@ -433,7 +433,7 @@ class Group
} }
/** /**
* @brief Create group sidebar widget * Create group sidebar widget
* *
* @param string $every * @param string $every
* @param string $each * @param string $each

70
src/Model/Item.php
View file

@ -141,7 +141,7 @@ class Item
} }
/** /**
* @brief Select pinned rows from the item table for a given user * Select pinned rows from the item table for a given user
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param array $selected Array of selected fields, empty for all * @param array $selected Array of selected fields, empty for all
@ -186,7 +186,7 @@ class Item
} }
/** /**
* @brief returns an activity index from an activity string * returns an activity index from an activity string
* *
* @param string $activity activity string * @param string $activity activity string
* @return integer Activity index * @return integer Activity index
@ -203,7 +203,7 @@ class Item
} }
/** /**
* @brief returns an activity string from an activity index * returns an activity string from an activity index
* *
* @param integer $index activity index * @param integer $index activity index
* @return string Activity string * @return string Activity string
@ -218,7 +218,7 @@ class Item
} }
/** /**
* @brief Fetch a single item row * Fetch a single item row
* *
* @param mixed $stmt statement object * @param mixed $stmt statement object
* @return array current row * @return array current row
@ -330,7 +330,7 @@ class Item
} }
/** /**
* @brief Fills an array with data from an item query * Fills an array with data from an item query
* *
* @param object $stmt statement object * @param object $stmt statement object
* @param bool $do_close * @param bool $do_close
@ -352,7 +352,7 @@ class Item
} }
/** /**
* @brief Check if item data exists * Check if item data exists
* *
* @param array $condition array of fields for condition * @param array $condition array of fields for condition
* *
@ -376,7 +376,6 @@ class Item
/** /**
* Retrieve a single record from the item table for a given user and returns it in an associative array * Retrieve a single record from the item table for a given user and returns it in an associative array
* *
* @brief Retrieve a single record from a table
* @param integer $uid User ID * @param integer $uid User ID
* @param array $selected * @param array $selected
* @param array $condition * @param array $condition
@ -397,7 +396,7 @@ class Item
} }
/** /**
* @brief Select rows from the item table for a given user * Select rows from the item table for a given user
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param array $selected Array of selected fields, empty for all * @param array $selected Array of selected fields, empty for all
@ -421,7 +420,6 @@ class Item
/** /**
* Retrieve a single record from the item table and returns it in an associative array * Retrieve a single record from the item table and returns it in an associative array
* *
* @brief Retrieve a single record from a table
* @param array $fields * @param array $fields
* @param array $condition * @param array $condition
* @param array $params * @param array $params
@ -445,7 +443,7 @@ class Item
} }
/** /**
* @brief Select rows from the item table and returns them as an array * Select rows from the item table and returns them as an array
* *
* @param array $selected Array of selected fields, empty for all * @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition * @param array $condition Array of fields for condition
@ -472,7 +470,7 @@ class Item
} }
/** /**
* @brief Select rows from the item table * Select rows from the item table
* *
* @param array $selected Array of selected fields, empty for all * @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition * @param array $condition Array of fields for condition
@ -513,7 +511,7 @@ class Item
} }
/** /**
* @brief Select rows from the starting post in the item table * Select rows from the starting post in the item table
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param array $selected * @param array $selected
@ -537,7 +535,6 @@ class Item
/** /**
* Retrieve a single record from the starting post in the item table and returns it in an associative array * Retrieve a single record from the starting post in the item table and returns it in an associative array
* *
* @brief Retrieve a single record from a table
* @param integer $uid User ID * @param integer $uid User ID
* @param array $selected * @param array $selected
* @param array $condition * @param array $condition
@ -560,7 +557,6 @@ class Item
/** /**
* Retrieve a single record from the starting post in the item table and returns it in an associative array * Retrieve a single record from the starting post in the item table and returns it in an associative array
* *
* @brief Retrieve a single record from a table
* @param array $fields * @param array $fields
* @param array $condition * @param array $condition
* @param array $params * @param array $params
@ -583,7 +579,7 @@ class Item
} }
/** /**
* @brief Select rows from the starting post in the item table * Select rows from the starting post in the item table
* *
* @param array $selected Array of selected fields, empty for all * @param array $selected Array of selected fields, empty for all
* @param array $condition Array of fields for condition * @param array $condition Array of fields for condition
@ -634,7 +630,7 @@ class Item
} }
/** /**
* @brief Returns a list of fields that are associated with the item table * Returns a list of fields that are associated with the item table
* *
* @param $usermode * @param $usermode
* @return array field list * @return array field list
@ -694,7 +690,7 @@ class Item
} }
/** /**
* @brief Returns SQL condition for the "select" functions * Returns SQL condition for the "select" functions
* *
* @param boolean $thread_mode Called for the items (false) or for the threads (true) * @param boolean $thread_mode Called for the items (false) or for the threads (true)
* *
@ -717,7 +713,7 @@ class Item
} }
/** /**
* @brief Returns all needed "JOIN" commands for the "select" functions * Returns all needed "JOIN" commands for the "select" functions
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param string $sql_commands The parts of the built SQL commands in the "select" functions * @param string $sql_commands The parts of the built SQL commands in the "select" functions
@ -809,7 +805,7 @@ class Item
} }
/** /**
* @brief Add the field list for the "select" functions * Add the field list for the "select" functions
* *
* @param array $fields The field definition array * @param array $fields The field definition array
* @param array $selected The array with the selected fields from the "select" functions * @param array $selected The array with the selected fields from the "select" functions
@ -858,7 +854,7 @@ class Item
} }
/** /**
* @brief add table definition to fields in an SQL query * add table definition to fields in an SQL query
* *
* @param string $query SQL query * @param string $query SQL query
* @param array $fields The field definition array * @param array $fields The field definition array
@ -884,7 +880,7 @@ class Item
} }
/** /**
* @brief Update existing item entries * Update existing item entries
* *
* @param array $fields The fields that are to be changed * @param array $fields The fields that are to be changed
* @param array $condition The condition for finding the item entries * @param array $condition The condition for finding the item entries
@ -1047,7 +1043,7 @@ class Item
} }
/** /**
* @brief Delete an item and notify others about it - if it was ours * Delete an item and notify others about it - if it was ours
* *
* @param array $condition The condition for finding the item entries * @param array $condition The condition for finding the item entries
* @param integer $priority Priority for the notification * @param integer $priority Priority for the notification
@ -1063,7 +1059,7 @@ class Item
} }
/** /**
* @brief Delete an item for an user and notify others about it - if it was ours * Delete an item for an user and notify others about it - if it was ours
* *
* @param array $condition The condition for finding the item entries * @param array $condition The condition for finding the item entries
* @param integer $uid User who wants to delete this item * @param integer $uid User who wants to delete this item
@ -1093,7 +1089,7 @@ class Item
} }
/** /**
* @brief Delete an item and notify others about it - if it was ours * Delete an item and notify others about it - if it was ours
* *
* @param integer $item_id Item ID that should be delete * @param integer $item_id Item ID that should be delete
* @param integer $priority Priority for the notification * @param integer $priority Priority for the notification
@ -2036,7 +2032,7 @@ class Item
} }
/** /**
* @brief Insert a new item content entry * Insert a new item content entry
* *
* @param array $item The item fields that are to be inserted * @param array $item The item fields that are to be inserted
* @return bool * @return bool
@ -2084,7 +2080,7 @@ class Item
} }
/** /**
* @brief Insert a new item content entry * Insert a new item content entry
* *
* @param array $item The item fields that are to be inserted * @param array $item The item fields that are to be inserted
* @throws \Exception * @throws \Exception
@ -2124,7 +2120,7 @@ class Item
} }
/** /**
* @brief Update existing item content entries * Update existing item content entries
* *
* @param array $item The item fields that are to be changed * @param array $item The item fields that are to be changed
* @param array $condition The condition for finding the item content entries * @param array $condition The condition for finding the item content entries
@ -2152,7 +2148,7 @@ class Item
} }
/** /**
* @brief Update existing item content entries * Update existing item content entries
* *
* @param array $item The item fields that are to be changed * @param array $item The item fields that are to be changed
* @param array $condition The condition for finding the item content entries * @param array $condition The condition for finding the item content entries
@ -2180,7 +2176,7 @@ class Item
} }
/** /**
* @brief Distributes public items to the receivers * Distributes public items to the receivers
* *
* @param integer $itemid Item ID that should be added * @param integer $itemid Item ID that should be added
* @param string $signed_text Original text (for Diaspora signatures), JSON encoded. * @param string $signed_text Original text (for Diaspora signatures), JSON encoded.
@ -2276,7 +2272,7 @@ class Item
} }
/** /**
* @brief Store public items for the receivers * Store public items for the receivers
* *
* @param integer $itemid Item ID that should be added * @param integer $itemid Item ID that should be added
* @param array $item The item entry that will be stored * @param array $item The item entry that will be stored
@ -2322,7 +2318,7 @@ class Item
} }
/** /**
* @brief Add a shadow entry for a given item id that is a thread starter * Add a shadow entry for a given item id that is a thread starter
* *
* We store every public item entry additionally with the user id "0". * We store every public item entry additionally with the user id "0".
* This is used for the community page and for the search. * This is used for the community page and for the search.
@ -2386,7 +2382,7 @@ class Item
} }
/** /**
* @brief Add a shadow entry for a given item id that is a comment * Add a shadow entry for a given item id that is a comment
* *
* This function does the same like the function above - but for comments * This function does the same like the function above - but for comments
* *
@ -2469,7 +2465,7 @@ class Item
} }
/** /**
* @brief Creates an unique guid out of a given uri * Creates an unique guid out of a given uri
* *
* @param string $uri uri of an item entry * @param string $uri uri of an item entry
* @param string $host hostname for the GUID prefix * @param string $host hostname for the GUID prefix
@ -2515,7 +2511,7 @@ class Item
} }
/** /**
* @brief Set "success_update" and "last-item" to the date of the last time we heard from this contact * Set "success_update" and "last-item" to the date of the last time we heard from this contact
* *
* This can be used to filter for inactive contacts. * This can be used to filter for inactive contacts.
* Only do this for public postings to avoid privacy problems, since poco data is public. * Only do this for public postings to avoid privacy problems, since poco data is public.
@ -3096,7 +3092,7 @@ class Item
} }
/** /**
* @brief add/remove activity to an item * add/remove activity to an item
* *
* Toggle activities as like,dislike,attend of an item * Toggle activities as like,dislike,attend of an item
* *
@ -3463,7 +3459,7 @@ class Item
} }
/** /**
* @brief Find any non-embedded images in private items and add redir links to them * Find any non-embedded images in private items and add redir links to them
* *
* @param array &$item The field array of an item row * @param array &$item The field array of an item row
*/ */
@ -3488,7 +3484,7 @@ class Item
} }
/** /**
* @brief Given an item array, convert the body element from bbcode to html and add smilie icons. * Given an item array, convert the body element from bbcode to html and add smilie icons.
* If attach is true, also add icons for item attachments. * If attach is true, also add icons for item attachments.
* *
* @param array $item * @param array $item

2
src/Model/ItemContent.php
View file

@ -13,7 +13,7 @@ use Friendica\DI;
class ItemContent class ItemContent
{ {
/** /**
* @brief Convert a message into plaintext for connectors to other networks * Convert a message into plaintext for connectors to other networks
* *
* @param array $item The message array that is about to be posted * @param array $item The message array that is about to be posted
* @param int $limit The maximum number of characters when posting to that network * @param int $limit The maximum number of characters when posting to that network

4
src/Model/ItemURI.php
View file

@ -11,7 +11,7 @@ use Friendica\Database\DBA;
class ItemURI class ItemURI
{ {
/** /**
* @brief Insert an item-uri record and return its id * Insert an item-uri record and return its id
* *
* @param array $fields Item-uri fields * @param array $fields Item-uri fields
* *
@ -38,7 +38,7 @@ class ItemURI
} }
/** /**
* @brief Searched for an id of a given uri. Adds it, if not existing yet. * Searched for an id of a given uri. Adds it, if not existing yet.
* *
* @param string $uri * @param string $uri
* *

16
src/Model/Notify.php
View file

@ -22,7 +22,7 @@ use Psr\Log\LoggerInterface;
use Friendica\Network\HTTPException; use Friendica\Network\HTTPException;
/** /**
* @brief Methods for read and write notifications from/to database * Methods for read and write notifications from/to database
* or for formatting notifications * or for formatting notifications
*/ */
final class Notify final class Notify
@ -164,7 +164,7 @@ final class Notify
} }
/** /**
* @brief set seen state of $note of local_user() * set seen state of $note of local_user()
* *
* @param array $note note array * @param array $note note array
* @param bool $seen optional true or false, default true * @param bool $seen optional true or false, default true
@ -197,7 +197,7 @@ final class Notify
} }
/** /**
* @brief List of pages for the Notifications TabBar * List of pages for the Notifications TabBar
* *
* @return array with with notifications TabBar data * @return array with with notifications TabBar data
* @throws Exception * @throws Exception
@ -544,7 +544,7 @@ final class Notify
} }
/** /**
* @brief Get home notifications * Get home notifications
* *
* @param bool $seen False => only include notifications into the query * @param bool $seen False => only include notifications into the query
* which aren't marked as "seen" * which aren't marked as "seen"
@ -587,7 +587,7 @@ final class Notify
} }
/** /**
* @brief Get introductions * Get introductions
* *
* @param bool $all If false only include introductions into the query * @param bool $all If false only include introductions into the query
* which aren't marked as ignored * which aren't marked as ignored
@ -650,7 +650,7 @@ final class Notify
} }
/** /**
* @brief Format the notification query in an usable array * Format the notification query in an usable array
* *
* @param array $intros The array from the db query * @param array $intros The array from the db query
* *
@ -738,8 +738,8 @@ final class Notify
} }
/** /**
* @brief Check for missing contact data and try to fetch the data from * Check for missing contact data and try to fetch the data from
* from other sources * from other sources
* *
* @param array $intro The input array with the intro data * @param array $intro The input array with the intro data
* *

4
src/Model/PermissionSet.php
View file

@ -7,7 +7,7 @@ namespace Friendica\Model;
use Friendica\Database\DBA; use Friendica\Database\DBA;
/** /**
* @brief functions for interacting with the permission set of an object (item, photo, event, ...) * functions for interacting with the permission set of an object (item, photo, event, ...)
*/ */
class PermissionSet class PermissionSet
{ {
@ -62,7 +62,7 @@ class PermissionSet
} }
/** /**
* @brief Returns a permission set for a given contact * Returns a permission set for a given contact
* *
* @param integer $uid User id whom the items belong * @param integer $uid User id whom the items belong
* @param integer $contact_id Contact id of the visitor * @param integer $contact_id Contact id of the visitor

28
src/Model/Photo.php
View file

@ -2,7 +2,7 @@
/** /**
* @file src/Model/Photo.php * @file src/Model/Photo.php
* @brief This file contains the Photo class for database interface * This file contains the Photo class for database interface
*/ */
namespace Friendica\Model; namespace Friendica\Model;
@ -30,7 +30,7 @@ require_once "include/dba.php";
class Photo class Photo
{ {
/** /**
* @brief Select rows from the photo table and returns them as array * Select rows from the photo table and returns them as array
* *
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
* @param array $conditions Array of fields for conditions * @param array $conditions Array of fields for conditions
@ -51,7 +51,7 @@ class Photo
} }
/** /**
* @brief Retrieve a single record from the photo table * Retrieve a single record from the photo table
* *
* @param array $fields Array of selected fields, empty for all * @param array $fields Array of selected fields, empty for all
* @param array $conditions Array of fields for conditions * @param array $conditions Array of fields for conditions
@ -72,7 +72,7 @@ class Photo
} }
/** /**
* @brief Get photos for user id * Get photos for user id
* *
* @param integer $uid User id * @param integer $uid User id
* @param string $resourceid Rescource ID of the photo * @param string $resourceid Rescource ID of the photo
@ -93,7 +93,7 @@ class Photo
} }
/** /**
* @brief Get a photo for user id * Get a photo for user id
* *
* @param integer $uid User id * @param integer $uid User id
* @param string $resourceid Rescource ID of the photo * @param string $resourceid Rescource ID of the photo
@ -116,7 +116,7 @@ class Photo
} }
/** /**
* @brief Get a single photo given resource id and scale * Get a single photo given resource id and scale
* *
* This method checks for permissions. Returns associative array * This method checks for permissions. Returns associative array
* on success, "no sign" image info, if user has no permission, * on success, "no sign" image info, if user has no permission,
@ -147,7 +147,7 @@ class Photo
} }
/** /**
* @brief Check if photo with given conditions exists * Check if photo with given conditions exists
* *
* @param array $conditions Array of extra conditions * @param array $conditions Array of extra conditions
* *
@ -161,7 +161,7 @@ class Photo
/** /**
* @brief Get Image object for given row id. null if row id does not exist * Get Image object for given row id. null if row id does not exist
* *
* @param array $photo Photo data. Needs at least 'id', 'type', 'backend-class', 'backend-ref' * @param array $photo Photo data. Needs at least 'id', 'type', 'backend-class', 'backend-ref'
* *
@ -192,7 +192,7 @@ class Photo
} }
/** /**
* @brief Return a list of fields that are associated with the photo table * Return a list of fields that are associated with the photo table
* *
* @return array field list * @return array field list
* @throws \Exception * @throws \Exception
@ -206,7 +206,7 @@ class Photo
} }
/** /**
* @brief Construct a photo array for a system resource image * Construct a photo array for a system resource image
* *
* @param string $filename Image file name relative to code root * @param string $filename Image file name relative to code root
* @param string $mimetype Image mime type. Defaults to "image/jpeg" * @param string $mimetype Image mime type. Defaults to "image/jpeg"
@ -230,7 +230,7 @@ class Photo
/** /**
* @brief store photo metadata in db and binary in default backend * store photo metadata in db and binary in default backend
* *
* @param Image $Image Image object with data * @param Image $Image Image object with data
* @param integer $uid User ID * @param integer $uid User ID
@ -320,7 +320,7 @@ class Photo
/** /**
* @brief Delete info from table and data from storage * Delete info from table and data from storage
* *
* @param array $conditions Field condition(s) * @param array $conditions Field condition(s)
* @param array $options Options array, Optional * @param array $options Options array, Optional
@ -346,7 +346,7 @@ class Photo
} }
/** /**
* @brief Update a photo * Update a photo
* *
* @param array $fields Contains the fields that are updated * @param array $fields Contains the fields that are updated
* @param array $conditions Condition array with the key values * @param array $conditions Condition array with the key values
@ -525,7 +525,7 @@ class Photo
} }
/** /**
* @brief Fetch the photo albums that are available for a viewer * Fetch the photo albums that are available for a viewer
* *
* The query in this function is cost intensive, so it is cached. * The query in this function is cost intensive, so it is cached.
* *

2
src/Model/Process.php
View file

@ -8,7 +8,7 @@ use Friendica\Database\DBA;
use Friendica\Util\DateTimeFormat; use Friendica\Util\DateTimeFormat;
/** /**
* @brief functions for interacting with a process * functions for interacting with a process
*/ */
class Process class Process
{ {

13
src/Model/Profile.php
View file

@ -32,7 +32,7 @@ use Friendica\Util\Temporal;
class Profile class Profile
{ {
/** /**
* @brief Returns default profile for a given user id * Returns default profile for a given user id
* *
* @param integer User ID * @param integer User ID
* *
@ -46,7 +46,7 @@ class Profile
} }
/** /**
* @brief Returns default profile for a given user ID and ID * Returns default profile for a given user ID and ID
* *
* @param int $uid The contact ID * @param int $uid The contact ID
* @param int $id The contact owner ID * @param int $id The contact owner ID
@ -61,7 +61,7 @@ class Profile
} }
/** /**
* @brief Returns profile data for the contact owner * Returns profile data for the contact owner
* *
* @param int $uid The User ID * @param int $uid The User ID
* @param array $fields The fields to retrieve * @param array $fields The fields to retrieve
@ -75,7 +75,7 @@ class Profile
} }
/** /**
* @brief Returns a formatted location string from the given profile array * Returns a formatted location string from the given profile array
* *
* @param array $profile Profile array (Generated from the "profile" table) * @param array $profile Profile array (Generated from the "profile" table)
* *
@ -109,7 +109,6 @@ class Profile
} }
/** /**
*
* Loads a profile into the page sidebar. * Loads a profile into the page sidebar.
* *
* The function requires a writeable copy of the main App structure, and the nickname * The function requires a writeable copy of the main App structure, and the nickname
@ -127,7 +126,6 @@ class Profile
* the theme is chosen before the _init() function of a theme is run, which will usually * the theme is chosen before the _init() function of a theme is run, which will usually
* load a lot of theme-specific content * load a lot of theme-specific content
* *
* @brief Loads a profile into the page sidebar.
* @param App $a * @param App $a
* @param string $nickname string * @param string $nickname string
* @param int $profile int * @param int $profile int
@ -238,7 +236,6 @@ class Profile
* *
* Includes all available profile data * Includes all available profile data
* *
* @brief Get all profile data of a local user
* @param string $nickname nick * @param string $nickname nick
* @param int $uid uid * @param int $uid uid
* @param int $profile_id ID of the profile * @param int $profile_id ID of the profile
@ -293,7 +290,6 @@ class Profile
* It is very difficult to templatise the HTML completely * It is very difficult to templatise the HTML completely
* because of all the conditional logic. * because of all the conditional logic.
* *
* @brief Formats a profile for display in the sidebar.
* @param array $profile * @param array $profile
* @param int $block * @param int $block
* @param boolean $show_connect Show connect link * @param boolean $show_connect Show connect link
@ -1208,7 +1204,6 @@ class Profile
* system pconfig, which means they don't want to see anybody else's theme * system pconfig, which means they don't want to see anybody else's theme
* settings except their own while on this site. * settings except their own while on this site.
* *
* @brief Get the user ID of the page owner
* @return int user ID * @return int user ID
* *
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

10
src/Model/PushSubscriber.php
View file

@ -12,7 +12,7 @@ use Friendica\Util\DateTimeFormat;
class PushSubscriber class PushSubscriber
{ {
/** /**
* @brief Send subscription notifications for the given user * Send subscription notifications for the given user
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param int $default_priority * @param int $default_priority
@ -27,7 +27,7 @@ class PushSubscriber
} }
/** /**
* @brief start workers to transmit the feed data * start workers to transmit the feed data
* *
* @param int $default_priority * @param int $default_priority
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -54,7 +54,7 @@ class PushSubscriber
} }
/** /**
* @brief Renew the feed subscription * Renew the feed subscription
* *
* @param integer $uid User ID * @param integer $uid User ID
* @param string $nick Priority for push workers * @param string $nick Priority for push workers
@ -98,7 +98,7 @@ class PushSubscriber
} }
/** /**
* @brief Delay the push subscriber * Delay the push subscriber
* *
* @param integer $id Subscriber ID * @param integer $id Subscriber ID
* @throws \Exception * @throws \Exception
@ -136,7 +136,7 @@ class PushSubscriber
} }
/** /**
* @brief Reset the push subscriber * Reset the push subscriber
* *
* @param integer $id Subscriber ID * @param integer $id Subscriber ID
* @param string $last_update Date of last transmitted item * @param string $last_update Date of last transmitted item

4
src/Model/Storage/Database.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Model/Storage/Filesystem.php * @file src/Model/Storage/Filesystem.php
* @brief Storage backend system * Storage backend system
*/ */
namespace Friendica\Model\Storage; namespace Friendica\Model\Storage;
@ -11,7 +11,7 @@ use Psr\Log\LoggerInterface;
use Friendica\Database\Database as DBA; use Friendica\Database\Database as DBA;
/** /**
* @brief Database based storage system * Database based storage system
* *
* This class manage data stored in database table. * This class manage data stored in database table.
*/ */

8
src/Model/Storage/Filesystem.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Model/Storage/Filesystem.php * @file src/Model/Storage/Filesystem.php
* @brief Storage backend system * Storage backend system
*/ */
namespace Friendica\Model\Storage; namespace Friendica\Model\Storage;
@ -12,7 +12,7 @@ use Friendica\Util\Strings;
use Psr\Log\LoggerInterface; use Psr\Log\LoggerInterface;
/** /**
* @brief Filesystem based storage backend * Filesystem based storage backend
* *
* This class manage data on filesystem. * This class manage data on filesystem.
* Base folder for storage is set in storage.filesystem_path. * Base folder for storage is set in storage.filesystem_path.
@ -52,7 +52,7 @@ class Filesystem extends AbstractStorage
} }
/** /**
* @brief Split data ref and return file path * Split data ref and return file path
* *
* @param string $reference Data reference * @param string $reference Data reference
* *
@ -69,7 +69,7 @@ class Filesystem extends AbstractStorage
/** /**
* @brief Create dirctory tree to store file, with .htaccess and index.html files * Create dirctory tree to store file, with .htaccess and index.html files
* *
* @param string $file Path and filename * @param string $file Path and filename
* *

14
src/Model/Storage/IStorage.php
View file

@ -1,18 +1,18 @@
<?php <?php
/** /**
* @file src/Model/Storage/IStorage.php * @file src/Model/Storage/IStorage.php
* @brief Storage backend system * Storage backend system
*/ */
namespace Friendica\Model\Storage; namespace Friendica\Model\Storage;
/** /**
* @brief Interface for storage backends * Interface for storage backends
*/ */
interface IStorage interface IStorage
{ {
/** /**
* @brief Get data from backend * Get data from backend
* *
* @param string $reference Data reference * @param string $reference Data reference
* *
@ -21,7 +21,7 @@ interface IStorage
public function get(string $reference); public function get(string $reference);
/** /**
* @brief Put data in backend as $ref. If $ref is not defined a new reference is created. * Put data in backend as $ref. If $ref is not defined a new reference is created.
* *
* @param string $data Data to save * @param string $data Data to save
* @param string $reference Data reference. Optional. * @param string $reference Data reference. Optional.
@ -31,7 +31,7 @@ interface IStorage
public function put(string $data, string $reference = ""); public function put(string $data, string $reference = "");
/** /**
* @brief Remove data from backend * Remove data from backend
* *
* @param string $reference Data reference * @param string $reference Data reference
* *
@ -40,7 +40,7 @@ interface IStorage
public function delete(string $reference); public function delete(string $reference);
/** /**
* @brief Get info about storage options * Get info about storage options
* *
* @return array * @return array
* *
@ -80,7 +80,7 @@ interface IStorage
public function getOptions(); public function getOptions();
/** /**
* @brief Validate and save options * Validate and save options
* *
* @param array $data Array [optionname => value] to be saved * @param array $data Array [optionname => value] to be saved
* *

4
src/Model/Storage/StorageException.php
View file

@ -1,13 +1,13 @@
<?php <?php
/** /**
* @file src/Model/Storage/StorageException.php * @file src/Model/Storage/StorageException.php
* @brief Storage backend system * Storage backend system
*/ */
namespace Friendica\Model\Storage; namespace Friendica\Model\Storage;
/** /**
* @brief Storage Exception * Storage Exception
*/ */
class StorageException extends \Exception class StorageException extends \Exception
{ {

4
src/Model/Storage/SystemResource.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Model/Storage/SystemStorage.php * @file src/Model/Storage/SystemStorage.php
* @brief Storage backend system * Storage backend system
*/ */
namespace Friendica\Model\Storage; namespace Friendica\Model\Storage;
@ -9,7 +9,7 @@ namespace Friendica\Model\Storage;
use \BadMethodCallException; use \BadMethodCallException;
/** /**
* @brief System resource storage class * System resource storage class
* *
* This class is used to load system resources, like images. * This class is used to load system resources, like images.
* Is not intended to be selectable by admins as default storage class. * Is not intended to be selectable by admins as default storage class.

24
src/Model/User.php
View file

@ -2,7 +2,7 @@
/** /**
* @file src/Model/User.php * @file src/Model/User.php
* @brief This file includes the User class with user related database functions * This file includes the User class with user related database functions
*/ */
namespace Friendica\Model; namespace Friendica\Model;
@ -29,7 +29,7 @@ use Friendica\Worker\Delivery;
use LightOpenID; use LightOpenID;
/** /**
* @brief This class handles User related functions * This class handles User related functions
*/ */
class User class User
{ {
@ -138,7 +138,7 @@ class User
} }
/** /**
* @brief Returns the user id of a given profile URL * Returns the user id of a given profile URL
* *
* @param string $url * @param string $url
* *
@ -171,7 +171,7 @@ class User
} }
/** /**
* @brief Get owner data by user id * Get owner data by user id
* *
* @param int $uid * @param int $uid
* @param boolean $check_valid Test if data is invalid and correct it * @param boolean $check_valid Test if data is invalid and correct it
@ -243,7 +243,7 @@ class User
} }
/** /**
* @brief Get owner data by nick name * Get owner data by nick name
* *
* @param int $nick * @param int $nick
* @return boolean|array * @return boolean|array
@ -261,7 +261,7 @@ class User
} }
/** /**
* @brief Returns the default group for a given user and network * Returns the default group for a given user and network
* *
* @param int $uid User id * @param int $uid User id
* @param string $network network name * @param string $network network name
@ -294,7 +294,6 @@ class User
/** /**
* Authenticate a user with a clear text password * Authenticate a user with a clear text password
* *
* @brief Authenticate a user with a clear text password
* @param mixed $user_info * @param mixed $user_info
* @param string $password * @param string $password
* @param bool $third_party * @param bool $third_party
@ -312,9 +311,10 @@ class User
} }
/** /**
* Authenticate a user with a clear text password
*
* Returns the user id associated with a successful password authentication * Returns the user id associated with a successful password authentication
* *
* @brief Authenticate a user with a clear text password
* @param mixed $user_info * @param mixed $user_info
* @param string $password * @param string $password
* @param bool $third_party * @param bool $third_party
@ -536,7 +536,7 @@ class User
} }
/** /**
* @brief Checks if a nickname is in the list of the forbidden nicknames * Checks if a nickname is in the list of the forbidden nicknames
* *
* Check if a nickname is forbidden from registration on the node by the * Check if a nickname is forbidden from registration on the node by the
* admin. Forbidden nicknames (e.g. role namess) can be configured in the * admin. Forbidden nicknames (e.g. role namess) can be configured in the
@ -567,7 +567,7 @@ class User
} }
/** /**
* @brief Catch-all user creation function * Catch-all user creation function
* *
* Creates a user from the provided data array, either form fields or OpenID. * Creates a user from the provided data array, either form fields or OpenID.
* Required: { username, nickname, email } or { openid_url } * Required: { username, nickname, email } or { openid_url }
@ -872,7 +872,7 @@ class User
} }
/** /**
* @brief Sends pending registration confirmation email * Sends pending registration confirmation email
* *
* @param array $user User record array * @param array $user User record array
* @param string $sitename * @param string $sitename
@ -911,7 +911,7 @@ class User
} }
/** /**
* @brief Sends registration confirmation * Sends registration confirmation
* *
* It's here as a function because the mail is sent from different parts * It's here as a function because the mail is sent from different parts
* *

2
src/Module/Admin/Queue.php
View file

@ -11,7 +11,7 @@ use Friendica\Util\Arrays;
use Friendica\Util\DateTimeFormat; use Friendica\Util\DateTimeFormat;
/** /**
* @brief Admin Inspect Queue Page * Admin Inspect Queue Page
* *
* Generates a page for the admin to have a look into the current queue of * Generates a page for the admin to have a look into the current queue of
* worker jobs. Shown are the parameters for the job and its priority. * worker jobs. Shown are the parameters for the job and its priority.

4
src/Module/Attach.php
View file

@ -14,12 +14,12 @@ use Friendica\DI;
use Friendica\Model\Attach as MAttach; use Friendica\Model\Attach as MAttach;
/** /**
* @brief Attach Module * Attach Module
*/ */
class Attach extends BaseModule class Attach extends BaseModule
{ {
/** /**
* @brief Return to user an attached file given the id * Return to user an attached file given the id
*/ */
public static function rawContent(array $parameters = []) public static function rawContent(array $parameters = [])
{ {

5
src/Module/Base/Api.php
View file

@ -51,9 +51,8 @@ class Api extends BaseModule
/** /**
* Log in user via OAuth1 or Simple HTTP Auth. * Log in user via OAuth1 or Simple HTTP Auth.
* Simple Auth allow username in form of <pre>user@server</pre>, ignoring server part
* *
* @brief Login API user * Simple Auth allow username in form of <pre>user@server</pre>, ignoring server part
* *
* @return bool Was a user authenticated? * @return bool Was a user authenticated?
* @throws HTTPException\ForbiddenException * @throws HTTPException\ForbiddenException
@ -76,7 +75,7 @@ class Api extends BaseModule
} }
/** /**
* @brief Get user info array. * Get user info array.
* *
* @param int|string $contact_id Contact ID or URL * @param int|string $contact_id Contact ID or URL
* @return array|bool * @return array|bool

6
src/Module/Contact.php
View file

@ -27,8 +27,6 @@ use Friendica\Util\Strings;
/** /**
* Manages and show Contacts and their content * Manages and show Contacts and their content
*
* @brief manages contacts
*/ */
class Contact extends BaseModule class Contact extends BaseModule
{ {
@ -837,7 +835,7 @@ class Contact extends BaseModule
} }
/** /**
* @brief List of pages for the Contact TabBar * List of pages for the Contact TabBar
* *
* Available Pages are 'Status', 'Profile', 'Contacts' and 'Common Friends' * Available Pages are 'Status', 'Profile', 'Contacts' and 'Common Friends'
* *
@ -1049,7 +1047,7 @@ class Contact extends BaseModule
} }
/** /**
* @brief Gives a array with actions which can performed to a given contact * Gives a array with actions which can performed to a given contact
* *
* This includes actions like e.g. 'block', 'hide', 'archive', 'delete' and others * This includes actions like e.g. 'block', 'hide', 'archive', 'delete' and others
* *

2
src/Module/Feed.php
View file

@ -18,8 +18,6 @@ use Friendica\Protocol\OStatus;
* *
* The nocache GET parameter is provided mainly for debug purposes, requires auth * The nocache GET parameter is provided mainly for debug purposes, requires auth
* *
* @brief Provides public Atom feeds
*
* @author Hypolite Petovan <hypolite@mrpetovan.com> * @author Hypolite Petovan <hypolite@mrpetovan.com>
*/ */
class Feed extends BaseModule class Feed extends BaseModule

2
src/Module/Owa.php
View file

@ -14,7 +14,7 @@ use Friendica\Util\HTTPSignature;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief OpenWebAuth verifier and token generator * OpenWebAuth verifier and token generator
* *
* See https://macgirvin.com/wiki/mike/OpenWebAuth/Home * See https://macgirvin.com/wiki/mike/OpenWebAuth/Home
* Requests to this endpoint should be signed using HTTP Signatures * Requests to this endpoint should be signed using HTTP Signatures

4
src/Module/Photo.php
View file

@ -14,12 +14,12 @@ use Friendica\Model\Photo as MPhoto;
use Friendica\Object\Image; use Friendica\Object\Image;
/** /**
* @brief Photo Module * Photo Module
*/ */
class Photo extends BaseModule class Photo extends BaseModule
{ {
/** /**
* @brief Module initializer * Module initializer
* *
* Fetch a photo or an avatar, in optional size, check for permissions and * Fetch a photo or an avatar, in optional size, check for permissions and
* return the image * return the image

16
src/Module/Proxy.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Module/Proxy.php * @file src/Module/Proxy.php
* @brief Based upon "Privacy Image Cache" by Tobias Hößl <https://github.com/CatoTH/> * Based upon "Privacy Image Cache" by Tobias Hößl <https://github.com/CatoTH/>
*/ */
namespace Friendica\Module; namespace Friendica\Module;
@ -16,7 +16,7 @@ use Friendica\Util\HTTPSignature;
use Friendica\Util\Proxy as ProxyUtils; use Friendica\Util\Proxy as ProxyUtils;
/** /**
* @brief Module Proxy * Module Proxy
* *
* urls: * urls:
* /proxy/[sub1/[sub2/]]<base64url image url>[.ext][:size] * /proxy/[sub1/[sub2/]]<base64url image url>[.ext][:size]
@ -26,7 +26,7 @@ class Proxy extends BaseModule
{ {
/** /**
* @brief Initializer method for this class. * Initializer method for this class.
* *
* Sets application instance and checks if /proxy/ path is writable. * Sets application instance and checks if /proxy/ path is writable.
* *
@ -144,7 +144,7 @@ class Proxy extends BaseModule
/** /**
* @brief Build info about requested image to be proxied * Build info about requested image to be proxied
* *
* @return array * @return array
* [ * [
@ -224,7 +224,7 @@ class Proxy extends BaseModule
/** /**
* @brief setup ./proxy folder for direct cache * setup ./proxy folder for direct cache
* *
* @return bool False if direct cache can't be used. * @return bool False if direct cache can't be used.
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -249,7 +249,7 @@ class Proxy extends BaseModule
/** /**
* @brief Try to reply with image in cachefile * Try to reply with image in cachefile
* *
* @param array $request Array from getRequestInfo * @param array $request Array from getRequestInfo
* *
@ -271,7 +271,7 @@ class Proxy extends BaseModule
} }
/** /**
* @brief Try to reply with image in database * Try to reply with image in database
* *
* @param array $request Array from getRequestInfo * @param array $request Array from getRequestInfo
* *
@ -301,7 +301,7 @@ class Proxy extends BaseModule
} }
/** /**
* @brief Output the image with cache headers * Output the image with cache headers
* *
* @param Image $img * @param Image $img
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

4
src/Module/Register.php
View file

@ -26,7 +26,7 @@ class Register extends BaseModule
const OPEN = 2; const OPEN = 2;
/** /**
* @brief Module GET method to display any content * Module GET method to display any content
* *
* Extend this method if the module is supposed to return any display * Extend this method if the module is supposed to return any display
* through a GET request. It can be an HTML page through templating or a * through a GET request. It can be an HTML page through templating or a
@ -158,7 +158,7 @@ class Register extends BaseModule
} }
/** /**
* @brief Module POST method to process submitted data * Module POST method to process submitted data
* *
* Extend this method if the module is supposed to process POST requests. * Extend this method if the module is supposed to process POST requests.
* Doesn't display any content * Doesn't display any content

2
src/Module/Security/Login.php
View file

@ -60,7 +60,7 @@ class Login extends BaseModule
} }
/** /**
* @brief Wrapper for adding a login box. * Wrapper for adding a login box.
* *
* @param string $return_path The path relative to the base the user should be sent * @param string $return_path The path relative to the base the user should be sent
* back to after login completes * back to after login completes

2
src/Module/Security/Logout.php
View file

@ -19,7 +19,7 @@ use Friendica\Model\Profile;
class Logout extends BaseModule class Logout extends BaseModule
{ {
/** /**
* @brief Process logout requests * Process logout requests
*/ */
public static function init(array $parameters = []) public static function init(array $parameters = [])
{ {

6
src/Module/Tos.php
View file

@ -24,7 +24,7 @@ class Tos extends BaseModule
public $privacy_complete; public $privacy_complete;
/** /**
* @brief constructor for the module, initializing the text variables * constructor for the module, initializing the text variables
* *
* To make the text variables available outside of the module, they need to * To make the text variables available outside of the module, they need to
* be properties of the class, however cannot be set directly as the property * be properties of the class, however cannot be set directly as the property
@ -41,7 +41,7 @@ class Tos extends BaseModule
} }
/** /**
* @brief initialize the TOS module. * initialize the TOS module.
* *
* If this is a single user instance, we expect the user to know their * If this is a single user instance, we expect the user to know their
* dealings with their own node so a TOS is not necessary. * dealings with their own node so a TOS is not necessary.
@ -55,7 +55,7 @@ class Tos extends BaseModule
} }
/** /**
* @brief generate the content of the /tos page * generate the content of the /tos page
* *
* The content of the /tos page is generated from two parts. * The content of the /tos page is generated from two parts.
* (1) a free form part the admin of the node can set in the admin panel * (1) a free form part the admin of the node can set in the admin panel

4
src/Network/FKOAuth1.php
View file

@ -12,12 +12,12 @@ use OAuthSignatureMethod_HMAC_SHA1;
use OAuthSignatureMethod_PLAINTEXT; use OAuthSignatureMethod_PLAINTEXT;
/** /**
* @brief OAuth protocol * OAuth protocol
*/ */
class FKOAuth1 extends OAuthServer class FKOAuth1 extends OAuthServer
{ {
/** /**
* @brief Constructor * Constructor
*/ */
public function __construct() public function __construct()
{ {

2
src/Network/FKOAuthDataStore.php
View file

@ -21,7 +21,7 @@ define('REQUEST_TOKEN_DURATION', 300);
define('ACCESS_TOKEN_DURATION', 31536000); define('ACCESS_TOKEN_DURATION', 31536000);
/** /**
* @brief OAuthDataStore class * OAuthDataStore class
*/ */
class FKOAuthDataStore extends OAuthDataStore class FKOAuthDataStore extends OAuthDataStore
{ {

50
src/Network/Probe.php
View file

@ -6,7 +6,7 @@ namespace Friendica\Network;
/** /**
* @file src/Network/Probe.php * @file src/Network/Probe.php
* @brief Functions for probing URL * Functions for probing URL
*/ */
use DOMDocument; use DOMDocument;
@ -29,7 +29,7 @@ use Friendica\Util\Strings;
use Friendica\Util\XML; use Friendica\Util\XML;
/** /**
* @brief This class contain functions for probing URL * This class contain functions for probing URL
* *
*/ */
class Probe class Probe
@ -38,7 +38,7 @@ class Probe
private static $istimeout; private static $istimeout;
/** /**
* @brief Rearrange the array so that it always has the same order * Rearrange the array so that it always has the same order
* *
* @param array $data Unordered data * @param array $data Unordered data
* *
@ -68,7 +68,7 @@ class Probe
} }
/** /**
* @brief Check if the hostname belongs to the own server * Check if the hostname belongs to the own server
* *
* @param string $host The hostname that is to be checked * @param string $host The hostname that is to be checked
* *
@ -91,7 +91,7 @@ class Probe
} }
/** /**
* @brief Probes for webfinger path via "host-meta" * Probes for webfinger path via "host-meta"
* *
* We have to check if the servers in the future still will offer this. * We have to check if the servers in the future still will offer this.
* It seems as if it was dropped from the standard. * It seems as if it was dropped from the standard.
@ -179,7 +179,7 @@ class Probe
} }
/** /**
* @brief Perform Webfinger lookup and return DFRN data * Perform Webfinger lookup and return DFRN data
* *
* Given an email style address, perform webfinger lookup and * Given an email style address, perform webfinger lookup and
* return the resulting DFRN profile URL, or if no DFRN profile URL * return the resulting DFRN profile URL, or if no DFRN profile URL
@ -222,7 +222,7 @@ class Probe
} }
/** /**
* @brief Check an URI for LRDD data * Check an URI for LRDD data
* *
* this is a replacement for the "lrdd" function. * this is a replacement for the "lrdd" function.
* It isn't used in this class and has some redundancies in the code. * It isn't used in this class and has some redundancies in the code.
@ -318,7 +318,7 @@ class Probe
} }
/** /**
* @brief Fetch information (protocol endpoints and user information) about a given uri * Fetch information (protocol endpoints and user information) about a given uri
* *
* @param string $uri Address that should be probed * @param string $uri Address that should be probed
* @param string $network Test for this specific network * @param string $network Test for this specific network
@ -485,7 +485,7 @@ class Probe
} }
/** /**
* @brief Checks if a profile url should be OStatus but only provides partial information * Checks if a profile url should be OStatus but only provides partial information
* *
* @param array $webfinger Webfinger data * @param array $webfinger Webfinger data
* @param string $lrdd Path template for webfinger request * @param string $lrdd Path template for webfinger request
@ -529,7 +529,7 @@ class Probe
} }
/** /**
* @brief Fetch information (protocol endpoints and user information) about a given uri * Fetch information (protocol endpoints and user information) about a given uri
* *
* This function is only called by the "uri" function that adds caching and rearranging of data. * This function is only called by the "uri" function that adds caching and rearranging of data.
* *
@ -847,7 +847,7 @@ class Probe
} }
/** /**
* @brief Perform a webfinger request. * Perform a webfinger request.
* *
* For details see RFC 7033: <https://tools.ietf.org/html/rfc7033> * For details see RFC 7033: <https://tools.ietf.org/html/rfc7033>
* *
@ -917,7 +917,7 @@ class Probe
} }
/** /**
* @brief Poll the Friendica specific noscrape page. * Poll the Friendica specific noscrape page.
* *
* "noscrape" is a faster alternative to fetch the data from the hcard. * "noscrape" is a faster alternative to fetch the data from the hcard.
* This functionality was originally created for the directory. * This functionality was originally created for the directory.
@ -1021,7 +1021,7 @@ class Probe
} }
/** /**
* @brief Check for valid DFRN data * Check for valid DFRN data
* *
* @param array $data DFRN data * @param array $data DFRN data
* *
@ -1049,7 +1049,7 @@ class Probe
} }
/** /**
* @brief Fetch data from a DFRN profile page and via "noscrape" * Fetch data from a DFRN profile page and via "noscrape"
* *
* @param string $profile_link Link to the profile page * @param string $profile_link Link to the profile page
* *
@ -1101,7 +1101,7 @@ class Probe
} }
/** /**
* @brief Check for DFRN contact * Check for DFRN contact
* *
* @param array $webfinger Webfinger data * @param array $webfinger Webfinger data
* *
@ -1181,7 +1181,7 @@ class Probe
} }
/** /**
* @brief Poll the hcard page (Diaspora and Friendica specific) * Poll the hcard page (Diaspora and Friendica specific)
* *
* @param string $hcard_url Link to the hcard page * @param string $hcard_url Link to the hcard page
* @param array $data The already fetched data * @param array $data The already fetched data
@ -1309,7 +1309,7 @@ class Probe
} }
/** /**
* @brief Check for Diaspora contact * Check for Diaspora contact
* *
* @param array $webfinger Webfinger data * @param array $webfinger Webfinger data
* *
@ -1397,7 +1397,7 @@ class Probe
} }
/** /**
* @brief Check for OStatus contact * Check for OStatus contact
* *
* @param array $webfinger Webfinger data * @param array $webfinger Webfinger data
* @param bool $short Short detection mode * @param bool $short Short detection mode
@ -1524,7 +1524,7 @@ class Probe
} }
/** /**
* @brief Fetch data from a pump.io profile page * Fetch data from a pump.io profile page
* *
* @param string $profile_link Link to the profile page * @param string $profile_link Link to the profile page
* *
@ -1585,7 +1585,7 @@ class Probe
} }
/** /**
* @brief Check for pump.io contact * Check for pump.io contact
* *
* @param array $webfinger Webfinger data * @param array $webfinger Webfinger data
* @param string $addr * @param string $addr
@ -1642,7 +1642,7 @@ class Probe
} }
/** /**
* @brief Check for twitter contact * Check for twitter contact
* *
* @param string $uri * @param string $uri
* *
@ -1702,7 +1702,7 @@ class Probe
} }
/** /**
* @brief Check page for feed link * Check page for feed link
* *
* @param string $url Page link * @param string $url Page link
* *
@ -1749,7 +1749,7 @@ class Probe
} }
/** /**
* @brief Check for feed contact * Check for feed contact
* *
* @param string $url Profile link * @param string $url Profile link
* @param boolean $probe Do a probe if the page contains a feed link * @param boolean $probe Do a probe if the page contains a feed link
@ -1812,7 +1812,7 @@ class Probe
} }
/** /**
* @brief Check for mail contact * Check for mail contact
* *
* @param string $uri Profile link * @param string $uri Profile link
* @param integer $uid User ID * @param integer $uid User ID
@ -1900,7 +1900,7 @@ class Probe
} }
/** /**
* @brief Mix two paths together to possibly fix missing parts * Mix two paths together to possibly fix missing parts
* *
* @param string $avatar Path to the avatar * @param string $avatar Path to the avatar
* @param string $base Another path that is hopefully complete * @param string $base Another path that is hopefully complete

14
src/Object/Image.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Object/Image.php * @file src/Object/Image.php
* @brief This file contains the Image class for image processing * This file contains the Image class for image processing
*/ */
namespace Friendica\Object; namespace Friendica\Object;
@ -32,7 +32,7 @@ class Image
private $types; private $types;
/** /**
* @brief Constructor * Constructor
* @param string $data * @param string $data
* @param boolean $type optional, default null * @param boolean $type optional, default null
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -57,7 +57,7 @@ class Image
} }
/** /**
* @brief Destructor * Destructor
* @return void * @return void
*/ */
public function __destruct() public function __destruct()
@ -501,7 +501,7 @@ class Image
} }
/** /**
* @brief Scale image to target dimensions * Scale image to target dimensions
* *
* @param int $dest_width * @param int $dest_width
* @param int $dest_height * @param int $dest_height
@ -614,7 +614,7 @@ class Image
} }
/** /**
* @brief Magic method allowing string casting of an Image object * Magic method allowing string casting of an Image object
* *
* Ex: $data = $Image->asString(); * Ex: $data = $Image->asString();
* can be replaced by * can be replaced by
@ -671,7 +671,7 @@ class Image
} }
/** /**
* @brief supported mimetypes and corresponding file extensions * supported mimetypes and corresponding file extensions
* @return array * @return array
* @deprecated in version 2019.12 please use Util\Images::supportedTypes() instead. * @deprecated in version 2019.12 please use Util\Images::supportedTypes() instead.
*/ */
@ -681,7 +681,7 @@ class Image
} }
/** /**
* @brief Maps Mime types to Imagick formats * Maps Mime types to Imagick formats
* @return array With with image formats (mime type as key) * @return array With with image formats (mime type as key)
* @deprecated in version 2019.12 please use Util\Images::getFormatsMap() instead. * @deprecated in version 2019.12 please use Util\Images::getFormatsMap() instead.
*/ */

3
src/Protocol/ActivityPub.php
View file

@ -12,7 +12,8 @@ use Friendica\Model\User;
use Friendica\Util\HTTPSignature; use Friendica\Util\HTTPSignature;
/** /**
* @brief ActivityPub Protocol class * ActivityPub Protocol class
*
* The ActivityPub Protocol is a message exchange protocol defined by the W3C. * The ActivityPub Protocol is a message exchange protocol defined by the W3C.
* https://www.w3.org/TR/activitypub/ * https://www.w3.org/TR/activitypub/
* https://www.w3.org/TR/activitystreams-core/ * https://www.w3.org/TR/activitystreams-core/

2
src/Protocol/ActivityPub/Receiver.php
View file

@ -23,7 +23,7 @@ use Friendica\Util\LDSignature;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief ActivityPub Receiver Protocol class * ActivityPub Receiver Protocol class
* *
* To-Do: * To-Do:
* - Undo Announce * - Undo Announce

4
src/Protocol/ActivityPub/Transmitter.php
View file

@ -37,7 +37,7 @@ require_once 'include/api.php';
require_once 'mod/share.php'; require_once 'mod/share.php';
/** /**
* @brief ActivityPub Transmitter Protocol class * ActivityPub Transmitter Protocol class
* *
* To-Do: * To-Do:
* - Undo Announce * - Undo Announce
@ -1107,7 +1107,7 @@ class Transmitter
} }
/** /**
* @brief Callback function to replace a Friendica style mention in a mention that is used on AP * Callback function to replace a Friendica style mention in a mention that is used on AP
* *
* @param array $match Matching values for the callback * @param array $match Matching values for the callback
* @return string Replaced mention * @return string Replaced mention

66
src/Protocol/DFRN.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file include/dfrn.php * @file include/dfrn.php
* @brief The implementation of the dfrn protocol * The implementation of the dfrn protocol
* *
* @see https://github.com/friendica/friendica/wiki/Protocol and * @see https://github.com/friendica/friendica/wiki/Protocol and
* https://github.com/friendica/friendica/blob/master/spec/dfrn2.pdf * https://github.com/friendica/friendica/blob/master/spec/dfrn2.pdf
@ -40,7 +40,7 @@ use HTMLPurifier;
use HTMLPurifier_Config; use HTMLPurifier_Config;
/** /**
* @brief This class contain functions to create and send DFRN XML files * This class contain functions to create and send DFRN XML files
*/ */
class DFRN class DFRN
{ {
@ -50,7 +50,7 @@ class DFRN
const REPLY_RC = 2; // Reply that will be relayed const REPLY_RC = 2; // Reply that will be relayed
/** /**
* @brief Generates an array of contact and user for DFRN imports * Generates an array of contact and user for DFRN imports
* *
* This array contains not only the receiver but also the sender of the message. * This array contains not only the receiver but also the sender of the message.
* *
@ -91,7 +91,7 @@ class DFRN
} }
/** /**
* @brief Generates the atom entries for delivery.php * Generates the atom entries for delivery.php
* *
* This function is used whenever content is transmitted via DFRN. * This function is used whenever content is transmitted via DFRN.
* *
@ -130,7 +130,7 @@ class DFRN
} }
/** /**
* @brief Generate an atom feed for the given user * Generate an atom feed for the given user
* *
* This function is called when another server is pulling data from the user feed. * This function is called when another server is pulling data from the user feed.
* *
@ -340,7 +340,7 @@ class DFRN
} }
/** /**
* @brief Generate an atom entry for a given item id * Generate an atom entry for a given item id
* *
* @param int $item_id The item id * @param int $item_id The item id
* @param boolean $conversation Show the conversation. If false show the single post. * @param boolean $conversation Show the conversation. If false show the single post.
@ -409,7 +409,7 @@ class DFRN
} }
/** /**
* @brief Create XML text for DFRN mails * Create XML text for DFRN mails
* *
* @param array $item message elements * @param array $item message elements
* @param array $owner Owner record * @param array $owner Owner record
@ -446,7 +446,7 @@ class DFRN
} }
/** /**
* @brief Create XML text for DFRN friend suggestions * Create XML text for DFRN friend suggestions
* *
* @param array $item suggestion elements * @param array $item suggestion elements
* @param array $owner Owner record * @param array $owner Owner record
@ -476,7 +476,7 @@ class DFRN
} }
/** /**
* @brief Create XML text for DFRN relocations * Create XML text for DFRN relocations
* *
* @param array $owner Owner record * @param array $owner Owner record
* @param int $uid User ID * @param int $uid User ID
@ -535,7 +535,7 @@ class DFRN
} }
/** /**
* @brief Adds the header elements for the DFRN protocol * Adds the header elements for the DFRN protocol
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Owner record * @param array $owner Owner record
@ -613,7 +613,7 @@ class DFRN
} }
/** /**
* @brief Adds the author element in the header for the DFRN protocol * Adds the author element in the header for the DFRN protocol
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Owner record * @param array $owner Owner record
@ -758,7 +758,7 @@ class DFRN
} }
/** /**
* @brief Adds the author elements in the "entry" elements of the DFRN protocol * Adds the author elements in the "entry" elements of the DFRN protocol
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param string $element Element name for the author * @param string $element Element name for the author
@ -803,7 +803,7 @@ class DFRN
} }
/** /**
* @brief Adds the activity elements * Adds the activity elements
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param string $element Element name for the activity * @param string $element Element name for the activity
@ -870,7 +870,7 @@ class DFRN
} }
/** /**
* @brief Adds the elements for attachments * Adds the elements for attachments
* *
* @param object $doc XML document * @param object $doc XML document
* @param object $root XML root * @param object $root XML root
@ -906,7 +906,7 @@ class DFRN
} }
/** /**
* @brief Adds the "entry" elements for the DFRN protocol * Adds the "entry" elements for the DFRN protocol
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param string $type "text" or "html" * @param string $type "text" or "html"
@ -1143,7 +1143,7 @@ class DFRN
} }
/** /**
* @brief encrypts data via AES * encrypts data via AES
* *
* @param string $data The data that is to be encrypted * @param string $data The data that is to be encrypted
* @param string $key The AES key * @param string $key The AES key
@ -1156,7 +1156,7 @@ class DFRN
} }
/** /**
* @brief decrypts data via AES * decrypts data via AES
* *
* @param string $encrypted The encrypted data * @param string $encrypted The encrypted data
* @param string $key The AES key * @param string $key The AES key
@ -1169,7 +1169,7 @@ class DFRN
} }
/** /**
* @brief Delivers the atom content to the contacts * Delivers the atom content to the contacts
* *
* @param array $owner Owner record * @param array $owner Owner record
* @param array $contact Contact record of the receiver * @param array $contact Contact record of the receiver
@ -1405,7 +1405,7 @@ class DFRN
} }
/** /**
* @brief Transmits atom content to the contacts via the Diaspora transport layer * Transmits atom content to the contacts via the Diaspora transport layer
* *
* @param array $owner Owner record * @param array $owner Owner record
* @param array $contact Contact record of the receiver * @param array $contact Contact record of the receiver
@ -1495,7 +1495,7 @@ class DFRN
} }
/** /**
* @brief Fetch the author data from head or entry items * Fetch the author data from head or entry items
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $context In which context should the data be searched * @param object $context In which context should the data be searched
@ -1729,7 +1729,7 @@ class DFRN
} }
/** /**
* @brief Transforms activity objects into an XML string * Transforms activity objects into an XML string
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $activity Activity object * @param object $activity Activity object
@ -1784,7 +1784,7 @@ class DFRN
} }
/** /**
* @brief Processes the mail elements * Processes the mail elements
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $mail mail elements * @param object $mail mail elements
@ -1813,7 +1813,7 @@ class DFRN
} }
/** /**
* @brief Processes the suggestion elements * Processes the suggestion elements
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $suggestion suggestion elements * @param object $suggestion suggestion elements
@ -1912,7 +1912,7 @@ class DFRN
} }
/** /**
* @brief Processes the relocation elements * Processes the relocation elements
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $relocation relocation elements * @param object $relocation relocation elements
@ -1997,7 +1997,7 @@ class DFRN
} }
/** /**
* @brief Updates an item * Updates an item
* *
* @param array $current the current item record * @param array $current the current item record
* @param array $item the new item record * @param array $item the new item record
@ -2030,7 +2030,7 @@ class DFRN
} }
/** /**
* @brief Detects the entry type of the item * Detects the entry type of the item
* *
* @param array $importer Record of the importer user mixed with contact of the content * @param array $importer Record of the importer user mixed with contact of the content
* @param array $item the new item record * @param array $item the new item record
@ -2098,7 +2098,7 @@ class DFRN
} }
/** /**
* @brief Send a "poke" * Send a "poke"
* *
* @param array $item The new item record * @param array $item The new item record
* @param array $importer Record of the importer user mixed with contact of the content * @param array $importer Record of the importer user mixed with contact of the content
@ -2158,7 +2158,7 @@ class DFRN
} }
/** /**
* @brief Processes several actions, depending on the verb * Processes several actions, depending on the verb
* *
* @param int $entrytype Is it a toplevel entry, a comment or a relayed comment? * @param int $entrytype Is it a toplevel entry, a comment or a relayed comment?
* @param array $importer Record of the importer user mixed with contact of the content * @param array $importer Record of the importer user mixed with contact of the content
@ -2260,7 +2260,7 @@ class DFRN
} }
/** /**
* @brief Processes the link elements * Processes the link elements
* *
* @param object $links link elements * @param object $links link elements
* @param array $item the item record * @param array $item the item record
@ -2304,7 +2304,7 @@ class DFRN
} }
/** /**
* @brief Processes the entry elements which contain the items and comments * Processes the entry elements which contain the items and comments
* *
* @param array $header Array of the header elements that always stay the same * @param array $header Array of the header elements that always stay the same
* @param object $xpath XPath object * @param object $xpath XPath object
@ -2649,7 +2649,7 @@ class DFRN
} }
/** /**
* @brief Deletes items * Deletes items
* *
* @param object $xpath XPath object * @param object $xpath XPath object
* @param object $deletion deletion elements * @param object $deletion deletion elements
@ -2710,7 +2710,7 @@ class DFRN
} }
/** /**
* @brief Imports a DFRN message * Imports a DFRN message
* *
* @param string $xml The DFRN message * @param string $xml The DFRN message
* @param array $importer Record of the importer user mixed with contact of the content * @param array $importer Record of the importer user mixed with contact of the content
@ -2853,7 +2853,7 @@ class DFRN
} }
/** /**
* @brief Returns the activity verb * Returns the activity verb
* *
* @param array $item Item array * @param array $item Item array
* *

166
src/Protocol/Diaspora.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Protocol/diaspora.php * @file src/Protocol/diaspora.php
* @brief The implementation of the diaspora protocol * The implementation of the diaspora protocol
* *
* The new protocol is described here: http://diaspora.github.io/diaspora_federation/index.html * The new protocol is described here: http://diaspora.github.io/diaspora_federation/index.html
* This implementation here interprets the old and the new protocol and sends the new one. * This implementation here interprets the old and the new protocol and sends the new one.
@ -41,7 +41,7 @@ use Friendica\Worker\Delivery;
use SimpleXMLElement; use SimpleXMLElement;
/** /**
* @brief This class contain functions to create and send Diaspora XML files * This class contain functions to create and send Diaspora XML files
* *
*/ */
class Diaspora class Diaspora
@ -77,7 +77,7 @@ class Diaspora
} }
/** /**
* @brief Return a list of relay servers * Return a list of relay servers
* *
* The list contains not only the official relays but also servers that we serve directly * The list contains not only the official relays but also servers that we serve directly
* *
@ -167,7 +167,7 @@ class Diaspora
} }
/** /**
* @brief Return a contact for a given server address or creates a dummy entry * Return a contact for a given server address or creates a dummy entry
* *
* @param string $server_url The url of the server * @param string $server_url The url of the server
* @param array $fields Fieldlist * @param array $fields Fieldlist
@ -200,7 +200,7 @@ class Diaspora
} }
/** /**
* @brief Update or insert a relay contact * Update or insert a relay contact
* *
* @param string $server_url The url of the server * @param string $server_url The url of the server
* @param array $network_fields Optional network specific fields * @param array $network_fields Optional network specific fields
@ -234,7 +234,7 @@ class Diaspora
} }
/** /**
* @brief Return a list of participating contacts for a thread * Return a list of participating contacts for a thread
* *
* This is used for the participation feature. * This is used for the participation feature.
* One of the parameters is a contact array. * One of the parameters is a contact array.
@ -286,7 +286,7 @@ class Diaspora
} }
/** /**
* @brief repairs a signature that was double encoded * repairs a signature that was double encoded
* *
* The function is unused at the moment. It was copied from the old implementation. * The function is unused at the moment. It was copied from the old implementation.
* *
@ -317,7 +317,7 @@ class Diaspora
} }
/** /**
* @brief verify the envelope and return the verified data * verify the envelope and return the verified data
* *
* @param string $envelope The magic envelope * @param string $envelope The magic envelope
* *
@ -382,7 +382,7 @@ class Diaspora
} }
/** /**
* @brief encrypts data via AES * encrypts data via AES
* *
* @param string $key The AES key * @param string $key The AES key
* @param string $iv The IV (is used for CBC encoding) * @param string $iv The IV (is used for CBC encoding)
@ -396,7 +396,7 @@ class Diaspora
} }
/** /**
* @brief decrypts data via AES * decrypts data via AES
* *
* @param string $key The AES key * @param string $key The AES key
* @param string $iv The IV (is used for CBC encoding) * @param string $iv The IV (is used for CBC encoding)
@ -659,7 +659,7 @@ class Diaspora
/** /**
* @brief Dispatches public messages and find the fitting receivers * Dispatches public messages and find the fitting receivers
* *
* @param array $msg The post that will be dispatched * @param array $msg The post that will be dispatched
* *
@ -687,7 +687,7 @@ class Diaspora
} }
/** /**
* @brief Dispatches the different message types to the different functions * Dispatches the different message types to the different functions
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $msg The post that will be dispatched * @param array $msg The post that will be dispatched
@ -792,7 +792,7 @@ class Diaspora
} }
/** /**
* @brief Checks if a posting is valid and fetches the data fields. * Checks if a posting is valid and fetches the data fields.
* *
* This function does not only check the signature. * This function does not only check the signature.
* It also does the conversion between the old and the new diaspora format. * It also does the conversion between the old and the new diaspora format.
@ -945,7 +945,7 @@ class Diaspora
} }
/** /**
* @brief Fetches the public key for a given handle * Fetches the public key for a given handle
* *
* @param string $handle The handle * @param string $handle The handle
* *
@ -968,7 +968,7 @@ class Diaspora
} }
/** /**
* @brief Fetches data for a given handle * Fetches data for a given handle
* *
* @param string $handle The handle * @param string $handle The handle
* @param boolean $update true = always update, false = never update, null = update when not found or outdated * @param boolean $update true = always update, false = never update, null = update when not found or outdated
@ -1022,7 +1022,7 @@ class Diaspora
} }
/** /**
* @brief Updates the fcontact table * Updates the fcontact table
* *
* @param array $arr The fcontact data * @param array $arr The fcontact data
* @throws \Exception * @throws \Exception
@ -1043,7 +1043,7 @@ class Diaspora
} }
/** /**
* @brief get a handle (user@domain.tld) from a given contact id * get a handle (user@domain.tld) from a given contact id
* *
* @param int $contact_id The id in the contact table * @param int $contact_id The id in the contact table
* @param int $pcontact_id The id in the contact table (Used for the public contact) * @param int $pcontact_id The id in the contact table (Used for the public contact)
@ -1090,7 +1090,7 @@ class Diaspora
} }
/** /**
* @brief get a url (scheme://domain.tld/u/user) from a given Diaspora* * get a url (scheme://domain.tld/u/user) from a given Diaspora*
* fcontact guid * fcontact guid
* *
* @param mixed $fcontact_guid Hexadecimal string guid * @param mixed $fcontact_guid Hexadecimal string guid
@ -1116,7 +1116,7 @@ class Diaspora
} }
/** /**
* @brief Get a contact id for a given handle * Get a contact id for a given handle
* *
* @todo Move to Friendica\Model\Contact * @todo Move to Friendica\Model\Contact
* *
@ -1160,7 +1160,7 @@ class Diaspora
} }
/** /**
* @brief Check if posting is allowed for this contact * Check if posting is allowed for this contact
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $contact The contact that is checked * @param array $contact The contact that is checked
@ -1213,7 +1213,7 @@ class Diaspora
} }
/** /**
* @brief Fetches the contact id for a handle and checks if posting is allowed * Fetches the contact id for a handle and checks if posting is allowed
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param string $handle The checked handle in the format user@domain.tld * @param string $handle The checked handle in the format user@domain.tld
@ -1245,7 +1245,7 @@ class Diaspora
} }
/** /**
* @brief Does the message already exists on the system? * Does the message already exists on the system?
* *
* @param int $uid The user id * @param int $uid The user id
* @param string $guid The guid of the message * @param string $guid The guid of the message
@ -1265,7 +1265,7 @@ class Diaspora
} }
/** /**
* @brief Checks for links to posts in a message * Checks for links to posts in a message
* *
* @param array $item The item array * @param array $item The item array
* @return void * @return void
@ -1291,7 +1291,7 @@ class Diaspora
} }
/** /**
* @brief Checks for relative /people/* links in an item body to match local * Checks for relative /people/* links in an item body to match local
* contacts or prepends the remote host taken from the author link. * contacts or prepends the remote host taken from the author link.
* *
* @param string $body The item body to replace links from * @param string $body The item body to replace links from
@ -1327,7 +1327,7 @@ class Diaspora
} }
/** /**
* @brief sub function of "fetchGuid" which checks for links in messages * sub function of "fetchGuid" which checks for links in messages
* *
* @param array $match array containing a link that has to be checked for a message link * @param array $match array containing a link that has to be checked for a message link
* @param array $item The item array * @param array $item The item array
@ -1343,7 +1343,7 @@ class Diaspora
} }
/** /**
* @brief Fetches an item with a given guid from a given server * Fetches an item with a given guid from a given server
* *
* @param string $guid the message guid * @param string $guid the message guid
* @param string $server The server address * @param string $server The server address
@ -1378,7 +1378,7 @@ class Diaspora
} }
/** /**
* @brief Fetches a message from a server * Fetches a message from a server
* *
* @param string $guid message guid * @param string $guid message guid
* @param string $server The url of the server * @param string $server The url of the server
@ -1457,7 +1457,7 @@ class Diaspora
} }
/** /**
* @brief Fetches an item with a given URL * Fetches an item with a given URL
* *
* @param string $url the message url * @param string $url the message url
* *
@ -1490,7 +1490,7 @@ class Diaspora
} }
/** /**
* @brief Fetches the item record of a given guid * Fetches the item record of a given guid
* *
* @param int $uid The user id * @param int $uid The user id
* @param string $guid message guid * @param string $guid message guid
@ -1534,7 +1534,7 @@ class Diaspora
} }
/** /**
* @brief returns contact details * returns contact details
* *
* @param array $def_contact The default contact if the person isn't found * @param array $def_contact The default contact if the person isn't found
* @param array $person The record of the person * @param array $person The record of the person
@ -1561,7 +1561,7 @@ class Diaspora
} }
/** /**
* @brief Is the profile a hubzilla profile? * Is the profile a hubzilla profile?
* *
* @param string $url The profile link * @param string $url The profile link
* *
@ -1573,7 +1573,7 @@ class Diaspora
} }
/** /**
* @brief Generate a post link with a given handle and message guid * Generate a post link with a given handle and message guid
* *
* @param string $addr The user handle * @param string $addr The user handle
* @param string $guid message guid * @param string $guid message guid
@ -1612,7 +1612,7 @@ class Diaspora
} }
/** /**
* @brief Receives account migration * Receives account migration
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -1675,7 +1675,7 @@ class Diaspora
} }
/** /**
* @brief Processes an account deletion * Processes an account deletion
* *
* @param object $data The message object * @param object $data The message object
* *
@ -1699,7 +1699,7 @@ class Diaspora
} }
/** /**
* @brief Fetch the uri from our database if we already have this item (maybe from ourselves) * Fetch the uri from our database if we already have this item (maybe from ourselves)
* *
* @param string $author Author handle * @param string $author Author handle
* @param string $guid Message guid * @param string $guid Message guid
@ -1728,7 +1728,7 @@ class Diaspora
} }
/** /**
* @brief Fetch the guid from our database with a given uri * Fetch the guid from our database with a given uri
* *
* @param string $uri Message uri * @param string $uri Message uri
* @param string $uid Author handle * @param string $uid Author handle
@ -1747,7 +1747,7 @@ class Diaspora
} }
/** /**
* @brief Find the best importer for a comment, like, ... * Find the best importer for a comment, like, ...
* *
* @param string $guid The guid of the item * @param string $guid The guid of the item
* *
@ -1768,7 +1768,7 @@ class Diaspora
} }
/** /**
* @brief Processes an incoming comment * Processes an incoming comment
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param string $sender The sender of the message * @param string $sender The sender of the message
@ -1885,7 +1885,7 @@ class Diaspora
} }
/** /**
* @brief processes and stores private messages * processes and stores private messages
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $contact The contact of the message * @param array $contact The contact of the message
@ -1945,7 +1945,7 @@ class Diaspora
} }
/** /**
* @brief Processes new private messages (answers to private messages are processed elsewhere) * Processes new private messages (answers to private messages are processed elsewhere)
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $msg Array of the processed message, author handle and key * @param array $msg Array of the processed message, author handle and key
@ -2004,7 +2004,7 @@ class Diaspora
} }
/** /**
* @brief Processes "like" messages * Processes "like" messages
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param string $sender The sender of the message * @param string $sender The sender of the message
@ -2116,7 +2116,7 @@ class Diaspora
} }
/** /**
* @brief Processes private messages * Processes private messages
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2177,7 +2177,7 @@ class Diaspora
} }
/** /**
* @brief Processes participations - unsupported by now * Processes participations - unsupported by now
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2241,7 +2241,7 @@ class Diaspora
} }
/** /**
* @brief Processes photos - unneeded * Processes photos - unneeded
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2256,7 +2256,7 @@ class Diaspora
} }
/** /**
* @brief Processes poll participations - unssupported * Processes poll participations - unssupported
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2270,7 +2270,7 @@ class Diaspora
} }
/** /**
* @brief Processes incoming profile updates * Processes incoming profile updates
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2368,7 +2368,7 @@ class Diaspora
} }
/** /**
* @brief Processes incoming friend requests * Processes incoming friend requests
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $contact The contact that send the request * @param array $contact The contact that send the request
@ -2387,7 +2387,7 @@ class Diaspora
} }
/** /**
* @brief Processes incoming sharing notification * Processes incoming sharing notification
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2499,7 +2499,7 @@ class Diaspora
} }
/** /**
* @brief Fetches a message with a given guid * Fetches a message with a given guid
* *
* @param string $guid message guid * @param string $guid message guid
* @param string $orig_author handle of the original post * @param string $orig_author handle of the original post
@ -2579,7 +2579,7 @@ class Diaspora
} }
/** /**
* @brief Stores a reshare activity * Stores a reshare activity
* *
* @param array $item Array of reshare post * @param array $item Array of reshare post
* @param integer $parent_message_id Id of the parent post * @param integer $parent_message_id Id of the parent post
@ -2627,7 +2627,7 @@ class Diaspora
} }
/** /**
* @brief Processes a reshare message * Processes a reshare message
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param object $data The message object * @param object $data The message object
@ -2732,7 +2732,7 @@ class Diaspora
} }
/** /**
* @brief Processes retractions * Processes retractions
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param array $contact The contact of the item owner * @param array $contact The contact of the item owner
@ -2797,7 +2797,7 @@ class Diaspora
} }
/** /**
* @brief Receives retraction messages * Receives retraction messages
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param string $sender The sender of the message * @param string $sender The sender of the message
@ -2843,7 +2843,7 @@ class Diaspora
} }
/** /**
* @brief Receives status messages * Receives status messages
* *
* @param array $importer Array of the importer user * @param array $importer Array of the importer user
* @param SimpleXMLElement $data The message object * @param SimpleXMLElement $data The message object
@ -2967,7 +2967,7 @@ class Diaspora
* ************************************************************************************** */ * ************************************************************************************** */
/** /**
* @brief returnes the handle of a contact * returnes the handle of a contact
* *
* @param array $contact contact array * @param array $contact contact array
* *
@ -2993,7 +2993,7 @@ class Diaspora
/** /**
* @brief Creates the data for a private message in the new format * Creates the data for a private message in the new format
* *
* @param string $msg The message that is to be transmitted * @param string $msg The message that is to be transmitted
* @param array $user The record of the sender * @param array $user The record of the sender
@ -3035,7 +3035,7 @@ class Diaspora
} }
/** /**
* @brief Creates the envelope for the "fetch" endpoint and for the new format * Creates the envelope for the "fetch" endpoint and for the new format
* *
* @param string $msg The message that is to be transmitted * @param string $msg The message that is to be transmitted
* @param array $user The record of the sender * @param array $user The record of the sender
@ -3075,7 +3075,7 @@ class Diaspora
} }
/** /**
* @brief Create the envelope for a message * Create the envelope for a message
* *
* @param string $msg The message that is to be transmitted * @param string $msg The message that is to be transmitted
* @param array $user The record of the sender * @param array $user The record of the sender
@ -3101,7 +3101,7 @@ class Diaspora
} }
/** /**
* @brief Creates a signature for a message * Creates a signature for a message
* *
* @param array $owner the array of the owner of the message * @param array $owner the array of the owner of the message
* @param array $message The message that is to be signed * @param array $message The message that is to be signed
@ -3120,7 +3120,7 @@ class Diaspora
} }
/** /**
* @brief Transmit a message to a target server * Transmit a message to a target server
* *
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
* @param array $contact Target of the communication * @param array $contact Target of the communication
@ -3178,7 +3178,7 @@ class Diaspora
/** /**
* @brief Build the post xml * Build the post xml
* *
* @param string $type The message type * @param string $type The message type
* @param array $message The message data * @param array $message The message data
@ -3193,7 +3193,7 @@ class Diaspora
} }
/** /**
* @brief Builds and transmit messages * Builds and transmit messages
* *
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
* @param array $contact Target of the communication * @param array $contact Target of the communication
@ -3228,7 +3228,7 @@ class Diaspora
} }
/** /**
* @brief sends a participation (Used to get all further updates) * sends a participation (Used to get all further updates)
* *
* @param array $contact Target of the communication * @param array $contact Target of the communication
* @param array $item Item array * @param array $item Item array
@ -3277,7 +3277,7 @@ class Diaspora
} }
/** /**
* @brief sends an account migration * sends an account migration
* *
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
* @param array $contact Target of the communication * @param array $contact Target of the communication
@ -3305,7 +3305,7 @@ class Diaspora
} }
/** /**
* @brief Sends a "share" message * Sends a "share" message
* *
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
* @param array $contact Target of the communication * @param array $contact Target of the communication
@ -3349,7 +3349,7 @@ class Diaspora
} }
/** /**
* @brief sends an "unshare" * sends an "unshare"
* *
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
* @param array $contact Target of the communication * @param array $contact Target of the communication
@ -3370,7 +3370,7 @@ class Diaspora
} }
/** /**
* @brief Checks a message body if it is a reshare * Checks a message body if it is a reshare
* *
* @param string $body The message body that is to be check * @param string $body The message body that is to be check
* @param bool $complete Should it be a complete check or a simple check? * @param bool $complete Should it be a complete check or a simple check?
@ -3428,7 +3428,7 @@ class Diaspora
} }
/** /**
* @brief Create an event array * Create an event array
* *
* @param integer $event_id The id of the event * @param integer $event_id The id of the event
* *
@ -3508,7 +3508,7 @@ class Diaspora
} }
/** /**
* @brief Create a post (status message or reshare) * Create a post (status message or reshare)
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3647,7 +3647,7 @@ class Diaspora
} }
/** /**
* @brief Sends a post * Sends a post
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3666,7 +3666,7 @@ class Diaspora
} }
/** /**
* @brief Creates a "like" object * Creates a "like" object
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3698,7 +3698,7 @@ class Diaspora
} }
/** /**
* @brief Creates an "EventParticipation" object * Creates an "EventParticipation" object
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3736,7 +3736,7 @@ class Diaspora
} }
/** /**
* @brief Creates the object for a comment * Creates the object for a comment
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3803,7 +3803,7 @@ class Diaspora
} }
/** /**
* @brief Send a like or a comment * Send a like or a comment
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3837,7 +3837,7 @@ class Diaspora
} }
/** /**
* @brief Creates a message from a signature record entry * Creates a message from a signature record entry
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @return array The message * @return array The message
@ -3882,7 +3882,7 @@ class Diaspora
} }
/** /**
* @brief Relays messages (like, comment, retraction) to other servers if we are the thread owner * Relays messages (like, comment, retraction) to other servers if we are the thread owner
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3938,7 +3938,7 @@ class Diaspora
} }
/** /**
* @brief Sends a retraction (deletion) of a message, like or comment * Sends a retraction (deletion) of a message, like or comment
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner the array of the item owner * @param array $owner the array of the item owner
@ -3973,7 +3973,7 @@ class Diaspora
} }
/** /**
* @brief Sends a mail * Sends a mail
* *
* @param array $item The item that will be exported * @param array $item The item that will be exported
* @param array $owner The owner * @param array $owner The owner
@ -4024,7 +4024,7 @@ class Diaspora
} }
/** /**
* @brief Split a name into first name and last name * Split a name into first name and last name
* *
* @param string $name The name * @param string $name The name
* *
@ -4080,7 +4080,7 @@ class Diaspora
} }
/** /**
* @brief Create profile data * Create profile data
* *
* @param int $uid The user id * @param int $uid The user id
* *
@ -4165,7 +4165,7 @@ class Diaspora
} }
/** /**
* @brief Sends profile data * Sends profile data
* *
* @param int $uid The user id * @param int $uid The user id
* @param bool $recips optional, default false * @param bool $recips optional, default false
@ -4207,7 +4207,7 @@ class Diaspora
} }
/** /**
* @brief Creates the signature for likes that are created on our system * Creates the signature for likes that are created on our system
* *
* @param integer $uid The user of that comment * @param integer $uid The user of that comment
* @param array $item Item array * @param array $item Item array
@ -4238,7 +4238,7 @@ class Diaspora
} }
/** /**
* @brief Creates the signature for Comments that are created on our system * Creates the signature for Comments that are created on our system
* *
* @param integer $uid The user of that comment * @param integer $uid The user of that comment
* @param array $item Item array * @param array $item Item array

2
src/Protocol/Email.php
View file

@ -12,7 +12,7 @@ use Friendica\Model\Item;
use Friendica\Util\Strings; use Friendica\Util\Strings;
/** /**
* @brief Email class * Email class
*/ */
class Email class Email
{ {

6
src/Protocol/Feed.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Protocol/Feed.php * @file src/Protocol/Feed.php
* @brief Imports RSS/RDF/Atom feeds * Imports RSS/RDF/Atom feeds
* *
*/ */
namespace Friendica\Protocol; namespace Friendica\Protocol;
@ -19,12 +19,12 @@ use Friendica\Util\ParseUrl;
use Friendica\Util\XML; use Friendica\Util\XML;
/** /**
* @brief This class contain functions to import feeds * This class contain functions to import feeds
* *
*/ */
class Feed { class Feed {
/** /**
* @brief Read a RSS/RDF/Atom feed and create an item entry for it * Read a RSS/RDF/Atom feed and create an item entry for it
* *
* @param string $xml The feed data * @param string $xml The feed data
* @param array $importer The user record of the importer * @param array $importer The user record of the importer

70
src/Protocol/OStatus.php
View file

@ -33,7 +33,7 @@ require_once 'mod/share.php';
require_once 'include/api.php'; require_once 'include/api.php';
/** /**
* @brief This class contain functions for the OStatus protocol * This class contain functions for the OStatus protocol
*/ */
class OStatus class OStatus
{ {
@ -41,7 +41,7 @@ class OStatus
private static $conv_list = []; private static $conv_list = [];
/** /**
* @brief Fetches author data * Fetches author data
* *
* @param DOMXPath $xpath The xpath object * @param DOMXPath $xpath The xpath object
* @param object $context The xml context of the author details * @param object $context The xml context of the author details
@ -240,7 +240,7 @@ class OStatus
} }
/** /**
* @brief Fetches author data from a given XML string * Fetches author data from a given XML string
* *
* @param string $xml The XML * @param string $xml The XML
* @param array $importer user record of the importing user * @param array $importer user record of the importing user
@ -277,7 +277,7 @@ class OStatus
} }
/** /**
* @brief Read attributes from element * Read attributes from element
* *
* @param object $element Element object * @param object $element Element object
* *
@ -295,7 +295,7 @@ class OStatus
} }
/** /**
* @brief Imports an XML string containing OStatus elements * Imports an XML string containing OStatus elements
* *
* @param string $xml The XML * @param string $xml The XML
* @param array $importer user record of the importing user * @param array $importer user record of the importing user
@ -311,7 +311,7 @@ class OStatus
} }
/** /**
* @brief Internal feed processing * Internal feed processing
* *
* @param string $xml The XML * @param string $xml The XML
* @param array $importer user record of the importing user * @param array $importer user record of the importing user
@ -576,7 +576,7 @@ class OStatus
} }
/** /**
* @brief Processes the XML for a post * Processes the XML for a post
* *
* @param DOMXPath $xpath The xpath object * @param DOMXPath $xpath The xpath object
* @param object $entry The xml entry that is processed * @param object $entry The xml entry that is processed
@ -725,7 +725,7 @@ class OStatus
} }
/** /**
* @brief Fetch the conversation for posts * Fetch the conversation for posts
* *
* @param string $conversation The link to the conversation * @param string $conversation The link to the conversation
* @param string $conversation_uri The conversation in "uri" format * @param string $conversation_uri The conversation in "uri" format
@ -787,7 +787,7 @@ class OStatus
} }
/** /**
* @brief Store a feed in several conversation entries * Store a feed in several conversation entries
* *
* @param string $xml The feed * @param string $xml The feed
* @param string $conversation conversation * @param string $conversation conversation
@ -868,7 +868,7 @@ class OStatus
} }
/** /**
* @brief Fetch the own post so that it can be stored later * Fetch the own post so that it can be stored later
* *
* We want to store the original data for later processing. * We want to store the original data for later processing.
* This function is meant for cases where we process a feed with multiple entries. * This function is meant for cases where we process a feed with multiple entries.
@ -907,7 +907,7 @@ class OStatus
} }
/** /**
* @brief Fetch related posts and processes them * Fetch related posts and processes them
* *
* @param string $related The link to the related item * @param string $related The link to the related item
* @param string $related_uri The related item in "uri" format * @param string $related_uri The related item in "uri" format
@ -1016,7 +1016,7 @@ class OStatus
} }
/** /**
* @brief Processes the XML for a repeated post * Processes the XML for a repeated post
* *
* @param DOMXPath $xpath The xpath object * @param DOMXPath $xpath The xpath object
* @param object $entry The xml entry that is processed * @param object $entry The xml entry that is processed
@ -1085,7 +1085,7 @@ class OStatus
} }
/** /**
* @brief Processes links in the XML * Processes links in the XML
* *
* @param object $links The xml data that contain links * @param object $links The xml data that contain links
* @param array $item The item array * @param array $item The item array
@ -1155,7 +1155,7 @@ class OStatus
} }
/** /**
* @brief Create an url out of an uri * Create an url out of an uri
* *
* @param string $href URI in the format "parameter1:parameter1:..." * @param string $href URI in the format "parameter1:parameter1:..."
* *
@ -1187,7 +1187,7 @@ class OStatus
} }
/** /**
* @brief Checks if the current post is a reshare * Checks if the current post is a reshare
* *
* @param array $item The item array of thw post * @param array $item The item array of thw post
* *
@ -1204,7 +1204,7 @@ class OStatus
} }
/** /**
* @brief Cleans the body of a post if it contains picture links * Cleans the body of a post if it contains picture links
* *
* @param string $body The body * @param string $body The body
* *
@ -1242,7 +1242,7 @@ class OStatus
} }
/** /**
* @brief Adds the header elements to the XML document * Adds the header elements to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster
@ -1331,7 +1331,7 @@ class OStatus
} }
/** /**
* @brief Add the link to the push hubs to the XML document * Add the link to the push hubs to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param object $root XML root element where the hub links are added * @param object $root XML root element where the hub links are added
@ -1346,7 +1346,7 @@ class OStatus
} }
/** /**
* @brief Adds attachment data to the XML document * Adds attachment data to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param object $root XML root element where the hub links are added * @param object $root XML root element where the hub links are added
@ -1419,7 +1419,7 @@ class OStatus
} }
/** /**
* @brief Adds the author element to the XML document * Adds the author element to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster
@ -1505,7 +1505,7 @@ class OStatus
*/ */
/** /**
* @brief Returns the given activity if present - otherwise returns the "post" activity * Returns the given activity if present - otherwise returns the "post" activity
* *
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
* *
@ -1521,7 +1521,7 @@ class OStatus
} }
/** /**
* @brief Returns the given object type if present - otherwise returns the "note" object type * Returns the given object type if present - otherwise returns the "note" object type
* *
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
* *
@ -1537,7 +1537,7 @@ class OStatus
} }
/** /**
* @brief Adds an entry element to the XML document * Adds an entry element to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
@ -1572,7 +1572,7 @@ class OStatus
} }
/** /**
* @brief Adds a source entry to the XML document * Adds a source entry to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $contact Array of the contact that is added * @param array $contact Array of the contact that is added
@ -1594,7 +1594,7 @@ class OStatus
} }
/** /**
* @brief Fetches contact data from the contact or the gcontact table * Fetches contact data from the contact or the gcontact table
* *
* @param string $url URL of the contact * @param string $url URL of the contact
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster
@ -1647,7 +1647,7 @@ class OStatus
} }
/** /**
* @brief Adds an entry element with reshared content * Adds an entry element with reshared content
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
@ -1713,7 +1713,7 @@ class OStatus
} }
/** /**
* @brief Adds an entry element with a "like" * Adds an entry element with a "like"
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
@ -1752,7 +1752,7 @@ class OStatus
} }
/** /**
* @brief Adds the person object element to the XML document * Adds the person object element to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster
@ -1797,7 +1797,7 @@ class OStatus
} }
/** /**
* @brief Adds a follow/unfollow entry element * Adds a follow/unfollow entry element
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $item Data of the follow/unfollow message * @param array $item Data of the follow/unfollow message
@ -1861,7 +1861,7 @@ class OStatus
} }
/** /**
* @brief Adds a regular entry element * Adds a regular entry element
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
@ -1901,7 +1901,7 @@ class OStatus
} }
/** /**
* @brief Adds a header element to the XML document * Adds a header element to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster
@ -1942,7 +1942,7 @@ class OStatus
} }
/** /**
* @brief Adds elements to the XML document * Adds elements to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param \DOMElement $entry Entry element where the content is added * @param \DOMElement $entry Entry element where the content is added
@ -1991,7 +1991,7 @@ class OStatus
} }
/** /**
* @brief Adds the elements at the foot of an entry to the XML document * Adds the elements at the foot of an entry to the XML document
* *
* @param DOMDocument $doc XML document * @param DOMDocument $doc XML document
* @param object $entry The entry element where the elements are added * @param object $entry The entry element where the elements are added
@ -2155,8 +2155,6 @@ class OStatus
* Updates the provided last_update parameter if the result comes from the * Updates the provided last_update parameter if the result comes from the
* cache or it is empty * cache or it is empty
* *
* @brief Creates the XML feed for a given nickname
*
* @param string $owner_nick Nickname of the feed owner * @param string $owner_nick Nickname of the feed owner
* @param string $last_update Date of the last update * @param string $last_update Date of the last update
* @param integer $max_items Number of maximum items to fetch * @param integer $max_items Number of maximum items to fetch
@ -2252,7 +2250,7 @@ class OStatus
} }
/** /**
* @brief Creates the XML for a salmon message * Creates the XML for a salmon message
* *
* @param array $item Data of the item that is to be posted * @param array $item Data of the item that is to be posted
* @param array $owner Contact data of the poster * @param array $owner Contact data of the poster

8
src/Protocol/PortableContact.php
View file

@ -37,7 +37,7 @@ class PortableContact
const USERS_GCONTACTS_FALLBACK = 3; const USERS_GCONTACTS_FALLBACK = 3;
/** /**
* @brief Fetch POCO data * Fetch POCO data
* *
* @param integer $cid Contact ID * @param integer $cid Contact ID
* @param integer $uid User ID * @param integer $uid User ID
@ -61,7 +61,7 @@ class PortableContact
} }
/** /**
* @brief Fetch POCO data from the worker * Fetch POCO data from the worker
* *
* @param integer $cid Contact ID * @param integer $cid Contact ID
* @param integer $uid User ID * @param integer $uid User ID
@ -215,7 +215,7 @@ class PortableContact
} }
/** /**
* @brief Returns a list of all known servers * Returns a list of all known servers
* @return array List of server urls * @return array List of server urls
* @throws Exception * @throws Exception
*/ */
@ -239,7 +239,7 @@ class PortableContact
} }
/** /**
* @brief Fetch server list from remote servers and adds them when they are new. * Fetch server list from remote servers and adds them when they are new.
* *
* @param string $poco URL to the POCO endpoint * @param string $poco URL to the POCO endpoint
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException

3
src/Protocol/Salmon.php
View file

@ -12,7 +12,8 @@ use Friendica\Util\Strings;
use Friendica\Util\XML; use Friendica\Util\XML;
/** /**
* @brief Salmon Protocol class * Salmon Protocol class
*
* The Salmon Protocol is a message exchange protocol running over HTTP designed to decentralize commentary * The Salmon Protocol is a message exchange protocol running over HTTP designed to decentralize commentary
* and annotations made against newsfeed articles such as blog posts. * and annotations made against newsfeed articles such as blog posts.
*/ */

4
src/Util/Arrays.php
View file

@ -6,12 +6,12 @@
namespace Friendica\Util; namespace Friendica\Util;
/** /**
* @brief Array utility class * Array utility class
*/ */
class Arrays class Arrays
{ {
/** /**
* @brief Private constructor * Private constructor
*/ */
private function __construct () { private function __construct () {
// Utitlities don't have instances // Utitlities don't have instances

4
src/Util/BasePath.php
View file

@ -24,7 +24,7 @@ class BasePath
} }
/** /**
* @brief Returns the base filesystem path of the App * Returns the base filesystem path of the App
* *
* It first checks for the internal variable, then for DOCUMENT_ROOT and * It first checks for the internal variable, then for DOCUMENT_ROOT and
* finally for PWD * finally for PWD
@ -56,7 +56,7 @@ class BasePath
} }
/** /**
* @brief Returns a normalized file path * Returns a normalized file path
* *
* This is a wrapper for the "realpath" function. * This is a wrapper for the "realpath" function.
* That function cannot detect the real path when some folders aren't readable. * That function cannot detect the real path when some folders aren't readable.

2
src/Util/Crypto.php
View file

@ -12,7 +12,7 @@ use Friendica\Core\Logger;
use Friendica\Core\System; use Friendica\Core\System;
/** /**
* @brief Crypto class * Crypto class
*/ */
class Crypto class Crypto
{ {

4
src/Util/DateTimeFormat.php
View file

@ -12,7 +12,7 @@ use DateTimeZone;
use Exception; use Exception;
/** /**
* @brief Temporal class * Temporal class
*/ */
class DateTimeFormat class DateTimeFormat
{ {
@ -84,7 +84,7 @@ class DateTimeFormat
} }
/** /**
* @brief General purpose date parse/convert/format function. * General purpose date parse/convert/format function.
* *
* @param string $s Some parseable date/time string * @param string $s Some parseable date/time string
* @param string $tz_to Destination timezone * @param string $tz_to Destination timezone

2
src/Util/Emailer.php
View file

@ -10,7 +10,7 @@ use Friendica\Core\Logger;
use Friendica\Protocol\Email; use Friendica\Protocol\Email;
/** /**
* @brief class to handle emailing * class to handle emailing
*/ */
class Emailer class Emailer
{ {

18
src/Util/ExAuth.php
View file

@ -45,7 +45,7 @@ class ExAuth
private $host; private $host;
/** /**
* @brief Create the class * Create the class
* *
*/ */
public function __construct() public function __construct()
@ -58,7 +58,7 @@ class ExAuth
} }
/** /**
* @brief Standard input reading function, executes the auth with the provided * Standard input reading function, executes the auth with the provided
* parameters * parameters
* *
* @return null * @return null
@ -116,7 +116,7 @@ class ExAuth
} }
/** /**
* @brief Check if the given username exists * Check if the given username exists
* *
* @param array $aCommand The command array * @param array $aCommand The command array
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -162,7 +162,7 @@ class ExAuth
} }
/** /**
* @brief Check remote user existance via HTTP(S) * Check remote user existance via HTTP(S)
* *
* @param string $host The hostname * @param string $host The hostname
* @param string $user Username * @param string $user Username
@ -196,7 +196,7 @@ class ExAuth
} }
/** /**
* @brief Authenticate the given user and password * Authenticate the given user and password
* *
* @param array $aCommand The command array * @param array $aCommand The command array
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -255,7 +255,7 @@ class ExAuth
} }
/** /**
* @brief Check remote credentials via HTTP(S) * Check remote credentials via HTTP(S)
* *
* @param string $host The hostname * @param string $host The hostname
* @param string $user Username * @param string $user Username
@ -290,7 +290,7 @@ class ExAuth
} }
/** /**
* @brief Set the hostname for this process * Set the hostname for this process
* *
* @param string $host The hostname * @param string $host The hostname
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -329,7 +329,7 @@ class ExAuth
} }
/** /**
* @brief write data to the syslog * write data to the syslog
* *
* @param integer $loglevel The syslog loglevel * @param integer $loglevel The syslog loglevel
* @param string $sMessage The syslog message * @param string $sMessage The syslog message
@ -343,7 +343,7 @@ class ExAuth
} }
/** /**
* @brief destroy the class, close the syslog connection. * destroy the class, close the syslog connection.
*/ */
public function __destruct() public function __destruct()
{ {

16
src/Util/HTTPSignature.php
View file

@ -12,7 +12,7 @@ use Friendica\Model\User;
use Friendica\Model\APContact; use Friendica\Model\APContact;
/** /**
* @brief Implements HTTP Signatures per draft-cavage-http-signatures-07. * Implements HTTP Signatures per draft-cavage-http-signatures-07.
* *
* Ported from Hubzilla: https://framagit.org/hubzilla/core/blob/master/Zotlabs/Web/HTTPSig.php * Ported from Hubzilla: https://framagit.org/hubzilla/core/blob/master/Zotlabs/Web/HTTPSig.php
* *
@ -26,7 +26,7 @@ class HTTPSignature
{ {
// See draft-cavage-http-signatures-08 // See draft-cavage-http-signatures-08
/** /**
* @brief Verifies a magic request * Verifies a magic request
* *
* @param $key * @param $key
* *
@ -274,7 +274,7 @@ class HTTPSignature
*/ */
/** /**
* @brief Transmit given data to a target for a user * Transmit given data to a target for a user
* *
* @param array $data Data that is about to be send * @param array $data Data that is about to be send
* @param string $target The URL of the inbox * @param string $target The URL of the inbox
@ -323,7 +323,7 @@ class HTTPSignature
} }
/** /**
* @brief Set the delivery status for a given inbox * Set the delivery status for a given inbox
* *
* @param string $url The URL of the inbox * @param string $url The URL of the inbox
* @param boolean $success Transmission status * @param boolean $success Transmission status
@ -378,7 +378,7 @@ class HTTPSignature
} }
/** /**
* @brief Fetches JSON data for a user * Fetches JSON data for a user
* *
* @param string $request request url * @param string $request request url
* @param integer $uid User id of the requester * @param integer $uid User id of the requester
@ -408,7 +408,7 @@ class HTTPSignature
} }
/** /**
* @brief Fetches raw data for a user * Fetches raw data for a user
* *
* @param string $request request url * @param string $request request url
* @param integer $uid User id of the requester * @param integer $uid User id of the requester
@ -464,7 +464,7 @@ class HTTPSignature
} }
/** /**
* @brief Gets a signer from a given HTTP request * Gets a signer from a given HTTP request
* *
* @param $content * @param $content
* @param $http_headers * @param $http_headers
@ -596,7 +596,7 @@ class HTTPSignature
} }
/** /**
* @brief fetches a key for a given id and actor * fetches a key for a given id and actor
* *
* @param $id * @param $id
* @param $actor * @param $actor

12
src/Util/JsonLD.php
View file

@ -10,12 +10,12 @@ use Exception;
use Friendica\DI; use Friendica\DI;
/** /**
* @brief This class contain methods to work with JsonLD data * This class contain methods to work with JsonLD data
*/ */
class JsonLD class JsonLD
{ {
/** /**
* @brief Loader for LD-JSON validation * Loader for LD-JSON validation
* *
* @param $url * @param $url
* *
@ -51,7 +51,7 @@ class JsonLD
} }
/** /**
* @brief Normalises a given JSON array * Normalises a given JSON array
* *
* @param array $json * @param array $json
* *
@ -85,7 +85,7 @@ class JsonLD
} }
/** /**
* @brief Compacts a given JSON array * Compacts a given JSON array
* *
* @param array $json * @param array $json
* *
@ -146,7 +146,7 @@ class JsonLD
} }
/** /**
* @brief Fetches an element array from a JSON array * Fetches an element array from a JSON array
* *
* @param $array * @param $array
* @param $element * @param $element
@ -185,7 +185,7 @@ class JsonLD
} }
/** /**
* @brief Fetches an element from a JSON array * Fetches an element from a JSON array
* *
* @param $array * @param $array
* @param $element * @param $element

2
src/Util/LDSignature.php
View file

@ -6,7 +6,7 @@ use Friendica\Core\Logger;
use Friendica\Model\APContact; use Friendica\Model\APContact;
/** /**
* @brief Implements JSON-LD signatures * Implements JSON-LD signatures
* *
* Ported from Osada: https://framagit.org/macgirvin/osada * Ported from Osada: https://framagit.org/macgirvin/osada
*/ */

23
src/Util/Network.php
View file

@ -22,7 +22,6 @@ class Network
* Set the cookiejar argument to a string (e.g. "/tmp/friendica-cookies.txt") * Set the cookiejar argument to a string (e.g. "/tmp/friendica-cookies.txt")
* to preserve cookies from one request to the next. * to preserve cookies from one request to the next.
* *
* @brief Curl wrapper
* @param string $url URL to fetch * @param string $url URL to fetch
* @param bool $binary default false * @param bool $binary default false
* TRUE if asked to return binary results (file download) * TRUE if asked to return binary results (file download)
@ -47,7 +46,6 @@ class Network
* Inner workings and parameters are the same as @ref fetchUrl but returns an array with * Inner workings and parameters are the same as @ref fetchUrl but returns an array with
* all the information collected during the fetch. * all the information collected during the fetch.
* *
* @brief Curl wrapper with array of return values.
* @param string $url URL to fetch * @param string $url URL to fetch
* @param bool $binary default false * @param bool $binary default false
* TRUE if asked to return binary results (file download) * TRUE if asked to return binary results (file download)
@ -74,7 +72,7 @@ class Network
} }
/** /**
* @brief fetches an URL. * fetches an URL.
* *
* @param string $url URL to fetch * @param string $url URL to fetch
* @param bool $binary default false * @param bool $binary default false
@ -240,7 +238,7 @@ class Network
} }
/** /**
* @brief Send POST request to $url * Send POST request to $url
* *
* @param string $url URL to post * @param string $url URL to post
* @param mixed $params array of POST variables * @param mixed $params array of POST variables
@ -359,7 +357,7 @@ class Network
} }
/** /**
* @brief Check URL to see if it's real * Check URL to see if it's real
* *
* Take a URL from the wild, prepend http:// if necessary * Take a URL from the wild, prepend http:// if necessary
* and check DNS to see if it's real (or check if is a valid IP address) * and check DNS to see if it's real (or check if is a valid IP address)
@ -394,7 +392,7 @@ class Network
} }
/** /**
* @brief Checks that email is an actual resolvable internet address * Checks that email is an actual resolvable internet address
* *
* @param string $addr The email address * @param string $addr The email address
* @return boolean True if it's a valid email address, false if it's not * @return boolean True if it's a valid email address, false if it's not
@ -422,7 +420,7 @@ class Network
} }
/** /**
* @brief Check if URL is allowed * Check if URL is allowed
* *
* Check $url against our list of allowed sites, * Check $url against our list of allowed sites,
* wildcards allowed. If allowed_sites is unset return true; * wildcards allowed. If allowed_sites is unset return true;
@ -497,7 +495,7 @@ class Network
} }
/** /**
* @brief Check if email address is allowed to register here. * Check if email address is allowed to register here.
* *
* Compare against our list (wildcards allowed). * Compare against our list (wildcards allowed).
* *
@ -526,7 +524,6 @@ class Network
/** /**
* Checks for the existence of a domain in a domain list * Checks for the existence of a domain in a domain list
* *
* @brief Checks for the existence of a domain in a domain list
* @param string $domain * @param string $domain
* @param array $domain_list * @param array $domain_list
* @return boolean * @return boolean
@ -564,7 +561,7 @@ class Network
} }
/** /**
* @brief Remove Google Analytics and other tracking platforms params from URL * Remove Google Analytics and other tracking platforms params from URL
* *
* @param string $url Any user-submitted URL that may contain tracking params * @param string $url Any user-submitted URL that may contain tracking params
* @return string The same URL stripped of tracking parameters * @return string The same URL stripped of tracking parameters
@ -613,7 +610,7 @@ class Network
} }
/** /**
* @brief Returns the original URL of the provided URL * Returns the original URL of the provided URL
* *
* This function strips tracking query params and follows redirections, either * This function strips tracking query params and follows redirections, either
* through HTTP code or meta refresh tags. Stops after 10 redirections. * through HTTP code or meta refresh tags. Stops after 10 redirections.
@ -733,7 +730,7 @@ class Network
} }
/** /**
* @brief Find the matching part between two url * Find the matching part between two url
* *
* @param string $url1 * @param string $url1
* @param string $url2 * @param string $url2
@ -821,7 +818,7 @@ class Network
} }
/** /**
* @brief Glue url parts together * Glue url parts together
* *
* @param array $parsed URL parts * @param array $parsed URL parts
* *

16
src/Util/ParseUrl.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Util/ParseUrl.php * @file src/Util/ParseUrl.php
* @brief Get informations about a given URL * Get informations about a given URL
*/ */
namespace Friendica\Util; namespace Friendica\Util;
@ -13,7 +13,7 @@ use Friendica\Core\Logger;
use Friendica\Database\DBA; use Friendica\Database\DBA;
/** /**
* @brief Class with methods for extracting certain content from an url * Class with methods for extracting certain content from an url
*/ */
class ParseUrl class ParseUrl
{ {
@ -28,7 +28,7 @@ class ParseUrl
const MIN_DESC_COUNT = 100; const MIN_DESC_COUNT = 100;
/** /**
* @brief Search for chached embeddable data of an url otherwise fetch it * Search for chached embeddable data of an url otherwise fetch it
* *
* @param string $url The url of the page which should be scraped * @param string $url The url of the page which should be scraped
* @param bool $no_guessing If true the parse doens't search for * @param bool $no_guessing If true the parse doens't search for
@ -80,7 +80,7 @@ class ParseUrl
} }
/** /**
* @brief Parse a page for embeddable content information * Parse a page for embeddable content information
* *
* This method parses to url for meta data which can be used to embed * This method parses to url for meta data which can be used to embed
* the content. If available it prioritizes Open Graph meta tags. * the content. If available it prioritizes Open Graph meta tags.
@ -376,7 +376,7 @@ class ParseUrl
} }
/** /**
* @brief Convert tags from CSV to an array * Convert tags from CSV to an array
* *
* @param string $string Tags * @param string $string Tags
* @return array with formatted Hashtags * @return array with formatted Hashtags
@ -393,9 +393,9 @@ class ParseUrl
} }
/** /**
* @brief Add a hasht sign to a string * Add a hasht sign to a string
* *
* This method is used as callback function * This method is used as callback function
* *
* @param string $tag The pure tag name * @param string $tag The pure tag name
* @param int $k Counter for internal use * @param int $k Counter for internal use
@ -407,7 +407,7 @@ class ParseUrl
} }
/** /**
* @brief Add a scheme to an url * Add a scheme to an url
* *
* The src attribute of some html elements (e.g. images) * The src attribute of some html elements (e.g. images)
* can miss the scheme so we need to add the correct * can miss the scheme so we need to add the correct

12
src/Util/Pidfile.php
View file

@ -5,12 +5,12 @@
namespace Friendica\Util; namespace Friendica\Util;
/** /**
* @brief Pidfile class * Pidfile class
*/ */
class PidFile class PidFile
{ {
/** /**
* @brief Read the pid from a given pid file * Read the pid from a given pid file
* *
* @param string $file Filename of pid file * @param string $file Filename of pid file
* *
@ -25,7 +25,7 @@ class PidFile
} }
/** /**
* @brief Is there a running process with the given pid file * Is there a running process with the given pid file
* *
* @param string $file Filename of pid file * @param string $file Filename of pid file
* *
@ -49,7 +49,7 @@ class PidFile
} }
/** /**
* @brief Kills a process from a given pid file * Kills a process from a given pid file
* *
* @param string $file Filename of pid file * @param string $file Filename of pid file
* *
@ -74,7 +74,7 @@ class PidFile
} }
/** /**
* @brief Creates a pid file * Creates a pid file
* *
* @param string $file Filename of pid file * @param string $file Filename of pid file
* *
@ -96,7 +96,7 @@ class PidFile
} }
/** /**
* @brief Deletes a given pid file * Deletes a given pid file
* *
* @param string $file Filename of pid file * @param string $file Filename of pid file
* *

14
src/Util/Proxy.php
View file

@ -6,7 +6,7 @@ use Friendica\Core\Config;
use Friendica\DI; use Friendica\DI;
/** /**
* @brief Proxy utilities class * Proxy utilities class
*/ */
class Proxy class Proxy
{ {
@ -39,14 +39,14 @@ class Proxy
]; ];
/** /**
* @brief Private constructor * Private constructor
*/ */
private function __construct () { private function __construct () {
// No instances from utilities classes // No instances from utilities classes
} }
/** /**
* @brief Transform a remote URL into a local one. * Transform a remote URL into a local one.
* *
* This function only performs the URL replacement on http URL and if the * This function only performs the URL replacement on http URL and if the
* provided URL isn't local, "the isn't deactivated" (sic) and if the config * provided URL isn't local, "the isn't deactivated" (sic) and if the config
@ -128,7 +128,7 @@ class Proxy
} }
/** /**
* @brief "Proxifies" HTML code's image tags * "Proxifies" HTML code's image tags
* *
* "Proxifies", means replaces image URLs in given HTML code with those from * "Proxifies", means replaces image URLs in given HTML code with those from
* proxy storage directory. * proxy storage directory.
@ -146,7 +146,7 @@ class Proxy
} }
/** /**
* @brief Checks if the URL is a local URL. * Checks if the URL is a local URL.
* *
* @param string $url * @param string $url
* @return boolean * @return boolean
@ -170,7 +170,7 @@ class Proxy
} }
/** /**
* @brief Return the array of query string parameters from a URL * Return the array of query string parameters from a URL
* *
* @param string $url URL to parse * @param string $url URL to parse
* @return array Associative array of query string parameters * @return array Associative array of query string parameters
@ -186,7 +186,7 @@ class Proxy
} }
/** /**
* @brief Call-back method to replace the UR * Call-back method to replace the UR
* *
* @param array $matches Matches from preg_replace_callback() * @param array $matches Matches from preg_replace_callback()
* @return string Proxified HTML image tag * @return string Proxified HTML image tag

26
src/Util/Strings.php
View file

@ -10,12 +10,12 @@ use Friendica\Content\ContactSelector;
use Friendica\Core\Logger; use Friendica\Core\Logger;
/** /**
* @brief This class handles string functions * This class handles string functions
*/ */
class Strings class Strings
{ {
/** /**
* @brief Generates a pseudo-random string of hexadecimal characters * Generates a pseudo-random string of hexadecimal characters
* *
* @param int $size * @param int $size
* @return string * @return string
@ -45,7 +45,7 @@ class Strings
} }
/** /**
* @brief This is our primary input filter. * This is our primary input filter.
* *
* Use this on any text input where angle chars are not valid or permitted * Use this on any text input where angle chars are not valid or permitted
* They will be replaced with safer brackets. This may be filtered further * They will be replaced with safer brackets. This may be filtered further
@ -60,7 +60,7 @@ class Strings
} }
/** /**
* @brief Use this on "body" or "content" input where angle chars shouldn't be removed, * Use this on "body" or "content" input where angle chars shouldn't be removed,
* and allow them to be safely displayed. * and allow them to be safely displayed.
* @param string $string * @param string $string
* *
@ -72,7 +72,7 @@ class Strings
} }
/** /**
* @brief Generate a string that's random, but usually pronounceable. Used to generate initial passwords * Generate a string that's random, but usually pronounceable. Used to generate initial passwords
* *
* @param int $len length * @param int $len length
* *
@ -179,7 +179,7 @@ class Strings
} }
/** /**
* @brief Remove indentation from a text * Remove indentation from a text
* *
* @param string $text String to be transformed. * @param string $text String to be transformed.
* @param string $chr Optional. Indentation tag. Default tab (\t). * @param string $chr Optional. Indentation tag. Default tab (\t).
@ -209,7 +209,7 @@ class Strings
} }
/** /**
* @brief Get byte size returned in a Data Measurement (KB, MB, GB) * Get byte size returned in a Data Measurement (KB, MB, GB)
* *
* @param int $bytes The number of bytes to be measured * @param int $bytes The number of bytes to be measured
* @param int $precision Optional. Default 2. * @param int $precision Optional. Default 2.
@ -228,7 +228,7 @@ class Strings
} }
/** /**
* @brief Protect percent characters in sprintf calls * Protect percent characters in sprintf calls
* *
* @param string $s String to transform. * @param string $s String to transform.
* *
@ -240,7 +240,7 @@ class Strings
} }
/** /**
* @brief Base64 Encode URL and translate +/ to -_ Optionally strip padding. * Base64 Encode URL and translate +/ to -_ Optionally strip padding.
* *
* @param string $s URL to encode * @param string $s URL to encode
* @param boolean $strip_padding Optional. Default false * @param boolean $strip_padding Optional. Default false
@ -259,7 +259,7 @@ class Strings
} }
/** /**
* @brief Decode Base64 Encoded URL and translate -_ to +/ * Decode Base64 Encoded URL and translate -_ to +/
* @param string $s URL to decode * @param string $s URL to decode
* *
* @return string Decoded URL * @return string Decoded URL
@ -292,7 +292,7 @@ class Strings
} }
/** /**
* @brief Normalize url * Normalize url
* *
* @param string $url URL to be normalized. * @param string $url URL to be normalized.
* *
@ -305,7 +305,7 @@ class Strings
} }
/** /**
* @brief Normalize OpenID identity * Normalize OpenID identity
* *
* @param string $s OpenID Identity * @param string $s OpenID Identity
* *
@ -317,7 +317,7 @@ class Strings
} }
/** /**
* @brief Compare two URLs to see if they are the same, but ignore * Compare two URLs to see if they are the same, but ignore
* slight but hopefully insignificant differences such as if one * slight but hopefully insignificant differences such as if one
* is https and the other isn't, or if one is www.something and * is https and the other isn't, or if one is www.something and
* the other isn't - and also ignore case differences. * the other isn't - and also ignore case differences.

26
src/Util/Temporal.php
View file

@ -13,12 +13,12 @@ use Friendica\Core\Renderer;
use Friendica\Database\DBA; use Friendica\Database\DBA;
/** /**
* @brief Temporal class * Temporal class
*/ */
class Temporal class Temporal
{ {
/** /**
* @brief Two-level sort for timezones. * Two-level sort for timezones.
* *
* @param string $a * @param string $a
* @param string $b * @param string $b
@ -45,7 +45,7 @@ class Temporal
} }
/** /**
* @brief Emit a timezone selector grouped (primarily) by continent * Emit a timezone selector grouped (primarily) by continent
* *
* @param string $current Timezone * @param string $current Timezone
* @return string Parsed HTML output * @return string Parsed HTML output
@ -90,7 +90,7 @@ class Temporal
} }
/** /**
* @brief Generating a Timezone selector * Generating a Timezone selector
* *
* Return a select using 'field_select_raw' template, with timezones * Return a select using 'field_select_raw' template, with timezones
* grouped (primarily) by continent * grouped (primarily) by continent
@ -118,7 +118,7 @@ class Temporal
} }
/** /**
* @brief Wrapper for date selector, tailored for use in birthday fields. * Wrapper for date selector, tailored for use in birthday fields.
* *
* @param string $dob Date of Birth * @param string $dob Date of Birth
* @param string $timezone * @param string $timezone
@ -154,7 +154,7 @@ class Temporal
} }
/** /**
* @brief Returns a date selector * Returns a date selector
* *
* @param DateTime $min Minimum date * @param DateTime $min Minimum date
* @param DateTime $max Maximum date * @param DateTime $max Maximum date
@ -170,7 +170,7 @@ class Temporal
} }
/** /**
* @brief Returns a time selector * Returns a time selector
* *
* @param string $h Already selected hour * @param string $h Already selected hour
* @param string $m Already selected minute * @param string $m Already selected minute
@ -185,7 +185,7 @@ class Temporal
} }
/** /**
* @brief Returns a datetime selector. * Returns a datetime selector.
* *
* @param DateTime $minDate Minimum date * @param DateTime $minDate Minimum date
* @param DateTime $maxDate Maximum date * @param DateTime $maxDate Maximum date
@ -273,7 +273,7 @@ class Temporal
} }
/** /**
* @brief Returns a relative date string. * Returns a relative date string.
* *
* Implements "3 seconds ago" etc. * Implements "3 seconds ago" etc.
* Based on $posted_date, (UTC). * Based on $posted_date, (UTC).
@ -337,7 +337,7 @@ class Temporal
} }
/** /**
* @brief Returns timezone correct age in years. * Returns timezone correct age in years.
* *
* Returns the age in years, given a date of birth, the timezone of the person * Returns the age in years, given a date of birth, the timezone of the person
* whose date of birth is provided, and the timezone of the person viewing the * whose date of birth is provided, and the timezone of the person viewing the
@ -384,7 +384,7 @@ class Temporal
} }
/** /**
* @brief Get days of a month in a given year. * Get days of a month in a given year.
* *
* Returns number of days in the month of the given year. * Returns number of days in the month of the given year.
* $m = 1 is 'January' to match human usage. * $m = 1 is 'January' to match human usage.
@ -400,7 +400,7 @@ class Temporal
} }
/** /**
* @brief Returns the first day in month for a given month, year. * Returns the first day in month for a given month, year.
* *
* Months start at 1. * Months start at 1.
* *
@ -418,7 +418,7 @@ class Temporal
} }
/** /**
* @brief Output a calendar for the given month, year. * Output a calendar for the given month, year.
* *
* If $links are provided (array), e.g. $links[12] => 'http://mylink' , * If $links are provided (array), e.g. $links[12] => 'http://mylink' ,
* date 12 will be linked appropriately. Today's date is also noted by * date 12 will be linked appropriately. Today's date is also noted by

16
src/Util/XML.php
View file

@ -10,12 +10,12 @@ use Friendica\Core\System;
use SimpleXMLElement; use SimpleXMLElement;
/** /**
* @brief This class contain methods to work with XML data * This class contain methods to work with XML data
*/ */
class XML class XML
{ {
/** /**
* @brief Creates an XML structure out of a given array * Creates an XML structure out of a given array
* *
* @param array $array The array of the XML structure that will be generated * @param array $array The array of the XML structure that will be generated
* @param object $xml The createdXML will be returned by reference * @param object $xml The createdXML will be returned by reference
@ -114,7 +114,7 @@ class XML
} }
/** /**
* @brief Copies an XML object * Copies an XML object
* *
* @param object $source The XML source * @param object $source The XML source
* @param object $target The XML target * @param object $target The XML target
@ -134,7 +134,7 @@ class XML
} }
/** /**
* @brief Create an XML element * Create an XML element
* *
* @param \DOMDocument $doc XML root * @param \DOMDocument $doc XML root
* @param string $element XML element name * @param string $element XML element name
@ -156,7 +156,7 @@ class XML
} }
/** /**
* @brief Create an XML and append it to the parent object * Create an XML and append it to the parent object
* *
* @param \DOMDocument $doc XML root * @param \DOMDocument $doc XML root
* @param object $parent parent object * @param object $parent parent object
@ -172,7 +172,7 @@ class XML
} }
/** /**
* @brief Convert an XML document to a normalised, case-corrected array * Convert an XML document to a normalised, case-corrected array
* used by webfinger * used by webfinger
* *
* @param object $xml_element The XML document * @param object $xml_element The XML document
@ -223,7 +223,7 @@ class XML
} }
/** /**
* @brief Convert the given XML text to an array in the XML structure. * Convert the given XML text to an array in the XML structure.
* *
* Xml::toArray() will convert the given XML text to an array in the XML structure. * Xml::toArray() will convert the given XML text to an array in the XML structure.
* Link: http://www.bin-co.com/php/scripts/xml2array/ * Link: http://www.bin-co.com/php/scripts/xml2array/
@ -401,7 +401,7 @@ class XML
} }
/** /**
* @brief Delete a node in a XML object * Delete a node in a XML object
* *
* @param \DOMDocument $doc XML document * @param \DOMDocument $doc XML document
* @param string $node Node name * @param string $node Node name

2
src/Worker/APDelivery.php
View file

@ -13,7 +13,7 @@ use Friendica\Util\HTTPSignature;
class APDelivery class APDelivery
{ {
/** /**
* @brief Delivers ActivityPub messages * Delivers ActivityPub messages
* *
* @param string $cmd * @param string $cmd
* @param integer $target_id * @param integer $target_id

4
src/Worker/CheckVersion.php
View file

@ -3,7 +3,7 @@
/** /**
* @file src/Worker/CheckVersion.php * @file src/Worker/CheckVersion.php
* *
* @brief save Friendica upstream version to the DB * save Friendica upstream version to the DB
**/ **/
namespace Friendica\Worker; namespace Friendica\Worker;
@ -13,7 +13,7 @@ use Friendica\Database\DBA;
use Friendica\Util\Network; use Friendica\Util\Network;
/** /**
* @brief check the git repository VERSION file and save the version to the DB * check the git repository VERSION file and save the version to the DB
* *
* Checking the upstream version is optional (opt-in) and can be done to either * Checking the upstream version is optional (opt-in) and can be done to either
* the master or the develop branch in the repository. * the master or the develop branch in the repository.

2
src/Worker/CreateShadowEntry.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/CreateShadowEntry.php * @file src/Worker/CreateShadowEntry.php
* @brief This script creates posts with UID = 0 for a given public post. * This script creates posts with UID = 0 for a given public post.
* *
* This script is started from mod/item.php to save some time when doing a post. * This script is started from mod/item.php to save some time when doing a post.
*/ */

4
src/Worker/Cron.php
View file

@ -137,7 +137,7 @@ class Cron
} }
/** /**
* @brief Update public contacts * Update public contacts
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */
private static function updatePublicContacts() { private static function updatePublicContacts() {
@ -163,7 +163,7 @@ class Cron
} }
/** /**
* @brief Poll contacts for unreceived messages * Poll contacts for unreceived messages
* *
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/ */

10
src/Worker/CronJobs.php
View file

@ -89,7 +89,7 @@ class CronJobs
} }
/** /**
* @brief Update the cached values for the number of photo albums per user * Update the cached values for the number of photo albums per user
*/ */
private static function updatePhotoAlbums() private static function updatePhotoAlbums()
{ {
@ -104,7 +104,7 @@ class CronJobs
} }
/** /**
* @brief Expire and remove user entries * Expire and remove user entries
*/ */
private static function expireAndRemoveUsers() private static function expireAndRemoveUsers()
{ {
@ -132,7 +132,7 @@ class CronJobs
} }
/** /**
* @brief Clear cache entries * Clear cache entries
* *
* @param App $a * @param App $a
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -230,7 +230,7 @@ class CronJobs
} }
/** /**
* @brief Repair missing values in Diaspora contacts * Repair missing values in Diaspora contacts
* *
* @param App $a * @param App $a
* @throws \Friendica\Network\HTTPException\InternalServerErrorException * @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -270,7 +270,7 @@ class CronJobs
} }
/** /**
* @brief Do some repairs in database entries * Do some repairs in database entries
* *
*/ */
private static function repairDatabase() private static function repairDatabase()

6
src/Worker/DBClean.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/DBClean.php * @file src/Worker/DBClean.php
* @brief The script is called from time to time to clean the database entries and remove orphaned data. * The script is called from time to time to clean the database entries and remove orphaned data.
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;
@ -26,7 +26,7 @@ class DBClean {
} }
/** /**
* @brief Fork the different DBClean processes * Fork the different DBClean processes
*/ */
private static function forkCleanProcess() { private static function forkCleanProcess() {
// Get the expire days for step 8 and 9 // Get the expire days for step 8 and 9
@ -42,7 +42,7 @@ class DBClean {
} }
/** /**
* @brief Remove orphaned database entries * Remove orphaned database entries
* @param integer $stage What should be deleted? * @param integer $stage What should be deleted?
* *
* Values for $stage: * Values for $stage:

2
src/Worker/DBUpdate.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/DBUpdate.php * @file src/Worker/DBUpdate.php
* @brief This file is called when the database structure needs to be updated * This file is called when the database structure needs to be updated
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

6
src/Worker/Delivery.php
View file

@ -240,7 +240,7 @@ class Delivery
} }
/** /**
* @brief Deliver content via DFRN * Deliver content via DFRN
* *
* @param string $cmd Command * @param string $cmd Command
* @param array $contact Contact record of the receiver * @param array $contact Contact record of the receiver
@ -389,7 +389,7 @@ class Delivery
} }
/** /**
* @brief Deliver content via Diaspora * Deliver content via Diaspora
* *
* @param string $cmd Command * @param string $cmd Command
* @param array $contact Contact record of the receiver * @param array $contact Contact record of the receiver
@ -484,7 +484,7 @@ class Delivery
} }
/** /**
* @brief Deliver content via mail * Deliver content via mail
* *
* @param string $cmd Command * @param string $cmd Command
* @param array $contact Contact record of the receiver * @param array $contact Contact record of the receiver

2
src/Worker/Directory.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/Directory.php * @file src/Worker/Directory.php
* @brief Sends updated profile data to the directory * Sends updated profile data to the directory
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

2
src/Worker/Expire.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/Expire.php * @file src/Worker/Expire.php
* @brief Expires old item entries * Expires old item entries
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

8
src/Worker/OnePoll.php
View file

@ -216,7 +216,7 @@ class OnePoll
} }
/** /**
* @brief Updates a personal contact entry and the public contact entry * Updates a personal contact entry and the public contact entry
* *
* @param array $contact The personal contact entry * @param array $contact The personal contact entry
* @param array $fields The fields that are updated * @param array $fields The fields that are updated
@ -229,7 +229,7 @@ class OnePoll
} }
/** /**
* @brief Poll DFRN contacts * Poll DFRN contacts
* *
* @param array $contact The personal contact entry * @param array $contact The personal contact entry
* @param string $updated The updated date * @param string $updated The updated date
@ -383,7 +383,7 @@ class OnePoll
} }
/** /**
* @brief Poll Feed/OStatus contacts * Poll Feed/OStatus contacts
* *
* @param array $contact The personal contact entry * @param array $contact The personal contact entry
* @param string $protocol The used protocol of the contact * @param string $protocol The used protocol of the contact
@ -433,7 +433,7 @@ class OnePoll
} }
/** /**
* @brief Poll Mail contacts * Poll Mail contacts
* *
* @param array $contact The personal contact entry * @param array $contact The personal contact entry
* @param integer $importer_uid The UID of the importer * @param integer $importer_uid The UID of the importer

2
src/Worker/ProfileUpdate.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/ProfileUpdate.php * @file src/Worker/ProfileUpdate.php
* @brief Send updated profile data to Diaspora and ActivityPub * Send updated profile data to Diaspora and ActivityPub
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

2
src/Worker/RemoveContact.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/RemoveContact.php * @file src/Worker/RemoveContact.php
* @brief Removes orphaned data from deleted contacts * Removes orphaned data from deleted contacts
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

2
src/Worker/RemoveUser.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/RemoveUser.php * @file src/Worker/RemoveUser.php
* @brief Removes orphaned data from deleted users * Removes orphaned data from deleted users
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

2
src/Worker/SpoolPost.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file src/Worker/SpoolPost.php * @file src/Worker/SpoolPost.php
* @brief Posts items that wer spooled because they couldn't be posted. * Posts items that where spooled because they couldn't be posted.
*/ */
namespace Friendica\Worker; namespace Friendica\Worker;

2
tests/Util/Database/StaticDatabase.php
View file

@ -57,7 +57,7 @@ class StaticDatabase extends Database
} }
/** /**
* @brief Does a commit * Does a commit
* *
* @return boolean Was the command executed successfully? * @return boolean Was the command executed successfully?
*/ */

2
tests/src/Util/ACLFormaterTest.php
View file

@ -8,7 +8,7 @@ use Friendica\Util\ACLFormatter;
use PHPUnit\Framework\TestCase; use PHPUnit\Framework\TestCase;
/** /**
* @brief ACLFormater utility testing class * ACLFormater utility testing class
*/ */
class ACLFormaterTest extends TestCase class ACLFormaterTest extends TestCase
{ {

24
tests/src/Util/ArraysTest.php
View file

@ -9,12 +9,12 @@ use Friendica\Util\Arrays;
use PHPUnit\Framework\TestCase; use PHPUnit\Framework\TestCase;
/** /**
* @brief Array utility testing class * Array utility testing class
*/ */
class ArraysTest extends TestCase class ArraysTest extends TestCase
{ {
/** /**
* @brief Tests if an empty array and an empty delimiter returns an empty string. * Tests if an empty array and an empty delimiter returns an empty string.
*/ */
public function testEmptyArrayEmptyDelimiter() public function testEmptyArrayEmptyDelimiter()
{ {
@ -23,7 +23,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if an empty array and a non-empty delimiter returns an empty string. * Tests if an empty array and a non-empty delimiter returns an empty string.
*/ */
public function testEmptyArrayNonEmptyDelimiter() public function testEmptyArrayNonEmptyDelimiter()
{ {
@ -32,7 +32,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a non-empty array and an empty delimiter returns the value (1). * Tests if a non-empty array and an empty delimiter returns the value (1).
*/ */
public function testNonEmptyArrayEmptyDelimiter() public function testNonEmptyArrayEmptyDelimiter()
{ {
@ -41,7 +41,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a non-empty array and an empty delimiter returns the value (12). * Tests if a non-empty array and an empty delimiter returns the value (12).
*/ */
public function testNonEmptyArray2EmptyDelimiter() public function testNonEmptyArray2EmptyDelimiter()
{ {
@ -50,7 +50,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a non-empty array and a non-empty delimiter returns the value (1). * Tests if a non-empty array and a non-empty delimiter returns the value (1).
*/ */
public function testNonEmptyArrayNonEmptyDelimiter() public function testNonEmptyArrayNonEmptyDelimiter()
{ {
@ -59,7 +59,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a non-empty array and a non-empty delimiter returns the value (1,2). * Tests if a non-empty array and a non-empty delimiter returns the value (1,2).
*/ */
public function testNonEmptyArray2NonEmptyDelimiter() public function testNonEmptyArray2NonEmptyDelimiter()
{ {
@ -68,7 +68,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a 2-dim array and an empty delimiter returns the expected string. * Tests if a 2-dim array and an empty delimiter returns the expected string.
*/ */
public function testEmptyMultiArray2EmptyDelimiter() public function testEmptyMultiArray2EmptyDelimiter()
{ {
@ -77,7 +77,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a 2-dim array and an empty delimiter returns the expected string. * Tests if a 2-dim array and an empty delimiter returns the expected string.
*/ */
public function testEmptyMulti2Array2EmptyDelimiter() public function testEmptyMulti2Array2EmptyDelimiter()
{ {
@ -86,7 +86,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a 2-dim array and a non-empty delimiter returns the expected string. * Tests if a 2-dim array and a non-empty delimiter returns the expected string.
*/ */
public function testEmptyMultiArray2NonEmptyDelimiter() public function testEmptyMultiArray2NonEmptyDelimiter()
{ {
@ -95,7 +95,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a 2-dim array and a non-empty delimiter returns the expected string. * Tests if a 2-dim array and a non-empty delimiter returns the expected string.
*/ */
public function testEmptyMulti2Array2NonEmptyDelimiter() public function testEmptyMulti2Array2NonEmptyDelimiter()
{ {
@ -104,7 +104,7 @@ class ArraysTest extends TestCase
} }
/** /**
* @brief Tests if a 3-dim array and a non-empty delimiter returns the expected string. * Tests if a 3-dim array and a non-empty delimiter returns the expected string.
*/ */
public function testEmptyMulti3Array2NonEmptyDelimiter() public function testEmptyMulti3Array2NonEmptyDelimiter()
{ {

2
tests/src/Util/StringsTest.php
View file

@ -8,7 +8,7 @@ use Friendica\Util\Strings;
use PHPUnit\Framework\TestCase; use PHPUnit\Framework\TestCase;
/** /**
* @brief Strings utility test class * Strings utility test class
*/ */
class StringsTest extends TestCase class StringsTest extends TestCase
{ {

2
tests/src/Util/XmlTest.php
View file

@ -8,7 +8,7 @@ use Friendica\Util\XML;
use PHPUnit\Framework\TestCase; use PHPUnit\Framework\TestCase;
/** /**
* @brief XML utility test class * XML utility test class
*/ */
class XmlTest extends TestCase class XmlTest extends TestCase
{ {

2
view/js/autocomplete.js
View file

@ -1,6 +1,6 @@
// @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt Expat // @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt Expat
/** /**
* @brief Friendica people autocomplete * Friendica people autocomplete
* *
* require jQuery, jquery.textcomplete * require jQuery, jquery.textcomplete
* *

2
view/php/none.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file view/theme/frio/php/modes/none.php * @file view/theme/frio/php/modes/none.php
* @brief The site template for pure content (e.g. (modals) * The site template for pure content (e.g. (modals)
* *
* This themplate is used e.g for bs modals. So outputs * This themplate is used e.g for bs modals. So outputs
* only the pure content * only the pure content

4
view/theme/frio/css/font-awesome.custom.css
View file

@ -1,6 +1,6 @@
/* /*
@fiel view/theme/frio/css/font-awesome.custom.css @file view/theme/frio/css/font-awesome.custom.css
@brief This file applies Font Awesome icons to some friendica standard classes This file applies Font Awesome icons to some friendica standard classes
*/ */
.icon:before { .icon:before {

2
view/theme/frio/js/mod_admin.js
View file

@ -1,5 +1,5 @@
/** /**
* @brief Javascript for the admin module * Javascript for the admin module
*/ */
$(function() { $(function() {
$('body').on('click', '.selectall', function() { $('body').on('click', '.selectall', function() {

2
view/theme/frio/js/mod_contacts.js
View file

@ -20,7 +20,7 @@ $(document).ready(function() {
}); });
/** /**
* @brief This function submits the form with the batch action values. * This function submits the form with the batch action values.
* *
* @param {string} name The name of the batch action. * @param {string} name The name of the batch action.
* @param {string} value If it isn't empty the action will be posted. * @param {string} value If it isn't empty the action will be posted.

2
view/theme/frio/js/mod_display.js
View file

@ -1,5 +1,5 @@
/** /**
* @brief Javascript for the display module * Javascript for the display module
*/ */
// Catch the GUID from the URL // Catch the GUID from the URL

2
view/theme/frio/js/mod_events.js
View file

@ -1,6 +1,6 @@
/** /**
* @file view/theme/frio/js/mod_events.js * @file view/theme/frio/js/mod_events.js
* @brief Initialization of the fullCalendar and format the output. * Initialization of the fullCalendar and format the output.
*/ */
$(document).ready(function() { $(document).ready(function() {

8
view/theme/frio/js/mod_group.js
View file

@ -1,7 +1,7 @@
/** /**
* @file view/theme/frio/js/mod_group.js * @file view/theme/frio/js/mod_group.js
* @brief The javascript for the group module * The javascript for the group module
*/ */
@ -13,7 +13,7 @@ $(document).ready(function() {
}); });
/** /**
* @brief Change the group membership of the contacts and fetch the new grup list * Change the group membership of the contacts and fetch the new grup list
* as html * as html
* *
* @param {int} gid The group ID * @param {int} gid The group ID
@ -41,7 +41,7 @@ function groupChangeMember(gid, cid, sec_token) {
} }
/** /**
* @brief Change the group list view mode * Change the group list view mode
* *
* @param {object} elm The button element of the view mode switcher * @param {object} elm The button element of the view mode switcher
* @returns {undefined} * @returns {undefined}
@ -61,7 +61,7 @@ function switchGroupViewMode(elm) {
} }
/** /**
* @brief Filter the group member list for contacts * Filter the group member list for contacts
* *
* @returns {undefined} * @returns {undefined}
*/ */

2
view/theme/frio/js/mod_notifications.js
View file

@ -1,6 +1,6 @@
/** /**
* @brief Javascript for the notifications module * Javascript for the notifications module
*/ */
// Catch the intro ID from the URL // Catch the intro ID from the URL

4
view/theme/frio/js/modal.js
View file

@ -1,5 +1,5 @@
/** /**
* @brief Contains functions for bootstrap modal handling. * Contains functions for bootstrap modal handling.
*/ */
$(document).ready(function(){ $(document).ready(function(){
// Clear bs modal on close. // Clear bs modal on close.
@ -175,7 +175,7 @@ Dialog._load = function(url) {
}; };
/** /**
* @brief Add first element with the class "heading" as modal title * Add first element with the class "heading" as modal title
* *
* Note: this should be really done in the template * Note: this should be really done in the template
* and is the solution where we havent done it until this * and is the solution where we havent done it until this

2
view/theme/frio/js/textedit.js
View file

@ -1,5 +1,5 @@
/* /*
* @brief The file contains functions for text editing and commenting * The file contains functions for text editing and commenting
*/ */
// Lifted from https://css-tricks.com/snippets/jquery/move-cursor-to-end-of-textarea-or-input/ // Lifted from https://css-tricks.com/snippets/jquery/move-cursor-to-end-of-textarea-or-input/

6
view/theme/frio/php/Image.php
View file

@ -1,18 +1,18 @@
<?php <?php
/** /**
* @file view/theme/frio/php/Image.php * @file view/theme/frio/php/Image.php
* @brief contain methods to deal with images * contain methods to deal with images
*/ */
/** /**
* @brief This class contains methods to deal with images * This class contains methods to deal with images
*/ */
use Friendica\Core\L10n; use Friendica\Core\L10n;
class Image class Image
{ {
/** /**
* @brief Give all available options for the background image * Give all available options for the background image
* *
* @param array $arr Array with the present user settings * @param array $arr Array with the present user settings
* *

2
view/theme/frio/php/default.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file view/theme/frio/php/modes/default.php * @file view/theme/frio/php/modes/default.php
* @brief The default site template * The default site template
*/ */
?> ?>
<!DOCTYPE html > <!DOCTYPE html >

14
view/theme/frio/php/frio_boot.php
View file

@ -3,7 +3,7 @@
/** /**
* @file view/theme/frio/php/frio_boot.php * @file view/theme/frio/php/frio_boot.php
* *
* @brief This file contains functions for page construction * This file contains functions for page construction
* *
*/ */
@ -11,7 +11,7 @@ use Friendica\App;
use Friendica\DI; use Friendica\DI;
/** /**
* @brief Load page template in dependence of the template mode * Load page template in dependence of the template mode
* *
* @todo Check if this is really needed. * @todo Check if this is really needed.
*/ */
@ -33,7 +33,7 @@ function load_page(App $a)
} }
/** /**
* @brief Check if page is a modal page * Check if page is a modal page
* *
* This function checks if $_REQUEST['pagename'] is * This function checks if $_REQUEST['pagename'] is
* a defined in a $modalpages * a defined in a $modalpages
@ -54,7 +54,7 @@ function is_modal() {
} }
/** /**
* @brief Array with modalpages * Array with modalpages
* *
* The array contains the page names of the pages * The array contains the page names of the pages
* which should displayed as modals * which should displayed as modals
@ -74,7 +74,7 @@ function get_modalpage_list() {
} }
/** /**
* @brief Array with standard pages * Array with standard pages
* *
* The array contains the page names of the pages * The array contains the page names of the pages
* which should displayed as standard-page * which should displayed as standard-page
@ -91,7 +91,7 @@ function get_standard_page_list() {
} }
/** /**
* @brief Check if page is standard page * Check if page is standard page
* *
* This function checks if $_REQUEST['pagename'] is * This function checks if $_REQUEST['pagename'] is
* a defined $standardpages * a defined $standardpages
@ -112,7 +112,7 @@ function is_standard_page($pagetitle) {
return $is_standard_page; return $is_standard_page;
} }
/** /**
* @brief Get the typ of the page * Get the typ of the page
* *
* @param type $pagetitle * @param type $pagetitle
* @return string * @return string

2
view/theme/frio/php/standard.php
View file

@ -1,7 +1,7 @@
<?php <?php
/** /**
* @file view/theme/frio/php/modes/default.php * @file view/theme/frio/php/modes/default.php
* @brief The default site template * The default site template
*/ */
?> ?>
<!DOCTYPE html > <!DOCTYPE html >

10
view/theme/frio/theme.php
View file

@ -77,7 +77,7 @@ function frio_uninstall()
} }
/** /**
* @brief Replace friendica photo links hook * Replace friendica photo links hook
* *
* This function does replace the links to photos * This function does replace the links to photos
* of other friendica users. Original the photos are * of other friendica users. Original the photos are
@ -115,7 +115,7 @@ function frio_item_photo_links(App $a, &$body_info)
} }
/** /**
* @brief Replace links of the item_photo_menu hook * Replace links of the item_photo_menu hook
* *
* This function replaces the original poke and the message links * This function replaces the original poke and the message links
* to call the addToModal javascript function so this pages can * to call the addToModal javascript function so this pages can
@ -135,7 +135,7 @@ function frio_item_photo_menu(App $a, &$arr)
} }
/** /**
* @brief Replace links of the contact_photo_menu * Replace links of the contact_photo_menu
* *
* This function replaces the original poke and the message links * This function replaces the original poke and the message links
* to call the addToModal javascript function so this pages can * to call the addToModal javascript function so this pages can
@ -191,7 +191,7 @@ function frio_contact_photo_menu(App $a, &$args)
} }
/** /**
* @brief Construct remote nav menu * Construct remote nav menu
* *
* It creates a remote baseurl form $_SESSION for remote users and friendica * It creates a remote baseurl form $_SESSION for remote users and friendica
* visitors. This url will be added to some of the nav links. With this behaviour * visitors. This url will be added to some of the nav links. With this behaviour
@ -340,7 +340,7 @@ function frio_acl_lookup(App $a, &$results)
} }
/** /**
* @brief Manipulate the data of the item * Manipulate the data of the item
* *
* At the moment we use this function to add some own stuff to the item menu * At the moment we use this function to add some own stuff to the item menu
* *