TYPO3 Core

Around every 15 months I upgrade some TYPO3 instances from LTS to LTS release. As an integrator a suitable migration guide is essential. Unfortunately, for upgrade from TYPO3 10.4 to 11.5 sysext felogin entirely changed. But there is no integration guide at all. I discovered it the first time when I run my first upgrade to 11.5 and felogin did not work anymore. It took me many hours to figure out all the changes and adjust my current configuration accordingly. Please improve your documentation for integrators.

To assist others who are in the same situation, I am writing my adjustments below. These do not claim to be complete and are limited to one of my instances.

configuration¶

felogin configuration (10.4)

# felogin is a system extension

[loginUser('*')]
  # user logged in , use template for navbar
  plugin.tx_felogin_pi1.templateFile = EXT:my_sitepackage/Resources/Private/Templates/FrontendLogin.navbar.html
[ELSE]
  # user not logged in, use template for plugin on start page
  plugin.tx_felogin_pi1.templateFile = EXT:my_sitepackage/Resources/Private/Templates/FrontendLogin.plugin.html
[END]  

plugin.tx_felogin_pi1 {
  storagePid = 1481

  # https://forge.typo3.org/issues/59821
  showForgotPassword = 1
  showForgotPasswordLink = 1

  # Setting this option will disable the redirect options! Instead of redirecting the plugin will show the logout form.
  showLogoutFormAfterLogin = 1

  redirectPageLogin = 1478
  redirectPageLogout = 1478
  redirectMode = login, logout

  email_from = spool@mydomain.de
  email_fromName = first and last name
  replyTo = reply-to@mydomain.de

  _CSS_DEFAULT_STYLE >

  userfields {
    first_name {
      required = 1
    }
    last_name {
      required = 1
    }
  }
  _LOCAL_LANG {
    de {
      username = E-Mail
      password = Passwort
      ll_welcome_message = Bitte geben Sie Ihre E-Mailadresse und Ihr Passwort ein, um sich an der Website anzumelden:
      ll_enter_your_data = E-Mail
      ll_forgot_header = Passwort vergessen?
      ll_forgot_header_backToLogin = Zurück zur Anmeldung
      ll_error_message = Während der Anmeldung ist ein Fehler aufgetreten. Wahrscheinlich haben Sie Ihre E-Mail-Adresse oder Ihr Passwort falsch eingegeben. Vergewissern Sie sich, dass Sie beide Angaben korrekt eingegeben haben - Groß-/Kleinschreibung wird unterschieden.
      ll_forgot_reset_message_emailSent = Es wurde eine E-Mail mit einem Link zum Zurücksetzen des Passworts an Ihre E-Mail-Adresse gesendet. Sollten Sie keine E-Mail erhalten, besteht kein Zugang für diese E-Mail-Adresse.
    }
  }
}

felogin configuration (11.5)

Be aware, plugin.tx_felogin_pi1 is plugin.tx_felogin_login now and configuration is moved to plugin.tx_felogin_login.settings

# felogin is a system extension

# Login link visible when not logged in and logout link visible when logged in
10 = TEXT
10 {
    value = Login
    typolink.parameter = 1478
}
[loginUser('*')]
    10.value = Logout
    10.typolink.additionalParams = &logintype=logout
[end]

plugin.tx_felogin_login {

  view {
    templateRootPaths {
      20 = EXT:my_sitepackage/Resources/Private/felogin/Templates
    }
  }

  settings {

    pages = 1481

    showForgotPassword = 1

    # Setting this option will disable the redirect options! Instead of redirecting the plugin will show the logout form.
    showLogoutFormAfterLogin = 1

    redirectPageLogout = 1478
    redirectMode = logout,getpost

    email_from = spool@mydomain.de
    email_fromName = first and last name
    replyTo = reply-to@mydomain.de

  }

  _CSS_DEFAULT_STYLE >

  userfields {
    first_name {
      required = 1
    }
    last_name {
      required = 1
    }
  }
  _LOCAL_LANG {
    de {
      username = E-Mail
      password = Passwort
      welcome_message = Bitte geben Sie Ihre E-Mailadresse und Ihr Passwort ein, um sich an der Website anzumelden:
      enter_your_data = E-Mail
      forgot_header = Passwort vergessen?
      forgot_header_backToLogin = Zurück zur Anmeldung
      error_message = Während der Anmeldung ist ein Fehler aufgetreten. Wahrscheinlich haben Sie Ihre E-Mail-Adresse oder Ihr Passwort falsch eingegeben. Vergewissern Sie sich, dass Sie beide Angaben korrekt eingegeben haben - Groß-/Kleinschreibung wird unterschieden.
      forgot_reset_message_emailSent = Es wurde eine E-Mail mit einem Link zum Zurücksetzen des Passworts an Ihre E-Mail-Adresse gesendet. Sollten Sie keine E-Mail erhalten, besteht kein Zugang für diese E-Mail-Adresse.
      newpassword_label1 = Neues Passwort:
      newpassword_label2 = Passwort wiederholen:
    }
  }
}

content via TS¶

add felogin via TypoScript (10.4)

  # login form  
  20 < plugin.tx_felogin_pi1

add felogin via TypoScript (11.5)

  # login form  
  20 = USER
  20 {
    userFunc = TYPO3\CMS\Extbase\Core\Bootstrap->run
    extensionName = Felogin
    pluginName = Login

    settings < plugin.tx_felogin_login.settings 
  }

templates¶

Copy the templates you want to customize to your sitepackage extension and add your path to templateRootPaths. You can find these in typo3/sysext/felogin/Resources/private/Templates

conclution¶

To be honest, because of the incredibly complex major upgrades every 15 months, I have already ported the first instances to WordPress. Every time there are some extensions in TYPO3 that are no longer developed and therefore have to be replaced (this time e.g. gridelements). Each time, dozens of templates of all configured extensions have to be checked and adjusted. And this time then felogin. For a system extension, I expect significantly more support here. I had to google all the information together. In my opinion, TYPO3 cannot survive in the long run. For comparison: an upgrade in Wordpress from 5.9 to 6.0 and then to 6.1. every time it was just a single click and a little wait.