Getting Started

Minimal Setup

Installation:
```
composer require alphalemon/social-sdk-bundle:dev-master
```
If not using AlphaLemonBootstrapBundle, manually register the bundle in config/bundles.php (Laravel 5.4+) or AppKernel.php (older versions):
```
AlphaLemon\Block\SocialSDKBundle\SocialSDKBundle::class => ['all' => true],
```
First Use Case: Add a Facebook/Twitter button to your Blade template (e.g., resources/views/layouts/app.blade.php):
```

<div class="fb-like" data-href="{{ url('/') }}" data-layout="button_count"></div>


<a href="https://twitter.com/share" class="twitter-share-button" data-url="{{ url('/') }}">Tweet</a>
```
The bundle will automatically inject the required SDK (<script> tags) at the end of the page only if the corresponding button exists.

Implementation Patterns

Core Workflow

Declarative Integration:
- No manual SDK inclusion in layouts. The bundle scans the DOM for social buttons (e.g., fb-like, twitter-share-button) and loads the SDK dynamically.
- Example: Add a button in a partial view (e.g., resources/views/partials/share-buttons.blade.php):
```
@if($showFacebook)
    <div class="fb-like" data-href="{{ $url }}"></div>
@endif
```
Conditional Loading:
- SDKs are lazy-loaded (only when buttons are present). Optimize page weight by excluding SDKs from pages without social features.
- Example: Disable SDK for a specific route:
```
// config/social_sdk.php
'excluded_routes' => ['admin.*'],
```

Customization:

Override default SDK attributes (e.g., Facebook app ID) via config:

// config/social_sdk.php
'facebook' => [
    'app_id' => env('FACEBOOK_APP_ID', 'your_app_id'),
    'version' => 'v12.0',
],

Twig/Laravel Blade Integration:
- Use helpers to conditionally render buttons:
```
// Laravel Blade
@socialSdkButton('facebook', ['href' => url('/post')])
```
- The helper checks for SDK requirements and renders the button.
Asset Management:
- SDK scripts are added to the end of the <body> via Twig’s {% block javascripts %} or Laravel’s @stack('scripts'):
```
@stack('scripts')

```

Gotchas and Tips

Pitfalls

Route Exclusions:
- SDKs may load unexpectedly if excluded routes are misconfigured. Verify excluded_routes in config/social_sdk.php:
```
'excluded_routes' => ['admin.*', 'api.*'], // Regex or glob patterns
```
Button Selectors:
- The bundle uses CSS selectors to detect buttons. Custom selectors require extending the provider (see below). Example:
```

<button class="custom-twitter-share" data-url="{{ url('/') }}"></button>
```
  Fix: Extend SdkBase to override detection logic.
Caching:
- SDK scripts may be cached aggressively by CDNs (e.g., Facebook). Use data-sdktime attributes to bust caches:
```
// config/social_sdk.php
'cache_busting' => true,
```
Asynchronous Loading:
- SDKs are loaded synchronously by default. For async loading, modify the provider:
```
public function getScriptTag(): string
{
    return '<script async src="..."></script>';
}
```
Debugging:
- Check if SDKs are loaded by inspecting the page source or using browser dev tools (Network tab). Missing SDKs often indicate:
  - Incorrect button classes/attributes.
  - Route exclusions blocking the page.
  - Provider not registered (for custom SDKs).

Tips

Extending for New SDKs:

Create a custom provider (e.g., LinkedInSdk) extending SdkBase:

namespace App\SocialSDK;

use AlphaLemon\Block\SocialSDKBundle\Core\Sdk\SdkBase;

class LinkedInSdk extends SdkBase
{
    protected $name = 'linkedin';
    protected $scriptUrl = 'https://platform.linkedin.com/batch';
    protected $buttonSelector = '.linkedin-share-button';

    public function getScriptTag(): string
    {
        return sprintf(
            '<script type="in/batch" src="%s"></script>',
            $this->scriptUrl
        );
    }
}

'providers' => [
    'linkedin' => App\SocialSDK\LinkedInSdk::class,
],

Performance:
- Preload SDKs for critical pages (e.g., homepage) by forcing inclusion:
```
// In a service provider
$this->app['social_sdk']->forceSdk('facebook');
```

Testing:

Mock SDK detection in PHPUnit:

$this->partialMock(SocialSDKManager::class, ['detectButtons'])
     ->method('detectButtons')
     ->willReturn(['facebook' => true]);

Configuration:

Override default config via environment variables:

// config/social_sdk.php
'facebook' => [
    'app_id' => env('SOCIAL_SDK_FACEBOOK_APP_ID'),
],

SOCIAL_SDK_FACEBOOK_APP_ID=your_app_id_here

Fallbacks:

Provide fallback scripts if the bundle fails:

@if(!socialSdkLoaded('facebook'))
    <script src="https://connect.facebook.net/en_US/sdk.js"></script>
@endif

Social Sdk Bundle Laravel Package