Overriding the Callback Logic
Want even more freedom over your application? Well as of Socialstream v4.1.0, you can specifiy overrides for how Socialstream handles the OAuth callback part of the flow. 🤯
If the callback from a provider contains an
errors key in the request, Socialstream handles this via a new HandlesOauthCallbackErrors interface. By default, the implementation is bound to the \JoelButcher\Socialstream\Actions\Auth\HandleOauthCallbackErrors implementation, but you can change this at any time by specifying a custom callback within the boot method of your applications AppServiceProvider:<?php
namespace App\Providers
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function boot(): void
{
Socialstream::handlesOAuthCallbackErrorsUsing(function ($app) {
// ...
});
}
}
Alternatively, you can provider the FQN of a
HandlesOauthCallbackErrors instance:<?php
namespace App\Providers
use App\Actions\Socialstream\Auth\HandleCallbackErrors;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function boot(): void
{
Socialstream::handlesOAuthCallbackErrorsUsing(HandleCallbackErrors::class);
}
}
Socialstream now deferes all OAuth authentication logic to a new
AuthenticatesOauthCallback implementation. This implementation lives within the source code for socialstream and can remain unchanged for the majority of use-cases. However, should you wish to override, or customise this logic, you can do so by providing your own implementation. Simple define a closure, or create a class that implements the AuthenticatesOauthCallback contract and specify this within the boot method of your applications AppServiceProvider:<?php
namespace App\Providers
use App\Actions\Socialstream\Auth\HandleOAuthCallback;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function boot(): void
{
// Socialstream::authenticatesOauthCallbackUsing(function ($app) {
// ...
// });
Socialstream::authenticatesOauthCallbackUsing(HandleOAuthCallback::class);
}
}