NOTE: This is a static archive copy of STWiki. The site can no longer be edited.

HomePagePlugin

Allow sitewide, user or hostname specified default pages

Usage

This plugin makes the Default frontpage configurable -
  1. any time a user goes to ../../../bin/view they will be shown the topic configured
by the Foswiki administrator in {HomePagePlugin}{SiteDefaultTopic} in the Extensions section of configure.
  1. if {HomePagePlugin}{GotoHomePageOnLogin} is set, when a user logs in, they will be shown the topic specificed in their UserForm

Additionally, there is now a ={HomePagePlugin}{HostnameMapping} EXPERT setting that allows you to set different frontpages for each domain or protocol, which means you could define a hostname per web

eg
    'http://home.org' => 'Home',
    'http://www.home.org' => 'Home.Www',
    'http://blog.org' => 'Blog',
    'http://www.blog.org' => 'Blog.Www'

or
    'http://download.foswiki.org' => 'Download',
    'http://tasks.foswiki.org' => 'Tasks',
    'http://development.foswiki.org' => 'Development',
    'http://extensions.foswiki.org' => 'Extensions',
    'http://community.foswiki.org' => 'Community',
    'http://support.foswiki.org' => 'Support',
    'http://CarlSagan.foswiki.org' => 'Main.CarlSagan,

TemplateLogin individual configurable HomePage on login

The Admin can also configure {HomePagePlugin}{GotoHomePageOnLogin}, to default to an individual HomePage defined in a UserForm field in the users personal topic. (the current user - WikiGuest - has HomePage set to : nothing)

Note that this means that any URLs emailed to them will only be useful after login.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Info

Many thanks to the following sponsors for supporting this work:
  • Created for Blackfin inc.

Change History:  
1.23 (18 Mar 2015) Foswikitask:Item13312: Don't override URL params topic and defaultweb
1.22 (18 Dec 2014) Foswikitask:Item12583: Use simple decimal version strings for better compatibility
1.2.1 (16 Dec 2012) Foswikitask:Item12297: Address perlcritic recommendation.
Foswikitask:Item11960: Don't redirect cli scripts
Foswikitask:Item11866: Don't redirect to malformed targets
1.2.0 (16 Apr 2012) Foswikitask:Item11761: Include in core release
1.1.1 (1 Aug 2009) fix bug in login screen usage
1.1.0 (July 2009) add Expert hash allowing domain name based frontpage setting
1.0.0 (Feb 2009) initial version
Dependencies: None

Topic revision: r1 - 18 Mar 2015, ProjectContributor
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding STWiki? Send feedback