Your IP : 216.73.216.196
<?php
/**
* @package OSMap
* @contact www.joomlashack.com, help@joomlashack.com
* @copyright 2007-2014 XMap - Joomla! Vargas - Guillermo Vargas. All rights reserved.
* @copyright 2016-2021 Joomlashack.com. All rights reserved.
* @license https://www.gnu.org/licenses/gpl.html GNU/GPL
*
* This file is part of OSMap.
*
* OSMap 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.
*
* OSMap is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with OSMap. If not, see <https://www.gnu.org/licenses/>.
*/
namespace Alledia\OSMap\Sitemap;
use Alledia\OSMap\Factory;
use Alledia\OSMap\Helper\General;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\Registry\Registry;
defined('_JEXEC') or die();
/**
* Sitemap items collector
*/
class Collector
{
/**
* @var SitemapInterface
*/
protected $sitemap;
/**
* @var array
*/
protected $uidList = [];
/**
* @var array
*/
protected $urlHashList = [];
/**
* Callback used to trigger the desired action while fetching items.
* This is only used in the legacy method printNode, which is called by
* the osmap plugins to process the additional items.
*
* @var callable
*/
protected $printNodeCallback;
/**
* The current view: xml or html. Kept for backward compatibility with
* the legacy plugins. It is always XML since the collector is generic now
* and needs to have the information about the item's level even for the
* XML view in the Pro version
*
* @var string
*/
public $view = 'xml';
/**
* Legacy property used by some plugins. True if we are collecting news.
*
* @var string
*
* @deprecated
*/
public $isNews = false;
/**
* The items counter.
*
* @var int
*/
protected $counter = 0;
/**
* The custom settings for items
*
* @var array
*/
protected $itemsSettings;
/**
* The legacy custom settings for items. Which will be upgraded
*
* @var array
*/
protected $legacyItemsSettings;
/**
* If false, say that any next sub-level should be unpublished
*
* @var mixed
*/
protected $unpublishLevel = false;
/**
* @var array
*/
protected $tmpItemDefaultSettings = [
'changefreq' => 'weekly',
'priority' => '0.5'
];
/**
* The current items level
*
* @var int
*/
protected $currentLevel = 0;
/**
* The reference for the instance of the current menu for item and its
* subitems.
*
* @var object
*/
protected $currentMenu;
/**
* The ID of the current menu item for nodes
*
* @var int
*/
protected $currentMenuItemId;
/**
* The component's params
*
* @var Registry
*/
public $params;
/**
* Collector constructor.
*
* @param SitemapInterface $sitemap
*
* @return void
* @throws \Exception
*/
public function __construct(SitemapInterface $sitemap)
{
$this->sitemap = $sitemap;
$this->params = ComponentHelper::getParams('com_osmap');
/*
* Try to detect the current view. This is just for backward compatibility
* for legacy plugins. New plugins doesn't need to know what is the view.
* They always calculate the visibility for both views and the view is
* the one who decides to whow or not. If not equals HTML, is always XML.
*/
$inputView = Factory::getPimpleContainer()->input->get('view', 'xml');
if ($inputView === 'html') {
$this->view = 'html';
}
}
/**
* Collects sitemap items based on the selected menus. This is the main
* method of this class. For each found item, it will call the given
* callback, so it can manipulate the data in many ways. It returns the
* total of found items.
*
* @param callable $callback
*
* @return int
* @throws \Exception
*/
public function fetch($callback)
{
$menus = $this->getSitemapMenus();
$this->counter = 0;
if ($menus) {
$this->getLegacyItemsSettings();
$this->getItemsSettings();
foreach ($menus as $menu) {
$this->currentMenu = &$menu;
$items = $this->getMenuItems($menu);
foreach ($items as $item) {
if ($this->itemIsBlackListed($item)) {
$item = null;
continue;
}
// Store the current menu item id. Added to use it while defining the node's settings hash, so same
// items, but from different menus can have individual settings
$this->currentMenuItemId = $item['id'];
// Set the menu item UID. The UID can be changed by 3rd party plugins, according to the content
$item['uid'] = 'menuitem.' . $item['id'];
// Store the menu settings to use in the submitItemToCallback called by callbacks
$this->tmpItemDefaultSettings['changefreq'] = $menu->changefreq;
$this->tmpItemDefaultSettings['priority'] = $menu->priority;
// Check the level of menu
$level = (int)$item['level'] - 1;
if ($level !== $this->currentLevel) {
$this->changeLevel($level - $this->currentLevel);
}
// Submit the item and prepare it calling the plugins
$this->submitItemToCallback($item, $callback, true);
// Internal links can trigger plugins to grab more items
// The child items are not displayed if the parent item is ignored
if ($item->isInternal && !$item->ignore) {
// Call the plugin to get additional items related to it
$this->callPluginsGetItemTree($item, $callback);
}
// Make sure the memory is cleaned up
$item = null;
}
$items = [];
unset($items);
}
$menu = null;
}
$this->currentMenu = null;
$this->tmpItemDefaultSettings = [];
$callback = null;
return $this->counter;
}
/**
* Submit the item to the callback, checking duplicity and incrementing
* the counter. It can receive an array or object and returns true or false
* according to the result of the callback.
*
* @param array|object $item
* @param callable $callback
* @param bool $prepareItem
*
* @return bool
* @throws \Exception
*/
public function submitItemToCallback(&$item, $callback, $prepareItem = false)
{
$currentMenuItemId = $this->getCurrentMenuItemId();
// Add the menu information
if (is_array($item)) {
$item['menuItemId'] = $this->currentMenu->id;
$item['menuItemTitle'] = $this->currentMenu->name;
$item['menuItemType'] = $this->currentMenu->menutype;
} else {
$item->menuItemId = $this->currentMenu->id;
$item->menuItemTitle = $this->currentMenu->name;
$item->menuItemType = $this->currentMenu->menutype;
}
// Converts to an Item instance, setting internal attributes
$item = new Item($item, $currentMenuItemId);
if ($prepareItem) {
// Call the plugins to prepare the item
$this->callPluginsPreparingTheItem($item);
}
// Make sure to have the correct date format (UTC)
$item->setModificationDate();
$item->setAdapter();
$item->visibleForRobots = $item->adapter->checkVisibilityForRobots();
// Set the current level to the item
$item->level = $this->currentLevel;
$this->setItemCustomSettings($item);
$this->checkParentIsUnpublished($item);
$this->checkDuplicatedUIDToIgnore($item);
// Verify if the item can be displayed to count as unique for the XML sitemap
if (
!$item->ignore
&& $item->published
&& $item->visibleForRobots
&& (!$item->duplicate || !$this->params->get('ignore_duplicated_uids', 1))
) {
// Check if the URL is not duplicated (specially for the XML sitemap)
$this->checkDuplicatedURLToIgnore($item);
if (!$item->duplicate || !$this->params->get('ignore_duplicated_uids', 1)) {
++$this->counter;
}
}
return (bool)call_user_func_array($callback, [&$item]);
}
/**
* Gets the list of selected menus for the sitemap.
* It returns a list of objects with the attributes:
* - name
* - menutype
* - priority
* - changefrq
* - ordering
*
* @return array;
* @throws \Exception
*/
protected function getSitemapMenus()
{
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select([
'mt.id',
'mt.title AS ' . $db->quoteName('name'),
'mt.menutype',
'osm.changefreq',
'osm.priority',
'osm.ordering'
])
->from('#__osmap_sitemap_menus AS osm')
->join('LEFT', '#__menu_types AS mt ON (osm.menutype_id = mt.id)')
->where('osm.sitemap_id = ' . $db->quote($this->sitemap->id))
->order('osm.ordering');
return $db->setQuery($query)->loadObjectList('menutype');
}
/**
* Get the menu items as a tree
*
* @param object $menu
*
* @return array
* @throws \Exception
*/
protected function getMenuItems($menu)
{
$container = Factory::getPimpleContainer();
$db = $container->db;
$app = $container->app;
$lang = $container->language;
$query = $db->getQuery(true)
->select([
'm.id',
'm.title AS ' . $db->quoteName('name'),
'm.alias',
'm.path',
'm.level',
'm.type',
'm.home',
'm.params',
'm.parent_id',
'm.browserNav',
'm.link',
'1 AS ' . $db->quoteName('isMenuItem'), // Say that the menu came from a menu
'0 AS ' . $db->quoteName('ignore') // Flag that allows child classes choose to ignore items
])
->from('#__menu AS m')
->join('INNER', '#__menu AS p ON (p.lft = 0)')
->where([
'm.menutype = ' . $db->quote($menu->menutype),
'm.published = 1',
sprintf('m.access IN (%s)', General::getAuthorisedViewLevels()),
'm.lft > p.lft',
'm.lft < p.rgt'
])
->order('m.lft');
if ($app->isClient('site')) {
if ($app->getLanguageFilter()) {
$languageTags = array_map([$db, 'quote'], [$lang->getTag(), '*']);
$query->where(sprintf('m.language IN (%s)', join(',', $languageTags)));
}
}
$items = $db->setQuery($query)->loadAssocList();
if ($this->params->get('ignore_hidden_menus', false)) {
$items = array_filter(
$items,
function ($menu) {
$params = json_decode($menu['params']);
if (isset($params->menu_show) && $params->menu_show == 0) {
return false;
}
return true;
}
);
}
return $items;
}
/**
* Checks if the item's uid was already registered. If positive, set the
* item to be ignored and return true. If negative, register the item and
* return false.
*
* @param object $item
*
* @return bool
*/
protected function checkDuplicatedUIDToIgnore($item)
{
// If is already set, interrupt the flux and ignore the item
if (isset($this->uidList[$item->uid])) {
$item->duplicate = true;
if ($this->params->get('ignore_duplicated_uids', 1)) {
$item->addAdminNote('COM_OSMAP_ADMIN_NOTE_DUPLICATED_IGNORED');
} else {
$item->addAdminNote('COM_OSMAP_ADMIN_NOTE_DUPLICATED');
}
return true;
}
// Not set and published, so let's register
if ($item->published && $item->visibleForRobots && !$item->ignore) {
$this->uidList[$item->uid] = 1;
}
return false;
}
/**
* Checks if the item's full link was already registered. If positive,
* set the item to be ignored and return true. If negative, register the item and return false
*
* @param object $item
*
* @return bool
* @throws \Exception
*/
protected function checkDuplicatedURLToIgnore($item)
{
if (!empty($item->fullLink)) {
$container = Factory::getPimpleContainer();
// We need to make sure to have a URL free of hash chars
$url = $container->router->removeHashFromURL($item->fullLink);
$hash = $container->router->createUrlHash($url);
if (isset($this->urlHashList[$hash])) {
$item->duplicate = true;
$item->addAdminNote('COM_OSMAP_ADMIN_NOTE_DUPLICATED_URL_IGNORED');
return true;
}
// Not set and published, so let's register
if ($item->published && $item->visibleForRobots && !$item->ignore) {
$this->urlHashList[$hash] = 1;
}
}
return false;
}
/**
* Calls the respective OSMap and XMap plugin, according to the item's
* component/option. If the plugin's method returns false, it will set
* the item's ignore attribute to true.
*
* @param Item $item
*
* @return void
* @throws \Exception
*/
protected function callPluginsPreparingTheItem($item)
{
$plugins = General::getPluginsForComponent($item->component);
foreach ($plugins as $plugin) {
$className = '\\' . $plugin->className;
if (method_exists($className, 'prepareMenuItem')) {
if ($plugin->isLegacy) {
$params = $plugin->params->toArray();
} else {
$params =& $plugin->params;
}
$arguments = [
&$item,
&$params
];
// If a legacy plugin doesn't specify this method as static, fix the plugin to avoid warnings
$result = General::callUserFunc(
$className,
$plugin->instance,
'prepareMenuItem',
$arguments
);
// If a plugin doesn't return true we ignore the item and break
if ($result === false) {
$item->set('ignore', true);
break;
}
}
$plugin = null;
}
}
/**
* Calls the respective OSMap and XMap plugin, according to the item's
* component/option. Get additional items and send to the callback.
*
* @param Item $item
* @param Callable $callback
*
* @return void
* @throws \Exception
*/
protected function callPluginsGetItemTree($item, $callback)
{
$this->printNodeCallback = $callback;
// Call the OSMap and XMap legacy plugins
$plugins = General::getPluginsForComponent($item->component);
foreach ($plugins as $plugin) {
$className = '\\' . $plugin->className;
if (method_exists($className, 'getTree')) {
if ($plugin->isLegacy) {
$params = $plugin->params->toArray();
} else {
$params = $plugin->params;
}
$arguments = [
&$this,
&$item,
&$params
];
General::callUserFunc(
$className,
$plugin->instance,
'getTree',
$arguments
);
}
}
}
/**
* Returns true if the link of the item is in the blacklist array.
*
* @param array $item
*
* @return bool
*/
protected function itemIsBlackListed($item)
{
$blackList = [
'administrator' => 1
];
$link = $item['link'];
return isset($blackList[$link]);
}
/**
* This method is used for backward compatibility. The plugins will call
* it. In the legacy XMap, its behavior depends on the sitemap view type,
* only changing the level in the HTML view. OSMap will always consider the
* level of the item, even for XML view. XML will just ignore that.
*
* @param int $step
*
* @return void
*/
public function changeLevel($step)
{
if (is_numeric($step)) {
$this->currentLevel += (int)$step;
}
}
/**
* Method called by legacy plugins, which will pass the new item to the
* callback. Returns the result of the callback converted to boolean.
*
* @param object $node
*
* @return bool
* @throws \Exception
*/
public function printNode($node)
{
return $this->submitItemToCallback($node, $this->printNodeCallback);
}
/**
* This method gets the settings for all items which have custom settings.
*
* @return array;
*/
protected function getItemsSettings()
{
if (empty($this->itemsSettings)) {
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select([
'*',
sprintf(
'IF (IFNULL(settings_hash, %1$s) = %1$s, uid, CONCAT(uid, %2$s, settings_hash)) AS %3$s',
$db->quote(''),
$db->quote(':'),
$db->quoteName('key')
)
])
->from('#__osmap_items_settings')
->where('sitemap_id = ' . $db->quote($this->sitemap->id))
->where($db->quoteName('format') . ' = 2');
$this->itemsSettings = $db->setQuery($query)->loadAssocList('key');
}
return $this->itemsSettings;
}
/**
* Gets the item custom settings if set. If not set, returns false.
*
* @param string $key
*
* @return array[]|false
*/
public function getItemCustomSettings($key)
{
if (isset($this->itemsSettings[$key])) {
return $this->itemsSettings[$key];
}
return false;
}
/**
* This method gets the legacy settings for all items to be loaded avoiding
* lost the custom settings for items after the migration to v4.2.1.
*
* @return array
*/
protected function getLegacyItemsSettings()
{
if (!isset($this->legacyItemsSettings)) {
$db = Factory::getDbo();
$query = $db->getQuery(true)
->select('*')
->from('#__osmap_items_settings')
->where('sitemap_id = ' . $db->quote($this->sitemap->id))
->where($db->quoteName('format') . ' IS NULL');
$this->legacyItemsSettings = $db->setQuery($query)->loadAssocList('uid');
}
return $this->legacyItemsSettings;
}
/**
* Returns the settings based on the UID only. Used when we have legacy
* settings on the database.
*
* @param string $uid
*
* @return array[]|false
*/
protected function getLegacyItemCustomSettings($uid)
{
if (isset($this->legacyItemsSettings[$uid])) {
return $this->legacyItemsSettings[$uid];
}
return false;
}
/**
* Sets the item's custom settings if exists. If no custom settings are
* found and is a menu item, use the menu's settings. If is s subitem
* (from plugins), we consider it already set the respective settings. But
* if there is a custom setting for the item, we use that overriding what
* was set in the plugin.
*
* @param Item $item
*
* @return void
*/
public function setItemCustomSettings($item)
{
// Check if the menu item has custom settings. If not, use the values from the menu
// Check if there is a custom settings specific for this URL. Sometimes the same page has different URLs.
// We can have different settings for items with the same UID, but different URLs
$key = $item->uid . ':' . $item->settingsHash;
$settings = $this->getItemCustomSettings($key);
// Check if there is a custom settings for all links with that UID (happens right after a migration from
// versions before 4.0.0 or before 4.2.1)
if ($settings === false) {
$settings = $this->getLegacyItemCustomSettings($item->uid);
// The Joomla plugin changed the UID
// from joomla.archive => joomla.archive.[id] and joomla.featured => joomla.featured[id]
// So we need to try getting the settings from the old UID
if ($settings === false) {
if (preg_match('/^joomla.(archive|featured)/', $item->uid, $matches)) {
$settings = $this->getLegacyItemCustomSettings('joomla.' . $matches[1]);
}
}
}
if ($settings === false) {
// No custom settings, so let's use the menu's settings
if ($item->isMenuItem) {
$item->changefreq = $this->tmpItemDefaultSettings['changefreq'];
$item->priority = $this->tmpItemDefaultSettings['priority'];
}
} else {
// Apply the custom settings
$item->changefreq = $settings['changefreq'];
$item->priority = (float)$settings['priority'];
$item->published = (bool)$settings['published'];
}
}
/**
* Check if the parent is unpublished or ignored and makes sure to ignore any item on it's sublevel
*
* @param Item $item
*
* @return void
*/
protected function checkParentIsUnpublished($item)
{
// Check if this item belongs to a sub-level which needs to be unpublished
if ($this->unpublishLevel !== false && $item->level > $this->unpublishLevel) {
$item->set('published', false);
$item->addAdminNote('COM_OSMAP_ADMIN_NOTE_PARENT_UNPUBLISHED');
}
// If the item is unpublished and the 'ignore' level is false, mark the level to ignore sub-items
$displayable = $item->published
&& !$item->ignore
&& (!$item->duplicate || !$this->params->get('ignore_duplicated_uids', 1));
if (!$displayable && $this->unpublishLevel === false) {
$this->unpublishLevel = $item->level;
}
// If the item won't be ignored, make sure to reset the 'ignore' level
if (
$item->published
&& !$item->ignore
&& (!$item->duplicate || !$this->params->get('ignore_duplicated_uids', 1))
) {
$this->unpublishLevel = false;
}
}
/**
* Returns the current menu item id
*
* @return int
*/
public function getCurrentMenuItemId()
{
return $this->currentMenuItemId;
}
/**
* Removes circular reference
*/
public function cleanup()
{
$this->sitemap = null;
$this->printNodeCallback = null;
$this->params = null;
$this->currentMenu = null;
}
}