=== Instagram Feed Embed ===
Contributors: snehalpancholi
Tags: instagram, social media, feed, embed, grid
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Displays a responsive grid of Instagram posts by fetching official oEmbed data for a curated list of post URLs.

== Description ==

Add a curated Instagram grid to any post or page without API tokens. Simply paste the public Instagram post URLs into the settings page and drop `[instagram_feed]` into your content.

**Features:**
* Curated post-by-post approach — full control over which posts appear
* Fetches embed HTML via Instagram's oEmbed API and caches results
* Configurable grid columns (1–6), gap, and max width
* Optional caption display
* Responsive — adapts to 2 columns on tablets and 1 column on phones
* Graceful fallback card when oEmbed is unavailable
* Clear cache button in the admin
* Zero dependencies — no Instagram app, no API key required for basic public posts

**Note:** Instagram's oEmbed endpoint may require an Instagram/Facebook access token for some accounts. If embeds return empty, the plugin renders a styled fallback link card pointing to the original post.

== Installation ==

1. Upload the `instagram-feed-embed` folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Settings → Instagram Feed** and paste public Instagram post URLs (one per line).
4. Use `[instagram_feed]` in any post or page.

== Frequently Asked Questions ==

= Do I need an API key? =
Not for publicly accessible posts. Instagram's oEmbed endpoint works without authentication for most public posts. If you see fallback cards, the posts may be restricted.

= How do I change the number of columns for just one instance? =
Use the shortcode attribute: `[instagram_feed columns="2"]`.

= How often are the embeds refreshed? =
Every 24 hours by default (configurable via "Cache Duration"). Use the Clear Cache button to force an immediate refresh.

== Changelog ==

= 1.0.0 =
* Initial release.
