Atomic Social Kit

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