%META:TOPICINFO{author="ProjectContributor" date="1655468868" format="1.1" version="1"}%
---+!! !HomePagePlugin
%FORMFIELD{"Description"}%

%TOC%

---++ Usage

This plugin makes the Default frontpage configurable -
   1 any time a user goes to %SCRIPTURL{view}% they will be shown the topic =configured= 
by the Foswiki administrator in ={HomePagePlugin}{SiteDefaultTopic}= in the Extensions section of =configure=.
   2 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
<verbatim>
    'http://home.org' => 'Home',
    'http://www.home.org' => 'Home.Www',
    'http://blog.org' => 'Blog',
    'http://www.blog.org' => 'Blog.Www'
</verbatim>

or
<verbatim>
    '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,
</verbatim>

---++ !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 - %WIKIUSERNAME% - has !HomePage set to : %FORMFIELD{"HomePage" alttext="nothing" efault="nothing" topic="%WIKIUSERNAME%"}%)
 
__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 -&gt; "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!)
<verbatim>
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install
</verbatim>

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.

---++ Dependencies
None

---++ Change History
%TABLE{columnwidths="7em" tablewidth="100%"}%
| 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.%BR%\
                        Foswikitask:Item11960: Don't redirect cli scripts %BR%\
                        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 |

%META:FORM{name="PackageForm"}%
%META:FIELD{name="Author" title="Author" value="Foswiki:Main.SvenDowideit"}%
%META:FIELD{name="Copyright" title="Copyright" value="&copy; 2009 SvenDowideit@fosiki.com - http://fosiki.com<br> &copy; 2012-2015 Foswiki Contributors"}%
%META:FIELD{name="Description" title="Description" value="Allow User specified home pages - on login"}%
%META:FIELD{name="Home" title="Home" value="http://foswiki.org/Extensions/HomePagePlugin"}%
%META:FIELD{name="License" title="License" value="[[http://www.gnu.org/licenses/gpl.html][GPL (Gnu General Public License 3)]]"}%
%META:FIELD{name="Release" title="Release" value="15 Mar 2026"}%
%META:FIELD{name="Repository" title="Repository" value="https://github.com/foswiki/distro"}%
%META:FIELD{name="Support" title="Support" value="http://foswiki.org/Support/HomePagePlugin"}%
%META:FIELD{name="Version" title="Version" value="1.23"}%
