Documentation: Yandex Metrica for Joomla

Documentation update date:
Documentation is relevant for version: 1.2.1

System Requirements

System requirements differ for Joomla 3, Joomla 4, Joomla 5 and Joomla 6, so please refer to the section corresponding to your version.

Joomla 3

Joomla: 3.0.0 - 3.10.x
PHP: 5.3 or higher
MySQL: 5.1 or higher
MariaDB: 10.1 or higher
PostgreSQL: 8.3.18 or higher
Memory: 128MB or higher

Joomla 4

Joomla: 4.0.0 - 4.x.x
PHP: 7.2 or higher
MySQL: 5.6 or higher
MariaDB: 10.3.35 or higher
PostgreSQL: 11.0 or higher
Memory: 128MB or higher

Joomla 5 and Joomla 6

Joomla: 5.0.0 - 5.x.x / 6.0.0 - 6.x.x
PHP: 8.1 or higher
MySQL: 8.0.11 or higher
MariaDB: 10.4 or higher
PostgreSQL: 12.0 or higher
Memory: 128MB or higher

Extension Installation

The extension installation process is slightly different for Joomla 3 and Joomla 4/5/6, so please refer to the section corresponding to your version.

Installation for Joomla 3

  1. Download the extension package.
  2. Go to the Joomla 3 administration panel.
  3. Open "Extensions" -> "Extension Manager".
  4. Click on the "Upload Package" tab.
  5. Select the downloaded extension package and click "Upload and Install".

Installation for Joomla 4, Joomla 5, and Joomla 6

  1. Download the extension package.
  2. Go to the Joomla 4/5/6 administration panel.
  3. Open "System" -> "Extensions".
  4. Click on the "Upload Package" tab.
  5. Drag and drop the downloaded extension package into the upload area or click "Select Package".
  6. Click "Upload and Install".

Extension settings

Plugin settings are located in different places depending on the Joomla version. Please use the paths below to find the plugin:

  • Joomla 3: "Extensions" -> "Plugins"
  • Joomla 4/5/6: "System" -> "Manage" -> "Plugins"

In the plugin list, find "System - IWS.BY Yandex Metrika". Click on the plugin name, and a page with available settings will open. Let's review each field below.

License Key

Enter the license key received upon purchasing the module on the IWS.BY website. Without a key in this field, the plugin will not be able to access the update server and update automatically.

Yandex Metrika Code

In this field, you must enter the Yandex Metrika service code obtained when registering your website on the Yandex Metrika portal.

Example of the service code:

<!-- Yandex.Metrika counter -->
<script type="text/javascript">
    (function(m,e,t,r,i,k,a){
        m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
        m[i].l=1*new Date();
        for (var j = 0; j < document.scripts.length; j++) {if (document.scripts[j].src === r) { return; }}
        k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)
    })(window, document,'script','https://mc.yandex.ru/metrika/tag.js', 'ym');

    ym(00000000, 'init', {webvisor:true, clickmap:true, referrer: document.referrer, url: location.href, accurateTrackBounce:true, trackLinks:true});
</script>
<noscript><div><img src="https://mc.yandex.ru/watch/00000000" style="position:absolute; left:-9999px;" alt="" /></div></noscript>
<!-- /Yandex.Metrika counter -->

Yandex Metrika Registration

The registration process and all useful information regarding website registration in Yandex Metrika are described in the official Yandex documentation, available at the following link: https://yandex.com/support/metrica/general/creating-counter.html.

Adding the Visible Counter (Informer)

Yandex Metrika allows you to publish an informer with analytical data on your website pages. To do this, you need to configure Yandex Metrika and create a module on your site.

Enabling the informer in Yandex Metrika

Go to the integration code settings for your website's counter. To do this, click on "Settings" -> "Counters" in the left menu of Yandex Metrika.

Counter settings section in the Yandex Metrika interface

Scroll down the page to the "Additional settings" section.

Additional counter settings in Yandex Metrika

In the additional settings block that appears, check the box next to "Informer" (Visible counter).

Enabling the informer in Yandex Metrika counter settings

The informer will appear below, along with a "Customize" button next to it. Customize the informer to suit your website's design.

Customizing the Yandex Metrika counter informer design

