Extension:GeoCrumbs
| GeoCrumbs Release status: stable |
|
|---|---|
| Implementation | API |
| Description | Adds a trail of bread crumbs to the page |
| Author(s) | Roland Unger, Hans Musil, and Matthias Mullie |
| Latest version | 2.0.1 |
| MediaWiki | >= 1.42 |
| PHP | 5.4+ |
| Database changes | No |
| License | GNU General Public License 2.0 or later |
| Download | README |
| Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Translate the GeoCrumbs extension if it is available at translatewiki.net | |
| Issues | Open tasks · Report a bug |
The GeoCrumbs extension, formerly known as BreadCrumbs adds a trail of bread crumbs to the page. See https://en.wikivoyage.org/wiki/Wikivoyage:Breadcrumb_navigation or other Wikivoyage sites for more information.
Installation
- <translate> [[<tvar name=2>Special:ExtensionDistributor/GeoCrumbs</tvar>|Download]] and move the extracted <tvar name=name>
GeoCrumbs</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
<translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/GeoCrumbs - <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php</tvar> file:</translate>
wfLoadExtension( 'GeoCrumbs' );
- File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>
Usage
This extension provides a new MediaWiki parser function named "isin".
It expects one argument, the name of the article where the current article "is in".
During parsing of the wiki markup, some few data related to the isin function's argument are generated and stored in the parser cache.
When the article is displayed, its HTML code has to be built from the parser cache.
The BreadCrumbs extension has a method triggered by the 'OutputPageParserOutput' hook.
Here, the complete bread crumb trail is build up by starting with the article's own isin and retrieving subsequently higher level isin data from the corresponding parser caches.
The HTML code of the bread crumb trail is added to the page's subtitle.
Example:
{{#isin:Europe}}
The country of Spain is part of Europe.
| File:Wikimedia-logo black.svg | <translate> This {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is being used on one or more [[<tvar name=2>m:Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]].</translate> <translate> This probably means that the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is stable and works well enough to be used by such high-traffic websites.</translate> <translate> Look for this {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension's|skin's}} name in Wikimedia's <tvar name=2>CommonSettings.php</tvar> and <tvar name=3>InitialiseSettings.php</tvar> configuration files to see where it's installed.</translate> <translate> A full list of the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extensions|skins}} installed on a particular wiki can be seen on the wiki's <tvar name=ver>Special:Version</tvar> page.</translate> |
| File:OOjs UI icon information-progressive.svg |
- Pages with script errors
- Pages with broken file links
- Stable extensions
- Extensions without an image
- API extensions
- Extensions without a compatibility policy
- GPL licensed extensions
- Extensions in Wikimedia version control
- OutputPageParserOutput extensions
- ParserAfterTidy extensions
- ParserFirstCallInit extensions
- All extensions
- Extensions used on Wikimedia
- Breadcrumbs extensions
