PHPackages convergine/craft-social-buddy - 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. convergine/craft-social-buddy ActiveCraft-plugin convergine/craft-social-buddy ============================= Social Buddy is a CraftCMS plugin for seamless social media publishing. Share entries to Facebook, Instagram, Pinterest, Telegram, Medium, LinkedIn, and X (Twitter), with options for both automatic and manual posting. Supports multi-platform publishing, customizable content, and cron job automation. 1.1.1(6mo ago)1351proprietaryPHP Since Feb 20Pushed 6mo ago1 watchersCompare [ Source](https://github.com/convergine/craft-social-buddy)[ Packagist](https://packagist.org/packages/convergine/craft-social-buddy)[ RSS](/packages/convergine-craft-social-buddy/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (2)Versions (6)Used By (0) Social Buddy for CraftCMS ========================= [](#social-buddy-for-craftcms) [![Screenshot](./docs/images/social_buddy_banner.png)](./docs/images/social_buddy_banner.png) Social Buddy is a CraftCMS plugin designed to streamline your social media publishing process. Effortlessly share your Craft entries as posts across multiple social media platforms, including Facebook, Instagram, Pinterest, Telegram, Medium, LinkedIn, and X (Twitter), directly from your Craft CMS (manual or automatic). The plugin has three licensing levels depending on social media platforms supported: - **LITE**: Facebook - **STANDARD**: LITE + Instagram, X(Twitter) - **PRO**: STANDARD + Pinterest, LinkedIn, Medium, Telegram The plugin offers flexibility with two operating modes: - **Automatic Mode**: Automatically publishes entries when their status changes to "Published" from a pending state. - **Manual Mode**: Allows administrators to manually publish entries by clicking a "Publish" button, giving you precise control over what gets shared. Before publishing, administrators need to connect the plugin to their social media accounts in the Settings section. To enable automatic publishing, set up a cron job using the following command: ``` php craft social-buddy/scheduled ``` This ensures that your content is shared promptly and efficiently without manual intervention. Features -------- [](#features) - **Multi-Platform Publishing**: Publish entries to popular social media platforms such as Facebook, Instagram, Pinterest, Telegram, Medium, LinkedIn, and X (Twitter). - **Automatic & Manual Modes**: Choose between automatic publishing upon status changes or have full control with manual publishing. - **Easy Social Media Integration**: Connect your social media accounts via the plugin's Settings section with straightforward instructions. - **Cron Job Automation**: Set up cron jobs for automated publishing, ensuring your content is shared even when you're not around. - **Customizable Post Content**: Tailor the content that gets posted to each social platform, including images, captions, and hashtags. - **User-Friendly Interface**: Intuitive and clean interface that integrates seamlessly with your Craft CMS workflow. - **Detailed Publishing Logs**: Keep track of published posts and any errors with comprehensive logging. - **Multi-Account Support**: Manage and publish to multiple accounts on the same platform if needed. - **Secure Authorization**: Robust security measures to protect your social media credentials and data. Requirements ------------ [](#requirements) - **Craft CMS 4.0.0 or later** - **PHP 8.0.2 or later** - **Social Media Accounts**: Valid accounts for each social media platform you wish to publish to. - **Cron Job Access**: Ability to set up cron jobs on your hosting environment for automatic publishing. Installation ------------ [](#installation) You can install this plugin from the Plugin Store or with Composer. #### From the Plugin Store [](#from-the-plugin-store) 1. Go to the Plugin Store in your project’s Control Panel. 2. Search for “Social Buddy”. 3. Click on the “Install” button in the plugin's modal window. #### With Composer [](#with-composer) Open your terminal and run the following commands: ``` # Navigate to your project directory cd /path/to/my-project.test # Require the plugin via Composer composer require convergine/craft-social-buddy # Install the plugin via Craft CLI ./craft plugin/install craft-social-buddy ``` Configuration ------------- [](#configuration) After installation, configure the plugin by following these steps: 1. **Connect Social Media Accounts**: Navigate to the plugin’s Settings page and connect each social media platform by following the provided instructions. 2. **Set Publishing Preferences**: Choose between automatic and manual publishing modes, and configure content templates for each platform if desired. 3. **Configure Entries/Default Fields**: Go to Social Buddy → Settings → Entries/Default Fields, enable the sections and entry types for which you need social media publishing. Select the entry attribute for the post body and the attribute for the image. 4. **Add socialBuddy custom field to the Field Layout**: Go to Settings → Content → Sections. Choose Section and entry type. Add sociaulBuddy custom field somwhere in the Field Layout tabs. 5. **Set Up Cron Job (For Automatic Mode)**: Schedule the following command to run at your preferred intervals: ``` php craft element-status-events/scheduled ``` This ensures entries are published automatically when their status changes. Roadmap ------- [](#roadmap) - **Advanced Scheduling Options**: Ability to schedule posts for specific times per entry. - **Analytics Integration**: View engagement metrics directly within the plugin dashboard. - **Content Variations**: Customize posts differently for each social platform to maximize engagement. - **Additional Platform Support**: Integration with more social media platforms based on user requests. - **Team Collaboration Features**: Assign permissions and roles for team members to manage social postings. Support ------- [](#support) For any issues or questions, you can reach us by email at or by opening an issue on [GitHub](https://github.com/convergine/craft-social-buddy). ### Health Score 34 — LowBetter than 77% of packages Maintenance66 Regular maintenance activity Popularity13 Limited adoption so far Community11 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 Every ~62 days Total 5 Last Release 198d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d26ea9efef0ec989914f3bf1600ce6c31eb9eef49eda0c947b575c66a1bdbaee?d=identicon)[convergine](/maintainers/convergine) --- Top Contributors [![bogopol2](https://avatars.githubusercontent.com/u/5630325?v=4)](https://github.com/bogopol2 "bogopol2 (10 commits)")[![convergine](https://avatars.githubusercontent.com/u/7737586?v=4)](https://github.com/convergine "convergine (8 commits)")[![GBDeveloper2](https://avatars.githubusercontent.com/u/199299862?v=4)](https://github.com/GBDeveloper2 "GBDeveloper2 (3 commits)") --- Tags craft-plugincraft4craft5craftcmscraftcms-pluginautomationfacebookinstagramtelegramcraftcmslinkedinpinterestsocial mediamediumX-Twittersocial-buddy ### Embed Badge ![Health badge](/badges/convergine-craft-social-buddy/health.svg) ``` [![Health](https://phpackages.com/badges/convergine-craft-social-buddy/health.svg)](https://phpackages.com/packages/convergine-craft-social-buddy) ``` ### Alternatives [hwi/oauth-bundle Support for authenticating users using both OAuth1.0a and OAuth2 in Symfony. 2.4k21.5M69](/packages/hwi-oauth-bundle)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[facebook/php-ads-sdk PHP SDK for Facebook Business 9014.1M8](/packages/facebook-php-ads-sdk)[wrav/oembed A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles. 36205.0k3](/packages/wrav-oembed)[pdir/social-feed-bundle Social feed extension for Contao CMS 1414.8k](/packages/pdir-social-feed-bundle)[hut6/oembed A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles. 102.3k](/packages/hut6-oembed) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)