Click the "Save" button to save all Yandex Metrika settings.

Saving counter settings in Yandex Metrika

Now scroll the screen to the "Counter code" area and copy the informer code from the block. The code is located between <!-- Yandex.Metrika informer --> and <!-- /Yandex.Metrika informer -->.

The code should look like this:

<!-- Yandex.Metrika informer -->
<a href="https://metrika.yandex.ru/stat/?id=00000000&amp;from=informer" target="_blank" rel="nofollow">
    <img src="https://informer.yandex.ru/informer/88141256/3_1_FFFFFFFF_EFEFEFFF_0_pageviews"
         style="width:88px; height:31px; border:0;"
         alt="Yandex.Metrika"
         title="Yandex.Metrika: data for today (pageviews, visits, and unique visitors)"
         class="ym-advanced-informer" data-cid="00000000" data-lang="en" />
</a>
<!-- /Yandex.Metrika informer -->

After copying the code, proceed to the next section of the instructions.

Creating a module on the website

In the Joomla administrator panel, go to the Module Manager.

Click the "New" button to open the module creation interface. In the window that opens, select the "Custom" (Custom HTML) module type. The page for adding an HTML module to your website will open. Fill in the "Title" field.

In the "Custom Output" (HTML code) field, paste the informer code from Yandex Metrika that you copied in the previous chapter.

Custom HTML code field in Joomla

If the field appears as a rich text editor, click on "Toggle Editor" or "Source Code" (usually represented by a < > icon or "Tools" -> "Source code") in the editor's toolbar.

Adding HTML code in the Joomla editor

A pop-up window with a text field will appear. Paste the informer code generated by Yandex Metrika into this field and click the "OK" button at the bottom right. The Yandex Metrika informer image will appear in the text editor.

Yandex Metrika informer in the Joomla editor
On the right side of the module creation page, select the "Position" where the informer will be displayed on the site, and set the "Status" option to "Published". Next, switch to the "Menu Assignment" tab. In the "Module Assignment" field, select "On all pages". Finally, click the "Save & Close" button on the module creation page. The module will now display the visitor informer on your website.

Extension update error

If you encounter an error when updating an extension in the Joomla control panel, this section of the instructions is for you.

Error appears in several cases, all of which are related to the extension's license key.

1) You have not filled in the license key in the extension settings.

Go to the extension settings and check if the "License key" field is filled in. Without a license key, it is not possible to download updates. Sometimes, you may have added a license key, but the Joomla CMS did not save it correctly. In this case, in the extension settings, after entering the license key, click "Save" and then click "Save & Close".

2) Your license key has expired.

To check the expiration date of your license key, go to https://iws.by/en/my-account/view-license-keys. In the list of license keys, find the key for your extension and check its validity in the "Valid until" column. If the license key has expired, it is not possible to get updates. To resolve this issue, place a new order and obtain a current license key.

3) The license key is not valid on your current site.

Our update system is designed so that the first time you access the update server, the license key is assigned to the site that requested it. If you try to use the license key on multiple sites, updates will be available for only one site. If you need updates for multiple sites, purchase multiple license keys on our website. Sites without license keys will not be able to receive updates.

Attention! If you have changed your site's address and cannot download updates, write to us at support@iws.by with the new site address. We will update the data on our update server, and within 24 hours you will be able to receive updates.

Support

IWS.BY support service for questions regarding our products is available via email: support@iws.by.

All available support options are available on the Support page: Go to.

Webpay Mastercard Mastercard ID Check Visa Visa Secure
SSL Secure Secure Payments

Individual entrepreneur Alexander Igorevich Berezuev, Republic of Belarus, Vetka.

Certificate of state registration No. 490772447 was issued by the Vetka District Committee on August 15, 2013.

Reproduction of materials from IWS.BY in whole or in part without the written permission of IWS.BY is prohibited.

The site is registered in the Commercial Register of the Republic of Belarus on July 27, 2015 № 280215

Telephone number of employees of local executive and administrative bodies at the place of state registration of IWS.BY, authorised to consider applications of buyers: 8 02330 44345.

The book of comments and suggestions is located at the address: Republic of Belarus, Vetka, Lenina str. 20.

© 2013-2026 IWS.BY. All rights reserved.
Sign in