Registered: Apr 2003
From:

Hello,

it could be very helpful to add a 'help' button to each installation page with a user defined text. so all addditional infos could be placed in this text box. This help text must be opened by clicking on the button or pressing F1.

Or it's already possible? How?

regards
norial

Quick Link | Report this post to a moderator | IP: Logged

Registered: Nov 2001
From:

You would have to modify the source code.

Usually the page text should give enough information, seperate help pages are not that user friendly.

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2003
From:

why not?

there is only place for a short text. and why additional info are not that user friendly?
normally noboby reads this text (normally reads any installastion text and klick only 'next') but sometimes a user needs a explination of some words or options.

regards
/norial

Quick Link | Report this post to a moderator | IP: Logged

Registered: Oct 2001
From: Israel

You can do it with a plug-in too, but there is currently no way to do it just by script.

__________________
NSIS FAQ | NSIS Home Page | Donate $
"I hear and I forget. I see and I remember. I do and I understand." -- Confucius

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2003
From:

is any plugin available which insert a help/extra button in pages?

Quick Link | Report this post to a moderator | IP: Logged

Registered: Oct 2001
From: Israel

Not that I know of, you'd have to write one.

__________________
NSIS FAQ | NSIS Home Page | Donate $
"I hear and I forget. I see and I remember. I do and I understand." -- Confucius

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

is this the sort of thing you're looking for?

it is very basic (no config and a hacked around example) at the moment but if you click on the button or press f1 then a little window will pop up. if the 'info' window is already open then it will be brought back to be active again.

still working on how best to implement the setting of the button onto the pages and it's interacting with the running installer.

