WP Manifestindependent plugin directory
manifest / media / picture-element-thumbnails

Wordpress Picture Elements

Adds function to get picture elements instead of image tags for thumbnails in WordPress

by Ethan Clevenger · github.com/ethanclevenger91/picture-element-thumbnails

2stars
1forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/ethanclevenger91/picture-element-thumbnails/archive/refs/heads/master.zip

Readme

Picture Element Thumbnails

Contributors: eclev91

Tags: thumbnails

Requires at least: 4.0

Tested up to: 4.4.2

Stable tag: 4.4.2

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html

Get a picture element instead of an image tag for responsive images on your WordPress site.

Description

This plugin introduces a couple of nifty functions to replace the_post_thumbnail() & get_the_post_thumbnail() in exchange for the responsive picture element. Use:

get_the_post_picture(
    $fallback_image_size,
    array(
        $breakpoint_1=>$image_size_1,
        $breakpoint_2=>$image_size_2
    )
    [, $id, $atts]
);

For example:

<?php echo get_the_post_picture(
    'single-featured-sm',
    array(
        '(min-width:768px)'=>'single-featured-md',
        '(min-width:992px)'=>'single-featured-lg',
        '(min-width:1200px)'=>'single-featured'
    )
); ?>

Installation

  1. Install via the WordPress Plugin directory or upload this to your plugins folder.

  2. Activate from the Plugins screen on your Dashboard.

Frequently Asked Questions

What?

the_post_picture() and get_the_post_picture(). See the description for an example.

Why?

This is really a bigger question than the scope of this plugin, but see here.

Oh, you weren't talking about the picture element as a whole. There exists at least one plugin that will out-of-the-box replace all <img> tags with "picture" elements and set breakpoints based on the image sizes. But if you need art direction, you need the HTML5 <picture> element. This plugin gives you control over A. Which elements are replaced and B. What your breakpoints are.

Does the order of my sizes array matter?

Yup. Pass them smallest image to largest.

Browser Support?

The plugin includes PictureFill.js. This should polyfill most browsers. If you have an issue, please report it!

Can I use my custom image sizes?

Yessir.

Can I contribute?

PRs are welcome! See GitHub.

Screenshots

Changelog

1.0

  • Initial launch!

1.0.2

  • Added get_the_attachment_picture() as an alternative to wp_get_attachment_image()

1.0.3

  • Resolve some notices regarding static functions

1.0.4

  • Resolve another static notice

Read the full README on GitHub →