Table of Contents
HtmlMetaTags Plugin
Compatible with DokuWiki
- 2024-02-06 "Kaos" yes
- 2023-04-04 "Jack Jackrum" yes
- 2022-07-31 "Igor" yes
- 2020-07-29 "Hogfather" yes
Similar to meta, socialcards
Description
This plugin enriches the html page with all meta tags what you want, e.g. keywords, description and any others. Some meta information are very usefull for web crawlers for indexing and categorizing the page.
Extends with V2.0: This version allow you to add :
- open graph metatags like og:description, og:image…
- link to media file. tags must start with media-
- media-og:image=(:wiki:image.jpg)
- multiple calls to htmlmetatags all values will be added
Note: The Initial version of this plugIn is not compatible to the new V2.xy. The difference of attribute to value splitter is changed from ':' to '='.
{{htmlmetatags>metatag-keywords=(values) metatag-og:description=(open graph description.)}}
Note: Linebreaks can add inside the {{ }} without any trouble.
{{htmlmetatags>metatag-keywords=(values) metatag-og:description=(open graph description.) }}
Syntax
With the string {{htmlmetatags>...}}
on the page level you activate the plugin. The leading string “metatag-” marks a tag for the web site. After this leading string followed the key from tag. In =(...)
write the value of the tag.
Also, the plugin is on page level.
Example to activate the plugin on your page write:
{{htmlmetatags>metatag-mytag=(some usefull text)}}
The meta tag: mytag is any word. This word is the name of the new meta tag, e.g. keyword. Followed on this name is to write =
with ('...')
. This brackets contains the text required for the value of the new meta tag.
You can write more than once meta tag on the page separate by space.
{{htmlmetatags>metatag-robots=() metatag-keywords=(apfel,bananne,birne) metatag-description=(Allgemeiner Obstbauer) metatag-media-og:image=(:wiki:image.jpg) metatag-og:description=(anything else) metatag-og:any=(anything else 2) }}
The result on web page is:
<meta name="robots" content="noindex,nofollow"/> <meta name="keywords" content="apfel,bananne,birne"/> <meta name="description" content="Allgemeiner Obstbauer"/> <meta property="og:image" content="http://localhost/lib/exe/fetch.php?media=wiki:image.jpg"/> <meta property="og:description" content="anything else"/> <meta property="og:any" content="anything else 2"/>
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Download the plugin at htmlmetatags-master.zip and extract the zip file to the plugin folder on your dokuwiki.
Further Informtions
This section explains some usefully tips for using the plugin. Check your generated html code for the right meta tag and optimize it with this plugin. Crawlers (like google) collect their data by reading the the meta tag and then by the content. Of curse every crawler uses own algorithm for indexing the web pages.
Change Log
- Merge pull request #7 from dregad/i6-php8-warnings (2024-08-20 18:38)
- Bump version to 2024-03-04 (2024-03-04 18:33)
- Fix static analysis warnings (2024-03-04 18:25)
- Whitespace (2024-03-04 18:21)
- Fix PHP Undefined array key warning (2024-03-04 18:20)
- Merge pull request #4 from dregad/require-deprecated (2023-08-21 09:42)
- Fix deprecation warnings (2023-06-12 18:47)
- Fix line endings (CRLF -> LF) (2023-06-12 18:46)
- 2017-04-24 V2.2 make it compatible wit PHP 7
- 2017-02-08 V2.1 when no metadata is available then set/add this on page (with the given keys via this plugin)
- 2016-07-12 V2.0 add handling for open graph metatags (Eric Maeker eric [at] maeker [dot] fr)
- 2016-04-22 Change the date for “last Update”
- 2015-05-27 Initial release
FAQ
Discussion
Feature Request: Define OpenGraph image directly in an image tag
Proposal: In the spirit of Don't repeat yourself I'd prefer to not have a “metadata-container” in which I define a “metatag-media-og” attribute and define its image filepath/link only to later in the content area again having an image with its filepath placed but instead directly in my image of choice say “This is my openGraph image for that page” by a markup like this {{wiki:dokuwiki-128.png?og}}. If I have multiple images on a page, I could simply remove the og-tag from one and add it to another one. But the other method should be kept, because it allows advanced features such as using images which are not present in the page content.
In general: Thanks for providing his! Am currently researching which CMS to choose for my portfolio and am seriously considering DokuWiki as I love it's simplicity. One thing which held me back was not having OpenGraph support which is such a convenience for URL sharing in any media (messengers, social media). If that works out with your plugin, great!
— porg 2021-06-21 20:09
Thanks by Eivind
Thanks for a really helpful plugin! I have one issue: Open Graph allows for several images to be specified, but this plugin smacks them together in the same meta content. — Eivind 2016-11-28 21:48