Attachments Pro

Overview

Attachments Pro is the big brother to Attachments. With this plugin you can easily append WordPress Media items to Posts, Pages, or Custom Post Types with the end goal of integrating them within your theme with the greatest of detail.

Attachments Pro lets you add your own meta boxes to WordPress admin edit screens based on the conditions you set, with the fields you want.

WordPress has a lot of room to grow when it comes to both Media management as well as Media inclusion within your posts. Attachments Pro does what it can to fill that gap. The most frustrating thing for me as a WordPress developer was having to adhere to WordPress’ markup when it inserted an image or gallery of images. Attachments abstracts those assets and lets you use your own markup.

Adding assets via Attachments Pro uses the built in WordPress Media browser. You’re able to browse existing Media items, or add your own just as you would when adding an image to a post.

With the Media assets being managed outside the main content editor of the Post edit screen, you can now loop through each asset in your theme’s template file and output the details as you wish. There is a sample code snippet in the readme.txt that ships with Attachments Pro that walks you through adding Attachments Pro to your template files.

Features

Attachments Pro is the successor to the (always free) Attachments. Their differences are outlined below:

Installation & Initial Setup

Once Attachments is activated, you can spend a few minutes customizing the details you’d like to set for each instance. To do so, visit the Attachments Pro link under the Settings menu in the WordPress admin. Once you have created your Attachments Pro instances, you will find the meta boxes on your Post/Page/Custom Post Type edit screens.

Code Samples

Using Attachments Pro, you can integrate your attachments using the exact markup you want. The most common way to integrate Attachments Pro is by editing your theme files and including the attachments where you’d like, how you’d like. Alternatively, you can use the auto-append feature and a custom template to achieve the same effect. The snippets below should help get you started.

Direct template integration

To integrate Attachments Pro directly with your theme, you’ll need to edit the applicable templates.

<?php
    $existing_attachments = new AttachmentsPro();

    // arguments for our first instance of Attachments
    $args   = array(
        'instance'  => 'attachments',   // the instance name
        'details'   => true             // returns more image info
    );
    // retrieve our existing Attachments for this instance
    $existing_attachments = $existing_attachments->get_attachments( $args );
?>
<?php if( !empty( $existing_attachments ) ) : ?>
    <ul>
        <?php foreach( $existing_attachments as $attachment ) : ?>
            <li>
                <pre>
                    <?php print_r( $attachment ); ?>
                </pre>
            </li>
        <?php endforeach; ?>
    </ul>
<?php endif; ?>

Shortcode filtration

There are two separate filters used by Attachments Pro. attachments_pro_format_attachments is applied to all Attachments. attachments_pro_format_attachments_{instance} is applied to only the {instance}.

function attachments_pro_custom_format_attachments( $output, $existing_attachments )
{
  ob_start();
  if( !empty( $existing_attachments ) ) : ?>
    <div class="attachments">
      <ul>
        <?php foreach( $existing_attachments as $attachment ) : ?>
          <li>
            <img src="<?php echo $attachment['src']['thumbnail']['url']; ?>" alt="<?php echo $attachment['name']; ?>" />
          </li>
        <?php endforeach; ?>
      </ul>
    </div>
  <?php endif ;
  $output = ob_get_contents();
  ob_end_clean();
  return $output;
}
// filter our Attachments Pro instance with the name 'attachments'
add_filter( 'attachments_pro_format_attachments_attachments', 'attachments_pro_custom_format_attachments', 10, 2 );

Data Returned

When working with Attachments, you’ll have an array of information available about each Attachment. That information is as follows:

Full Example

Below is a sample integrating all of the keys outlined above:

<?php
  $existing_attachments = new AttachmentsPro();

  // arguments for our first instance of Attachments
  $args   = array(
      'instance'  => 'attachments',   // the instance name
      'details'   => true,            // returns more image info
      'limit'     => 0                // limit the number of Attachments returned
    );
  // retrieve our existing Attachments for this instance
  $existing_attachments = $existing_attachments->get_attachments( $args );
