Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iwheelbuy/socialnetwork
https://github.com/iwheelbuy/socialnetwork
access-token authorization facebook google oauth oauth2 odnoklassniki social-network vkontakte
Last synced: 11 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/iwheelbuy/socialnetwork
- Owner: iwheelbuy
- License: mit
- Created: 2018-03-23T12:57:50.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-10-06T19:49:00.000Z (about 2 years ago)
- Last Synced: 2024-10-15T09:46:57.647Z (23 days ago)
- Topics: access-token, authorization, facebook, google, oauth, oauth2, odnoklassniki, social-network, vkontakte
- Language: Swift
- Size: 347 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SocialNetwork
[](http://cocoapods.org/pods/SocialNetwork)
[](http://cocoapods.org/pods/SocialNetwork)
[](http://cocoapods.org/pods/SocialNetwork)
## Usage
Install via CocoaPods:
```ruby
pod 'SocialNetwork', '0.4.0'
```
You can open an official application of a social network or present `SFSafariViewController` for authorization:
```swift
switch SocialNetwork.facebook.appExists {
case true:
UIApplication.shared.openURL(SocialNetwork.facebook.appUrl)
case false:
let controller = SFSafariViewController(url: SocialNetwork.facebook.oauthUrl)
UIApplication.shared.keyWindow?.rootViewController?.present(controller: controller)
}
```
Take into account that not each social network allows to authorize via its official application.
## Info.plist setup
To be able to use `appExists` variable you should provide `LSApplicationQueriesSchemes` for desired social networks:
```swift
LSApplicationQueriesSchemes
fb
fbapi
fbauth
fbauth2
odnoklassniki
okauth
vk
vk-share
vkauthorize
```
Required `CFBundleURLTypes` - `socialnetwork`. Other `CFBundleURLTypes` are optional and should be provided only if you plan to use authorization via official applications:
```swift
CFBundleURLTypes
CFBundleURLName
SocialNetwork
CFBundleURLSchemes
socialnetwork
fb0123456789
ok0123456789
vk0123456789
```
## Redirect URL setup
In each social network, which is planned to be used for authorization, you should provide a redirect URL:
https://iwheelbuy.github.io/SocialNetwork/simplified.html
The code of redirection html page can be found there:
https://github.com/iwheelbuy/SocialNetwork/blob/master/docs/simplified.html
## Basic setup
Set the `SocialNetworkDataSource` and the `SocialNetworkDelegate` somewhere in your project:
```swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
SocialNetwork.dataSource = self
SocialNetwork.delegate = self
return true
}
```
Proceed the URL this way:
```swift
func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
if SocialNetwork.didProceed(url: url) {
return true
}
return false
}
```
Conform to `SocialNetworkDelegate` to receive authorization data:
```swift
extension AppDelegate: SocialNetworkDelegate {
func socialNetwork(socialNetwork: SocialNetwork, didCompleteWithParameters parameters: [String : String]) {
// hide authorization controllers if there are some
if let token = socialNetwork.getToken(parameters: parameters) {
// do something with token
}
}
}
```
Conform to `SocialNetworkDataSource` and provide information for required social networks:
```swift
extension AppDelegate: SocialNetworkDataSource {
func socialNetworkClientIdentifier(socialNetwork: SocialNetwork) -> String? {
switch socialNetwork {
case .facebook:
return "0123456789"
default:
return nil
}
}
}
```
There are some additional optional methods, where you can provide client secret for code flow authorization or change the default permissions:
```swift
extension AppDelegate: SocialNetworkDataSource {
func socialNetworkClientSecret(socialNetwork: SocialNetwork) -> String? {
switch socialNetwork {
case .facebook:
return "987654321"
default:
return nil
}
}
func socialNetworkPermissions(socialNetwork: SocialNetwork) -> String? {
switch socialNetwork {
case .facebook:
return "public_profile,email"
default:
return nil
}
}
}
```
## Author
iwheelbuy, [email protected]
## License
SocialNetwork is available under the MIT license. See the LICENSE file for more info.