I've figured out how to add help files for plugins in the form of .htm files. I've encountered one problem though. How do I register a help file for a plugin that has multiple registered editors?
My current plugin has one mgDeclarePlugin and three mgRegisterEditor. So, when I go to Help->On Plugins, I see the name that I used with mgDeclarePlugin in Plugin Modules and I see the three registered editors in Tools/Data extensions. When I hit help, it brings me to the same help file for all three editors which is normal because I declared the help file for the plugin with mgRegisterHelpFile and that function takes a mgPlugin argument and not a mgPluginTool argument which basically means I can't register a help file for a specific editor. I know MTA_HELPCONTEXT exists but it looks to me as it doesn't allow .htm files to be specified.
So how do I register a .htm help file for each editor in my plugin? If I can't is there a way to specify a bookmark so that it scrolls to the right spot in the .htm file?
Ok, thanks. I think I'll just need to put a main page with hyperlinks and that should do the trick :)
You can only register one help file per plugin. That means all the tools contained in your plugin must share the same file. The idea was that you could use HTML targets to get context sensitive help. ie. when you did Help on a particular tool, your help file would open to the named target (using MTA_HELPCONTEXT). Unfortunately that currently does not work for HTML files so you're stuck until we either:
Fix MTA_HELPCONTEXT to open the HTML file to the named target
Allow different help files per tool.