Um die im auth-Plugin eingebaute Authentifizierung bei einem eigenen Projekt nutzen zu können, musst Du zunächst ein paar Einstellungen vornehmen.

Als Erstes muss natürlich ein Häkchen bei Authentifizierung aktiviert gesetzt werden. Außerdem musst Du DIch entscheiden, welches Feld der User-Tabelle als Loginname genutzt wird. Es steht jedes Feld zur Auswahl, aber man wird im Normalfall das Feld Login oder – wie hier in der Demo – E-Mail wählen. Da dieser Loginname natürlich nicht doppelt vorkommen darf, sollte bei der Registrierung durch die Validierungsfunktion validate|unique überprüft werden, ob der Loginname schon vorhanden ist.

Weiterhin muss am Anfang des Templates diese Zeile stehen:

$ycom_user = rex_ycom_auth::getUser();

Sodann kann man prüfen, ob ein User angelegt ist, und könnte – als simples Beispiel – im positiven Fall seinen Namen anzeigen:

if ($ycom_user) {

    // Benutzter besitzt die nötige Berechtigung
    echo 'Hallo, '.rex_ycom_auth::getUser()->getValue('name');

} else {

    // Benutzter besitzt die nötige Berechtigung nicht
    echo 'Bitte erst einloggen';

}
>

In vielen anderen CMS ist die Struktur eines Loginbereichs fest vorgegeben. Das erleichtert natürlich zunächst die Arbeit für den Admin, macht den Loginbereich aber bis zu einem gewissen Grad unflexibel. Im YCom-AddOn muss man dagegen zentrale Seiten des Login-Vorgangs zunächst manuell "verdrahten", was dem Admin aber die Freiheit gibt, einen geschützten Bereich nahezu so aufzubauen, wie er sich das vorstellt oder das Projekt es erfordert.

Folgende Weiterleitungen gilt es zu definieren:

• wenn erfolgreich eingeloggt:
  Diese Seite sollte den User in seinem Loginbereich empfangen. Für die Demo wurde dazu der Startartikel Loginbereich gewählt
• wenn nicht erfolgreich eingeloggt:
  Zu dieser Seite gelangt man, wenn der Loginversuch nicht gelingt. Im Normalfall möchte man, dass die Seite Login einfach erneut angezeigt wird.
• nach dem Ausloggen:
  In der Demo gibt es eine eigens erstellte Seite Logged Out, zu der man beim Logout geleitet wird. Dort kann man den User verabschieden und ihm einen Link zum erneuten Login anbieten.
• wenn auf einen gesperrten Artikel zugriffen wird:
  Wenn der User eine URL aufruft, die er nur eingeloggt sehen darf, so wird er zu der Seite Loginbereich geleitet, um sich einloggen zu können. Sofern er bereits eingeloggt ist und eine Seite aufruft, für die die ihm zugewiesene Gruppe keine Rechte besitzt, so erfolgt eine erneute Weiterleitung zu der Seite, die man bei wenn erfolgreich eingeloggt: definiert hat.