/Many-Assets

An ExpressionEngine plugin to retrieve P&T Assets from across multiple Entries

Primary LanguagePHP

Many Assets

Retrieve Pixel&Tonic's Assets from across many entries, and/or across many custom fields.

Simply pass a pipe- or comma-delimited list of entry ids, add parse="inward", and be on your way.

  • Author: John D Wells
  • Version 1.3.2 (consider beta until I say otherwise)
Thanks to:

Features

  • Fetch Assets assigned to multiple entries
  • Fetch Assets assigned across multiple custom fields
  • Matrix-compatible
  • Easily fetch Assets outside of exp:channel:entries

Requirements

Installation

  1. Be sure Assets is installed and configured to your liking
  2. Copy the many_assets folder to ./system/expressionengine/third_party/

Required Parameters

entry_ids="..."

A pipe- or comma-delimited list of entry IDs.

parse="inward"

This is required for the plugin to parse in the correct order.

Optional Parameters

Accepts all of Asset's documented parameters, plus:

fields="..."

A pipe- or comma-delimited list of fields that the lookup should be limited to.

Prefix with not to exclude fields.

The format of each field is: channel_name:field_name, and in the case of a Matrix column, channel_name:field_name:column_name.

Usage Examples

Basic

{exp:many_assets entry_ids="420|1976|2011" parse="inward"}
	...
{/exp:many_assets}

Exclude custom field

{exp:many_assets entry_ids="420|1976|2011" fields="not page:cf_leading_image" parse="inward"}
	...
{/exp:many_assets}

Limit to field name & matrix col

{exp:many_assets entry_ids="420|1976|2011" fields="page:cf_page_slideshow|page:cf_page_matrix:file" parse="inward"}
	...
{/exp:many_assets}

Combined with Playa and CE Img

{exp:many_assets entry_ids="{exp:playa:parent_ids entry_id='420'}" parse="inward" prefix="asset" limit="5" orderby="random"}

	{exp:ce_img:pair src="{asset:server_path}" width="450" height="320" crop="yes" allow_scale_larger="yes"}
		<figure>
			<img src="{made}" width="{width}" height="{height}" alt="" />
			{if asset:caption}<figcaption>{asset:caption}</figcaption>{/if}
		</figure>
	{/exp:ce_img:pair}
	
{/exp:many_assets}