socialfeed 4.0.0-alpha1

Overview

Social Feed 4.0.0-alpha1 is a major version release targeting Drupal 11 with PHP 8.3+. This release brings improved error handling, enhanced dependency management, and complete modernization for the latest Drupal ecosystem.

Key Changes

Drupal 11 Compatibility

• Full support for Drupal 11 with modern PHP 8.3+ requirement
• Updated to latest compatible dependency versions
• Removed support for older Drupal versions (8.x, 9.x, 10.x)

Improved Error Handling

• Enhanced try-catch blocks across all post collectors (Facebook, Twitter, Instagram)
• Better error logging with detailed error messages for debugging
• Graceful fallback to empty arrays when API calls fail

Updated Dependencies

• Upgraded abraham/twitteroauth to ^4.0 for PHP 8.3+ compatibility
• Upgraded facebook/php-business-sdk to >=14.0 (replaces deprecated SDK)
• Updated nesbot/carbon to ^2.59 || ^3.0 for better date handling

Instagram API Modernization

• Critical: Instagram Basic Display API deprecated (December 4, 2024)
• Migrated to Instagram Graph API for Professional (Creator/Business) accounts
• Added support for images, videos, and carousel albums
• Enhanced Instagram post collector with improved filtering

Code Quality Improvements

• Refactored FacebookPostCollector for better maintainability
• Enhanced TwitterPostCollector with improved error handling
• Enhanced InstagramPostCollector with API deprecation handling
• Type safety improvements across service classes
• Updated README with comprehensive Drupal 11 guidance

Breaking Changes

• Drupal 11 only: No longer compatible with Drupal 8, 9, or 10
• PHP 8.3+ required: Minimum PHP version increased from 7.4 to 8.3
• Instagram API migration required: Personal accounts must convert to Creator/Business accounts for Instagram feeds to work
• Existing configurations may need review and reconfiguration

Migration Guide

Instagram Users (Critical)

1. Convert your Instagram account to Creator or Business account if using Basic Display
2. Update API credentials in the Socialfeed configuration
3. Re-authenticate via the Instagram settings form at /admin/config/services/socialfeed/instagram

From Drupal 10 to 11

1. Ensure your PHP version is 8.3 or higher
2. Update Drupal to 11.x
3. Update the Social Feed module to 4.0.0-alpha1
4. Run drush cache:rebuild
5. Test all configured social media feeds

Requirements

• PHP: 8.3 or higher (Drupal 11 minimum requirement)
• Drupal: 11.x only
• Dependencies:
  • abraham/twitteroauth ^4.0
  • facebook/php-business-sdk >=14.0
  • nesbot/carbon ^2.59 || ^3.0

Platform-Specific Notes

Facebook

• Improved API error handling with better logging
• Enhanced post filtering by type
• Configurable post count with pagination support

Instagram

• ACTION REQUIRED: Migrate from Basic Display API (deprecated December 4, 2024)
• Now uses Instagram Graph API for Professional accounts
• Supports images, videos, and carousel albums

Twitter

• Improved error handling and logging
• Uses Twitter API v1.1 via abraham/twitteroauth ^4.0
• Note: Twitter has deprecated API v1.1; migration to v2 planned for future versions

Known Limitations

• Twitter API v1.1 endpoints are deprecated by Twitter but still functional
• Twitter feeds require live environment (not available in local development)
• Some edge cases in concurrent feed requests may occur

Important Notice

This is an alpha release and is NOT recommended for production use. It is intended for developers and early adopters who want to test this major version. Please thoroughly test all configured social media feeds before considering production deployment.

Testing & Feedback

Your feedback is crucial! Please test this version and report:

• Bugs or compatibility issues
• Migration issues from 3.x to 4.x
• Feature requests or improvements

Report issues in the Social Feed issue queue.

Support & Resources

• Documentation: See README.md for detailed configuration guide
• Issues: https://www.drupal.org/project/issues/socialfeed
• Repository: https://git.drupalcode.org/project/socialfeed
• Project Page: https://www.drupal.org/project/socialfeed