?>
<?php if( !empty( $existing_attachments ) ) : ?>
  <ul>
    <?php foreach( $existing_attachments as $attachment ) : ?>
      <li>
        <h2>Name: <?php echo $attachment['name']; ?></h2>
        <p>ID: <?php echo $attachment['id']; ?></p>
        <p>URL: <?php echo $attachment['url']; ?></p>
        <p>Force Download: <?php echo $attachment['download']; ?></p>
        <p>MIME type: <?php echo $attachment['mime']; ?></p>
        <p>Filesize (bytes): <?php echo $attachment['filesize']['bytes']; ?></p>
        <p>Filesize (formatted): <?php echo $attachment['filesize']['formatted']; ?></p>
        <?php if( !empty( $attachment['fields'] ) ) : ?>
          <h5>Fields</h5>
          <ul>
            <?php foreach( $attachment['fields'] as $field ) : ?>
              <li><?php echo $field; ?></li>
            <?php endforeach; ?>
          </ul>
        <?php endif; ?>
        <?php if( !empty( $attachment['src'] ) ) : ?>
          <p>Thumbnail:
            <?php echo $attachment['src']['thumbnail']['width']; ?>px wide<br />
            <?php echo $attachment['src']['thumbnail']['height']; ?>px tall<br />
            <?php echo $attachment['src']['thumbnail']['url']; ?><br />
            <?php echo $attachment['src']['thumbnail']['filesize']['bytes']; ?> bytes<br />
            <?php echo $attachment['src']['thumbnail']['filesize']['formatted']; ?> (formatted)
          </p>
          <p>Medium:
            <?php echo $attachment['src']['medium']['width']; ?>px wide<br />
            <?php echo $attachment['src']['medium']['height']; ?>px tall<br />
            <?php echo $attachment['src']['medium']['url']; ?><br />
            <?php echo $attachment['src']['medium']['filesize']['bytes']; ?> bytes<br />
            <?php echo $attachment['src']['medium']['filesize']['formatted']; ?> (formatted)
          </p>
          <p>Large:
            <?php echo $attachment['src']['large']['width']; ?>px wide<br />
            <?php echo $attachment['src']['large']['height']; ?>px tall<br />
            <?php echo $attachment['src']['large']['url']; ?><br />
            <?php echo $attachment['src']['large']['filesize']['bytes']; ?> bytes<br />
            <?php echo $attachment['src']['large']['filesize']['formatted']; ?> (formatted)
          </p>
          <p>Full:
            <?php echo $attachment['src']['full']['width']; ?>px wide<br />
            <?php echo $attachment['src']['full']['height']; ?>px tall<br />
            <?php echo $attachment['src']['full']['url']; ?><br />
            <?php echo $attachment['src']['full']['filesize']['bytes']; ?> bytes<br />
            <?php echo $attachment['src']['full']['filesize']['formatted']; ?> (formatted)
          </p>
        <?php endif; ?>
      </li>
    <?php endforeach; ?>
  </ul>
<?php endif; ?>

Screenshots

Settings for a single Attachments Pro instance

An Attachments Pro instance meta box as it appears on an edit screen

Auto-append template documentation

Shortcode insertion

Requirements

Attachments Pro requires WordPress 3.3+ and in doing so PHP5+.

Refunds

Refunds will be offered within seven days of purchase if you are unhappy with the performance of Attachments Pro and it does not meet your expectations. Refunds will not be offered as a result of malfunction due to incompatibility with another plugin or custom Theme.

Support

You can begin with the code snippet available in the readme.txt and customize using the provided details. Support is not offered in response to issues caused by other plugins or a custom theme. Before contacting support deactivate all other plugins and switch to the default WordPress Theme to determine the issue. Support is offered from 10am to 4pm ET weekdays.

Feature Requests

Feature requests are more than welcome, please use the official channel.