What's this?

This is a Symfony 3 bundle written in PHP 7 that provides an easy way for simultaneous publishing to social networks. Currently, it integrates with Facebook and Twitter only.

---

How to install it?

Recommended way is through Composer

composer require "martin-georgiev/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: "v2.8"             # Optional, also supports "mcrypt" and "urandom". Default uses the latest graph version.
            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 \MartinGeorgiev\SocialPost\SocialPostBundle(),
        ];
        return $bundles;
    }
    // ...
}

Post a test message

<?php
//...
$container->get('social_post')->publish('your test message');

Please have in mind that optional arguments on publish() are not yet supported by Twitter. The published tweet will contain only the value provided for $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 prove to be helpful.

---

License

This package is licensed under the MIT License. Please, respect that!