PHPackages                             bitpiston/wp-instagram-widget-js - 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 &amp; Helpers](/categories/utility)
4. /
5. bitpiston/wp-instagram-widget-js

AbandonedArchivedWordpress-plugin[Utility &amp; Helpers](/categories/utility)

bitpiston/wp-instagram-widget-js
================================

A client side drop-in replacement for Scott Evans's WP Instagram Widget plugin.

v3.0.0-beta(5y ago)30GPL-2.0+PHPPHP &gt;=7.2

Since Jan 10Pushed 5y agoCompare

[ Source](https://github.com/BitPiston/wp-instagram-widget-js)[ Packagist](https://packagist.org/packages/bitpiston/wp-instagram-widget-js)[ Docs](https://github.com/bitpiston/wp-instagram-widget-js)[ RSS](/packages/bitpiston-wp-instagram-widget-js/feed)WikiDiscussions master Synced today

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

WP Instagram Widget JS
======================

[](#wp-instagram-widget-js)

About
-----

[](#about)

WP Instagram Widget JS is a client side drop-in replacement for Scott Evans's WP Instagram Widget plugin. It does not require you to provide your login details or sign in via oAuth nor does it use the soon to be dead Instagram API.

The widget is built to mirror the original as closely as possible which was built with the following philosophy:

- Use sensible and simple markup
- Provide no styles/css - it is up to you to style the widget to your theme and taste
- Cache where possible - filters are provided to adjust cache timings
- Require little setup - avoid oAuth for example

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

[](#installation)

To install this plugin:

- Upload the `wp-instagram-widget-js` folder to the `/wp-content/plugins/` directory
- Activate the plugin through the 'Plugins' menu in WordPress
- That's it!

Alternatively you can install the plugin using composer:

```
composer require bitpiston/wp-instagram-widget-js

```

Visit [WordPress.org for a comprehensive guide](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation) on in how to install WordPress plugins.

Hooks &amp; Filters
-------------------

[](#hooks--filters)

The following filters from version 2.0 and earlier are supported:

The first allows you adjust that cache time for retrieving the images from Instagram:

```
add_filter('null_instagram_cache_time', 'my_cache_time');

function my_cache_time() {
	return HOUR_IN_SECONDS;
}

```

The second allows you to filter video results from the widget:

```
add_filter('wpiw_images_only', '__return_true');

```

The rest allow you to add custom classes to the \[ul\] list container, each list item, link or image:

```
add_filter( 'wpiw_list_class', 'my_instagram_class' );

add_filter( 'wpiw_item_class', 'my_instagram_class' );
add_filter( 'wpiw_a_class', 'my_instagram_class' );
add_filter( 'wpiw_img_class', 'my_instagram_class' );
add_filter( 'wpiw_linka_class', 'my_instagram_class' );

function my_instagram_class( $classes ) {
	$classes = "instagram-image";
	return $classes;
}

```

In version 1.3 you also have two new hooks for adding custom output before and after the widget:

```
wpiw_before_widget
wpiw_after_widget

```

The following filters are no longer supported as it is not possible to provide a drop-in compatible equivelent:

In version 1.4 and above you can also customise the image loop completely by creating a `parts/wp-instagram-widget.php` file in your theme.

In version 1.9.6 you can now use a filter to change the location of your custom template part: `wpiw_template_part`.

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

...

Changelog
---------

[](#changelog)

#### 3.0

[](#30)

- Rewritten to scrape client side

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.7% 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

2135d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1577833?v=4)[Jan Pingel](/maintainers/Einkoro)[@einkoro](https://github.com/einkoro)

---

Top Contributors

[![scottsweb](https://avatars.githubusercontent.com/u/411945?v=4)](https://github.com/scottsweb "scottsweb (132 commits)")[![einkoro](https://avatars.githubusercontent.com/u/1577833?v=4)](https://github.com/einkoro "einkoro (4 commits)")[![tomjn](https://avatars.githubusercontent.com/u/58855?v=4)](https://github.com/tomjn "tomjn (2 commits)")[![jensteichert](https://avatars.githubusercontent.com/u/4951204?v=4)](https://github.com/jensteichert "jensteichert (1 commits)")[![chrisatomix](https://avatars.githubusercontent.com/u/1768449?v=4)](https://github.com/chrisatomix "chrisatomix (1 commits)")[![simonwheatley](https://avatars.githubusercontent.com/u/233434?v=4)](https://github.com/simonwheatley "simonwheatley (1 commits)")[![tealborder](https://avatars.githubusercontent.com/u/15683138?v=4)](https://github.com/tealborder "tealborder (1 commits)")[![thegallagher](https://avatars.githubusercontent.com/u/486626?v=4)](https://github.com/thegallagher "thegallagher (1 commits)")[![cfxd](https://avatars.githubusercontent.com/u/1671933?v=4)](https://github.com/cfxd "cfxd (1 commits)")

---

Tags

javascriptjquery-pluginphpwordpresswordpress-pluginwordpress-widget

### Embed Badge

![Health badge](/badges/bitpiston-wp-instagram-widget-js/health.svg)

```
[![Health](https://phpackages.com/badges/bitpiston-wp-instagram-widget-js/health.svg)](https://phpackages.com/packages/bitpiston-wp-instagram-widget-js)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[mautic/core

Mautic Open Source Distribution

10.0k2.6k9](/packages/mautic-core)[mediawiki/maps

Adds various mapping features to MediaWiki

84152.3k3](/packages/mediawiki-maps)[starcitizentools/citizen-skin

A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki.

3376.6k](/packages/starcitizentools-citizen-skin)[civicrm/civicrm-drupal-8

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

19251.4k3](/packages/civicrm-civicrm-drupal-8)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)

PHPackages © 2026

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