a2nt/silverstripe-vkconnect

Integration of VK Connect into SilverStripe

Vk Connect Integration Module

Maintainer Contact

• Anton Fedianin https://twma.pro

Requirements

• SilverStripe 3.2

Overview

The module provides a basic interface for implementing the Vk PHP SDK on your SilverStripe website. The Vk SDK allows users to login to your website using their Vk account details, creating a single sign-on within the existing SilverStripe member system., _(*1)

What it provides

• Loads the VK PHP SDK., _(*2)

• Provides $VkLoginLink template variable to generate a link to login to VK.com Upon clicking the link and being redirected back to your application the SilverStripe Member::currentUser() will be populated with a Member instance linked to the users VK profile., _(*3)

<% with CurrentMember %>
    $Name $Avatar(small)
<% end_with %>

Installation

composer require "a2nt/silverstripe-vkconnect" "dev-master"

Register your website / application with VK., _(*4)

Set your configuration through the SilverStripe Config API. For example I keep my configuration in mysite/_config/vkconnect.yml file:, _(*5)

VkControllerExtension:
  app_id: 'MyAppID'
  api_secret: 'Secret'

Update the database by running /dev/build to add the additional fields to the Member table and make sure you ?flush=1 when you reload your website., _(*6)

<a href="$VkLoginLink">Login via Vk</a>

You can also access the Vk PHP SDK in your PHP code.., _(*7)

// https://developers.Vk.com/docs/php/VkSession/4.0.0
$session = Controller::curr()->getVkSession();

For more information about what you can do through the SDK see:, _(*8)

https://vk.com/dev/manuals, _(*9)

Options

All the following values are set either via the Config API like follows, _(*10)

Config::inst()->update('VkControllerExtension', '$option', '$value'), _(*11)

Or (more recommended) through the YAML API, _(*12)

VkControllerExtension: option: value, _(*13)

app_id

Your app id. Found on the Vk Developer Page., _(*14)

api_secret

Vk API secret. Again, from your Application page., _(*15)

create_member

Optional, default: true, _(*16)

Whether or not to create a Member record in the database with the users information. If you disable this, ensure your code uses $CurrentVkMember rather than $Member. Other access functionality (such as admin access) will not work., _(*17)

member_groups

Optional, default '', _(*18)

A list of group codes to add the user. For instance if you want every member who joins through Vk to be added to a group Vk Members set the following:, _(*19)

VkControllerExtension: member_groups: - Vk_members, _(*20)

permissions

Optional, default 'email', _(*21)

A list of permission codes you want from the user. Permission codes are listed on developers.Vk.com., _(*22)

Ensure you include email in your list if you require create_member., _(*23)

Vk_fields

Default 'email','first_name','last_name', _(*24)

A list of fields you want to retrieve from Vk for the user. Available fields are listed on developers.Vk.com., _(*25)

Ensure you include email in your list if you require create_member., _(*26)

sync_member_details

Optional, default true, _(*27)

Flag as to whether to replace user information (such as name) in your database with the values from Vk., _(*28)

License

Released under the BSD-3-Clause License., _(*29)