=== Atomic Social Kit ===
Contributors: wpcaliph
Tags: social media, facebook, instagram, reviews, gutenberg blocks, feedback
Requires at least: 6.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display social media feeds from Facebook and Instagram, plus Facebook reviews, with beautiful Gutenberg blocks.

== Description ==

**Atomic Social Kit** is a powerful WordPress plugin that allows you to display social media content from Facebook and Instagram (Business/Creator via the Graph API) using beautiful, customizable Gutenberg blocks.

== Source code and build tools ==

The minified JavaScript and CSS files under the `build/` directory are generated from the original, human‑readable source code that is **included in this plugin**:

* Block source files (JS/JSX and SCSS) live in the `src/blocks/` directory.
* Admin dashboard React code lives in `src/admin/`.
* The compiled assets that WordPress loads at runtime live in the `build/` directory.

Developers can review and rebuild the compressed assets using the included build tools:

1. Install Node.js and npm.
2. From the plugin directory, run:
   - `npm install`
   - `npm run build` to build production assets.
   - `npm start` to run the development build/watch process.

The plugin’s source code and build configuration are fully available in the distributed zip so that other developers can inspect, learn from, and contribute to the project.

== External service and privacy ==

This plugin connects your WordPress site to the **Facebook Graph API** in order to fetch and display your own page content:

* The plugin communicates only with the official Facebook Graph API endpoints.
* The plugin sends the **Facebook Page ID** and **Access Token** that you configure in `Settings → Social Media` so that Facebook can return your page posts and reviews.
* These credentials are stored in your WordPress database using the standard WordPress options API and are **not** sent to wpcaliph.com or any other third‑party server.
* The plugin does **not** track visitors, set tracking pixels, or send any analytics or behavioral data outside your site.
* The data retrieved from Facebook (such as post content, review text, reviewer name and avatar, ratings and counts) is used only to render the blocks on your site and may be cached locally to reduce the number of API requests.

The **Instagram Feed** block sends your **Instagram User ID** and **Instagram Access Token** (or, if that field is empty, your **Facebook Access Token**) to Meta’s `graph.instagram.com` or `graph.facebook.com` endpoints to load profile fields and media. That data is used only to render the block and may be cached like other social data.

For more information about how Facebook handles data, please review Facebook’s own policies:

* Facebook Terms: https://www.facebook.com/terms.php
* Facebook Data Policy: https://www.facebook.com/policy.php
* Facebook Platform Terms for developers: https://developers.facebook.com/terms

By using this plugin you are responsible for ensuring that your use of Facebook services complies with Facebook’s terms and with your local privacy laws (for example, updating your site’s privacy policy to mention that you display content from Facebook).

### Features

**Atomic Social Feed Block**
* Display posts from Facebook
* Multiple layout options: Grid, Masonry, List, and Carousel
* Customizable columns and post count
* Show/hide post elements (avatar, author, date, content, images, likes, comments, shares)
* Multiple card styles: Modern, Classic, Minimal, Card
* Adjustable spacing and border radius
* Responsive design

**Instagram Feed Block**
* Profile header (avatar, username, post/follower counts, bio, follow link)
* Layouts: Grid, Masonry, and Carousel (Swiper)
* Captions, like and comment counts (when returned by the API)
* Optional load-more on the frontend
* Respects global cache settings

**Atomic Social Reviews Block**
* Display reviews from Facebook
* Star rating display with customizable colors
* Filter reviews by minimum rating
* Multiple layout options
* Show/hide review elements (avatar, author, date, rating, review text)
* Customizable card styles
* Responsive design

### Supported Platforms

* **Facebook** - Display page posts and reviews
* **Instagram** - Display Business/Creator media (Graph API; token from Facebook settings)

### Easy Setup

1. Install and activate the plugin
2. Go to Settings > Social Media
3. Enter your Facebook API credentials (and Instagram Business Account ID under Instagram if you use that block)
4. Add blocks to your posts or pages
5. Customize the display options

### Customization Options

* Choose from multiple layout types
* Adjust columns and spacing
* Select different card styles
* Control which elements to display
* Customize colors and styling
* Enable carousel mode with autoplay

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/atomic-social-kit` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings > Social Media to configure your Facebook API credentials and optional Instagram ID.
4. Add the blocks to your posts or pages using the Gutenberg editor.

== Frequently Asked Questions ==

= Do I need API keys? =

Yes, you need to obtain Facebook API credentials. The plugin provides links to help you get these credentials.

= Is this plugin compatible with the latest WordPress version? =

Yes, this plugin is tested with WordPress 6.4 and uses the latest Gutenberg block API.

= Can I customize the appearance? =

Yes, the plugin provides extensive customization options including layout types, card styles, colors, spacing, and more.

= Does it work on mobile devices? =

Yes, all layouts are fully responsive and work great on mobile devices.

== Screenshots ==

1. Social Media Feed block in the editor
2. Social Reviews block displaying Facebook reviews
3. Multiple layout options
4. Settings page for API configuration

== Changelog ==

= 1.0.1 [22nd April 2026] =
* Added: Admin notice when Instagram block build files are missing.
* Added: Instagram Feed block (grid, masonry, carousel) with profile header and load more.
* Added: Instagram settings screen (Business Account ID; uses Facebook access token).
* Fixed: Instagram Feed frontend config encoding (base64 data attribute) so the block reliably hydrates after save/cache.
* Fixed: Instagram script load order (depends on Swiper).
* Fixed: Prefixed options, transients, and asset handles to avoid conflicts.
* Fixed: Removed debug/test code and synced admin UI version labels.
* Improved: Security and sanitization for all settings and REST endpoints.
* Improved: Escaping and validation for data rendered on the frontend.
* Improved: Facebook Feeds & Reviews
* Improved: Security Issue
* Fixed: Plugin issues

= 1.0.0 =
* Initial release
* Social Media Feed block with support for Facebook
* Social Media Reviews block with support for Facebook reviews
* Multiple layout options
* Extensive customization options
* Responsive design

== Upgrade Notice ==

= 1.0.5 =
Fixes Instagram Feed not appearing on the frontend for some sites; run npm run build if the block is missing in the editor.

= 1.0.4 =
Adds the Instagram Feed block and Instagram settings. Configure your Instagram Business Account ID and use a Facebook Graph token with Instagram permissions.

= 1.0.0 =
Initial release of Atomic Social Kit plugin.