Componette

Componette

michalsvec

michalsvec / nette-opauth v0.6.6

Opauth package for Nette framework

download-cloud-line composer require michalsvec/nette-opauth

michalsvec/nette-opauth

Requirements

As it's an Opauth extension for Nette framework, it requires

Installation

Update composer.json:

"require": {
    "michalsvec/nette-opauth": "*"
}

and then

$ composer install

Update bootstrap.php:

// add compiler extension
$configurator->onCompile[] = function (\Nette\Config\Configurator $config, \Nette\Config\Compiler $compiler) {
	$compiler->addExtension('opauth', new NetteOpauth\DI\Extension());
};

// register routers
\NetteOpauth\NetteOpauth::register($container->router);

Check if routes are in proper order (auth routes before the commons). And update Auth presenter as shown in example.

Then you can use:

{if Nette\Config\Configurator::detectDebugMode()}
	<a href="{plink Auth:callback, strategy => 'fake'}">Fake login</a><br/>
{/if}
<a href="{plink Auth:google}">Sign-in with Google</a><br/>
<a href="{plink Auth:facebook}">Sign-in with Facebook</a><br/>
<a href="{plink Auth:twitter}">Sign-in with Twitter</a><br/>
<a href="{plink Auth:linkedin}">Sign-in with LinkedIn</a><br/>

Configure in config.neon

opauth:
	path: '/auth/'
	debug: false
	callback_url: '{path}callback'
	security_salt: '123abc456def'
	callback_transport: 'session'
	Strategy:
		Facebook:
			app_id: ''
			app_secret: ''
		Google:
			client_id: ''
			client_secret: ''
		Twitter:
			key: ''
			secret: ''
		LinkedIn:
			api_key: ''
			secret_key: ''

Tips and triks

  • opauth needs public callback url to proper redirect thus is impossible to use it at localhost (except the fake login).
  • facebook
    • registration of app
  • google
    • registration of app
    • google ids are very long (more than unsigned int) be careful about that
  • twitter
    • registration of app
    • do not provide email
  • linkedin

Roadmap

  • add more identities for various providers
  • v0.6.6 Fixed routing

    Fixed trailing slashes in route definitions. Closes #10

  • v0.6.5 Linkedin support

    Added LinkedIn support. Thanks to @fabiancz.

  • v0.6.0

    • Updated to Nette 2.1
    • Added Neon syntax in README
Componette Componette felix@nette.org