Customizing and Overriding User Login page, Register, and Password Reset in Drupal 6 and 7

Customizing the user login, register, and password reset pages is fairly
simple, and uses the following concepts:

• preprocessing to set variables


• registration of functions in the theme registry


• creation of one or more theme templates.

Step 1.
In the site theme directory, create or edit your
template.php file.

Step 2.
The first step is to implement hook_theme for
your theme. In the template.php file for your theme, look for a function
named yourtheme_theme() and modify it to add these return
values. If the function doesn‘t exist, add the following:

For D6:

<?php
/**
*
Registers overrides for various functions.
*
* In this case, overrides
three user functions
*/
function
yourtheme_theme() {
  return
array(
    ‘user_login‘ =>
array(
      ‘template‘
=>
‘user-login‘,
     
‘arguments‘ => array(‘form‘
=> NULL),
   
),
    ‘user_register‘ =>
array(
      ‘template‘
=>
‘user-register‘,
     
‘arguments‘ => array(‘form‘
=> NULL),
   
),
    ‘user_pass‘ =>
array(
      ‘template‘
=>
‘user-pass‘,
     
‘arguments‘ => array(‘form‘
=> NULL),
   
),
  );
}
?>

Notes about that code:

• Change the function name by replacing "yourtheme" with the name of your
  theme


• The template can be the same for all three. The example above uses a
  different template for each case: user-login, user-register, and
  user-pass


• The template names must use a dash, not an underscore


• Note:
  It‘s user_pass not user_password

For D7:

<?php
function
yourtheme_theme() {
  $items
= array();
 
$items[‘user_login‘] =
array(
    ‘render element‘ =>
‘form‘,
    ‘path‘
=>
drupal_get_path(‘theme‘,
‘yourtheme‘) .
‘/templates‘,
   
‘template‘ =>
‘user-login‘,
   
‘preprocess functions‘ =>
array(
      
‘yourtheme_preprocess_user_login‘
   
),
  );
 
$items[‘user_register_form‘]
= array(
    ‘render element‘ =>
‘form‘,
    ‘path‘
=>
drupal_get_path(‘theme‘,
‘yourtheme‘) .
‘/templates‘,
   
‘template‘ =>
‘user-register-form‘,
   
‘preprocess functions‘ =>
array(
     
‘yourtheme_preprocess_user_register_form‘
   
),
  );
 
$items[‘user_pass‘] =
array(
    ‘render element‘ =>
‘form‘,
    ‘path‘
=>
drupal_get_path(‘theme‘,
‘yourtheme‘) .
‘/templates‘,
   
‘template‘ =>
‘user-pass‘,
   
‘preprocess functions‘ =>
array(
     
‘yourtheme_preprocess_user_pass‘
   
),
  );
  return
$items;
}
?>

Notes about the D7 version:

• The ‘path‘ lines tell Drupal where to find the .tpl.php files. This is
  optional, and in the code above, ‘path‘ tells Drupal to find the files in the
  templates subdirectory of the theme‘s base directory.


• Note the "_form" added to the user_register element.


• Note: As it is the case for D6,
  it‘s user_pass not user_password

Step 3.
Now you implement three preprocess functions.
There may be more concise ways to code this, but this works very well and is
easy to read, so here we go!

For D6:

<?php
function
yourtheme_preprocess_user_login(&$variables)
{
 
$variables[‘intro_text‘] =
t(‘This is my awesome login
form‘);
 
$variables[‘rendered‘] =
drupal_render($variables[‘form‘]);
}
function
yourtheme_preprocess_user_register(&$variables)
{
 
$variables[‘intro_text‘] =
t(‘This is my super awesome reg
form‘);
 
$variables[‘rendered‘] =
drupal_render($variables[‘form‘]);
}
function
yourtheme_preprocess_user_pass(&$variables)
{
 
$variables[‘intro_text‘] =
t(‘This is my super awesome insane
password form‘);
 
$variables[‘rendered‘] =
drupal_render($variables[‘form‘]);
}
?>

Notes about that code:

• Change the function name by replacing "yourtheme" with the name of your
  theme


• The line $variables[‘intro_text‘] adds the text
  that follows to the $variables array, which gets passed
  to the template as $intro_text


• The second line renders the form and adds that code to
  the $variables array, which gets passed to the template
  as $rendered

For D7:
The code is even simpler for D7 because we don‘t need to
pass a variable containing the form content we want rendered. The variable
exists already in the $vars array and can be rendered in the .tpl.php file.

<?php
function
yourtheme_preprocess_user_login(&$vars)
{
 
$vars[‘intro_text‘] =
t(‘This is my awesome login
form‘);
}
function
yourtheme_preprocess_user_register_form(&$vars)
{
 
$vars[‘intro_text‘] =
t(‘This is my super awesome reg
form‘);
}
function
yourtheme_preprocess_user_pass(&$vars)
{
 
$vars[‘intro_text‘] =
t(‘This is my super awesome request new
password
form‘);
}
?>

The above preprocess functions simply add a variable into the $vars array
that is then displayed in the .tpl.php file. Much more complex manipulation of
the content of the render array is possible.

Please note, that the preprocess functions should go into the template.php
file.

Step 4.
Create template files to match
the ‘template‘ values defined above.

For D6
We need the following template files (make sure to use a
dash, not an underscore) :

• user-login.tpl.php


• user-register.tpl.php


• user-pass.tpl.php

For D7
As for D6 but
with user-register-form.tpl.php for the register
form.

Step 5.
Paste the following into user-login.tpl.php.
Modify as necessary for user-register.tpl.php(D6)
and user-register-form.tpl.php (D7):

For D6:

<p><?php print
$intro_text;
?></p>
<div
class="my-form-wrapper">
  <?php print
$rendered;
?>
</div>

For D7:

<p><?php print
render($intro_text);
?></p>
<div
class="yourtheme-user-login-form-wrapper">
  <?php
print
drupal_render_children($form)
?>
</div>

Note the change to the syntax for causing Drupal to render the form. Also,
the D7 sample uses a different class for the div, but that‘s just a matter of
preference.

Step 6.
Save your template.php file to the theme‘s main
directory. Save your .tpl.php files in the same place for the D6 examples, or,
in the case of the D7 examples, to the directory you specify in the ‘path‘
element of the $items array.

Step 7.
Rebuild the cache. Go to Administration
> Performance and click on "Rebuild Cache" on the bottom of the
page.

Now, the user login page will contain the new text from the preprocess
function, and the tpl.php file(s) can be modified to suit the site‘s
needs.

Customizing and Overriding User Login page, Register, and
Password Reset in Drupal 6 and 7,布布扣,bubuko.com

Customizing and Overriding User Login page, Register, and
Password Reset in Drupal 6 and 7