PHPackages                             masonitedoors/widen-media - 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. masonitedoors/widen-media

ActiveWordpress-plugin

masonitedoors/widen-media
=========================

Search and add Widen digital assets to your WordPress media library.

2.6.7(3y ago)62.2k7[5 issues](https://github.com/masonitedoors/widen-media/issues)GPL-2.0-or-laterPHPPHP &gt;=7

Since Apr 18Pushed 3y ago4 watchersCompare

[ Source](https://github.com/masonitedoors/widen-media)[ Packagist](https://packagist.org/packages/masonitedoors/widen-media)[ RSS](/packages/masonitedoors-widen-media/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (6)Versions (37)Used By (0)

Widen Media
===========

[](#widen-media)

[![Widen Media on Packagist](https://camo.githubusercontent.com/4c234dce1ef039ab5a3968a6f0ec455bf69d57f3f8caf7f959493dd5ffb0bf96/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d61736f6e697465646f6f72732f776964656e2d6d656469612e7376673f7374796c653d666c6174)](https://packagist.org/packages/masonitedoors/widen-media)

> Search and add Widen digital assets to your WordPress media library.

This WordPress plugin lets users search for images in [Widen](https://www.widen.com/) and add them to their site's media library. This plugin does not download media from Widen but rather creates a new WordPress media attachment that refers to the Widen asset URL. Some additional Widen metadata is captured and saved to the database on the "Add to Media Library" action. This plugin does not currently support syncing of meta data between Widen &amp; WordPress.

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

[](#installation)

You can either [download a release zip](https://github.com/masonitedoors/widen-media/releases) and install via the WordPress plugin installer or via composer.

### Composer

[](#composer)

```
composer require masonitedoors/widen-media
```

Configuration
-------------

[](#configuration)

### WordPress

[](#wordpress)

This plugin uses [V2 of the Widen API](https://widenv2.docs.apiary.io/). You will need to define your Widen API access token in `wp-config.php`.

```
define( 'WIDEN_MEDIA_ACCESS_TOKEN', 'my-widen-api-token' );
```

Widen Metadata
--------------

[](#widen-metadata)

Some additional Widen metadata is captured and saved to the database on the `Add to Media Library` action. This plugin does not currently support syncing of meta data between Widen &amp; WordPress.

Collections
-----------

[](#collections)

This plugin saves Widen collections under the post type `wm_collection` in order to provide a way for other themes and plugins to have access to this data without having to directly interact with Widen's API.

Within the main search page under "Add New", users can toggle "collection" when searching Widen. This will return only results that match that collection name.

When searching for a collection, a *Save Collection* button will be displayed. This button saves the current result page's collection to the metadata of a new post under the `wp_collection` post type. Note that a collection large than 100 assets will only save the 100 assets on the current results page.

Defining Custom Image Sizes
---------------------------

[](#defining-custom-image-sizes)

This plugin ships with some default image sizes however a filter has been included if you wish to change those defined sizes from within another plugin or theme.

Example function defining 2 image sizes:

```
function filter_defined_image_sizes( $default_image_sizes ) {
  $sizes = [
    'banner-sm' => [
      'label'  => __( 'Small Banner', 'textdomain' ),
      'width'  => 820,
      'height' => 312,
    ],
    'banner-lg' => [
      'label'  => __( 'Large Banner', 'textdomain' ),
      'width'  => 1500,
      'height' => 500,
    ],
  ];

  // Uncomment to append sizes to the plugin's already defined sizes.
  // $sizes = array_merge( $sizes, $default_image_sizes );

  return $sizes;
}
add_filter( 'wm_defined_image_sizes', 'filter_defined_image_sizes', 10, 1 );
```

Plugin API
----------

[](#plugin-api)

This plugin provides some function to allow other plugins to easly interact with Widen data imported into WordPress as well as the Widen API.

### wm\_get\_collections()

[](#wm_get_collections)

Returns an array of collection objects.

### wm\_get\_collection( int $collection\_id )

[](#wm_get_collection-int-collection_id-)

Returns the collection object.

### wm\_get\_asset\_fields( int $asset\_id )

[](#wm_get_asset_fields-int-asset_id-)

Returns all the fields from Widen for an asset that exists within the WordPress Media Library.

### wm\_get\_asset\_field( int $asset\_id, string $key, bool $single = false )

[](#wm_get_asset_field-int-asset_id-string-key-bool-single--false-)

Returns a single field for a Widen asset that exists within the WordPress Media Library.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance3

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~40 days

Recently: every ~163 days

Total

31

Last Release

1373d ago

Major Versions

0.0.10 → 1.3.42019-05-07

1.3.4 → 2.0.02019-07-17

PHP version history (2 changes)0.0.1PHP &gt;=7

0.0.3PHP &gt;=7.2

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/86462a839287f8f512fe9222f33d3369129aed32d9e7a7eb636489e67c5008f7?d=identicon)[ipetty](/maintainers/ipetty)

---

Top Contributors

[![josephfusco](https://avatars.githubusercontent.com/u/6676674?v=4)](https://github.com/josephfusco "josephfusco (19 commits)")[![mwks-jg](https://avatars.githubusercontent.com/u/109112506?v=4)](https://github.com/mwks-jg "mwks-jg (18 commits)")[![jdashley27](https://avatars.githubusercontent.com/u/6895259?v=4)](https://github.com/jdashley27 "jdashley27 (7 commits)")[![AlexGarrisonMercury](https://avatars.githubusercontent.com/u/77010313?v=4)](https://github.com/AlexGarrisonMercury "AlexGarrisonMercury (5 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![sagarrison12](https://avatars.githubusercontent.com/u/3916157?v=4)](https://github.com/sagarrison12 "sagarrison12 (1 commits)")

---

Tags

cdndamdigital-asset-managementmedia-librarywordpresswordpress-plugin

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/masonitedoors-widen-media/health.svg)

```
[![Health](https://phpackages.com/badges/masonitedoors-widen-media/health.svg)](https://phpackages.com/packages/masonitedoors-widen-media)
```

###  Alternatives

[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching

Instant switching between user accounts in WordPress and WooCommerce.

19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin

Blog plugin for October CMS

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

User plugin for October CMS

11954.3k13](/packages/rainlab-user-plugin)

PHPackages © 2026

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