PHPackages                             cedaro/metamedia - 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. cedaro/metamedia

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

cedaro/metamedia
================

A WordPress plugin to register media selection meta boxes.

v1.0.0(12y ago)868PHP

Since May 27Pushed 11y ago4 watchersCompare

[ Source](https://github.com/cedaro/metamedia)[ Packagist](https://packagist.org/packages/cedaro/metamedia)[ Docs](https://github.com/blazersix/metamedia)[ RSS](/packages/cedaro-metamedia/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

Metamedia
=========

[](#metamedia)

A WordPress plugin to register media selection meta boxes.

**Contributors:** [Brady Vercher](https://github.com/bradyvercher)
**Requires:** 3.5
**Tested up to:** 4.0
**License:** [GPL-2.0+](http://www.gnu.org/licenses/gpl-2.0.html)

With the release of WordPress 3.5, an effort was made to decouple attachments from the posts where they were uploaded, which was a shift from previous versions, and a greater emphasis was placed on the `[gallery]` shortcode. Backward compatibility was maintained, but it became a little less intuitive to manage a gallery of images that were simply attached to a post. In any case it has always been a little difficult to select multiple featured images, or multiple galleries, for use in different areas in a template.

Metamedia allows for registering simple meta boxes like the "Featured Image" meta box for selecting a single image or gallery of images to be stored in a post meta field for easy retrieval and usage in templates. It can be used with any post type and uses the native media frame.

[![Gallery Meta Box](https://camo.githubusercontent.com/d40088501ee1f0d6bd9567aa630b39548bd453d4b5b4ed0fdadbe934b2d7369e/68747470733a2f2f7261772e6769746875622e636f6d2f63656461726f2f6d6574616d656469612f6d61737465722f73637265656e73686f742d312e706e67)](https://camo.githubusercontent.com/d40088501ee1f0d6bd9567aa630b39548bd453d4b5b4ed0fdadbe934b2d7369e/68747470733a2f2f7261772e6769746875622e636f6d2f63656461726f2f6d6574616d656469612f6d61737465722f73637265656e73686f742d312e706e67)
*An example gallery meta box. The images can be sorted directly in the meta box.*

[![Featured Image Meta Box](https://camo.githubusercontent.com/02d7379b445d4c8ebc4a63a2bc30d098498020127dcfb5d86b4e126639d52951/68747470733a2f2f7261772e6769746875622e636f6d2f63656461726f2f6d6574616d656469612f6d61737465722f73637265656e73686f742d322e706e67)](https://camo.githubusercontent.com/02d7379b445d4c8ebc4a63a2bc30d098498020127dcfb5d86b4e126639d52951/68747470733a2f2f7261772e6769746875622e636f6d2f63656461726f2f6d6574616d656469612f6d61737465722f73637265656e73686f742d322e706e67)
*An example meta box with custom labels for selecting a single image.*

Usage
-----

[](#usage)

To add a meta box similar to the "Featured Post" meta box, simply register it using `register_metamedia_metabox()` like this:

```
function themename_register_metamedia() {
	if ( ! is_admin() || ! function_exists( 'register_metamedia_meta_box' ) ) {
		return;
	}

	// Register a meta box for assigning a 'hero' image to posts.
	register_metamedia_meta_box( 'hero', 'post' );
}
add_action( 'init', 'themename_register_metamedia' );
```

Now in a template, the image ID can be retrieved using `get_post_meta( $post_id, 'hero', true )`.

### Methods

[](#methods)

The parameters for both methods are the same. Most labels and properties of registered meta boxes and the media modal can be customized using the optional `$args` parameter.

**`register_metamedia_meta_box( $meta_key, $post_type, $args = array() )`**

**`register_metamedia_gallery_meta_box( $meta_key, $post_type, $args = array() )`**

### Arguments

[](#arguments)

   Key Description Example     **`meta_box_title`** The title of the meta box. *`Hero Image`*   **`meta_box_context`** Where the meta box should appear. *`side`*   **`choose_label`** Label of the button used to open the media frame. *`Select Image`*   **`remove_label`** Label of the link used to remove a selected image. *`Remove image`*   **`frame_title`** The title of the media frame. *`2-10`*   **`frame_button`** The label of the button used to select an image in the media frame. *`Update Image`*  *Some arguments may not work with the gallery meta box. Additional arguments are available for more advanced usage.*

Installation
------------

[](#installation)

Metamedia is available in the [WordPress plugin repository](https://wordpress.org/plugins/metamedia/), so it can be installed from within your admin panel like any other plugin. You may also download it directly from GitHub using one of the following methods:

### Upload

[](#upload)

1. Download the [latest release](https://github.com/cedaro/metamedia/archive/master.zip) from GitHub.
2. Go to the **Plugins → Add New** screen in your WordPress admin panel and click the **Upload** tab at the top.
3. Upload the zipped archive.
4. Click the **Activate Plugin** link after installation completes.

### Manual

[](#manual)

1. Download the [latest release](https://github.com/cedaro/metamedia/archive/master.zip) from GitHub.
2. Unzip the archive.
3. Copy the folder to `/wp-content/plugins/`.
4. Go to the **Plugins** screen in your WordPress admin panel and click the **Activate** link under Metamedia.

Read the Codex for more information about [installing plugins manually](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).

### Git

[](#git)

Clone this repository in `/wp-content/plugins/`:

`git clone git@github.com:cedaro/metamedia.git`

Then go to the **Plugins** screen in your WordPress admin panel and click the **Activate** link under Metamedia.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Unknown

Total

1

Last Release

4737d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8e6e3b868bf75a4204de91fdc45d15b02a6874b6f88706d06cacfea1857fa0e5?d=identicon)[bradyvercher](/maintainers/bradyvercher)

---

Top Contributors

[![bradyvercher](https://avatars.githubusercontent.com/u/1302030?v=4)](https://github.com/bradyvercher "bradyvercher (20 commits)")

### Embed Badge

![Health badge](/badges/cedaro-metamedia/health.svg)

```
[![Health](https://phpackages.com/badges/cedaro-metamedia/health.svg)](https://phpackages.com/packages/cedaro-metamedia)
```

###  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)