forked from justintadlock/breadcrumb-trail
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
121 lines (68 loc) · 7.04 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
=== Breadcrumb Trail ===
Contributors: greenshady
Donate link: https://themehybrid.com/donate
Tags: breadcrumbs, navigation, menu
Requires at least: 4.7
Tested up to: 4.8.2
Requires PHP: 5.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.htm
A powerful script for adding breadcrumbs to your site that supports Schema.org HTML5-valid microdata.
== Description ==
Breadcrumb Trail is one of the most advanced and robust breadcrumb menu systems available for WordPress. It started out as a small script for basic blogs but has grown into a system that can handle nearly any site's setup to show the most accurate breadcrumbs for each page.
### Before using
Please note that Breadcrumb Trail requires that you understand and know how to edit your theme's PHP code, at least to the extent of copying and pasting one line of code. If you're not comfortable doing this, it's best to ask that your theme author integrate the code necessary to support this plugin.
### How it works
This plugin automatically detects your permalink setup and displays breadcrumbs based off that structure. Nearly all sites have some sort of hierarchy. Breadcrumb Trail recognizes that and builds a set of unique breadcrumbs for each page on your site.
This means that it can also detect custom post types and taxonomies right out of the box. Whatever you throw at it, it's got a solution.
### Features
* Auto-detects the permalink structure of your site for the most accurate breadcrumbs.
* Hooks for plugin/theme developers to overwrite output.
* Coded with object-oriented programming (OOP) methods to allow developers to extend it for those highly-custom setups.
* Properly handles nearly any custom post type or taxonomy.
### Professional support
If you need professional plugin support from me, the plugin author, you can join the club at [Theme Hybrid](https://themehybrid.com/club), which is a professional WordPress help/support site where I handle support for all my plugins and themes for a community of 75,000+ users (and growing).
### Plugin Development
If you're a theme author, plugin author, or just a code hobbyist, you can follow the development of this plugin on it's [GitHub repository](https://github.com/justintadlock/breadcrumb-trail).
### Donations
Yes, I do accept donations. If you want to donate, you can do so from my [donations page](https://themehybrid.com/donate) or grab me something from my [Amazon Wish List](http://a.co/flUb0ns).
I appreciate all donations, no matter the size. Further development of this plugin is not contingent on donations, but they are always a nice incentive.
== Frequently Asked Questions ==
### Why was this plugin created?
Many of my theme users had a real need for a functional breadcrumb menu without having to find and test a lot of other plugins. Therefore, I created a breadcrumbs script for those users. Eventually, I decided to package it as a plugin and share it with others.
The plugin is still mostly packaged with themes and is currently being used on millions of WordPress sites.
### What's a breadcrumb menu?
Basically, it's a navigational tool. On many sites, you'll see something that looks like this:
You are here: Home > Page > Sub-page > Sub-sub-page
This plugin allows you to easily add this type of menu your site.
### How do I add it to my theme?
There are several methods, but in general, you would add the following line of code to your theme. Generally, this goes somewhere near the bottom of your theme's `header.php` template. However, you can add it anywhere you want in your theme, and it should work.
<?php if ( function_exists( 'breadcrumb_trail' ) ) breadcrumb_trail(); ?>
To see all methods and options, refer to the `readme.md` file included with the plugin download. You can also [view the readme online](https://github.com/justintadlock/breadcrumb-trail/blob/master/readme.md).
### How do I disable the plugin styles?
You can disable the plugin styles by adding this to your theme's `functions.php` file:
add_filter( 'breadcrumb_trail_inline_style', '__return_false' );
Note that the breadcrumbs will be completely unstyled at this point. You'll need to add style rules to your theme's `style.css` file.
### Do breadcrumbs show in Google search results?
Yes, breadcrumbs *can* show in Google search results. The breadcrumbs are coded in a way that all of the major search engines should be able to recognize them. It is marked up with the appropriate Schema.org properties to make it easier for search engines and other systems to understand.
With that said, it's still left up to the search provider to actually show the breadcrumbs. Generally, they do show them.
Don't expect to see breadcrumbs in your search results on the first day either. It may take a bit, depending on how often your Web site is crawled.
### What is Schema.org? Microdata?
[Microdata](http://en.wikipedia.org/wiki/Microdata_(HTML)) is a way to nest metadata into your Web site's pages. It allows things like search engines and browsers to provide a more useful experience for users. Microdata provides a way for you to describe the "meaning" (i.e., semantics) of specific items on your site by using a standardized vocabulary.
[Schema.org](http://schema.org) is a microdata vocabulary. It is a collaboration by Bing, Google, Yahoo!, and Yandex for creating a set of standardized conventions for using microdata on the Web. With these standards in place, we can make our Web sites' data more understandable to search engines and browsers while providing a richer experience for users.
### Does this help with SEO?
Well, it doesn't hurt. The way I see it, the more meaningful information you provide to search engines, the more likely you are to rank up. Properly-coded breadcrumbs are just one tool in a gigantic toolbox for building a search-engine optimized site.
### The breadcrumbs display the wrong data!
This is rare, especially if you put the code in your header template. However, it can happen on occasion when your theme or another plugin messes with some of WordPress' global variables but doesn't set things back properly after doing whatever it is they're doing.
There's not really much I can do to correct that within the Breadcrumb Trail plugin. The only thing I could do is help you fix the theme/plugin causing the issue. If this happens, you'll need to drop by my [support forums](https://themehybrid.com/support) to get help.
== Screenshots ==
1. Breadcrumbs in Google search results.
2. Date-based permalink structure in breadcrumbs.
3. Custom post type + taxonomy (portfolio).
4. Image attachment of a blog post.
== Upgrade Notice ==
### Version 1.0.0+
If upgrading to a version earlier than 1.0.0, your custom styles may need to be adjusted. The HTML markup has changed to a better HTML5 structure.
== Changelog ==
Please see the `changelog.md` file included with the plugin file. Or, you can view the [online change log](https://github.com/justintadlock/breadcrumb-trail/blob/master/changelog.md).