drupal 4.5 front_page module

Hi guys,

Am probably getting carried away a little with my first ever drupal module...am amazed I was able to get this working...and I am aware there are other modules like Summary out there etc...but...I have "upgraded" it a little to allow for the folllowing functionality:

a) Allows you to specify a custom home page for both Logged in Users and Visitors to your site/users not logged in.

b) allows you to specify whether the pages are THEMED or FULL pages..

(i.e. a THEMED front_page will display your page WITH your default theme, layout and style sheet...a FULL front_page is a completely seperate page...where you can specify a completely different layout to your site.)

I created this so I could increase the ergonomics of the site and make it more friendly to visitors and registered users alike. So on the "not logged in" page, I can insert more information about what is inside, reasons for registering, help with getting a new password etc. that wouldn't be relevant to logged in users.

I hope the above makes sense and it is of use to drupal users. It works with drupal 4.5. Installation instructions are as follows:

a) Copy and paste the code below into a text editor like NOTEPAD.

(during the copy n paste process, make sure there are no extra spaces or lines at the bottom of the file...i.e. after the closing tag ?>. Otherwise the module will give you Header error messages)

b) save it as front_page.module and upload it in ASCII format to your MODULES folder.

c) go to your ADMINISTER - MODULES page and enable the front_page module.

d) go to ADMINISTER - USER - CONFIGURE - PERMISSIONS and set the ACCESS FRONT_PAGE checkbox to what you want.

e) go to ADMINISTER - SETTINGS - FRONT_PAGE and paste in your HTML/Text for your front page and select whether you want it to be FULL or THEMED.

f) go to AMDINISTER - SETTINGS and set your default front page to be front_page

That's it!

Drupal automatically detects if the USER is logged in or not and directs people to the relevant page.

here's the module:

// $Id: front_page.module,v 1.2 2004/11/25  Jasonm3m Exp $ 

/** 
 * @file 
 * This is my first module that allows the user to set a custom front page
 * to the drupal installation.
 * 
 * This module is designed for 4.5 compatibility
 */ 


/** 
 * Implementation of hook_help(). 
 * 
 * This is the explanatory text that appears in your administer - modules page 
 * where you switch on/off modules
 */ 
function front_page_help($section) { 
  switch ($section) { 
    case 'admin/modules#description': 
      // This description is shown in the listing at admin/modules. 
      return t('this module allows you to set a custom home page.'); 
  } 
} 

/** 
 * Implementation of hook_perm(). 
 * 
 * this function makes the front_page option appear in the user - permissions page
 */ 

function front_page_perm() { 
  return array('access front_page');
} 


/** 
 * Am not too sure what this function does.
 */ 


function front_page_link($type, $node = 0, $main) {
if ($type == "system") {
   menu("front_page", t("front"), "front_page", 0, MENU_SHOW);
   }
 }



/** 
 * this function sets the necessary paths etc. so drupal
 * knows where to find the front_page
 * 
 * in your Administer - Settings make sure default front page is set
 * to front_page
 * 
 * Please note that I have left the Title blank below so nothing appears above the 
 * page when it is displayed.
 */ 



function front_page_menu($may_cache) {
  if ($may_cache) {
    $items = array();
    $items[] = array(
      'path' => 'front_page',
      'title' => t(''),
      'callback' => 'front_page',
      'access' => user_access('access front_page'),
      'type' => MENU_SUGGESTED_ITEM);
    return $items;
  } 
}


/** 
 * this function allows a user to change or paste html in the
 * administer - settings area.
 * 
 */ 


function front_page_settings() {
  $output  = form_textarea(t("Front page HTML or TEXT for users not logged in"), "front_page_text", variable_get("front_page_text", ""), 60, 10, t("Paste your HTML here for users or visitors to your site who are not logged in"));
  $output .= form_select(t('Select whether you want your logged-in page to be a THEMED or a FULL front_page'), 'front_page_size', variable_get('front_page_size', themed), drupal_map_assoc(array(themed, full)), t('A THEMED front_page means your default layout, theme and stylesheet will be loaded with your custom front_page. A FULL front_page allows you to have a completely different layout, style sheet etc. Useful if you want to use a FLASH based front-end to your site or a splash-page.<br>'));
  $output .= form_textarea(t("Front page HTML or TEXT for logged in users"), "front_page_text_yes", variable_get("front_page_text_yes", ""), 60, 10, t("Paste your HTML here for users you are already logged in"));
  $output .= form_select(t('Select whether you want this page to be a THEMED or a FULL front_page'), 'front_page2_size', variable_get('front_page2_size', themed), drupal_map_assoc(array(themed, full)), t(''));
return $output;

}

/** 
 * This function displayes your front page(s)
 * 
 * this function loads up the front page and displays it
 *  
 * you specify your front page html/text under
 * administer - settings - front_page
 *
 */ 


function front_page() {

global $user;
if (!$user->uid){
    $output = variable_get("front_page_text", "drupal");
		$fpsize = variable_get("front_page_size", "drupal");
		if ($fpsize == "themed") {print theme('page', $output);}
		if ($fpsize == "full") {print $output;}
		}
else{
    $output = variable_get("front_page_text_yes", "drupal");
    $fpsize = variable_get("front_page2_size", "drupal");
		if ($fpsize == "themed") {print theme('page', $output);}
		if ($fpsize == "full") {print $output;}
		}
}

Hi,

At the very top of your HTML ...where you point to the CSS file..

i.e.

in your html file you have the following:

[head] 
[style type="text/css">@import url(path/to/css/front_page.css);[/style]
[/head]

(replace square brackets with the angled brackets)

Hope that helps

Dub

DUBLIN DRUPALLER
___________________________________________________
A drupal user by chance and a dubliner by sheer luck.
Using Drupal to help build Artist & Band web communities.