Tag Archives: Code

Breadcrumb NavXT 5.4.0

Posted by in WordPress > Plugins

Holy new filters Batman! Breadcrumb NavXT 5.4.0 features several new filters and many bug fixes. Several fixes focus on strings and translations, including the addition of translation context for some strings. Additionally, date format strings for date breadcrumbs are now translatable. Two potential sources for PHP errors/warnings were mitigated. Lastly, the “Your settings are out of date” message no longer appears on fresh installs of Breadcrumb NavXT.

New Filters

Three new filters were added to Breadcrumb NavXT for 5.4.0. These are: bcn_post_terms, bcn_pick_post_term, and bcn_add_post_type_arg.

bcn_post_terms

Previously, it was not easy to to control the number of terms, or what terms, were displayed when the hierarchy for a post was set to a flat taxonomy type. The bcn_post_terms filter provides a method for modifying what terms are displayed in this situation.

bcn_pick_post_term

For posts belonging to multiple terms from a hierarchical taxonomy, Breadcrumb NavXT has, since 3.0, picked the first term with a parent, or the last term if none of the terms have parents. While this is an efficient method of picking the term, it is not applicable for all use cases. In the past, it was not easy to override this decision. There are ways to influence the selection based on the rule outlined above. But, this was not precise. The bcn_pick_post_term filter allows complete control over what term is selected by Breadcrumb NavXT.

bcn_add_post_type_arg

Introduced in Breadcrumb NavXT 5.3.0, the post_type query argument was added to archive URLs when it was determined that the current post type was not the native type for that archive (e.g. for date archives and some taxonomy archives). While this behavior is correct, it may not be desired for every site. In 5.4.0 the bcn_add_post_type_arg filter was added to provide a way to override the decision Breadcrumb NavXT makes in regards to adding the post_type query argument to a URL. See How to Remove post_type From Breadcrumb NavXT URLs for an example of how to use this new filter.

As always, checkout the Breadcrumb NavXT Documentation’s Filter Reference for more details on these filters, and the other filters in Breadcrumb NavXT.

Translations

As explained in the Breadcrumb NavXT Translations Moving to Language Packs article, Breadcrumb NavXT has moved away from shipping translations with the plugin. This is the first release to ship without any included translations, all translations are available via language packs, or from the Breadcrumb NavXT Translation Project.

If you would like to contribute to translating Breadcrumb NavXT, please visit the Breadcrumb NavXT Translation Project. A big thanks to all of the translators that have contributed to the translations in the past and continue to contribute.

As always, you can grab the latest version of Breadcrumb NavXT from the Breadcrumb NavXT page. If you experience any issues with this version of Breadcrumb NavXT, please leave a comment on this post detailing the issue.

-John Havlik

[end of transmission, stay tuned]

Tagged:
Updated:

WP Lynx 1.1.1

Posted by in WordPress > Plugins

What’s this? A bugfix release for WP Lynx? That’s right, announcing the immediate availability of the first bug fix release for WP Lynx 1.1. Three bugs were squashed in this release. In 1.1, the uninstaller was moved to a newer uninstaller akin to what Breadcrumb NavXT received in 5.3.0. However, the wrong class was instantiated, causing uninstalls to not work, this has been fixed in 1.1.1. Additionally, a bug in the settings page content alignment in WordPress 4.4 was fixed. Lastly, the Lynx Print adding interface now handles server side errors more gracefully.

You can grab the latest WP Lynx on the WP Lynx WordPress.org plugin page.

-John Havlik

[end of transmission, stay tuned]

Add a Static Breadcrumb to the Breadcrumb Trail

Posted by in Guides

In some cases WordPress may be not be running your entire site. In these instances, there may be a root above what WordPress knows about. To add a breadcrumb to represent this, you have two options.

  1. Breadcrumb NavXT Menu Magic can be used. You will need to have a ‘custom item’ menu entry that represents this off WordPress resource and is the root to all of the other menu entries.
  2. Write a little code in a site specific plugin.

The Code

The Menu Magic method is neat and does not require any code writing. However, that’s not what this article is really about. Besides, the required code is quite simple. The following code just needs to be placed in a site specific plugin (or your theme’s functions.php if that floats your boat):

add_action('bcn_after_fill', 'my_static_breadcrumb_adder');
function my_static_breadcrumb_adder($breadcrumb_trail)
{
    $breadcrumb_trail->add(new bcn_breadcrumb('STATIC_TITLE', NULL, array('home'), 'STATIC_URL', NULL, true));
}

After placing this code into your site specific plugin, you will need to update two portions of it. Replace STATIC_TITLE with the title of the resource this breadcrumb represents, and replace STATIC_URL with the URL to the resource represented by this breadcrumb. That’s it. Simple, right?

-John Havlik

[end of transmission, stay tuned]

Breadcrumb NavXT Polylang Extensions 1.0.0

Posted by in Announcements

Introducing Breadcrumb NavXT Polylang Extensions. This plugin improves Breadcrumb NavXT’s support for Polylang, at plugin that facilities multi-lingual content on WordPress based sites.

While Breadcrumb NavXT mostly works with Polylang, the deficiencies outlined in Breadcrumb NavXT and WPML Compatibility apply to compatibility with Polylang as well. With Breadcrumb NavXT Polylang Extensions, string based settings within Breadcrumb NavXT and Custom Post Type root pages are translatable within Polylang.

Features

  • Automatically links to the correct Custom Post Type “root page” for the current language
  • Makes Breadcrumb NavXT settings that are strings available for translation via Polylang
  • Improves Breadcrumb NavXT widget’s Polylang compatibility

-John Havlik

[end of transmission, stay tuned]

Breadcrumb NavXT WPML Extensions 1.1.0

Posted by in Announcements

Announcing the immediate availability of Breadcrumb NavXT WPML Extensions 1.1.0. This version switches to the WPML 3.2+ API for translating strings. Backwards compatibility with WPML 3.1 (and older) is maintained. However, users of other plugins (Polylang) that provide emulations of the WPML API may no longer work. Speaking of which, Polylang will get its own extension in early 2016. Additionally, a bug that prevented updated setting strings from Breadcrumb NavXT from showing up in the string translation screen on non-multisite installs in a timely matter.

Users with valid and activated license keys should receive an update notification within the WordPress dashboard and be able to use the update mechanism to update (just like with any plugin in the WordPress.org repository).

-John Havlik

[end of transmission, stay tuned]