We launched new forums in March 2019—join us there. In a hurry for help with your website? Get Help Now!
    • 8880
    • 29 Posts
    Kylej,
    Thanks, parentRowTpl did it.
      • 11678
      • 160 Posts
      Kyle; Might I suggest a small addition to your documentation? One issue I notice that keeps popping up in the forum, is the new user’s frustration over not understanding how to control the orientation and appearance of the menu. At the moment this is not completely addressed in the docs. A lot of the new users evidently are not familiar with CSS and do not understand that it is basically the CSS that determines how the menu will look.
      So my suggested addition is a note such as this in the head area of your documentation where the new user will find it:

      "The orientation of the menu (horizontal menu versus a vertical) is determined by the CSS styling of the "ul" tag. The horizontal menu “ul” is “display: inline;” and the vertical menu “ul” is “display: block;"

      I realize this is simplistic for experienced MODx users - but it would be gold to the confused new user and only uses a bit more space in the doc.
      Thanks for your consideration,
      Hal Davey
        "Today’s headlines are nothing more than whispers of history"
        • 27376
        • 576 Posts
        Will this update break any previous versions of Wayfinder?
          • 15987
          • 786 Posts
          No it should not break anything. I can’t guarantee it, but I did try to test all of the parameters, templates, etc
            • 22303 MODX Staff
            • 10,725 Posts
            First, I just want to say that this latest Wayfinder is working wonderfully for me. Great job Kyle; I really like some of the new parameters, as they made child’s play of some fairly complex menus I was converting from Mambo yesterday...great timing! smiley

            Quote from: Mark at Feb 20, 2007, 07:17 PM

            Here is the dream I have for Reflect (Ditto’s archiving component) that Wayfinder would benefit from as well. The user creates a single template chunk that has nested templates in it and then the snippet takes that, breaks it apart into the segments it needs, and stores them in a cache file. That way a user could see his/her menu template easily and even make changes to the tag structure in an WYSIWYG editor...

            The hard part is making it work...
            I’m concerned that this vision is somewhat contrary to the philosophy and goals of the content management core. What I mean is that it is not the responsibility (and should never be) of a snippet to break apart nested templates in some arbitrary format, cache content, etc. That’s not to say it shouldn’t be allowed when developing your own solutions, but I do not believe that core snippets such as Ditto, Reflect, and Wayfinder should exemplify these potentially one-off approaches. As we start to internationalize MODx, add content revisioning, etc., this is going to be even more important, as you would have to rewrite the code and write custom migration scripts for all of the proprietary templating, caching, and administration taking place in these components to take advantage of some of these fixes and features being developed.

            I know me saying this is going to frustrate some of you, as usual, but it is important to me that we start to address these issues at the core level rather than inside each snippet implementation. And the sooner we start reinforcing these consistent approaches in the core add-ons, the sooner other would-be add-on developers can follow by these examples. But I’m convinced that the more content management logic we place inside these add-ons as a workaround to a core issue or missing feature, the harder it is going to be to resolve those issues in a consistent way moving forward.

            In other words, let’s start focusing on how we can get the features we need to support the requirements that are inspiring Mark’s vision into the core. This will require a level of collaboration between core developers and add-on developers that has yet to exist in this project, but IMHO, this is way overdue already.
              • 27376
              • 576 Posts
              Quote from: OpenGeek at Feb 23, 2007, 12:19 PM

              What I mean is that it is not the responsibility (and should never be) of a snippet to break apart nested templates in some arbitrary format, cache content, etc.
              This is the kind of solution that the FileDownload snippet uses. One chunk contains all the templates the snippet will use. This has a number of downsides. Some of which OpenGeek eloquently put. One more reason I personally don’t like the method is that there are some templates I don’t use, so if I wanted to customize a single template, I’d have to re-write all the templates the snippet uses.

              One method I’m slowly adopting in my snippets is what I like to call the ’wrapper’ method. Instead of having two chunks designate the start and end of a template, make one chunk with a [+wrapper+] or some sort of placeholder in between and fill the placeholder in your snippet. Wayfinder alraedy uses this method.

              You still end up with a lot of chunks if you’re customizing each template, but then the advent of config files in Ditto (and now Wayfinder!), you can create custom ’@CODE’ or ’@FILE’ templates and save them elsewhere. So the Chunks section can remain clean, OpenGeek’s philosophy is enforced, and everyone’s happy laugh
                • 20765
                • 90 Posts
                myfriendscallmebill Reply #27, 19 years, 7 months ago
                Hi Kyle--
                Thanks for your continuing work on this wonderful snippet. I used it’s first version on a commercial site last year where I had up to four Wayfinder calls per page.

                I’m revving up for another project, wanted to revisit Wayfinder, and found this topic re. version 2. I’ve played somewhat with v2, and so far it’s behaving as expected.

                But the main point of this post is that I’ve tried to document Wayfinder fully and properly, and have attached the first useable version to this post. I’m hoping you’ll have time to answer some of the open questions (indicated in italics), and point out where I’ve gone wrong. I’m also hoping that this will prove helpful to all who’ve been struggling to comprehend this snippet.

                The MODx community is welcome to use this in any way you see fit. Maybe it will work as the basis for the next-generation of documentation for Wayfinder...

                Best regards,
                Bill
                  • 28042 ☆ A M B ☆
                  • 24,524 Posts
                  Wiki! Wiki!
                    Studying MODX in the desert - http://sottwell.com
                    Tips and Tricks from the MODX Forums and Slack Channels - http://modxcookbook.com
                    Join the Slack Community - http://modx.org
                    • 15987
                    • 786 Posts
                    Bill,
                    Thanks for working on the documentation. I gave it a quick run through and it looks pretty good. I will go through it in more detail later today/tonight and try to answer all of the questions you have. I will post the updates here when I am done.

                    Thanks again,
                    Kyle
                      • 15987
                      • 786 Posts
                      I have made this version final, get it here:

                      http://modxcms.com/Wayfinder-868.html