Canalplan Bug Tracker



Anonymous Login
2019-06-19 17:47 BST

View Issue Details Jump to Notes ]
IDProjectCategoryView StatusLast Update
0000263Canalplan [All Projects] Feature Requestpublic2017-04-14 13:11
ReporterShultzy 
Assigned ToNick Atty 
PrioritynormalSeverityminorReproducibilityN/A
StatusassignedResolutionopen 
PlatformMicrosoftOSWindowsOS Version8.1
Product VersionProduct Build 
Target VersionFixed in Version 
Summary0000263: Help Page References
DescriptionIt has been suggested by a user that certain pages in CP would benefit from having a reference to the corresponding help page.

As an example at the end of the [Major Editing] page a pointer to the [Major edit — Help and information on using the major editing functions.] help page would be useful.
TagsNo tags attached.
Attach Tags (Separate by ",")
Attached Files

-Relationships
+Relationships

-Upload File
Select File
Maximum size: 5,000 KB
+Upload File

-Notes

~0001035

Nick Atty (administrator)

I think that's a really good idea. It should be easy to do it programatically - build something into the footer block that generates the link (and arrange a neat way to manage the associations).

I'll look at the first part at least, and think about the second.

~0001036

Nick Atty (administrator)

I'll document it here, it probably needs to go into the help documentation. Will release in the next few minutes.

There is now an automated way to put help on any page that has buttons at the bottom. All you need to do is visit that page and find the "page_code". To get this, hover over the logo on the page you want to put help on - it's show in small type below the build details. For example, the code for the route editor is "route_entry", the code for major edit is "majedit".

Then visit the help page you want to associate with this page and edit it, add the string

@$helppage page_code$

anywhere you want as a line by itself. This does not get displayed. ('page_code' in this example should be replaced with the actual code such as "majedit" or "route_entry".

"Save" or "Finish" the edit, and the association will be automatically made. If you revisit the page it will now have a "help" button that opens the help system on the appropriate page.

I'll leave open in case I've broken anything along the way!

~0001037

Shultzy (updater)

These all work:
My Page
Plan a Journey
Preferences
Photos
Major edit

These don't work as the don't create a button but show a green band over the top three lines:
Places
Waterways

~0001038

Shultzy (updater)

PS the [Home] page doesn't have a button either.

~0001053

Nick Atty (administrator)

It looks like there's something wrong with the HTML on those pages - the green band at the top is the background for the button bar which is being correctly generated but isn't rendering properly.

The home page is made in an entirely different way to all the other pages so isn't picking it up. I'll think about what to do there.

~0001055

Nick Atty (administrator)

I've fixed the HTML on the gazetteer pages (place and waterway) but:
- waterway has a lot of empty space in it
- options has a nasty artefact of adding the logo

~0001057

Shultzy (updater)

[Places] and [Waterways] has worked, but I feel that the [Help] button should be in a more prominent position on pages that are more than a screen deep

~0001080

Shultzy (updater)

The Page code[Page code: editphoto] is visible on the page but not under the CP logo. When I tried to add this Page code to the help pages it didn't work. It may be that there can only be one help page valid at any given time.
+Notes

-Add Note
Note
View Status
Upload File
Maximum size: 5,000 KB
+Add Note

-Issue History
Date Modified Username Field Change
2017-03-24 22:34 Shultzy New Issue
2017-03-24 22:42 user3 Assigned To => Nick Atty
2017-03-24 22:42 user3 Status new => assigned
2017-03-25 08:44 Nick Atty Note Added: 0001035
2017-03-26 09:03 Nick Atty Note Added: 0001036
2017-03-26 18:46 Shultzy Note Added: 0001037
2017-03-26 18:52 Shultzy Note Added: 0001038
2017-03-29 07:22 Nick Atty Note Added: 0001053
2017-03-30 07:28 Nick Atty Note Added: 0001055
2017-03-30 13:54 Shultzy Note Added: 0001057
2017-04-14 13:11 Shultzy Note Added: 0001080
+Issue History