note 1: the installer will hang if you press f1 with a messagebox open at the moment (not sure if i'm handling messages, etc correctly)

note 2: if the info window is open when the installer is closed then it likely to cause a crash

note 3: not all parts of the button will react at the moment due to it overlapping other controls on the dialog

basically this is just a test to see if it'll work and to check how the handling of the nsis window works for such a feature

-daz

Attachment: helptest.zip
This has been downloaded 480 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2003
From:

Hello daz,

quote:

---

Originally posted by DrO
[B]is this the sort of thing you're looking for?

---

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

glad i got the correct idea of what you meant

quote:

---

Is this the first release ?

---

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

updated a few bits so that this is now more configurable to use ie font is taken from the installer, button can be repositioned, etc.

problem is that when a page is finished, the installer will crash if the 'end' function is used (don't use for the moment). posting more to see how the font placement, etc works on other systems.

-daz

ps
@the devs: when a page is changed, is the window proc being altered? asking since i can never get the 'end' function to successfully unsubclass the window - seems to be trying to access memory from where the dll was mapped into the address space even though i've restored the original window proc i had

thanks

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

ooops, forgot to attach

Attachment: helpbutton2.zip
This has been downloaded 433 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Oct 2001
From: Israel

quote:

---

Originally posted by DrO
@the devs: when a page is changed, is the window proc being altered? asking since i can never get the 'end' function to successfully unsubclass the window - seems to be trying to access memory from where the dll was mapped into the address space even though i've restored the original window proc i had

---

There are two window procs, one for the outer dialog and one for the inner dialog. The problem you're having is probably caused by unloading the plug-in in the leave function which is called when processing a windows message. That message is sent to the dialog by no other but your own plug-in. When the control returns to your plug-in's code it's no longer there, and that causes the crash. Sub-classing is so wonderful, don't you think?

__________________
NSIS FAQ | NSIS Home Page | Donate $
"I hear and I forget. I see and I remember. I do and I understand." -- Confucius

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

quote:

---

Sub-classing is so wonderful, don't you think?

---

i know what you mean

thought that might be the case. with plugins, the hwndParent is the outer dialog (which i'm hoping is right) since that's the one i've been subclassing.

in the code, i have in the start function the plugin using loadlibrary to keep the plugin loaded (removing the need for the /nounload) and then doing the required freelibrary in the end function after it all return values indicate i have unsubclassed the window.

will have a better look at the installer exe source later on i think to see better what's going on

thanks for the info kichik

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

finally worked out how to get around the problems with the plugin crashing (window hooks, doh! but no more subclassing )

now it is possible to get a button onto any page and fixed the message deadlocks from the initial release when the installer was not the active window (messageboxes, etc). now it will allow the 'f1' to work when a messagebox is open.

will post the latest version soon (need some testing on other systems to make sure that the dll is freed correctly so the plugins directory of the installer can be correctly removed on close)
[would have posted it now but i brought the wrong version with me )

@kichik - the info was much appreciated found the message id for a page change which makes it able to automatically unhook a page without calling other functions, cheers for the pointer

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

latest version attached (check the example script on how to use)

works on 2k and 98 (just ran on the work machine and it crashes - NT4 )

can people please test so i can get an idea of what is / isn't wrong with the code, thanks

-daz

Attachment: helpbutton v0.5a.zip
This has been downloaded 378 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

attached is a test version of the dll, can people with NT systems test it please

it will put up messageboxes to show where in the startup process things are (also will beep when the dll is loaded and unloaded).

tried it on a NT test machine and now it does not crash but on loading it will cause the installer to exit immediately
(wierd how all other oses i've tried the code on work fine )

thanks
-daz

p.s. the code shown will cope with reading text and rtf files now by using /file=blah.rtf in the window text parameter (see earlier posts for an example script) and i'm working on html display.
just a pain that it's not running correctly with NT

Attachment: helpbutton_debug.zip
This has been downloaded 414 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

a few versions later and now the NT4 issue is fixed (see below for reason)

i'm putting the updated version up in a bit after i get a readme on how to use it done.

overall features are:

1. add a button onto a page where you want it to go (resizes to the text)
   
2. define your own button text e.g. "Help" or "Readme..."
   
3. show text you set in the script or use a file
   
4. support for plain text and rich text files
   
5. basic support of showing a html file (still need to correctly embed the window)
   
6. opens the window when pressing 'F1'
   

the reasons for the crashing under NT4 where related to trying to hook the window in the dll which it doesn't seem to like doing when the hook function is in the dll calling it (though it works fine under all other oses tested ).

the reason for this was trying to drop the need for a /NOUNLOAD to be used for all calls but i guess it wasn't meant to be

now i've gone back to a hybrid of the earlier code which just subclasses BUT i've improved the handling so it will now cope with the 'show' function being called in the page's leave function (useful for getting a button shown once the install has completed )

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

attached is the latest version (both the dll and an example installer with it in use)

see above for what it can do and check out the example for an idea of how to use the plugin.

more info will be available soon (proper readme file and also an archive page -> off to do that now)

-daz

[edit]
now in the archive here so check it out for how to use the plugin
[/edit]

Attachment: helpbutton_v0_7b_r.zip
This has been downloaded 378 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Last edited by DrO on 10-15-2003 at 03:50 PM

Quick Link | Report this post to a moderator | IP: Logged

Registered: Nov 2002
From: Shropshire, England

Good work!!!

-Stu

__________________
afrowuk.co.uk

Quick Link | Report this post to a moderator | IP: Logged

Registered: Oct 2001
From: Israel

Great, good job

But why is there no source code?

BTW, you can link directly to the attachment from the Archive, no need to link to the thread itself.

__________________
NSIS FAQ | NSIS Home Page | Donate $
"I hear and I forget. I see and I remember. I do and I understand." -- Confucius

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

quote:

---

Originally posted by kichik
But why is there no source code?

---

forgot to bring the files with me will have it up for the next version + need to make it readable (other than by me )

forgot about a direct link (was trying to get at least something on the archive before leaving work), thanks for the pointer though

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

version 0.9 attached

changes to the plugin are:

1. fixed a few crash issues with related to string lengths
   
2. button is now hidden if no text is passed for the title
   
3. FULLY integrated webbrowser control (now it acts like the text window )
   
4. source code provided for your viewing pleasure
   

Attachment: helpbutton_v0_9.zip
This has been downloaded 2569 time(s).

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2003
From:

Hello !

How can I use the Plugin with Modern UI
!insertmacro MUI_PAGE_WELCOME start

Function start
HelpButton::show /NOUNLOAD "246,231" "blah blah blah" "built to the power of the llama ^o^" "/html=$EXEDIR\winampmb.htm"
FunctionEnd

Gives an error: !insertmacro: macro "MUI_PAGE_WELCOME" requires 0 parameter(s), passed 1!

Must I modify system.nsh directly?

Quick Link | Report this post to a moderator | IP: Logged

Registered: Jul 2003
From: germany, b-w

u need to define the function in other way:

code:
!define MUI_PAGE_CUSTOMFUNCTION_PRE start
!insertmacro MUI_PAGE_WELCOME
...

__________________
hand by comm@nder21
----------
WiKi pages:CreateInternetShortcut|Enhanced FindWindow|Parse CSV-Data|Open/Close CD-Drive|Installer without Icon|Vista application compatibility

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2003
From: Germany

It seems there are still several "problems" of this plugin together with the Modern UI:

(1)The button is not displayed the XP styled way.
(2)It seems that every window-refresh unloads the button espeacially a refresh of an InstallOptions-Dialog, so u have to call the HelpButton::show - method at least in every show and leave-function.

Anyway - keep up the good work.
Hope there will be some new versions in the future.

Greez.

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

there should be a 1.0 out in the next few days which adds in chm support, more control over the positioning of the window (for both the chm window and the one the plugin makes) plus a few other tweaks, etc.

there was the xp issue which may be sorted now as well (not too sure since i still don't have an xp install to run on myself but the last screenshot i got from a recent test build showed the button was xp themed *shrugs*

anyhoo, expect a v1.0 soon

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2005
From: Netherlands

quote:

---

Originally posted by DrO
there should be a 1.0 out in the next few days which adds in chm support, more control over the positioning of the window (for both the chm window and the one the plugin makes) plus a few other tweaks, etc.

anyhoo, expect a v1.0 soon

-daz

---

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

i've been a bit side tracked with work so the 1.0 release is a few days behind. if i can i'll do it sunday night (depends on work and 'real life' giving me the time to sit down and do some coding ) otherwise it'll be monday night

-daz

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2005
From: Netherlands

never mind, I can wait.
Sounds much better, 1.0 than 0.9

thx, Hans

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

Help Support plugin v1.0 RC1

download 1.0 RC1

archive reference page for 0.9 sytnax

main changes are that you can now use /help to use chm files e.g. "/help=${NSISDIR}\nsis.chm"

as well it's now possible to specify the top left corner of the window as "x,y" or center (centers in the middle of the desktop) or centerp (centers in the middle of the installer).

and also the size of the window can be set via "width,height" after the top left corner value.

until it's documented/tweaked any of the new parts not used need to be set as "" in the script where you'd otherwise place the information. depending on feedback, etc i'll potnetially modify this and i will update the help file about this in the next day or so

syntax example:
HelpButton::show /NOUNLOAD "232,231" "?" "" "/help=${NSISDIR}\nsis.chm" "" "" "centerp" "500,500"

this will place a '?' button to the left of one of the 'back' button in a classic UI installer and open the nsis.chm file centered over the installer window and 500x500 pixels in size

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Jul 2003
From: germany, b-w

could you please post at least the basic syntax??

__________________
hand by comm@nder21
----------
WiKi pages:CreateInternetShortcut|Enhanced FindWindow|Parse CSV-Data|Open/Close CD-Drive|Installer without Icon|Vista application compatibility

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

Comm@nder21: post editted now

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Apr 2005
From: Netherlands

Two words, absolutely great !

thx for the quick response

Hans

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

HansH: cool, good to hear it's working for you. i've been trying to get to a 1.0 state with it for almost a year now so it's good to know the updates haven't screwed things up too much

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged

Registered: Not Yet
From:

Window size using html

Using version 1.0RC1 (and older) I can't get the html helpwindow large enough. I'm using: HelpButton::show /NOUNLOAD "232,231" "?" "" "/html=xxx.html" "" "" "centerp" "800,800"
It's as if there is a max limit for the window size.
Is it possible to fix?

Quick Link | Report this post to a moderator | IP: Logged

Registered: Sep 2003
From: UK

there shouldn't be a limit with the size (from the plugin side of things). the only thing i can think of is that the html help window enforces a size limit itself but without looking into this i can't say for certain. will try and look at it over the weekend (and update the wiki page as well)

-daz

__________________
My Plugin Site | Current Plugin Releases | Winamp-en-gb Lang Pack [14/03/2009 (Rev #2)]

Quick Link | Report this post to a moderator | IP: Logged