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. [API Development](/categories/api)
4. /
5. masonitedoors/widen-media

ActiveWordpress-plugin[API Development](/categories/api)

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

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

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

Since Apr 18Pushed 4y 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 4w ago

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 & 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 & 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 69% of packages

Maintenance3

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity72

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

1467d 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 >=7

0.0.3PHP >=7.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6676674?v=4)[Joe Fusco](/maintainers/josephfusco)[@josephfusco](https://github.com/josephfusco)

![](https://avatars.githubusercontent.com/u/7424837?v=4)[ipetty](/maintainers/ipetty)[@ipetty](https://github.com/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

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.6k10](/packages/helsingborg-stad-municipio)[october/rain

October Rain Library

1601.7M103](/packages/october-rain)[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.

45844.8k1](/packages/pressbooks-pressbooks)[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.7k17.3k100](/packages/elgg-elgg)[mediawiki/maps

Adds various mapping features to MediaWiki

85155.1k3](/packages/mediawiki-maps)[civicrm/civicrm-drupal-8

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

20256.6k4](/packages/civicrm-civicrm-drupal-8)

PHPackages © 2026

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