Changeset 8045 for trunk/doc/src


Ignore:
Timestamp:
Jun 3, 2022, 8:59:50 AM (6 months ago)
Author:
Nicklas Nordborg
Message:

Merge BASE 3.19.3 to the trunk

Location:
trunk
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk

  • trunk/doc/src/docbook/developer/extensions.xml

    r7982 r8045  
    26862686      </sect3>
    26872687     
    2688       <sect3 id="pextensions_developer.login-manager.settings">
     2688      <sect3 id="extensions_developer.login-manager.settings">
    26892689        <title>Configuration settings</title>
    26902690     
     
    27472747        <para>
    27482748          All installed and enabled login forms are available in a selection list
    2749           from which the user can select to switch to another login form. For technical reasons
    2750           custom scripts and stylesheets are loaded for all installed login forms even
    2751           though only one is displayed at a time. Developers must ensure that CSS rules
    2752           and scripts are not affecting other login forms than the intended one.
     2749          from which the user can select to switch to another login form. Since BASE 3.19.3
     2750          custom scripts and stylesheets are only loaded for the currently active form.
     2751          In earlier BASE versions, custom scripts and stylesheets were loaded for all installed
     2752          login forms.
    27532753        </para>
    27542754        <para>
    2755           To help with this, BASE is setting two data-attributes on the
     2755          It is possible for both style sheets and scripts to verify that they are only used on
     2756          the intended login form. BASE is setting two data-attributes on the
    27562757          <sgmltag class="starttag">body</sgmltag> tag:
    27572758        </para>
     
    28162817      </note>
    28172818     
     2819      <sect3 id="extensions_developer.login-form.before-login">
     2820        <title>The before-login event</title>
     2821     
     2822        <para>
     2823          In BASE 3.19.3 the <code>before-login</code> was introduced. It is a custom event
     2824          that is sent to the <sgmltag class="starttag">form</sgmltag> tag just before the
     2825          login form is submitted to the server. Extensions may add event listeners for this
     2826          event if they need to take some action and they have the possibility to cancel
     2827          the submission by calling the <code>event.preventDefault()</code> method.
     2828        </para>
     2829       
     2830        <para>
     2831          This functionality is, for example, used by the <ulink
     2832          url="https://baseplugins.thep.lu.se/wiki/net.sf.basedb.webauthn">WebAuthn</ulink> extension,
     2833          which need to contact the server to get a <emphasis>challenge</emphasis>, ask the user
     2834          to insert and click on the security key, and then return the signed challenge in the
     2835          <code>extraField</code> before the login form is actually submitted. Since all of this
     2836          is handled asynchronously the <code>before-login</code> event need to be cancelled. The login
     2837          form can be submitted by calling <code>Login.submitLoginForm()</code>.
     2838        </para>
     2839      </sect3>
    28182840    </sect2>
    28192841   
Note: See TracChangeset for help on using the changeset viewer.