Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
Part of #1921152: META: Start providing tour tips for other core modules.
Problem/Motivation
Write tour integration for forum.module
Proposed resolution
Create tour yml files for required admin screens in forum.
Remaining tasks
Review forum_menu() and decide on screens that require tour integration
Write tour integration
User interface changes
New tours
API changes
None
Technical pointers when creating tour tips
See: https://www.drupal.org/docs/8/api/tour-api/overview for tech notes on making tour tips.
Comment | File | Size | Author |
---|---|---|---|
#33 | forum-tour-1926296.33.patch | 9.73 KB | Antti J. Salminen |
#29 | forum-tour-1926296.29.patch | 9.66 KB | Antti J. Salminen |
#25 | forum-tour-1926296.25.patch | 9.52 KB | Antti J. Salminen |
#19 | forum-tour-1926296.19.fail_.patch | 9.53 KB | larowlan |
#19 | forum-tour-1926296.19.pass_.patch | 10.2 KB | larowlan |
Comments
Comment #1
larowlanPatch for review.
Adds three yml files to cover the forum admin listing and the add/edit forum and add/edit container forms.
Also adds minor changes to tour.js to allow for the modal option (when no data-id or data-class is provided).
This is used for a nice introduction to the point of the form.
Some screenshots below.
Full tour screencast here: http://youtu.be/ItLxCQgB7-c
Comment #2
larowlanRenames ids/files to remove reference to language as per #1935120: Unusual language use in tour module
Comment #3
nick_schuch CreditAttribution: nick_schuch commentedHere is a screencast of the tour: http://youtu.be/BjoPEisDOrk
The content looks really good. Ill make sure to add a line about "Use examples" in the pattern definition documentation.
We should add some css in to provide a margin for the tips that touch the bottom of the page. What do you think?
Comment #4
nick_schuch CreditAttribution: nick_schuch commentedThis following adds to the patch and adds some gap between the bottom of the browser and the tip.
Comment #5
nick_schuch CreditAttribution: nick_schuch commentedComment #7
nick_schuch CreditAttribution: nick_schuch commented#4: forum-tour-1926296.4.patch queued for re-testing.
Comment #8
tstoecklerAs the Joyride library is external code I don't think we should be modifying it. I think it would be better to override the selectors in tour.css or whatever.
Comment #9
nick_schuch CreditAttribution: nick_schuch commentedThanks for the review tstoeckler. After a discussion with larowlan today we need to revert back the css anyway. I completely understand what you mean.
I think if we cannot solve the issue (if it arises again) we can talk about it then. Did you happen to review the tour content?
Comment #10
tstoecklerNot yet, I hope to very soon, though.
Comment #11
nick_schuch CreditAttribution: nick_schuch commentedThanks tstoeckler!
Comment #12
larowlanReroll
Comment #13
larowlanhttp://s00940b77ab6f5d5.s3.simplytest.me/ admin/power if you want a run through
expires in 15
Comment #14
larowlanNeeds #1995152-7: Broken selector for the overview item to work
Comment #14.0
larowlanUpdated summary
Comment #15
larowlanThis is needs work as it should add tests to ensure the markup is present.
Blocked on #2028535: Provide a TourTestBase class for use by core and contrib modules
Comment #16
larowlanBack on this
Comment #17
larowlanThis fails because we've lost the action buttons.
Need to add a new issue (bug) for that.
Comment #19
larowlanFail/pass demonstrating we have a) tour test coverage and b) fix for #2073197: Local actions 'add new forum|container' no longer found at admin/stucture/forums
Comment #21
larowlanTest bot runs in a sub directory, need to rethink selectors
Comment #22
larowlanPostponing until #2073197: Local actions 'add new forum|container' no longer found at admin/stucture/forums is fixed
Comment #22.0
larowlanUpdated issue summary.
Comment #23
larowlanComment #24
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedWorking a bit on this.
Comment #25
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedRerolled with routes, PSR-4, config move and removed the fix that went in with another commit as far as I can see.
Comment #26
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedTriggering tests to see where the patch stands.
Comment #28
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedComment #29
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedSome reroll changes.
Comment #30
nick_schuch CreditAttribution: nick_schuch commentedComment #32
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedWorking on getting the tests to pass again.
Comment #33
Antti J. Salminen CreditAttribution: Antti J. Salminen commentedThis should pass more tests than previously. The forum edit page delete link is not present on the page with the "administer forums" permission. Looks like there is a bug with the forum permissions instead of an issue with the tour itself.
Comment #35
webchickThis one seems like a good thing to do, but postponed on #1921152-109: META: Start providing tour tips for other core modules. for now.
Comment #36
mgiffordComment #43
dorficus CreditAttribution: dorficus as a volunteer commentedNoticed that the link points to an anchor that isn't there. On #1921152-69: META: Start providing tour tips for other core modules. the anchor this link pointed to has gone to its own doc page.
Comment #50
quietone CreditAttribution: quietone at PreviousNext commentedForum is approved for removal. See #1898812: [policy] Deprecate forum module for removal in Drupal 11
This is now Postponed. The status is set according to two policies. The Remove a core extension and move it to a contributed project and the Extensions approved for removal policies.
It will be moved to the contributed extension once the Drupal 11 branch is open.
Comment #52
quietone CreditAttribution: quietone at PreviousNext commented