Class yii\authclient\widgets\AuthChoice

AuthChoice prints buttons for authentication via various auth clients.

It opens a popup window for the client authentication process. By default this widget relies on presence of yii\authclient\Collection among application components to get auth clients information.

Example:

<?= yii\authclient\widgets\AuthChoice::widget([
    'baseAuthUrl' => ['site/auth']
]); ?>

You can customize the widget appearance by using begin() and end() syntax along with using method clientLink() or createClientUrl(). For example:

<?php
use yii\authclient\widgets\AuthChoice;
?>
<?php $authAuthChoice = AuthChoice::begin([
    'baseAuthUrl' => ['site/auth']
]); ?>
<ul>
<?php foreach ($authAuthChoice->getClients() as $client): ?>
    <li><?= $authAuthChoice->clientLink($client) ?></li>
<?php endforeach; ?>
</ul>
<?php AuthChoice::end(); ?>

This widget supports following keys for yii\authclient\ClientInterface::getViewOptions() result:

• popupWidth: int, width of the popup window in pixels.
• popupHeight: int, height of the popup window in pixels.
• widget: array, configuration for the widget, which should be used to render a client link; such widget should be a subclass of yii\authclient\widgets\AuthChoiceItem.

See also yii\authclient\AuthAction.

Public Properties

Public Methods

Protected Methods

Events

Property Details

$autoRender public property

Indicates if widget content, should be rendered automatically. Note: this value automatically set to 'false' at the first call of createClientUrl()

public boolean $autoRender = true

$baseAuthUrl public property

Base auth URL configuration.

public array getBaseAuthUrl ( )
public void setBaseAuthUrl ( array $baseAuthUrl )

$clientCollection public property

Name of the auth client collection application component. This component will be used to fetch services value if it is not set.

public string $clientCollection = 'authClientCollection'

$clientIdGetParamName public property

Name of the GET param , which should be used to passed auth client id to URL defined by $baseAuthUrl.

public string $clientIdGetParamName = 'authclient'

$clientOptions public property

Additional options to be passed to the underlying JS plugin.

public array $clientOptions = []

$clients public property

Auth providers

public yii\authclient\ClientInterface[] getClients ( )
public void setClients ( array $clients )

$options public property

The HTML attributes that should be rendered in the div HTML tag representing the container element.

See also yii\helpers\Html::renderTagAttributes() for details on how attributes are being rendered.

public array $options = []

$popupMode public property

Indicates if popup window should be used instead of direct links.

public boolean $popupMode = true

Method Details