| 1 |
augustin |
1.12.2.2 |
$Id: README.txt,v 1.12.2.1 2007/07/10 04:36:08 augustin Exp $
|
| 2 |
jasonm3m |
1.9 |
|
| 3 |
uwe |
1.1 |
Introduction:
|
| 4 |
|
|
|
| 5 |
jasonm3m |
1.3 |
This module is for people who want a custom front page to their Drupal sites.
|
| 6 |
|
|
|
| 7 |
augustin |
1.12.2.1 |
The key functionality of this module is outlined below.
|
| 8 |
jasonm3m |
1.5 |
|
| 9 |
augustin |
1.12.2.1 |
If you are comfortable with theming using a mix of php/html, I recommend you check out the
|
| 10 |
|
|
handbook pages I have added to Drupal.org which explains how a more advanced method of theming
|
| 11 |
|
|
your front page. http://drupal.org/node/46017
|
| 12 |
|
|
|
| 13 |
augustin |
1.12.2.2 |
This module is intended for Drupal Version 4.7
|
| 14 |
augustin |
1.12.2.1 |
It will not work with earlier versions.
|
| 15 |
jasonm3m |
1.3 |
|
| 16 |
|
|
|
| 17 |
|
|
Key Functionality:
|
| 18 |
|
|
|
| 19 |
augustin |
1.12.2.1 |
1. Allows you to specify a custom front page based on role type.
|
| 20 |
|
|
|
| 21 |
|
|
e.g. For a musicians website, you could have a different front page for Drummers, Guitarists, Singers, Bass Players etc.
|
| 22 |
jasonm3m |
1.3 |
|
| 23 |
jasonm3m |
1.11 |
3. Allows you to have a FULL front page or SPLASH page - a completely different layout to your
|
| 24 |
|
|
main drupal site - or alternatively as a THEMED full page, i.e. it loads with your default drupal site theme & layout.
|
| 25 |
jasonm3m |
1.10 |
|
| 26 |
augustin |
1.12.2.1 |
4. Automatically REDIRECT users to a specific page or path.
|
| 27 |
jasonm3m |
1.3 |
|
| 28 |
augustin |
1.12.2.1 |
5. Disable your site for everyone but Administrators and display a custom "under maintenance" message.
|
| 29 |
jasonm3m |
1.3 |
|
| 30 |
augustin |
1.12.2.1 |
6. Display a custom "mission" style message for authenticated users who have not visited the site for a set period.
|
| 31 |
jasonm3m |
1.4 |
|
| 32 |
augustin |
1.12.2.1 |
e.g. If you have had a significant update to the site, you might want to have a special notice for users who haven't
|
| 33 |
|
|
visited for 1 month, or 1 week etc.
|
| 34 |
jasonm3m |
1.7 |
|
| 35 |
augustin |
1.12.2.1 |
7. Override your HOME and Breadcrumb links on your site.
|
| 36 |
jasonm3m |
1.4 |
|
| 37 |
augustin |
1.12.2.1 |
e.g. you might have a splash front page that you don't want visitors already on your site returning to when they
|
| 38 |
|
|
click on HOME.
|
| 39 |
jasonm3m |
1.3 |
|
| 40 |
augustin |
1.12.2.1 |
8. You can include PHP/HTML or both in your frontpage
|
| 41 |
jasonm3m |
1.5 |
|
| 42 |
|
|
|
| 43 |
|
|
|
| 44 |
jasonm3m |
1.3 |
Installation:
|
| 45 |
augustin |
1.12.2.1 |
---------------
|
| 46 |
jasonm3m |
1.3 |
|
| 47 |
|
|
1. Upload front_page.module to your MODULES folder.
|
| 48 |
|
|
|
| 49 |
|
|
2. Go to the ADMINISTER section of your drupal site.
|
| 50 |
|
|
|
| 51 |
|
|
3. Click on MODULES
|
| 52 |
|
|
|
| 53 |
|
|
4. Enable the front_page.module
|
| 54 |
|
|
|
| 55 |
augustin |
1.12.2.1 |
5(a). (Drupal 4.6.x and Drupal 4.7.x) Go to ADMINISTER - SETTINGS - FRONT_PAGE
|
| 56 |
|
|
5(b). (Drupal 5.x) Go to ADMINISTER - SITE CONGIFURATION - ADVANCED FRONT PAGE SETTINGS
|
| 57 |
jasonm3m |
1.3 |
|
| 58 |
jasonm3m |
1.11 |
6. Paste in the TEXT/HTML/PHP contents of your front pages.
|
| 59 |
jasonm3m |
1.6 |
|
| 60 |
augustin |
1.12.2.1 |
7. Once you are happy with your front_pages, set the DEFAULT FRONT PAGE setting to be front_page.
|
| 61 |
|
|
|
| 62 |
|
|
|
| 63 |
|
|
############################################
|
| 64 |
|
|
IMPORTANT NOTE FOR THOSE USING PATH.MODULE (URL ALIAS):
|
| 65 |
|
|
Please ensure you have no other pages
|
| 66 |
|
|
setup with the URL ALIAS 'front_page' when
|
| 67 |
|
|
installing the front_page.module which uses the
|
| 68 |
|
|
'front_page' URL Alias by default.
|
| 69 |
|
|
##############################################
|
| 70 |
|
|
|
| 71 |
|
|
|
| 72 |
|
|
PROMOTED TO FRONT PAGE Example snippet
|
| 73 |
|
|
----------------------------------------
|
| 74 |
|
|
The default front page when you install Drupal for the first time, is 'node' which displays a list of node teasers, where
|
| 75 |
|
|
the nodes have been tagged as pages that are 'Promoted to Front Page'.
|
| 76 |
|
|
|
| 77 |
|
|
If you want to recreate that node listing after installing the front_page.module, simply paste the following snippet into
|
| 78 |
|
|
the text area provided on the front_page settings page and select the PHP filter before saving your new configuration.
|
| 79 |
|
|
|
| 80 |
|
|
<?php
|
| 81 |
|
|
print node_page_default();
|
| 82 |
|
|
?>
|
| 83 |
jasonm3m |
1.7 |
|
| 84 |
jasonm3m |
1.11 |
|
| 85 |
augustin |
1.12.2.1 |
|
| 86 |
|
|
Uninstall:
|
| 87 |
|
|
-------------
|
| 88 |
|
|
|
| 89 |
|
|
1(a) (Drupal 4.6.x and Drupal 4.7.x) Go to ADMINISTER -> SETTINGS and change the default front page to something other than 'front_page' (e.g. 'node').
|
| 90 |
|
|
1(b) (Drupal 5.x) Go to ADMINISTER -> SITE CONFIGURATION -> ADVANCED FRONT PAGE SETTINGS and change the default front page to something other than 'front_page' (e.g. 'node').
|
| 91 |
|
|
|
| 92 |
|
|
2(a) (Drupal 4.6.x and Drupal 4.7.x) Go to ADMINISTER -> MODULES and de-select the front_page.module from your list of modules.
|
| 93 |
|
|
2(b) (Drupal 5.x) Go to ADMINISTER -> MODULES and de-select the front_page.module from your list of modules.
|
| 94 |
|
|
|
| 95 |
|
|
3. Using FTP or other file manager, remove the front_page.module files and folder.
|
| 96 |
|
|
|
| 97 |
|
|
|
| 98 |
jasonm3m |
1.7 |
Hope you find it useful.
|
| 99 |
|
|
|
| 100 |
augustin |
1.12.2.1 |
This module has been developed by a few members of the drupal community and
|
| 101 |
|
|
we're always looking for ideas for improving it.
|
| 102 |
|
|
|
| 103 |
|
|
Email me or post a message on the drupal.org site if you have any ideas on
|
| 104 |
|
|
how we can improve the module.
|
| 105 |
jasonm3m |
1.3 |
|
| 106 |
jasonm3m |
1.5 |
Dublin Drupaller
|
| 107 |
jasonm3m |
1.7 |
|
| 108 |
jasonm3m |
1.3 |
|
| 109 |
augustin |
1.12.2.1 |
gus@modernmediamuse.com
|