You are here: Foswiki>Tasks Web>Item13230 (26 Jan 2015, GeorgeClark)Edit Attach

Item13230: Configure needs "I expected..." notice for {ScriptUrlPaths}{view}

pencil
Priority: Normal
Current State: No Action Required
Released In: n/a
Target Release: n/a
Applies To: Engine
Component: FoswikiUsability, Configure
Branches:
Reported By: VickiBrown
Waiting For:
Last Change By: GeorgeClark
/bin/configure is very good at providing "I expected..." hints for various path variables. However, it doesn't provide one for {ScriptUrlPaths}{view}

I ran into a problem today when setting up a Foswiki to run at .../foswiki/.... The site came up, but all of the links were wrong. I finally figured out what was wrong somewhat by accident.

The information under {ScriptUrlPaths}{view} says:

This is the complete path used to access the Foswiki view script including any suffix. 
Do not include a trailing /. (This is an exception override, so the ScriptSuffix is not automatically added.) e.g. /foswiki/bin/view.pl
Note: The default is acceptable except when shorter URLs are used.
If you are using Shorter URL's, then this is typically set to the base path of your wiki, which should 
be the value of {ScriptUrlPath} excluding /bin. e.g. if your {ScriptUrlPath} is either 
empty or set to /bin leave {ScriptUrlPaths}{view} empty; if it is set to something like 
/directory/bin set it to /directory

1. Although {ScriptUrlPaths}{view} is marked required the note says "DO not change this unless..." (which implies not required) and the "default" appears to be blank (i.e. not required).

2. The part that could throw an "I expected" warning or error: if {ScriptUrlPath} is set to something like /directory/bin set {ScriptUrlPaths}{view} to /directory.

My {ScriptUrlPath} was set to /foswiki/bin.

My {ScriptUrlPaths}{view} was set to ''.

It should have been easy, programmatically, to test this and print a hint, "I expected this to be /foswiki".

Then I would have discovered my issue an hour earlier and saved a lot of head-on-desk.

-- VickiBrown - 26 Jan 2015

This is actually fixed on Foswiki 1.2. The new configure has a lot of significant improvements. For example, clicking the "verify" button traces access to to the server to detect redirects, etc:

Tracing access to http://foswiki.com/bin/view, {ScriptUrlPaths}{view} = '' Server received the expected path: (empty) 

And one that's in error:

Server received (), but the configured path to view is (/bin). Changing {ScriptUrlPaths}{view} to () will probably correct this error. (Server may be configured for Shorter URLs.) 

And in addition, we are doing a lot of work on a new Foswiki "bootstrap". Install without any configuration. then visit your expected view URL. Foswiki should be functional, but you'll get a warning banner that says to click a link to visit configure to complete the configuration. By using Foswiki before configuration, it is able to guess the correct settings for the settings you mention above.

Setting to "No Action"

-- GeorgeClark - 26 Jan 2015
 

ItemTemplate edit

Summary Configure needs "I expected..." notice for {ScriptUrlPaths}{view}
ReportedBy VickiBrown
Codebase 1.1.9
SVN Range
AppliesTo Engine
Component FoswikiUsability, Configure
Priority Normal
CurrentState No Action Required
WaitingFor
Checkins
TargetRelease n/a
ReleasedIn n/a
CheckinsOnBranches
trunkCheckins
masterCheckins
ItemBranchCheckins
Release01x01Checkins
Topic revision: r2 - 26 Jan 2015, GeorgeClark
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy