README

What's this?

This is a Symfony bundle written in PHP 8.1 that wraps janwebdev/social-post - an easy way for simultaneous publishing to Facebook and Twitter. It was cloned from this repo and refactored to support PHP 8.1+ and Symfony 6.4 LTS and upper.

How to install it?

Recommended way is through Composer

composer require janwebdev/symfony-social-post-bundle

Integration with Symfony

Add social networks configuration

# Usually part of config.yml
social_post:
    publish_on: [facebook, twitter]         # List which Social networks you will be publishing to and configure your access to them as shown below
    providers:
        facebook:
            app_id: "YOUR-FACEBOOK-APP-ID"
            app_secret: "YOUR-FACEBOOK-APP-SECRET"
            default_access_token: "YOUR-FACEBOOK-NON-EXPIRING-PAGE-ACCESS-TOKEN"
            page_id: "YOUR-FACEBOOK-PAGE-ID"
            enable_beta_mode: true
            default_graph_version: "v15.0"
            persistent_data_handler: "memory"         # Optional, also supports "session". Default is "memory".
            pseudo_random_string_generator: "openssl" # Optional, also supports "mcrypt" and "urandom". Default is "openssl".
            http_client_handler: "curl"               # Optional, also supports "stream" and "guzzle". Default is "curl".
        twitter:
            consumer_key: "YOUR-TWITTER-APP-CONSUMER-KEY"
            consumer_secret: "YOUR-TWITTER-APP-CONSUMER-SECRET"
            access_token: "YOUR-TWITTER-ACCESS-TOKEN"
            access_token_secret: "YOUR-TWITTER-ACCESS-TOKEN-SECRET"

Register the bundle

# Usually your app/AppKernel.php
<?php
// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new \Janwebdev\SocialPostBundle\SocialPostBundle(),
        ];
        return $bundles;
    }
    // ...
}

Post a test message

# Some Symfony container aware class
<?php
//...
$message = new \Janwebdev\SocialPost\Message('your test message');
$container->get('social_post')->publish($message);

Additional help

Facebook doesn't support non-expiring user access tokens. Instead, you can obtain a permanent page access token. When using such tokens you can act and post as the page itself. More information about the page access tokens from the official Facebook documentation. Some Stackoverflow answers (here and here) also can of help.

License

This package is licensed under the MIT License.

janwebdev / symfony-social-post-bundle

Maintainers

Details