понедельник, 28 декабря 2015 г.
ITPMeta is a Joomla! extension that manages meta data and puts semantic data in the HEAD of website pages
ITPMeta documentation and FAQ
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.
- Getting Started
- Administrator Guide
- FAQ
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.
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.2
- PHP 5.3
- MySQL 5.1
- MooTools 1.2.x
- jQuery 1.8.x
- 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 (/).
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.
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.
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.
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" >
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: This plugin is available only for ITPMeta PRO.
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.
NOTE: This plugin is available only for ITPMeta PRO.
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:
- Go to "Manage URLs"
- Find the URI of the article. If missing, create it.
- Click on "Image" that is in the slide "Open Graph Basic".
- 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:
- Enable the plugin "System - ITPMeta Tags"
- Set "Yes" for option "Open Graph Image" in the plugin "System - ITPMeta Tags"
- Open the article in "Article Manager".
- 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! contentextension (com_content).
How to translate ITPMeta?
You can translate this extension in your language using Transifex. Go to the system and sign in. FindITPMeta 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.
- Go to "System" -> "Global Configuration" -> "System" -> "Debug Settings".
- Set to "Yes" the option "Debug System".
- 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:
- Make a backup of your site ( database and files ) ( optional but highly recommended );
- Install the new version over the old one ( all previous data will be saved );
- Check the extension settings and menu items for changes;
- Check for a new version of Prism Library. If there is a new version, install it.
- 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 liketest.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?
- Uninstall ITPMeta Library from the extensions manager.
- Install Prism library.
- 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 onITPrism 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.
0 коммент.:
Отправить комментарий