diff options
| -rw-r--r-- | engine/lib/metadata.php | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/engine/lib/metadata.php b/engine/lib/metadata.php index 77267d8a2..af366f99a 100644 --- a/engine/lib/metadata.php +++ b/engine/lib/metadata.php @@ -1,7 +1,7 @@ <?php /** * Elgg metadata - * Functions to manage object metadata. + * Functions to manage entity metadata. * * @package Elgg.Core * @subpackage DataModel.Metadata @@ -23,11 +23,11 @@ function row_to_elggmetadata($row) { } /** - * Get a specific item of metadata. + * Get a specific metadata object. * - * @param int $id The item of metadata being retrieved. + * @param int $id The id of the metadata being retrieved. * - * @return mixed + * @return mixed False on failure or ElggMetadata */ function get_metadata($id) { global $CONFIG; @@ -51,7 +51,7 @@ function get_metadata($id) { * * @param int $entity_guid The entity GUID * @param string $name The name of the metadata - * @param string $value The value of the item (useful to remove a single item of a set) + * @param string $value The value of the metadata (useful to remove a single item of a set) * * @return bool Depending on success */ @@ -173,7 +173,7 @@ function create_metadata($entity_guid, $name, $value, $value_type, $owner_guid, } /** - * Update an item of metadata. + * Update a specific piece of metadata. * * @param int $id Metadata id * @param string $name Metadata name @@ -285,9 +285,9 @@ $access_id = ACCESS_PRIVATE, $allow_multiple = false) { } /** - * Delete an item of metadata, where the current user has access. + * Delete a piece of metadata, where the current user has access. * - * @param int $id The item of metadata to delete. + * @param int $id The id of metadata to delete. * * @return bool */ @@ -317,12 +317,12 @@ function delete_metadata($id) { } /** - * Return the metadata values that match your query. + * Get metadata objects by name. * * @param int $entity_guid Entity GUID * @param string $meta_name Metadata name * - * @return mixed either a value, an array of ElggMetadata or false. + * @return mixed Either an ElggMetadata object, an array of ElggMetadata or false. */ function get_metadata_byname($entity_guid, $meta_name) { global $CONFIG; @@ -1252,8 +1252,9 @@ function metadata_array_to_values($array) { } /** - * Get the URL for this item of metadata, by default this - * links to the export handler in the current view. + * Get the URL for this metadata + * + * By default this links to the export handler in the current view. * * @param int $id Metadata ID * |