Please note: Functionality described on this page requires Download Monitor version 4.0 or above.
Versions in Download Monitor can be fetched via the Version Repository. Retrieve_single is a method of Download Monitor’s version repository service. The method returns a single DLM_Download_Version object with given ID. Retrieve_single throws an Exception if no version with given ID is found.
Signature
public function retrieve_single( $id ) {}Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | int | n/a | ID of the version that needs to be fetched. |
Examples
Retrieve Version with ID 91
This snippet retrieves version with ID 91. Notice that the retrieve_single call is wrapped in a try-catch block. This is because the retrieve_single method throws an exception if no Version with given ID is found.
try {
// retrieve version with ID 91
/** @var DLM_Download_Version $version **/
$version = download_monitor()->service( 'version_repository' )->retrieve_single( 91 );
} catch ( Exception $exception ) {
// version with ID 91 not found
}
