PHPackages                             newcity/wp-wrap-images - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. newcity/wp-wrap-images

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

newcity/wp-wrap-images
======================

0.1.2(8y ago)0851PHPPHP >=5.4.0

Since Nov 9Pushed 8y ago5 watchersCompare

[ Source](https://github.com/newcity/wp-wrap-images)[ Packagist](https://packagist.org/packages/newcity/wp-wrap-images)[ RSS](/packages/newcity-wp-wrap-images/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

Wrap WYSIWYG Images
===================

[](#wrap-wysiwyg-images)

Description
-----------

[](#description)

Wraps all images inserted into a WYSIWYG field from the Add Media interface with a `` element, even if no caption is assigned to the image. Compatible with the standard Wordpress tinyMCE editor and the [Advanced Custom Fields](https://www.advancedcustomfields.com/)WYSIWYG field type.

Installation Instructions
-------------------------

[](#installation-instructions)

To install this plugin manually:

1. Download the plugin .zip file
2. Unzip
3. Copy the Wrap WYSIWYG Images directory to your /wp-content/plugins directory
4. Go to the plugin management page and activate the plugin

This plugin has no settings to configure -- once it is activated, it starts doing it's work immediately.

Why this plugin exists
----------------------

[](#why-this-plugin-exists)

Wordpress is inconsistent in its handling of images inserted into WYSIWYG editor fields. If the image has a caption, Wordpress wraps it in a shortcode that in turn wraps the `` tag in a `` tag with an included `` tag.

**Example Image with Caption Output**

```

  This is a caption

```

If no caption is present, the image is unceremoniously dumped into the page with no wrapper. This presents a challenge for theme designers, since targeting the `` tag or the `` tag with CSS will yield different results.

How it works
------------

[](#how-it-works)

This plugin uses the `the_content` and `acf_the_content` hooks to wrap images without captions in the `[caption]` shortcode before the page is built. It also replaces Wordpress' default caption shortcode function with a slightly modified version that does not ignore captionless images. The result is that uncaptioned images receive exactly the same markup wrappers as captioned images, but without the `` element.

Possible conflicts
------------------

[](#possible-conflicts)

This plugin adds its replacement `[caption]` filter to `img_caption_shortcode`, and will conflict with any custom caption shortcode you may have already assigned via `img_caption_shortcode`. This plugin's filter is assigned with a priority of `10`, so if you want to use this plugin in combination with a different caption override filter you should assign the other filter a priority value greater than `10`.

Support
-------

[](#support)

This plugin is provided without warranty or formal support. To ask questions of the developer, send an email to .

Please submit bugs, patches, and feature requests to

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~51 days

Total

4

Last Release

2952d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c27bbbdc08869ccbf9bbb3c3e74e2cb775e4a96a202c7ef92cec1e7d6c80eaa9?d=identicon)[newcity](/maintainers/newcity)

### Embed Badge

![Health badge](/badges/newcity-wp-wrap-images/health.svg)

```
[![Health](https://phpackages.com/badges/newcity-wp-wrap-images/health.svg)](https://phpackages.com/packages/newcity-wp-wrap-images)
```

###  Alternatives

[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/builder-plugin

Builder plugin for October CMS

17147.2k1](/packages/rainlab-builder-plugin)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5671.4k1](/packages/pfefferle-wordpress-activitypub)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[humanmade/lottie-lite

A lightweight Lottie Animations Extension for WordPress

374.3k](/packages/humanmade-lottie-lite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)