joelbutcher/socialstream

[bug] https://docs.socialstream.dev/getting-started/socialite-providers" should be removed

helloadmin opened this issue · 5 comments

I acknowledge the massive amount of work to build and maintain a project. Thank you Joel.

I've been installing SocialStream for the last couple years in any laravel project but haven't really implemented as my priority is Azure/Microsoft oAuth. I finally took another swing at this, this past week.

This issue is in regard to the "Socialite Providers" documentation at https://docs.socialstream.dev/getting-started/socialite-providers

I'm using Inertia and as per the docs, I created a Azure icon and included in the icon location. I also modified the Socialstream.vue and ConnectedAccount.vue screen to include an Azure button.

I also added Providers::azure(), to the providers array of the /config/socialstream.php file as it seemed to be the most appropriate thing to do.

When pressing the button, the first issue is an exception of "Call to undefined method JoelButcher\Socialstream\Providers" references the "/vendor/joelbutcher/socialstream/src/Providers.php (line 223) " file. Of course, Azure is not defined there.

When I look at installation for socialiteproviders where the Azure oAuth is defined and this page in question references, SocialiteServiceProvider has already been removed from the providers array of the config\app.php file (presumably by the socialstream install script and SocialstreamServiceProvider is found in its place. Based on the socialiteproviders docs, I presume similarily, \SocialiteProivers\Manager\ServiceProvider class should replace this as per the socialiteproviders docs.

At this point, including Azure oAuth in SocialStream has exceeded the standard knowledge I have and I expect many others based on the absence of any official documentation or random posts or youtube videos on the subject.

I'm suggesting and requesting that the "https://docs.socialstream.dev/getting-started/socialite-providers" be removed as the documentation is insufficient and my gut says that it really isn't supported.

Alternatively, Azure oAuth is very important to me and with the broad range of other supported oAuth found at SocialiteProviders, i suspect would be useful and valuable to other Laravel developers. If there is such a thing as fund-a-feature, I'd certainly be interested in throwing in some $ to help get this working and documented.

Again, ty for the hundreds of hours to get your project to the point its current at. Much appreciated Joel.

@helloadmin Thanks for pointing this out. I will look improving the documentation behind getting socialite providers up and running with this package. Please can you raise an issue on joelbutcher/socialstream-docs that this documentation is insufficient and I'll spend some time investigating what needs to be done to get that package working in sync with this one.

Thanks again!

@helloadmin I've added a new "guide" for Socialite Providers here

Thank you,

Hello, I am experiencing the same issue and was wondering if there it has been fixed or a workaround.

The error is the same: Call to undefined method JoelButcher\Socialstream\Providers::azure()

That class only supports calls the to defined static methods (which out of the box, only supports providers from Laravel Socialite). To add a custom provider, use strings:

'providers' => [
    'azure',
]