{"id":21662648,"url":"https://github.com/codesyntax/cs.auth.facebook","last_synced_at":"2025-04-11T23:51:04.924Z","repository":{"id":3442789,"uuid":"4495576","full_name":"codesyntax/cs.auth.facebook","owner":"codesyntax","description":"Facebook authentication plugin for Plone","archived":false,"fork":false,"pushed_at":"2019-10-09T09:43:40.000Z","size":82,"stargazers_count":7,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T19:48:39.690Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"bengotow/PSDWriter","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codesyntax.png","metadata":{"files":{"readme":"README.rst","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":"2012-05-30T14:15:23.000Z","updated_at":"2025-03-06T06:06:50.000Z","dependencies_parsed_at":"2022-08-20T16:31:09.627Z","dependency_job_id":null,"html_url":"https://github.com/codesyntax/cs.auth.facebook","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesyntax%2Fcs.auth.facebook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesyntax%2Fcs.auth.facebook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesyntax%2Fcs.auth.facebook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codesyntax%2Fcs.auth.facebook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codesyntax","download_url":"https://codeload.github.com/codesyntax/cs.auth.facebook/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248497890,"owners_count":21113984,"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-11-25T10:17:32.786Z","updated_at":"2025-04-11T23:51:04.902Z","avatar_url":"https://github.com/codesyntax.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Introduction\n============\n\nA PAS plugin to login into a Plone Site using Facebook.\n\n* Log in to a Plone site through Facebook: when a user requests to log in to the Plone site he will be redirected to Facebook so that he provides the credentials there, then he will be redirected back to the Plone site and will be identified there.\n\n* The user will be a standard Plone user, so Roles or Group membership can be set.\n\n* Minimal user information is kept in Plone such as full name, Facebook ID, photo and e-mail (if available) of the user. This is kept to avoid permanent requests to Facebook API. This information is refreshed each time the user logs in to the site.\n\n\nInstallation and getting started\n--------------------------------\n\n1. Buildout\n\n   Add `cs.auth.facebook` to your ``buildout.cfg`` eggs list::\n\n    [buildout]\n    ...\n    eggs =\n        cs.auth.facebook\n        \n   Or as a required install dependency of your own addon ``setup.py``::\n\n    install_requires=[\n        ...\n        'cs.auth.facebook',\n    ], \n\n2. Create a new Facebook app at https://developers.facebook.com/apps and fill \n   in the required data in the plugin's control panel form. \n   Make sure to enter the URL of the Website that is using the Facebook Login in App -\u003e Facebook-Login -\u003e Settings -\u003e Valid OAuth Redirect URLs. If you want to run it from your local machine, you have to provide ``http://localhost:8080`` and disable SSL-Enforcement.\n\n3. Install the product in the Plone Control Panel and provide the app_id \n   and app_secret in the configuration panel.\n\n   In Plone 4 you now see the \"Facebook Login\" button viewlet. To customize the placement of this\n   viewlet please check out the `Plone Viewlet Documentation \u003chttp://goo.gl/RyUORn\u003e`_ \n\n4. Alternatively you can enable an action in portal_actions with the following configuration\n   (see ``profiles/default/actions.xml`` within this package)::\n\n    \u003cobject name=\"portal_actions\" meta_type=\"Plone Actions Tool\"\n       xmlns:i18n=\"http://xml.zope.org/namespaces/i18n\"\u003e\n        \u003cobject name=\"user\" meta_type=\"CMF Action Category\"\u003e\n            \u003cobject name=\"login_facebook\" meta_type=\"CMF Action\" i18n:domain=\"cs.auth.facebook\"\u003e\n                \u003cproperty name=\"title\" i18n:translate=\"\"\u003eLog in with Facebook\u003c/property\u003e\n                \u003cproperty name=\"description\" i18n:translate=\"\"\u003e\u003c/property\u003e\n                \u003cproperty name=\"url_expr\"\u003estring:${globals_view/navigationRootUrl}/@@facebook-login\u003c/property\u003e\n                \u003cproperty name=\"icon_expr\"\u003e\u003c/property\u003e\n                \u003cproperty name=\"available_expr\"\u003epython:member is None\u003c/property\u003e\n                \u003cproperty name=\"permissions\"\u003e\n                    \u003celement value=\"View\"/\u003e\n                \u003c/property\u003e\n                \u003cproperty name=\"visible\"\u003eFalse\u003c/property\u003e\n            \u003c/object\u003e\n        \u003c/object\u003e\n    \u003c/object\u003e\n    \n5. A second alternative is to link to the view ``${globals_view/navigationRootUrl}/@@facebook-login`` where ever you want to start the facebook login.\n\n\nBehind the scenes\n-----------------\n\nThe Facebook Login Viewlet uses the new Facebook JavaScript SDK v4.0 to ensure\nthe proper popup for every target device. You don't have to care about this.\n\nFor more information on FB JSDK checkout the `Facebook Developers Login Documentation \u003chttps://developers.facebook.com/docs/facebook-login/login-flow-for-web/v4.0\u003e`_\n\n\nCredit\n------\n\nThis product re-distributes a lot of code written by Martin Aspeli\n(aka @optilude) in his book \"Professional Plone 4 Development\" and\navailable under GPL license in his personal GitHub account with\nthe name 'optilux.facebookauth':\n\n  https://github.com/optilude/optilux/tree/chapter-16/src/optilux.facebookauth\n\n\nCompatibility\n=============\n\nPlone 4.x\n\nPlone 5.x\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodesyntax%2Fcs.auth.facebook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodesyntax%2Fcs.auth.facebook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodesyntax%2Fcs.auth.facebook/lists"}