ITPMeta is a Joomla! extension that manages meta data and puts semantic data in the HEAD of website pages. There are predefined Open Graph, Facebook, Twitter, Google, Dublin Core and SEO tags. This is a documentation and answers of frequently asked questions of ITPMeta.

Additional Information

You can find additional information about ITP Meta on the following pages.

Download and install

I guess, you have already installed Joomla! and now you have to download ITPMeta package, which is specific for your Joomla version.

Go to "Extension Manager" and install the package.

Joomla! extension manager

If you are installing the extension for the first time, you will see a list of installed libraries, plugins and modules. You will also see a list of minimum requirements. If the system displays red indicators for unfulfilled requirement, it will be good to find a way to fix it.

Requirements

You must install Prism Library because the extension needs it to work properly.

Technical Requirements

The minimum requirements to run the extension properly are:

  • Joomla! v3.4
  • PHP 5.5
  • MySQL 5.1
  • jQuery 1.9
  • cURL, fopen
  • Magic Quotes disabled

Manage URLs and tags

This is a manger of URLs that contains a list of Internet addresses from your site. You can create, edit or delete these addresses using buttons, which are on the right side of the manager.

When you create a record, you will be able to add META tags to that address. These tags will refer only to this page. They will be added to the source code when page be loaded.

01.To add an URL you have to click on the button "New". Enter the URI into the field "URI string". You should get the URI from the page address that you have been loaded.

For example:

If your URL is "http://itprism.com/blog/25-seo-infographic", you have to use "/blog/25-seo-infographic".

Select a status and save. If you select "Published" the system will load the data for this URI. If you select "Unpublished", that means this record is inactive and the system won't put any tags into the page code.

NOTE: The URI has to start with a slash (/).

Adding new URL

02. You have created a new record and now you are seeing a list with META tags. The list has to be displayed on the right side on the page.

Open Graph meta tags

03. When you click on a tag, the system will fill the text fields, which are on the left side. Those fields contain the code of the selected tag.

If you see a structure like this "{PAGE_TITLE}", that means you have to replace that string with your data.

Now, enter your value into text area "Content" and the system will put your value into the right place.

When you are done, save the data.

Adding a new meta tag

04. When click on save button,  new tag will be added in the list of existing ones. If you want to edit the tag, just click on it or on content text.

Meta tags list

 

Reorder tags

If you want to reorder tags you should drag and drop them in the position you want. Click on the icon that is on the left side of tag and drag it to new position.

Auto Update

If you enable this functionality, the system will update content of existing tags automatically.

NOTE: This option works for plugin "System - ITPMeta  Tags", which collects data and generates tags.

Example:

There is a tag "og:title" assigned to URI of an article. 

If you edit the title of that article and the option "Auto Update" is enabled, the system will get the new title and will store it to the tag.

If you want to use a custom title, you can replace the content of the tag with yours and disable the option "Auto Update."  Thus, you will prevent its automatic update, because the system updates content if there is difference.

Scripts

Using this functionality if you want to put any data in the code of specific page. You are able to put the code after opening BODY tag or before closing BODY tag.

Example:

You want to put Google Analytics with particular parameters that will collect analytics data for specific page. So, you can use this functionality.

Global tags

There are tags like "og:site_name" and "fb:admins" that have to be added in the code of everyone page. So, the tags managed by "Global tags"will be included in each page of your website.

Plug-ins

Plug-ins add additional features on the website. ITPMeta comes with several plugins and you can find them on the "Plug-in Manager". Enable those that you would like to use.

Plugin "System - ITPMeta"

This plugin adds predefined tags to the code of pages and puts schemas into the <HTML> tag.

Options

Tags position

You are able to select the position of the tags where they will be added.

  • standard position - the system follows the queue of adding meta data.
  • after <head> tag - the tags will be added immediately after open <HEAD> tag.
  • after <title> tag - the tags will be added immediately after the <TITLE> tag.

Schemas

The schemas describe element in the HTML code. The browser needs these schemas to learn more about tags that are in the code. So, we need to put a link to OpenGraph or Facebook schemas in the HTML tag.

You can add that data by selecting one of the options - "Yes" or "No", and the system will put following string to the code of web page.

prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# article: http://ogp.me/ns/article# blog: http://ogp.me/ns/blog#"

The HTML tag becomes something like that

<html prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# article: http://ogp.me/ns/article# blog: http://ogp.me/ns/blog#" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-gb" lang="en-gb" dir="ltr" >

ITPMeta settings

