OAuth authorization plugin for Moodle
PHP CSS
Latest commit a4374a5 Jul 16, 2016 sazonov README update
Permalink
Failed to load latest commit information.
db
lang
pix
.gitattributes
.gitignore
README.md
auth.php
htmlcode.php
index.php
out.php
redirect.php
styles.css
version.php
view_admin_config.php

README.md

LenAuth Plugin for Moodle

Easy authorization via most popular International and Russian social networks: Facebook, Google+, Yahoo, Twitter, VK, Yandex, Mail.RU

This plugin allows easy auth method for your Moodle. You just need to register and adjust OAuth applications of social networks and fill system data to LenAuth settings. If user didnt registered via LenAuth and has not a Moodle account - his account will be created, if account is registered, but not binded with LenAuth - account will be binded.

Features

  • a lot of settings
  • a lot of social buttons skins including Font-Awesome and Bootstrap based skins
  • detailed description about OAuth applications register
  • Russian language includes
  • own buttons text (some skins)
  • enable/disable services
  • international/russian logos in settings
  • own buttons order

Download Installation

English plugin documentation

Russian plugin documentation

Official Moodle plugin repository page

First of all, you need to have installed and fine working Moodle 2.6.5+

  • upload lenauth folder to /auth folder, so files need to be inside /auth/lenauth/
  • update Moodle DataBase. Just in admin panel click Home, and Moodle will suggest for LenAuth update
  • activate the plugin. Block Administration -> Plugins -> Authentication -> Manage authentication
  • register OAuth clients/applications at social networks and fill api data to LenAuth settings. Instructions are in the plugin admin page.

Usage. Output in Moodle theme

Its very-very simple. You have two methods: PHP-code or static HTML-code.

  • PHP-code. Copy PHP-code from skins table at LenAuth plugin screen opposite skin you need and paste the code into your current Moodle theme. All updates of LenAuth settings will automatically apply in theme.

Sample PHP-code:

<?php if ( file_exists( $CFG->dirroot . '/auth/lenauth/out.php' ) ) : include_once $CFG->dirroot . '/auth/lenauth/out.php'; echo auth_lenauth_out::getInstance()->lenauth_output('style3-text'); endif; ?>

  • Static HTML-code. Click Static HTML-code link under PHP-code. In new window you will see static HTML-code, so you can copy it and paste in your current theme. BUT! this is static code, so if you will change some settings in LenAuth you need to update this HTML-code!

Contributing

You're welcome for pull requests but against master branch. Thanks!

Changelog

Version 1.2.5 (2016071500)

Version 1.2.4 (2015123100)

Version 1.2.3 (2015112001)

Version 1.2.2 (2015071100)

  • Improvement from Mark Samberg (pull request #3) about Bootstrap + Font Awesome buttons styles. NOTE your current Moodle theme requires Bootstrap and Font Awesome to correct output this buttons skin. Yandex and Mail.Ru logos are out of Font Awesome for now...
  • Double email correct check

Version 1.2.0 (2015060300)

  • New feature: custom order of links/buttons output
  • Yahoo OAuth2 protocol full integration, old OAuth1 also supports. Now you can select Yahoo OAuth protocol version.
  • Improvement from Mark Samberg (pull request #2) to allow display buttons for guest users
  • VK API version updated to version 5.33

Version 1.1.0 (2015010500)

Version 1.0.8 (2014122400). Much thanks to Yandex Tech Team!

  • Added cookie clear if final data fails
  • Fix from Yandex Tech team: get default email instead of first

Version 1.0.7 (2014112500)

  • Fix for output variable at get_string function
  • Predefine ALL of configs
  • Small fix to complete show buttons examples in admin screen

Version 1.0.6 (2014112200)

  • Preset some plugin configs (Thanks to David Mudrák)
  • Added check for file exists of out.php
  • Complete Frankenstyle class and functions names
  • Some very small fixes

Version 1.0.4 (2014111300)

  • check permissions for file view_admin_config.php
  • edited config names and method names to Frankenstyle
  • fixed SQL request for function _lenauth_get_userdata_by_social_id to Postgresql compatibility
  • more documentation/metainfo for some functions
  • fix for Yandex button link for English locale

Version 1.0 (2014110200)

  • initial release.

Author

Copyright 2014, Igor Sazonov (sovletig@yandex.ru)