<?php
/**
* SeekQuarry/Yioop --
* Open Source Pure PHP Search Engine, Crawler, and Indexer
*
* Copyright (C) 2009 - 2026 Chris Pollett chris@pollett.org
*
* 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 3 of the License, or
* (at your option) any later version.
*
* This program 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 this program. If not, see <https://www.gnu.org/licenses/>.
*
* END LICENSE
*
* @author Chris Pollett chris@pollett.org (initial MediaJob class
* and subclasses based on work of Pooja Mishra for her master's)
* @license https://www.gnu.org/licenses/ GPL3
* @link https://www.seekquarry.com/
* @copyright 2009 - 2026
* @filesource
*/
namespace seekquarry\yioop\library\media_jobs;
use seekquarry\yioop\configs as C;
use seekquarry\yioop\library as L;
use seekquarry\yioop\models as M;
use seekquarry\yioop\library\CrawlConstants;
use seekquarry\yioop\library\FetchUrl;
use seekquarry\yioop\library\IndexShard;
use seekquarry\yioop\library\PhraseParser;
use seekquarry\yioop\library\UrlParser;
use seekquarry\yioop\models\GroupModel;
use seekquarry\yioop\controllers\CrawlController;
/**
* A media job to compute trending terms from the feed search sources, and
* to generate a list of top feed items for the landing page for the
* different subsearches displlayed on the landing page.
*/
class TrendingHighlightsJob extends MediaJob
{
/**
* Mamimum number of trending values to download in one try
*/
const MAX_VALUES_ONE_GO = 100;
/**
* Time in current epoch when feeds last updated
* @var int
*/
public $update_time;
/**
* Datasource object used to run db queries related to fes items
* (for storing and updating them)
* @var object
*/
public $db;
/**
* Initializes the last update time to far in the past so, feeds will get
* immediately updated. Sets up connect to DB to store feeds items, and
* makes it so the same media job runs both on name server and client
* Media Updaters
*/
public function init()
{
$this->update_time = 0;
$db_class = C\NS_DATASOURCES . ucfirst(C\p('DBMS')). "Manager";
$this->db = new $db_class();
$this->db->connect();
C\nsconddefine("TRENDING_UPDATE_INTERVAL", C\ONE_HOUR);
}
/**
* Only update if its been more than an hour since the last update
*
* @return bool whether its been an hour since the last update
*/
public function checkPrerequisites()
{
$time = time();
$something_updated = false;
$delta = $time - $this->update_time;
if ($delta > C\TRENDING_UPDATE_INTERVAL) {
$this->update_time = $time;
L\crawlLog("Performing trending value update");
return true;
}
L\crawlLog("Time since last update not exceeded, skipping trending value
update");
return false;
}
/**
* For now trending values only computed on Namesevers (as specific
* to the database there) so is done in prepareTasks
*/
public function nondistributedTasks()
{
$this->prepareTasks();
}
/**
* (Run on name server)
*/
public function prepareTasks()
{
$db = $this->db;
$sql = "SELECT * FROM MEDIA_SOURCE WHERE (TYPE='trending_value')";
$result = $db->execute($sql);
$trending_value_sites = [];
while ($trending_value_site = $db->fetchArray($result)) {
$aux_parts = explode("###",
html_entity_decode($trending_value_site['AUX_INFO'],
ENT_QUOTES));
if (!isset($aux_parts[6])) {
continue;
}
$trending_value_site['CATEGORY_GROUP'] = $aux_parts[5];
$trending_value_site['TREND_VALUE_REGEX'] = $aux_parts[6];
$trending_value_sites[] = $trending_value_site;
}
$this->tasks = $trending_value_sites;
L\crawlLog("----This media updater is responsible for the trending ".
"value_sites");
$i = 1;
foreach ($trending_value_sites as $trending_value_site) {
L\crawlLog("---- $i. " . $trending_value_site["NAME"]);
$i++;
}
$num_trending_sites = count($trending_value_sites);
$trending_values_one_go = self::MAX_VALUES_ONE_GO;
$limit = 0;
while ($limit < $num_trending_sites) {
$trending_values_batch = array_slice($trending_value_sites, $limit,
$trending_values_one_go);
$this->updateTrendingValuesOneGo($trending_values_batch);
$limit += $trending_values_one_go;
}
L\crawlLog("----Computing Landing Page Highlights");
$this->computeLandingHighlights();
}
/**
* For each of a supplied list of podcast associative arrays,
* downloads the non-expired media for that podcast to the wiki folder
* specified.
*
* @param array $trending_sites an array of associative arrays of info
* about values to download
* @param int $age oldest age items to consider for download
* @param boolean $test_mode if true then rather then updating items in
* wiki, returns as a string summarizing the results of the downloads
* that would occur as part of updating the podcast
* @return mixed either true, or if $test_mode is true then the results
* as a string of the operations involved in downloading the podcasts
*/
public function updateTrendingValuesOneGo($trending_sites,
$age = C\ONE_WEEK, $test_mode = false)
{
$db =$this->db;
$test_results = "";
$log_function = function ($msg, $log_tag = "pre class='source-test'")
use (&$test_results, $test_mode) {
$close_tag= preg_split("/\s+/",$log_tag)[0];
if ($test_mode) {
$test_results .= "<$log_tag>$msg</$close_tag>\n";
} else {
L\crawlLog($msg);
}
};
$trending_sites = FetchUrl::getPages($trending_sites, false, 0, null,
"SOURCE_URL", CrawlConstants::PAGE, false, null, true);
$insert_sql = "INSERT INTO TRENDING_TERM (TERM, OCCURRENCES, " .
"UPDATE_PERIOD, TIMESTAMP, LANGUAGE, CATEGORY) VALUES " .
"(?, ?, ?, ?, ?, ?)";
$time = time();
foreach ($trending_sites as $trending_site) {
$language = $trending_site['LANGUAGE'];
$category = $trending_site['CATEGORY'];
if (empty($trending_site[CrawlConstants::PAGE])) {
$log_function(
"...No data in {$trending_site['NAME']} skipping.", "h3");
continue;
}
$log_function("----Updating {$trending_site['NAME']}.", "h3");
// strip namespaces
$regex = $trending_site['TREND_VALUE_REGEX'];
$page = $trending_site[CrawlConstants::PAGE];
if (preg_match_all($regex, $page, $matches)) {
$trending_matches = [];
if (isset($matches[2])) {
$trending_matches = array_combine($matches[1], $matches[2]);
} else if(isset($matches[1])) {
$trending_matches =[[$trending_site['CATEGORY_GROUP']
=> $matches[1]]];
}
foreach ($trending_matches as $name => $value) {
$db->execute($insert_sql, [$name, $value,
C\TRENDING_UPDATE_INTERVAL,
$time, $language, $category]);
}
} else {
$log_function("----could not parse an values from page.");
}
}
return ($test_mode) ? $test_results : true;
}
/**
* Computes arrays of data used to display the news and trending highlights
* on the search landing page. Saves these precomputed arrays to
* C\TRENDS_DIR under a file for each locale
*/
public function computeLandingHighlights()
{
$locale_model = new M\LocaleModel();
$source_model = new M\SourceModel();
$subsearches = $source_model->getSubsearches();
$phrase_model = new M\PhraseModel();
$crawl_model = new M\CrawlModel();
$machine_model = new M\MachineModel();
$verticals_model = new M\SearchverticalsModel;
$trending_model = new M\TrendingModel;
$locale_list = $locale_model->getLocaleList();
$locale = C\p('DEFAULT_LOCALE');
$locale_major = (explode("-", $locale))[0];
foreach ($locale_list as $language) {
$locale_tag = $language['LOCALE_TAG'];
$locale_tag_major = (explode("-", $locale_tag))[0];
$highlights_file = C\TRENDS_DIR . "/highlights_$locale_tag.txt";
$num_random_trends = 9;
$highlights = [];
foreach ($subsearches as $subsearch) {
if (preg_match("/highlight:(\d+)\b/ui",
$subsearch["DEFAULT_QUERY"] ?? "", $highlight_match)) {
$subsearch['PRIORITY'] = (empty($highlight_match[1])) ? 0 :
floatval($highlight_match[1]);
if (preg_match("/trending:(\w+):(\w+)\b/ui",
$subsearch["DEFAULT_QUERY"], $trending_parts)) {
$subsearch['CATEGORY'] = $trending_parts[1] ?? "";
if (empty($trending_parts[2])) {
$subsearch['ORDER'] = "SCORE_DESC";
} else {
$subsearch['ORDER'] = $trending_parts[2];
}
}
$highlights[] = $subsearch;
}
}
usort($highlights, function($a, $b) {
if ($a['PRIORITY'] == $b['PRIORITY']) {
return 0;
}
return ($a['PRIORITY'] > $b['PRIORITY']) ? -1 : 1;
});
$landing_highlight_data = [];
$queue_servers = $machine_model->getQueueServerUrls();
foreach ($highlights as $highlight) {
if (!empty($highlight['CATEGORY'])) {
$landing_highlight_data[] = [
"NAME" => $phrase_model->translateDb(
$highlight['LOCALE_STRING'], $locale_tag),
'TYPE' => 'random_terms',
'CATEGORY' => $highlight['CATEGORY'],
"ORDER" => $highlight['ORDER'],
'DATA' => $trending_model->randomTrends(
$locale_tag, $highlight['CATEGORY'],
$num_random_trends)
];
} else {
$query = preg_replace("/trending:\w+|highlight:\w+/ui",
'', $highlight['DEFAULT_QUERY']);
if (preg_match("/\bm:(\d+)\b/",
$highlight['INDEX_IDENTIFIER'], $matches)) {
$mix = $crawl_model->getCrawlMix($matches[1]);
$query = $phrase_model->rewriteMixQuery($query, $mix);
} else {
$query = ($highlight['INDEX_IDENTIFIER'] == -1) ?
"site:all" : $highlight['INDEX_IDENTIFIER'] . " " .
$query;
}
$query = preg_replace('/lang:default-major/ui', "lang:" .
$locale_tag_major, $query);
$query = preg_replace('/lang:default/u',
"lang:" . $locale_tag,
$query);
$query_results = $phrase_model->getPhrasePageResults(
$query, 0, 5, false, $verticals_model, true, 0,
$queue_servers);
$pages = $query_results['PAGES'] ?? [];
$landing_highlight_data[] = [
"FOLDER_NAME" => $highlight['FOLDER_NAME'],
"NAME" => $phrase_model->translateDb(
$highlight['LOCALE_STRING'], $locale_tag),
'TYPE' => 'feed',
'DATA' => $pages
];
}
}
set_error_handler(null);
if (!file_exists(C\TRENDS_DIR)) {
@mkdir(C\TRENDS_DIR);
@chmod(C\TRENDS_DIR, 0777);
}
file_put_contents($highlights_file,
serialize($landing_highlight_data));
@chmod($highlights_file, 0777);
restore_error_handler();
}
}
}
(c) 2026 Seekquarry - Open Source Search Engine Software