Hi all, knowing nothing, I put forward a first attempt at a users guide that makes as few assumptions as I could about how the user interface is supposed to work. Several semantic issues are raised that might be of interest. Let me know if this is of any use.

PS> I'm still stuck on the last entry. Link Path. Can't get it right. Am determined to figure this out and leave a trail for others that follow.

CommentFileSizeAuthor
Noob's Path Breadcrumbs user guid.txt10.53 KBDan433
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

kalabro’s picture

Wow! Thanks for it, @Dan433!
I'll check it soon and give my feedback.

By the way, have you looked througth PB FAQ and docs?

Dan433’s picture

Thanks @kalabro. Yes, I read the faq and the docs but some of the broader-deeper Drupal concepts like hierarchical taxonomy and multiple context issues are mixed in with the beginner stuff. I'm trying to give the beginner (like me) a place to start as they ( I ) try to get a handle on what all the entries are for and how to properly enter them.

kalabro’s picture

Yes, it may be quite difficult for fellow Drupal developers to start using Path Breadcrumbs. The good news are that PB is built with "Drupal Way" concepts in mind so your new experience with be 100% useful in the future :)

Dan433’s picture

I edited the noob's guide to be more thorough but I have
Two questions:

What's a good format to share the Noob Guide?
The plain text file is awful. I can't upload the WORD file and PDF is ok but not easily editable. I'd really like for you to be able to make changes.

How do I provide a path link to a "view"?
This is a glaring gap in my guide that seems important because views are likely to be the way sites present a collection of all of a given type of content and are thus a likely entry in the breadcrumb trail. Views don't fit the form "node/%nodeid" because, I think, the views module is creating its pages on the fly. I can assign a "link path" within the views ui to be something like "/articles" but this does not work in Path Breadcrumbs. Actually, if I enter the path-link as just " articles " (no slash) it seems to work fine in the Path Breadcrumbs module but only if rendered with Drupal's theme_breadcrumbs or my overide but not with the Path Breadcrumbs render function (path_breadcrumbs_breadcrumb),which only seems to accept things like < front > and < none >. But I'm in over my head.

Dan433’s picture

As I refine my Noob guide I realize that all that is really needed is a few semantic changes to some of the text in the UI. I have the guide but it's probably not even needed if the following were changed.

-In Basic Settings

The title "Path" is vague for the beginner. I think what is intended here is really the pattern that describes the path in the URL. Can the title of the entry be changed from "path" to "path-pattern"

Path
->
Path-pattern

and then the first sentence of the help text would change:

The URL non-aliased path where breadcrumb will be shown.
->
Define the pattern that describes the path to the non-aliased Drupal URL for the page where breadcrumb will be shown.

(perhaps someone has a better term than "page". I wanted to say "entity" but I'm not sure of the full meaning of that word in Drupal lingo and the PB UI refers to pages in the Selection Rules section.)

Arguments

This section is great except "Settings" is just a repeat of the info already entered. I'm sure that there is something that could be changed here but there's no clue as to what and maybe this is not for the beginner anyway.

Selection Rules

The help text for Selection Rules begins by discussing Variants but the beginner doesn't know what a "variant" is. I think what this is trying to explain is what will happen if there are several "variants of breadcrumbs" defined.

could the beginning of the first sentence be changed from:

If there is more than one variant on a page,
->
If there is more than one variant of breadcrumbs defined for a page,

And can a bit of help text be added below the select list? It wasn't obvious what to do there.

just add
->
Select a context from the list.

Breadcrumbs

The titles LINK TITLE and LINK PATH are vague for the beginner who has been lead through all kinds of other required fields so it's not obvious that they have finally arrived at the actual breadcrumb labels. Can the titles of these entries be changed:

LINK TITLE
->
CRUMB TITLE

and

LINK PATH
->
CRUMB LINK PATH

My intention is to make the process obvious.

Dan433’s picture

I added a child page to https://drupal.org/node/2061939 the Path Breadcrumbs user's doc.

I called it "A Noob's Guide" and am attempting to explain the terms and process through a pretty simple example.

Let me know if I have overstepped.

kalabro’s picture

Well, I reviewed your text: https://www.drupal.org/node/2415031/revisions/view/8068953/8115831
Here some comments:

It says that the module is going to check to see if the context "exists" and helpfully defines existence as something that "contains data".

Actually, your PB item will not work without all configured contexts loaded successfully. In other words, contexts set on “Choose arguments” step are required. So, additional "context exist" check can be omitted here.

is a special entry for the title of the node: !page_title and so I use that for the link-title.

Page title and node title may be different. To add node title use %node:title token.

expect --yeah-- except that the link to the landing page for articles doesn't actually have a link. So close.

Usually it works. It seems you found a bug related to PB and your theme.

This document is quite uncommon for Drupal Documentation directory as it contains a lot of personal emotions and non-technical terms. I hope you configured and launched your site successfully and some day this guide can be just moved in your personal blog. Some screenshots are also very welcome.

Best,
Kate

Dan433’s picture

Thanks Kate,
Found https://www.drupal.org/contribute/documentation and am humbled.
I updated it to make it fit in to the Drupal docs better. Tried to expand to describe other possibilities along the way but...well...I'm still a noob.
No screen captures yet.
Dan