glFusion Wiki

Site Tools


glfusion:plugins:metatags:start

MetaTags Plugin for glFusion

Metatags plugin which allows you to set keywords and description meta tags in each article and staticpages.

Overview

Meta data is defined by W3Schools as:

The <meta> tag provides metadata about the HTML document. Metadata will not be displayed on the page, but will be machine parsable. Meta elements are typically used to specify page description, keywords, author of the document, last modified, and other metadata. The metadata can be used by browsers (how to display content or reload page), search engines (keywords), or other web services. – Copyright 1999-2017 by Refsnes Data. All Rights Reserved.

The MetaTags Plugin allows you to define specific meta data fields in stories and static pages.

The Metatags plugin allows you to set

<meta name=“keywords” content=“some,key,words”>

and

<meta name="description" content="Some description">

meta tags in HTML <head> section according to the page content. Currently meta tags are supported in articles and staticpages.

Usage

he Metatags plugin uses glFusion's autolink feature. If you have disabled it, please enable the feature in Configuration UI (Miscellaneous - Miscellaneous - Disable Autolinks).

In an article or a staticpage, if you write [meta:key comma_separated_keywords] as an autotag, this tag will be converted into

<meta name="keywords" content="comma_separated_keywords">.

For example, to have the following keywords shown in the header:

[meta:key glfusion,cms,content management system]

Would produce:

<meta name="keywords" content="glfusion,cms,content management system">.

Likewise, if you write [meta:desc description of the current page], the tag will be converted into <meta name=“description” content=“description of the current page”>. In both cases, autotags themselves are not visible in the content except for the editor(s).

For example, to place a meta description in a story, use:

[meta:desc This is a description of this story]

Would produce

<meta name="description" content="This is a description of this story">
Your keywords and description MUST NOT contain a right square bracket(']').

Configuration

Autotag name
This is the name glFusion recognizes as an autotag (meta in the above USAGE)
Replace
Keys (the label left to an textarea) will be converted into meta tag keys (the string in an textarea). For example:

key ⇒ keyword
desc ⇒ description
au ⇒ author
[meta:au Mark R. Evans]

translates to:

<meta name="author" content="Mark R. Evans">
Show tags to Editors?
By default, the meta auto tag is hidden in the rendered content. If this is set to true, then story editors will see the actual meta data when viewing the content.
Add Author
To automatically add the author&apos;s name to article pages, select &quot;true&quot; here. The metatag will be added at “LOW” priority so that any `[meta:author]` tag will override the author set in the article.
Defaults
You can create default tags that will appear on *every* page if no autotag is found.. Add an element with the desired tag name and value. Use the actual meta name value here, not the replacement key from above.

Use care with this option as duplicate metatags on your site can hurt rather than help your search engine rankings.

Once you have installed the Metatags plugin, it works well without manual configuration. However, if you would like to change the name of autotag (default value is 'meta') or keys translated into meta tag keys (default values are 'key' and 'desc'), you can set up the plugin through Configuration UI (http://yoursite/admin/configuration.php).

  • Autotag name: the name glFusion recognizes as an autotag (meta in the above USAGE)
  • Replace: keys (the label left to an textarea) will be converted into meta tag keys (the string in an textarea). For example:
      tag use  => meta tag
      key      => keyword
      desc     => description
      au       => author
    [meta:au Mark R. Evans] translates to:
    <meta name="author" content="Mark R. Evans">
  • Default keywords (comma separated): keywords used globally when no article or staticpage is displayed, e.g., at the site's homepage
  • Default description: description used globally when no article or staticpage is displayed, e.g., at the site's homepage
  • Execute PHP: When parsing static pages for the meta auto tag, should the metatags plugin execute embedded PHP? The default, and recommended setting for this is false.
  • Hide Tags for authors - By default, the meta auto tag will display in the story or staticpage only for content authors. Setting this to true will hide them completely (only visible when editing).

Installation

The MetaTags Plugin uses the glFusion automated plugin installer. Simply upload the distribution using the glFusion plugin installer located in the Plugin Administration page.

Upgrading

The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

glfusion/plugins/metatags/start.txt · Last modified: 2017/09/03 13:04 (external edit)

Page Tools