apply_filters( ‘login_message’, string $message )

User Contributed Notes

1. Skip to note 7 content

   Razon Komar Pal 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Add additional message for wp-login.php

   add_filter( 'login_message', 'wpdocs_sr_custom_login_message' );
   function wpdocs_sr_custom_login_message( $message ) {
       $action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : '';
       $errors = new WP_Error();
   
       if ( isset( $_GET['key'] ) ) {
           $action = 'resetpass';
       }
   
       if ( isset( $_GET['checkemail'] ) ) {
           $action = 'checkemail';
       }
   
       switch ( $action ):
           case 'register':
               $message .= '<p class="message">' . __( 'Show message before register form.', 'text_domain' ) . '</p>';
               break;
           case 'checkemail':
               $message .= '<p class="message">' . __( 'Show message before after registration complete message.', 'text_domain' ) . '</p>';
               break;
           case 'lostpassword':
               $message .= '<p class="message">' . __( 'Show message before lost password form.', 'text_domain' ) . '</p>';
               break;
           default:
               // this message will show in login screen, before the login form.
               $message .= '<p class="message">' . __( 'Show message before login form.', 'text_domain' ) . '</p>';
               break;
       endswitch;
   
       return $message;
   }
2. Skip to note 8 content

   Collins Mbaka 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   An example

   function wpdocs_the_login_message( $message ) {
       if ( empty( $message ) ) {
           return '<p>Welcome to this site. Please log in to continue.</p>';
       } else {
           return $message;
       }
   }
   add_filter( 'login_message', 'wpdocs_the_login_message' );
3. Skip to note 9 content

   Collins Mbaka 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   A plugin can register as a content filter with the code:

   add_filter( 'login_message', 'wpdocs_plugin_function_name' );
4. Skip to note 10 content

   Akira Tachibana 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   (From Codex)
   Example:

   function the_login_message( $message ) {
       if ( empty($message) ){
           return "<p>Welcome to this site. Please log in to continue</p>";
       } else {
           return $message;
       }
   }
   add_filter( 'login_message', 'the_login_message' );
5. Skip to note 11 content

   EHLOVader 1 year ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Expanding upon Razon Komar Pal‘s code snippet.

   I found that there are a few other instances that you might wish to show a specific message or not show any additional messages if the provided one is great.

   add_filter( 'login_message', function ( $message ) {
       $action = isset( $_REQUEST['action'] ) ? $_REQUEST['action'] : '';
   
       if ( isset( $_GET['key'] ) ) {
           $action = 'resetpass';
       }
   
       if ( isset( $_GET['checkemail'] ) ) {
           $action = 'checkemail';
       }
   
       if ( isset( $_GET['interim-login'] ) ) {
           $action = 'interim-login';
       }
   
       switch ( $action ) {
           case 'register':
               // $message .= __( 'Show message before register form.', 'text_domain' );
               break;
           case 'checkemail':
               // $message .= __( 'Show message before after registration complete message.', 'text_domain' );
               break;
           case 'lostpassword':
               // $message .= __( 'Show message before lost password form.', 'text_domain' );
               break;
           case 'rp':
               // $message .= __( 'Show message before reset password form.', 'text_domain' );
               break;
           case 'resetpass':
               // $message .= __( 'Show message after reset password form.', 'text_domain' );
               break;
           case 'interim-login':
               // $message .= __( 'Show message before interim login form.', 'text_domain' );
               break;
           default:
               // $message .= __( 'Show message before login form.', 'text_domain' );
               break;
       }
   
       return $message;
   } );
6. Skip to note 12 content

   Beda 1 year ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Be careful! There is another filter, with a similar description, but applied in a different place!
   https://developer.wordpress.org/reference/hooks/login_messages/

   THAT filter, is for example useful when you want to change the message on the “check mail” screen after a registration.