=== Mirror App - Social Page ===
Contributors: mirrorapp, mirrorapps
Tags: facebook, facebook feed, facebook page, facebook posts, facebook widget, social media, page feed, social feed
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your social page updates — including your full Facebook Feed with posts, photos, and videos — beautifully on your WordPress site using a simple shortcode, powered by Mirror App.

== Description ==

The **Mirror App Facebook Feed plugin** allows you to seamlessly display Your Facebook Page posts, photos, and videos directly on your WordPress website using a clean and customizable feed.
You control the design, layout, and content inside Mirror App — then simply paste the shortcode into any page, post, or widget area.

All you need is a shortcode generated in your [Mirror App dashboard](https://mirror-app.com/facebook-feed/wordpress).
Paste it anywhere, and your Facebook Feed instantly appears on your site.

Unlike traditional Facebook feed plugins that require API keys, tokens, or complex setup inside WordPress,
**this plugin does not process data or perform authentication locally.**
Everything — from account connection to feed design — is handled securely in **Mirror App**.
The plugin itself is a lightweight embed layer for displaying your ready-made Facebook Feed widget.

---

### Why Mirror App Facebook Feed?

* **Simple setup** – Configure everything inside Mirror App. No API keys, tokens, or coding.
* **Auto-refresh** – Your feed updates automatically without manual actions.
* **Lightweight** – The plugin only embeds the widget. No heavy scripts or data sync.
* **Secure** – All data processing occurs in Mirror App, not your site.
* **GDPR-friendly** – No personal data stored in WordPress.
* **Free plan available** – Premium features unlock analytics, custom layouts, and more.
* **Visual customization** – Adjust layout, colors, typography, and spacing.
* **Fast performance** – The script loads once per page, even with multiple feeds.

---

### Features
- Shortcode: `[mirror-app-social-page uuid]`
- Responsive iframe that fits any layout
- Optimized script (loads once per page)
- Compatible with Gutenberg, Elementor, Divi, and Classic Editor
- Supports multiple feeds on one or several pages

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/mirror-app-social-page/`, or install it directly from the WordPress Plugin Directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to your [Mirror App dashboard](https://mirror-app.com/facebook-feed/wordpress), connect your Facebook Page, customize your feed, and copy the shortcode.
4. Paste the shortcode into any post, page, or widget area.

⚠️ **Note:** The plugin does not handle authentication or API requests inside WordPress — it only embeds the ready-made widget from Mirror App.

Example:
`[mirror-app-social-page 4baf3a81-ec92-4d57-a9c5-7e0bdf4c34e9]`

== Frequently Asked Questions ==

= Do I need coding skills? =
No. Just copy and paste the shortcode from Mirror App.

= Can I display multiple Facebook feeds? =
Yes. Each feed has its own shortcode, and you can use several on one or multiple pages.

= Is the plugin free? =
Yes. The plugin is free. Mirror App also provides free and paid plans with additional layouts, analytics, and auto-refresh options.
See [Pricing](https://mirror-app.com/pricing).

= Is it responsive? =
Yes. Your Facebook feed will automatically adapt to any screen size.

= Where do I customize my feed? =
All customization — layout, colors, connected pages — is done in your [Mirror App dashboard](https://mirror-app.com/facebook-feed/wordpress).

= Does it connect directly to Facebook? =
No. All authentication and API requests happen securely in Mirror App.

= Can I use it without a Mirror App account? =
No. You need a free or paid account to generate your feed shortcode.

= Will it slow down my site? =
No. The plugin is lightweight and optimized to load asynchronously.

= Is my data safe? =
Yes. Mirror App handles all data externally in compliance with GDPR.

= Does it support videos and albums? =
Yes. The widget can display posts with videos, photos, albums, and text. All supported post types are automatically formatted to fit your selected layout.

= Can I hide specific post types? =
Yes. You can hide certain post types or individual posts directly in your widget settings inside Mirror App, without editing anything in WordPress.

= Will my visitors need to log in to Facebook? =
No. Your visitors don’t need a Facebook account or login. The widget displays publicly available content from your Facebook Page.

= What happens if I rename my Facebook Page? =
Your feed will keep working. As long as your page remains connected in Mirror App, any changes to its name or basic details are handled automatically in the background.

= How do I get support? =
- Visit our [Help Center](https://mirror-app.com/help-center)
- Post a topic in the [WordPress Support Forum](https://wordpress.org/support/plugin/mirror-app-social-page)
- Or email us: support@mirror-app.com

== Screenshots ==

1. Example of Facebook Feed embedded in a WordPress page
2. Mirror App dashboard – customizing your Facebook widget
3. Copying the shortcode from the Mirror App modal

== Service description ==

The plugin does **not** process data or handle authentication inside WordPress.
It only embeds the ready-made widget created in **Mirror App**.

All feed creation, account connection, and updates occur in Mirror App.
The WordPress plugin serves as a simple, secure embedding layer.

= Service Links =
* [Mirror App Facebook Feed](https://mirror-app.com/facebook-feed/wordpress)
* [Terms of Service](https://mirror-app.com/terms-of-service)
* [Privacy Policy](https://mirror-app.com/privacy-policy)

= Legal Note =
The plugin requires an active Mirror App account to create and manage widgets.
This plugin is **not affiliated with or endorsed by Meta Platforms, Inc.**
Facebook™ is a trademark of its respective owner.

== Support ==
Need help?
- [Help Center](https://mirror-app.com/help-center)
- [WordPress Support Forum](https://wordpress.org/support/plugin/mirror-app-social-page-widget)
- support@mirror-app.com

== Development ==

For developers: integration with vendor/iframe-bridge
The plugin uses the **@mirrorapp/iframe-bridge** library to manage iframe resizing and secure message communication between WordPress and the embedded feed.
**Key features:**
- Auto iframe resizing
- Viewport sync between parent and child frames
- Lightweight client-side library (ESM/CJS/UMD supported)
- TypeScript support

Documentation:
`vendor/iframe-bridge/README.md`

== Changelog ==

= 1.0.1 =
* Fix: resolved fatal error when multiple Mirror App plugins are active simultaneously.

= 1.0.0 =
* Initial release: shortcode support for Mirror App Facebook Feed
