Attachments for WordPress

Extensive usage instructions are available on GitHub

Attachments allows you to simply append any number of items from your WordPress Media Library to Posts, Pages, and Custom Post Types.

Associate Media items with posts The idea behind Attachments is to give developers the ability to directly associate Media items with any post. This is accomplished by adding a meta box to post edit screens as determined by the developer. Once Media items have been associated with a post, you’re able to retrieve those Attachments and include them directly within your template files using any specific markup you wish.

Integrate Attachments within your theme with fine grained control Attachments does not automatically integrate itself with your theme. Since the idea behind Attachments is to allow integration of Media within posts using developer-crafted, unique markup, it’s up to you to integrate with your theme. The most basic integration includes editing the appropriate template file and adding your call(s) to Attachments. For example, if you have set up Attachments to be used with your Posts entries, edit single.php to include the following within The Loop:

<?php $attachments = new Attachments( 'attachments' ); /* pass the instance name */ ?> <?php if( $attachments->exist() ) : ?> <h3>Attachments</h3> <p>Total Attachments: <?php echo $attachments->total(); ?></p> <ul> <?php while( $attachments->get() ) : ?> <li> ID: <?php echo $attachments->id(); ?><br /> Type: <?php echo $attachments->type(); ?><br /> Subtype: <?php echo $attachments->subtype(); ?><br /> URL: <?php echo $attachments->url(); ?><br /> Image: <?php echo $attachments->image( 'thumbnail' ); ?><br /> Source: <?php echo $attachments->src( 'full' ); ?><br /> Size: <?php echo $attachments->filesize(); ?><br /> Title Field: <?php echo $attachments->field( 'title' ); ?><br /> Caption Field: <?php echo $attachments->field( 'caption' ); ?> </li> <?php endwhile; ?> </ul> <?php endif; ?>