Download the PHP package justintadlock/hybrid-breadcrumbs without Composer
On this page you can find all versions of the php package justintadlock/hybrid-breadcrumbs. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download justintadlock/hybrid-breadcrumbs
More information about justintadlock/hybrid-breadcrumbs
Files in justintadlock/hybrid-breadcrumbs
Package hybrid-breadcrumbs
Short Description A powerful breadcrumb script for inclusion with WordPress themes.
License GPL-2.0-or-later
Homepage https://github.com/justintadlock/hybrid-breadcrumbs
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package hybrid-breadcrumbs
Hybrid\Breadcrumbs
Hybrid Breadcrumbs is a drop-in package that theme authors can use to add breadcrumbs to their WordPress themes.
The package is a developer-friendly project that aims to take out all the work of handling breadcrumbs. It is one of the most advanced and robust breadcrumb systems available that can handle nearly any setup to show the most accurate breadcrumbs for each page.
This project was originally launched in 2009 as the Breadcrumb Trail plugin. Hybrid Breadcrumbs is a reimagining of that original script as a better drop-in package for theme authors to use.
Requirements
- WordPress 4.9+.
- PHP 5.6+ (preferably 7+).
- Composer for managing PHP dependencies.
Documentation
The following docs are written with theme authors in mind because that'll be the most common use case. If including in a plugin, it shouldn't be much different.
Installation
First, you'll need to open your command line tool and change directories to your theme folder.
Then, use Composer to install the package.
Assuming you're not already including the Composer autoload file for your theme and are shipping this as part of your theme package, you'll want something like the following bit of code in your theme's functions.php to autoload this package (and any others).
The Composer autoload file will automatically load up Hybrid Breadcrumbs for you and make its code available for you to use.
Translations
Because this script has a few internationalized text strings within it, you'll want to overwrite the textdomain or use something like this one theme with two textdomains trick (the textdomain in this project is 'hybrid-core').
If you're creating a theme using the Hybrid Core framework, you don't have to worry about this. Hybrid Core will appropriately handle translations for you.
Usage
Most developers will want to utilize the Hybrid\Breadrumbs\Trail class. It is a static wrapper class that essentially acts as syntactic sugar for use in theme templates.
Typically, a call like the following would go into your theme's header.php template but can be used anywhere you want to show the breadcrumb trail.
Note that the plugin's namespace is Hybrid\Breadcrumbs. If you're working within another namespace, you'll want to add a use statement after your own namespace call or call \Hybrid\Breadcrumbs\Trail::display() directly. I'll assume you know what you're doing if you're working with namespaces. Otherwise, stick to the above.
Static class
The Hybrid\Breadcrumbs\Trail class has the following methods:
Breadcrumbs class
If you don't care for static classes and need to work directly with the object, that's fine too. You can create and use a the Breadcrumbs object like so:
Parameters
The Breadcrumbs class and the Trail class methods all accept a single parameter, which an array of optional arguments for setting up the breadcrumb trail. The following is a list of all the available options (see below for defaults).
labels- An array of labels.post_taxonomy- An array of taxonomies to show for single posts based on post type.show_on_front- Whether to show the breadcrumb trail on the site front page.show_trail_end- Whether to display the final breadcrumb.network- Whether to include the main site at the beginning of the trail on multisite.before- HTML to display before.after- HTML to display after.container_tag- HTML tag to use for the container.title_tag- HTML tag to use for the title.list_tag- HTML tag to use for the list.item_tag- HTML tag to use for each breadcrumb.container_class- Class to use for the container.title_class- Class to use for the title.list_class- Class to use for the list.item_class- Class to use for each breadcrumb.
Default Parameters
Default Labels
Labels are used for various breadcrumbs where WordPress doesn't provide a title/labels.
Default Post Taxonomies
By default, no post taxonomies are registered. However, if a site's post permalink structure is set to only %postname%, the following will be the default.
Copyright and License
This project is licensed under the GNU GPL, version 2 or later.
2018-2019 © Justin Tadlock.