Plugin "System - ITPMeta URLs"

This plugin collects URLs automatically and stores them to the extension.

Options

Collection type

This option sets the way used for collection URLs.

  • Full - collects all links.
  • Strict - collects links that are connected with a menu item. This option is recommended.

New link state

With this option, you give the status of the new links (published or unpublished), collected by the system. So, if you select "published," all new URIs will be active.

Autoupdate state

This option set status of URL options "Auto-Update". If you select "On" all new URIs will be stored with active auto-update functionality.

NOTE: You can dowload this plugin from our member site.

Plugin "System - ITPMeta - Tags"

This plugin collects data from Joomla! extensions and generates OpenGraph, Twitter Card or SEO tags.

Example:

If you want to generate "og:title" tag, enable the option "Open Graph Title." The system will get a title from an article and will add/update the tag.

Parameters

  • Default Image - the system will generate meta tag that points to default image if it is missing an intro image in the item options.
  • Generate Meta Description - the system will generate meta description from item description, if there are no predefined one.
  • Extract Image - the system will parse the item description and will use the first image in the meta tag that points to a picture of an article.
  • Auto-update Period - specify a period in days in which the system will check the meta tags for changes. If you leave this option blank, the system will check for changes every time when someone open a page.

NOTE: You can dowload this plugin from our member site.

How to set a picture that will be used when someone shares an article?

If you want to provide an image that will be used when someone clicks on the button "Like" or "Send", you have to add Open Graph image ( og:image ) tag to URI of that article. Follow next steps:

  1. Go to "Manage URLs"
  2. Find the URI of the article. If missing, create it.
  3. Click on "Image" that is in the slide "Open Graph Basic".
  4. Enter a link to the image in field "Content" and save.

If you use ITPMeta PRO and want the system to generate Open Graph image automatically, you should follow next steps:

  1. Enable the plugin "System - ITPMeta Tags"
  2. Set "Yes" for option "Open Graph Image" in the plugin "System - ITPMeta Tags"
  3. Open the article in "Article Manager".
  4. Select a picture using options "Images and Links". ITPMeta will use these pictures to generate Open Graph image tag.

NOTE: This process describes how to provide pictures when using native Joomla! content extension (com_content).

How to translate ITPMeta?

You can translate this extension in your language using Transifex. Go to the system and sign in. Find ITPMeta translation project and start translating. If you need more information, read the article "How to translate ITPrism extensions in your language?"

You can also use ITP Transifex to create language packages.

How to debug the extension and catch an error?

If there is a problem with the extension and the system does not display error messages, you should debug it. That will give you more information about the problem.

  1. Go to "System" -> "Global Configuration" -> "System" -> "Debug Settings".
  2. Set to "Yes" the option "Debug System".
  3. Now go to tab "Server" and set option "Error Reporting" to maximum.

Now, the system should display information about the error.

You can also check log files in folder "/logs" or the log file "error_log" in your main folder.

How to upgrade the extension?

The better way to upgrade the extensions is:

  1. Make a backup of your site ( database and files ) ( optional but highly recommended );
  2. Install the new version over the old one ( all previous data will be saved );
  3. Check the extension settings and menu items for changes;
  4. Check for a new version of Prism Library. If there is a new version, install it.
  5. You should also upgrade all other plugins, which work with ITPMeta.

It is a good practice to have a copy of your website on a subdomain. It can be something like test.mywebsite.com. You should upgrade ITPMeta on this test site first. That will be useful for you because you will be able to explore the newest features and configuration options. When all is OK, you will know how to upgrade the extension on your production website fast.

How to upgrade to version 4.0?

  1. Uninstall ITPMeta Library from the extensions manager.
  2. Install Prism library.
  3. Install version 4.0 over old one.

How to get support?

You can post issues on ITPMeta Git repository.  If you have any questions, you can send me a mail from the contact form. If you need premium support you are able to subscribe for my premium services on ITPrism members site.

How to get FREE support?

You can report issues on ITPMeta GitHub repository.

If you have any questions, you can send them to me, using the contact form. Please, send me a message with only one question. When I answer you, you will be able to send me your next one.

Share this post

Submit to DeliciousSubmit to DiggSubmit to FacebookSubmit to Google PlusSubmit to StumbleuponSubmit to TechnoratiSubmit to TwitterSubmit to LinkedIn

Free Subscription

You can get the latest publication via RSS, Twitter or Facebook. And I can also deliver last news to you for free via Email:

RSS subscription Find us on Facebook Google+ page Follow me