{"id":13606943,"url":"https://github.com/Flynsarmy/wn-sociallogin-plugin","last_synced_at":"2025-04-12T11:31:03.934Z","repository":{"id":38038296,"uuid":"357553168","full_name":"Flynsarmy/wn-sociallogin-plugin","owner":"Flynsarmy","description":"Allows Winter CMS site visitors to register/sign in with their social media accounts","archived":false,"fork":false,"pushed_at":"2022-12-05T22:29:07.000Z","size":223,"stargazers_count":5,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-10T20:29:14.619Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Flynsarmy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-13T12:55:57.000Z","updated_at":"2023-01-16T12:33:06.000Z","dependencies_parsed_at":"2023-01-24T07:31:10.485Z","dependency_job_id":null,"html_url":"https://github.com/Flynsarmy/wn-sociallogin-plugin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flynsarmy%2Fwn-sociallogin-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flynsarmy%2Fwn-sociallogin-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flynsarmy%2Fwn-sociallogin-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flynsarmy%2Fwn-sociallogin-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Flynsarmy","download_url":"https://codeload.github.com/Flynsarmy/wn-sociallogin-plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248560067,"owners_count":21124588,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T19:01:14.002Z","updated_at":"2025-04-12T11:31:03.912Z","avatar_url":"https://github.com/Flynsarmy.png","language":"PHP","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Social Login for Winter\n\nThe Social Login plugin for Winter CMS allows customers to register and log in to your site with their Facebook, Google, Twitter and other social media accounts. The login page is completely customisable and can theme seamlessly into any Winter site.\n\n## Supports\n\n* Twitter\n* Facebook\n* Google\n* **Extensible!** Don't see one you want? Add it!\n\n**New!** Backend login support. Check the 'Enabled on backend?' checkbox on a per-provider basis in Settings - Social Login.\n\n## Have a feature suggestion? Found a bug or need support?\n\nPlease use the contact form [on my website](https://www.flynsarmy.com/contact/) and I'll get back to you as soon as possible. I usually respond within a few hours depending on timezone differences.\n\n## Installation\n\nThis plugin relies on Winter.User, so make sure you have that installed.\n\nGo to System - Updates and in the search field enter **Flynsarmy.SocialLogin**\n\n### Via Composer\n\n* Add repository to composer.json:\n\n    ```json\n    \"repositories\": [\n        {\n            \"type\": \"vcs\",\n            \"url\": \"https://github.com/Flynsarmy/wn-sociallogin-plugin\"\n        }\n    ],\n    ```\n\n* Then run command in console:\n\n    ```bash\n    composer require --dev flynsarmy/wn-sociallogin-plugin \"dev-master\"\n    ```\n\n## Usage\n\n* Fill in any required credentials in System - Social Login, making sure the `Enabled?` checkbox is ticked when you're done.\n* Add `User - Account` and `Social Login` components to your login page\n* Copy `/plugins/winter/user/components/account/signin.htm` to your themes *partials/account* folder\n* Where you want your login links, add\n\n```twig\n{% for name, link in social_login_links %}\n    \u003ca href=\"{{ link }}\"\u003e{{ name }}\u003c/a\u003e\n{% endfor %}\n```\n\nRemember that you can format it any way you like.\n\n## Settings\n\nSometimes you'll want to decide which page to redirect to on login/error. For example perhaps you have a log in page before checkout in an ecommerce plugin and want to redirect to the cart on login. This can be done by appending the following query string values to your login links:\n\nQuery String Param | Default | Description\n-------------------|---------|-------------\ns | /      | Success page redirect URL (relative)\nf | /login | Error page redirect URL (relative)\n\n**Example usage:**\n\n```twig\n{% for name, link in social_login_links %}\n    \u003ca href=\"{{ link }}?s={{ 'home'|page }}\u0026f={{ 'login'|page }}\"\u003e{{ name }}\u003c/a\u003e\n{% endfor %}\n```\n\n### Events\n\nDevelopers can change the way logins are handled through several events detailed below.\n\nEvent | Parameters | Description\n------|------------|-------------\nflynsarmy.sociallogin.handleBackendLogin | array $provider_details, array $user_details, User $user | Triggers before backend login. Return true to halt the login process\nflynsarmy.sociallogin.handleLogin | array $provider_details, array $user_details, User $user | Triggers before frontend login. Return true to halt the login process\nflynsarmy.sociallogin.registerUser | array $provider_details, array $user_details | Triggers before registering a new user for attaching to a social account. Optionally return a User object\n\n### Other Notes\n\nTwitter doesn't return an email address, so when logging in with Twitter, a new user account is created and associated with the Twitter account.\n\n### Examples\n\nTo get your login page looking how mine is in the marketplace screenshot here's my `/themes/travu/partials/account/signin.htm`:\n\n```twig\n\u003cform id=\"login\" data-request=\"onSignin\"\u003e\n\t\u003cdiv class=\"form-group\"\u003e\n\t\t\u003clabel for=\"userSigninEmail\"\u003eEmail\u003c/label\u003e\n\t\t\u003cinput name=\"email\" type=\"email\" class=\"form-control\" id=\"userSigninEmail\" placeholder=\"Enter your email\"\u003e\n\t\u003c/div\u003e\n\n\t\u003cdiv class=\"form-group\"\u003e\n\t\t\u003clabel for=\"userSigninPassword\"\u003ePassword\u003c/label\u003e\n\t\t\u003cinput name=\"password\" type=\"password\" class=\"form-control\" id=\"userSigninPassword\" placeholder=\"Enter your password\"\u003e\n\t\u003c/div\u003e\n\n\t\u003cp align=\"right\"\u003e\n\t\tor sign in with\n\t\t{% for name, link in social_login_links %}\n\t\t\t\u003ca href=\"{{ link }}\" class='login {{ name|lower }}'\u003e\u003ci class=\"fa fa-2 fa-{{ name|lower }}\"\u003e\u003c/i\u003e\u003c/a\u003e\n\t\t{% endfor %}\n\t\u003c/p\u003e\n\n\t\u003cbutton type=\"submit\" class=\"btn btn-default\"\u003eSign in\u003c/button\u003e\n\u003c/form\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlynsarmy%2Fwn-sociallogin-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFlynsarmy%2Fwn-sociallogin-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFlynsarmy%2Fwn-sociallogin-plugin/lists"}