Package: visaplan.plone.breadcrumbs
This package provides breadcrumbs classes for object trees in Zope/Plone
instances; e.g., it is possible to have theuidrequest variable used for
the breadcrumb if a certain template is used.For each view template name, it allows the registration of an executable
breadcrumbs instance, which may create zero or more breadcrumbs and then give
over processing to a parent breadcrumb. Such breadcrumbs instances usually use
the current value of a certain request variable, or they may suppress the
creation of any breadcrumbs at all.NOTE:The purpose of this package isnotto provide new functionality
but to factor out existing functionality from an existing monolitic Zope product.
Thus, it is more likely to lose functionality during further development
(as parts of it will be forked out into their own packages,
or some functionality may even become obsolete because there are better
alternatives in standard Plone components).FeaturesBreadcrumbs classes for several use casesA simple registry for breadcrumbs and the templates they are triggered byDue to it’s history, this package still has a few dependencies which are not
really important for the core functionality but rather are related to
particular breadcrumbs classes of our old monolithic product and it’s eggified
successors. For this reason, and because of some weaknesses of the current
breadcrumbs registry, the current versions are called0.x.Before you fork you own mycompany.plone.breadcrumbs package, here is what we
plan for the 1.x versions:Theregisterfunction will take …thenameof a breadcrumbs class,the (single) parent (orNone, for the standard breadcrumbs from the
objects tree), andoptional keyword arguments.Currently, it takes an instance of a breadcrumbs class, and the further
information thrown at the breadcrumbs class when constructing the instance.
The main drawback is that the parent breadcrumb needs to already exist when a
new breadcrumb is to be registered, which leads to very annoying module
dependenies.Thus, versions 1.x will take all the necessary information during
registration, and will create a breadcrumb instance when it is first used,
including theparent(and “grandparents”, if any).Theparentslist will be replaced by a singleparent;
each breadcrumb has exactly one parent to which it hands over it’s results
after processing (orNone, which will cause the usual standard
breadcrumbs to be created from the objects tree).Thetweakmethod will likely be renamed to something more reasonable;
unless someone comes up with something better, this will beprocess.
It’s signature might change, too.ExamplesThis add-on can be seen in action at the following sites:https://www.unitracc.dehttps://www.unitracc.comDocumentationSorry, we don’t have real user documentation yet.InstallationInstall visaplan.plone.breadcrumbs by adding it to your buildout:[buildout]

...

eggs =
    visaplan.plone.breadcrumbsand then runningbin/buildoutContributeIssue Tracker:https://github.com/visaplan/visaplan.plone.breadcrumbs/issuesSource Code:https://github.com/visaplan/visaplan.plone.breadcrumbsSupportIf you are having issues, please let us know;
please use theissue trackermentioned above.LicenseThe project is licensed under the GPLv2.ContributorsTobias Herp,tobias.herp@visaplan.comChangelog0.1.6 (2022-03-04)New Features:New generic crumb class .base.UidCrumbMiscellaneous:Converted the .base module in a subpackage.[tobiasherp]0.1.5 (2022-01-18)Bugfixes:Fromhub['getbrain']we expect a brain, of course, rather than an object[tobiasherp]0.1.4 (2020-12-16)Bugfixes:Fixed a NameError in certain breadcrumbsImprovements:Python 3 compatibility, usingsixSorted imports, usingisortRequirements:sixMiscellaneous:Removed the currently emptytestextra[tobiasherp]0.1.3 (2020-07-02)Miscellaneous:(For now) hard-coded media center support[tobiasherp]0.1.2 (2020-03-05)Provides “feature”VisaplanTentativeBreadcrumbsThe featureVisaplanBreadcrumbswill be provided by version 1+.You may provide an oldcrumbs module depending on VisaplanTentativeBreadcrumbs,
and a crumbs module depending on VisaplanBreadcrumbs[tobiasherp]0.1.1 (2019-11-27)Reduced logging.Tools update
[tobiasherp]0.1 (2018-09-18)Initial release.
[tobiasherp]