Download Repository – retrieve

Please note: Functionality described on this page requires Download Monitor version 4.0 or above.

Downloads in Download Monitor can be fetched via the Download Repository. Retrieve is a method of Download Monitor’s download repository service. The method returns an array of downloads. Modifiable with filters. Can be limited and offset.

Signature

public function retrieve( $filters=array(), $limit=0, $offset=0 );

Parameters

Parameter	Type	Default	Description
$filters	array	array()	The filters that set what downloads will be fetch. Basic WP_Query parameters can be used here with some exceptions. Ignored parameters are post_type, posts_per_page, offset, paged, nopaging.
$limit	int	0	Allows you to limit the amount of downloads that are fetched.
$offset	int	0	The offset specifies the offset of the first row to return. Allows you to skip given offset of downloads in the result set.

Examples

Retrieve all downloads

This snippet retrieves all published downloads.

$downloads = download_monitor()->service( 'download_repository' )->retrieve();

Retrieve all downloads, order by title

This snippet retrieves all published downloads but order them by title.

$downloads = download_monitor()->service( 'download_repository' )->retrieve( array(
	'orderby' => 'title',
	'order'   => 'ASC'
) );

Retrieve all downloads of author

This snippet retrieves all published downloads but order them by title.

$downloads = download_monitor()->service( 'download_repository' )->retrieve( array(
	'author' => 2
) );

Retrieve all downloads in a category

This snippet retrieves all published downloads but order them by title.

$downloads = download_monitor()->service( 'download_repository' )->retrieve( array(
	'tax_query' => array(
		array(
			'taxonomy' => 'dlm_download_category',
			'field'    => 'slug',
			'terms'    => 'my-category-slug'
		)
	)
) );

Retrieving a single download can also be done with retrieve_single method.