Difference between revisions of "Plugin/Events/User/nl"

From Joomla! Documentation

< Plugin‎ | Events
(Updating to match new version of source page)
(Created page with "===Gebruikt in bestanden===")
(20 intermediate revisions by the same user not shown)
Line 10: Line 10:
  
 
===Parameters===
 
===Parameters===
−
* '''$user''' - an associative array of [http://api.joomla.org/cms-3/classes/JAuthenticationResponse.html JAuthenticateResponse] type (see link for array keys)
+
* '''$user''' - een associatirve array van het [http://api.joomla.org/cms-3/classes/JAuthenticationResponse.html JAuthenticateResponse] type (zie link voor array keys)
−
* '''$options''' - an associative array containing these keys: ["remember"] => bool, ["return"] => string, ["entry_url"] => string
+
* '''$options''' - een associatieve array die de volgende sleutels bevat: ["remember"] => bool, ["return"] => string, ["entry_url"] => string
  
−
===Return Value===
+
===Return waarde===
 
Boolean
 
Boolean
  
−
===Used in files===
+
===Gebruikt in bestanden===
 
*<tt>libraries/joomla/application/application.php</tt>
 
*<tt>libraries/joomla/application/application.php</tt>
 
*<tt>plugins/user/joomla.php</tt>
 
*<tt>plugins/user/joomla.php</tt>
Line 28: Line 28:
 
Dit evenement wordt gestart vóór de gebruiker is afgemeld van het systeem.  
 
Dit evenement wordt gestart vóór de gebruiker is afgemeld van het systeem.  
  
−
If any plugin returns false, the global logout fails and the onUserLogoutFailure event is fired; if it succeeds, onUserAfterLogout event is triggered instead.  
+
Als een plugin false retourneert zal het algemene uitloggen mislukken en de onUserLogoutFailure event wordt geactiveerd; als dit lukt zal het  onUserAfterLogout event worden geactiveerd.  
  
 
NOTE: as of 3.3.6, returning false does not work correctly, because stock components perform their logout operation during the onUserLogout event. So even if your plugin returns false, the stock ones have already run anyway. Thus, the user will be "mostly" logged out even if you return false. There is no actual way to cleanly abort logout.
 
NOTE: as of 3.3.6, returning false does not work correctly, because stock components perform their logout operation during the onUserLogout event. So even if your plugin returns false, the stock ones have already run anyway. Thus, the user will be "mostly" logged out even if you return false. There is no actual way to cleanly abort logout.
Line 36: Line 36:
 
* '''$options''' - an associative array containing this key: ["clientid"] => int
 
* '''$options''' - an associative array containing this key: ["clientid"] => int
  
−
===Return Value===
+
===Return waarde===
 
Boolean
 
Boolean
  
Line 62: Line 62:
 
An array of JAuthenticateResponse objects detailing the results of each called plugin, including success or failure.
 
An array of JAuthenticateResponse objects detailing the results of each called plugin, including success or failure.
  
−
===Used in files===
+
===Gebruikt in bestanden===
 
*<tt>libraries/joomla/user/authentication.php</tt>
 
*<tt>libraries/joomla/user/authentication.php</tt>
 
*<tt>plugins/authentication/gmail.php</tt>
 
*<tt>plugins/authentication/gmail.php</tt>
Line 73: Line 73:
 
==onUserLoginFailure==
 
==onUserLoginFailure==
  
−
===Description===
+
===Beschrijving===
−
This event is triggered whenever a user authentication request is failed by any plugin.
+
Deze gebeurtenis wordt geactiveerd wanneer een gebruiker authenticatie-aanvraag is mislukt door een plugin.
  
 
===Parameters===
 
===Parameters===
Line 82: Line 82:
 
Unknown. The return value appears to be ignored in any case.
 
Unknown. The return value appears to be ignored in any case.
  
−
===Used in file===
+
===Gebruikt in bestand===
 
*<tt>libraries/joomla/application/user/authentication.php</tt>
 
*<tt>libraries/joomla/application/user/authentication.php</tt>
  
 
==onUserAfterLogin==
 
==onUserAfterLogin==
  
−
===Description===
+
===Beschrijving===
−
This event is triggered whenever a user is successfully logged in.
+
Deze gebeurtenis wordt geactiveerd wanneer een gebruiker succesvol is ingelogd.
  
 
===Parameters===
 
===Parameters===
Line 99: Line 99:
 
* responseType
 
* responseType
  
−
===Return Value===
+
===Retourwaarde===
 
Boolean
 
Boolean
  
−
===Used in files===
+
===Gebruikt in bestanden===
 
*<tt>libraries/legacy/application/application.php</tt>
 
*<tt>libraries/legacy/application/application.php</tt>
 
*<tt>libraries/cms/application/cms.php</tt>
 
*<tt>libraries/cms/application/cms.php</tt>
Line 124: Line 124:
 
Boolean. Whether the user-save should proceed or not. Any plugin that returns false aborts the save.
 
Boolean. Whether the user-save should proceed or not. Any plugin that returns false aborts the save.
  
−
===Used in file===
+
===Gebruikt in bestand===
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>libraries/joomla/user/user.php</tt>
  
Line 144: Line 144:
 
Note: The old values that were just updated are not available here or afterwards. In case you need the old values, use onBeforeStoreUser().
 
Note: The old values that were just updated are not available here or afterwards. In case you need the old values, use onBeforeStoreUser().
  
−
===Return Value===
+
===Retourwaarde===
−
None
+
Geen
  
−
===Used in file===
+
===Gebruikt in bestand===
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>libraries/joomla/user/user.php</tt>
  
Line 155: Line 155:
 
==onUserBeforeDelete==
 
==onUserBeforeDelete==
  
−
===Description===
+
===Beschrijving===
−
The event is triggered when a user is about to be deleted from the system.
+
De gebeurtenis wordt geactiveerd wanneer een gebruiker wordt verwijderd uit het systeem.
  
 
===Parameters===
 
===Parameters===
−
* '''$user''' - An associative array of the columns in the user table.
+
* '''$user''' - Een associatieve array van de kolommen in de user tabel.
  
−
===Return Value===
+
===Retourwaarde===
−
None.
+
Geen.
  
−
===Used in files===
+
===Gebruikt in bestanden===
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>plugins/user/joomla.php</tt>
 
*<tt>plugins/user/joomla.php</tt>
Line 173: Line 173:
 
==onUserAfterDelete==
 
==onUserAfterDelete==
  
−
===Description===
+
===Beschrijving===
−
The event is triggered after a user has been deleted from the system.
+
De gebeurtenis wordt geactiveerd wanneer een gebruiker verwijderd is uit het systeem.
  
 
===Parameters===
 
===Parameters===
Line 181: Line 181:
 
* '''$msg''' - Error message if delete failed ([http://api.joomla.org/cms-3/classes/JError.html JError] object detailing the error, if any)
 
* '''$msg''' - Error message if delete failed ([http://api.joomla.org/cms-3/classes/JError.html JError] object detailing the error, if any)
  
−
===Return Value===
+
===Retourwaarde===
−
None.
+
Geen.
  
−
===Used in files===
+
===Gebruikt in bestanden===
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>libraries/joomla/user/user.php</tt>
 
*<tt>plugins/user/joomla.php</tt>
 
*<tt>plugins/user/joomla.php</tt>

Revision as of 16:28, 23 April 2016

Other languages:
English • ‎Nederlands • ‎español • ‎français

In een standaard Joomla installatie hebben we een aantal vooraf gedefineerde gebruiker gebeurtenissen die, wanneer geactiveerd, functies oproepen in de bijbehorende plugins.

onUserLogin

Beschrijving

Deze gebeurtenis wordt geactiveerd nadat de gebruiker is geverifieerd in het Joomla! gebruikersbestand.

Als het nodig is om de login-procedure (verificatie) af te breken, dan zult u de onUserAuthenticate in plaats daarvan moeten gebruiken.

Parameters

  • $user - een associatirve array van het JAuthenticateResponse type (zie link voor array keys)
  • $options - een associatieve array die de volgende sleutels bevat: ["remember"] => bool, ["return"] => string, ["entry_url"] => string

Return waarde

Boolean

Gebruikt in bestanden

  • libraries/joomla/application/application.php
  • plugins/user/joomla.php

Voorbeeld

  • plugins/user/example.php

onUserLogout

Beschrijving

Dit evenement wordt gestart vóór de gebruiker is afgemeld van het systeem.

Als een plugin false retourneert zal het algemene uitloggen mislukken en de onUserLogoutFailure event wordt geactiveerd; als dit lukt zal het onUserAfterLogout event worden geactiveerd.

NOTE: as of 3.3.6, returning false does not work correctly, because stock components perform their logout operation during the onUserLogout event. So even if your plugin returns false, the stock ones have already run anyway. Thus, the user will be "mostly" logged out even if you return false. There is no actual way to cleanly abort logout.

Parameters

  • $credentials - an associative array containing these keys: ["username"] => string, ["id"] => int
  • $options - an associative array containing this key: ["clientid"] => int

Return waarde

Boolean

Used in files

  • libraries/cms/application/cms.php
  • plugins/user/joomla/joomla.php
  • plugins/system/logout.php
  • plugins/system/remember/remember.php

Voorbeeld

  • plugins/user/example.php

onUserAuthenticate

Description

This event is triggered to verify that a set of login credentials is valid.

Parameters

Array of credentials. Structure:\\ ['username']\\ ['password']\\ Alternative authentication mechanisms can supply additional credentials.

Return Value

An array of JAuthenticateResponse objects detailing the results of each called plugin, including success or failure.

Gebruikt in bestanden

  • libraries/joomla/user/authentication.php
  • plugins/authentication/gmail.php
  • plugins/authentication/joomla.php
  • plugins/authentication/ldap.php

Voorbeeld

  • plugins/authentication/example.php

onUserLoginFailure

Beschrijving

Deze gebeurtenis wordt geactiveerd wanneer een gebruiker authenticatie-aanvraag is mislukt door een plugin.

Parameters

Two parameters. The credentials array for the user (see onAuthenticate), and the JAuthenticateResponse that caused the failure.

Return Value

Unknown. The return value appears to be ignored in any case.

Gebruikt in bestand

  • libraries/joomla/application/user/authentication.php

onUserAfterLogin

Beschrijving

Deze gebeurtenis wordt geactiveerd wanneer een gebruiker succesvol is ingelogd.

Parameters

Options is array with:

  • remember
  • return
  • entry_url
  • action
  • user - JUser Object
  • responseType

Retourwaarde

Boolean

Gebruikt in bestanden

  • libraries/legacy/application/application.php
  • libraries/cms/application/cms.php
  • plugins/authentication/cookie/cookie.php

onUserBeforeSave

Description

This event is triggered before an update of a user record.

De oude en de nieuwe gebruiker parameters worden aangeboden; veel gebruikte leden zijn: gebruikersnaam, naam, e-mailadres, wachtwoord, wachtwoord_wissen.

The password array entry is the hashed password value. If the user has just changed the password, you may retrieve the cleartext password from $newUser['password_clear']. (It will be set to "" if the password has not been changed.)

Parameters

  • $oldUser - An associative array of the columns in the user table (current values).
  • $isnew - Boolean to identify if this is a new user (true - insert) or an existing one (false - update)
  • $newUser - An associative array of the columns in the user table (new values).

Return Value

Boolean. Whether the user-save should proceed or not. Any plugin that returns false aborts the save.

Gebruikt in bestand

  • libraries/joomla/user/user.php

Voorbeeld

  • plugins/user/example.php

onUserAfterSave

Description

This event is triggered after an update of a user record, or when a new user has been stored in the database.

Password in $user array is already hashed at this point. You may retrieve the cleartext password using $_POST['password'].

Parameters

  • $user - An associative array of the columns in the user table.
  • $isnew - Boolean to identify if this is a new user (true - insert) or an existing one (false - update)
  • $success - Boolean to identify if the store was successful
  • $msg - Error message if store failed

Note: The old values that were just updated are not available here or afterwards. In case you need the old values, use onBeforeStoreUser().

Retourwaarde

Geen

Gebruikt in bestand

  • libraries/joomla/user/user.php

Voorbeeld

  • plugins/user/example.php

onUserBeforeDelete

Beschrijving

De gebeurtenis wordt geactiveerd wanneer een gebruiker wordt verwijderd uit het systeem.

Parameters

  • $user - Een associatieve array van de kolommen in de user tabel.

Retourwaarde

Geen.

Gebruikt in bestanden

  • libraries/joomla/user/user.php
  • plugins/user/joomla.php

Voorbeeld

  • plugins/user/example.php

onUserAfterDelete

Beschrijving

De gebeurtenis wordt geactiveerd wanneer een gebruiker verwijderd is uit het systeem.

Parameters

  • $user - An associative array of the columns in the user table.
  • $succes - Boolean to identify if the deletion was successful
  • $msg - Error message if delete failed (JError object detailing the error, if any)

Retourwaarde

Geen.

Gebruikt in bestanden

  • libraries/joomla/user/user.php
  • plugins/user/joomla.php

Voorbeeld

  • plugins/user/example.php
Retrieved from "https://docs.joomla.org/index.php?title=Plugin/Events/User/nl&oldid=296629"