432 lines
8.6 KiB
PHP
432 lines
8.6 KiB
PHP
<?php
|
|
/**
|
|
* @package Joomla.Administrator
|
|
* @subpackage com_finder
|
|
*
|
|
* @copyright Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
|
|
* @license GNU General Public License version 2 or later; see LICENSE
|
|
*/
|
|
|
|
defined('_JEXEC') or die;
|
|
|
|
JLoader::register('FinderIndexer', __DIR__ . '/indexer.php');
|
|
|
|
/**
|
|
* Result class for the Finder indexer package.
|
|
*
|
|
* This class uses magic __get() and __set() methods to prevent properties
|
|
* being added that might confuse the system. All properties not explicitly
|
|
* declared will be pushed into the elements array and can be accessed
|
|
* explicitly using the getElement() method.
|
|
*
|
|
* @package Joomla.Administrator
|
|
* @subpackage com_finder
|
|
* @since 2.5
|
|
*/
|
|
class FinderIndexerResult
|
|
{
|
|
/**
|
|
* An array of extra result properties.
|
|
*
|
|
* @var array
|
|
* @since 2.5
|
|
*/
|
|
protected $elements = array();
|
|
|
|
/**
|
|
* This array tells the indexer which properties should be indexed and what
|
|
* weights to use for those properties.
|
|
*
|
|
* @var array
|
|
* @since 2.5
|
|
*/
|
|
protected $instructions = array(
|
|
FinderIndexer::TITLE_CONTEXT => array('title', 'subtitle', 'id'),
|
|
FinderIndexer::TEXT_CONTEXT => array('summary', 'body'),
|
|
FinderIndexer::META_CONTEXT => array('meta', 'list_price', 'sale_price'),
|
|
FinderIndexer::PATH_CONTEXT => array('path', 'alias'),
|
|
FinderIndexer::MISC_CONTEXT => array('comments')
|
|
);
|
|
|
|
/**
|
|
* The indexer will use this data to create taxonomy mapping entries for
|
|
* the item so that it can be filtered by type, label, category,
|
|
* or whatever.
|
|
*
|
|
* @var array
|
|
* @since 2.5
|
|
*/
|
|
protected $taxonomy = array();
|
|
|
|
/**
|
|
* The content URL.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $url;
|
|
|
|
/**
|
|
* The content route.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $route;
|
|
|
|
/**
|
|
* The content title.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $title;
|
|
|
|
/**
|
|
* The content description.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $description;
|
|
|
|
/**
|
|
* The published state of the result.
|
|
*
|
|
* @var integer
|
|
* @since 2.5
|
|
*/
|
|
public $published;
|
|
|
|
/**
|
|
* The content published state.
|
|
*
|
|
* @var integer
|
|
* @since 2.5
|
|
*/
|
|
public $state;
|
|
|
|
/**
|
|
* The content access level.
|
|
*
|
|
* @var integer
|
|
* @since 2.5
|
|
*/
|
|
public $access;
|
|
|
|
/**
|
|
* The content language.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $language = '*';
|
|
|
|
/**
|
|
* The publishing start date.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $publish_start_date;
|
|
|
|
/**
|
|
* The publishing end date.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $publish_end_date;
|
|
|
|
/**
|
|
* The generic start date.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $start_date;
|
|
|
|
/**
|
|
* The generic end date.
|
|
*
|
|
* @var string
|
|
* @since 2.5
|
|
*/
|
|
public $end_date;
|
|
|
|
/**
|
|
* The item list price.
|
|
*
|
|
* @var mixed
|
|
* @since 2.5
|
|
*/
|
|
public $list_price;
|
|
|
|
/**
|
|
* The item sale price.
|
|
*
|
|
* @var mixed
|
|
* @since 2.5
|
|
*/
|
|
public $sale_price;
|
|
|
|
/**
|
|
* The content type id. This is set by the adapter.
|
|
*
|
|
* @var integer
|
|
* @since 2.5
|
|
*/
|
|
public $type_id;
|
|
|
|
/**
|
|
* The default language for content.
|
|
*
|
|
* @var string
|
|
* @since 3.0.2
|
|
*/
|
|
public $defaultLanguage;
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @since 3.0.3
|
|
*/
|
|
public function __construct()
|
|
{
|
|
$this->defaultLanguage = JComponentHelper::getParams('com_languages')->get('site', 'en-GB');
|
|
}
|
|
|
|
/**
|
|
* The magic set method is used to push additional values into the elements
|
|
* array in order to preserve the cleanliness of the object.
|
|
*
|
|
* @param string $name The name of the element.
|
|
* @param mixed $value The value of the element.
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function __set($name, $value)
|
|
{
|
|
$this->elements[$name] = $value;
|
|
}
|
|
|
|
/**
|
|
* The magic get method is used to retrieve additional element values
|
|
* from the elements array.
|
|
*
|
|
* @param string $name The name of the element.
|
|
*
|
|
* @return mixed The value of the element if set, null otherwise.
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function __get($name)
|
|
{
|
|
// Get the element value if set.
|
|
if (array_key_exists($name, $this->elements))
|
|
{
|
|
return $this->elements[$name];
|
|
}
|
|
else
|
|
{
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The magic isset method is used to check the state of additional element
|
|
* values in the elements array.
|
|
*
|
|
* @param string $name The name of the element.
|
|
*
|
|
* @return boolean True if set, false otherwise.
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function __isset($name)
|
|
{
|
|
return isset($this->elements[$name]);
|
|
}
|
|
|
|
/**
|
|
* The magic unset method is used to unset additional element values in the
|
|
* elements array.
|
|
*
|
|
* @param string $name The name of the element.
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function __unset($name)
|
|
{
|
|
unset($this->elements[$name]);
|
|
}
|
|
|
|
/**
|
|
* Method to retrieve additional element values from the elements array.
|
|
*
|
|
* @param string $name The name of the element.
|
|
*
|
|
* @return mixed The value of the element if set, null otherwise.
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function getElement($name)
|
|
{
|
|
// Get the element value if set.
|
|
if (array_key_exists($name, $this->elements))
|
|
{
|
|
return $this->elements[$name];
|
|
}
|
|
else
|
|
{
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Method to set additional element values in the elements array.
|
|
*
|
|
* @param string $name The name of the element.
|
|
* @param mixed $value The value of the element.
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function setElement($name, $value)
|
|
{
|
|
$this->elements[$name] = $value;
|
|
}
|
|
|
|
/**
|
|
* Method to get all processing instructions.
|
|
*
|
|
* @return array An array of processing instructions.
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function getInstructions()
|
|
{
|
|
return $this->instructions;
|
|
}
|
|
|
|
/**
|
|
* Method to add a processing instruction for an item property.
|
|
*
|
|
* @param string $group The group to associate the property with.
|
|
* @param string $property The property to process.
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function addInstruction($group, $property)
|
|
{
|
|
// Check if the group exists. We can't add instructions for unknown groups.
|
|
if (array_key_exists($group, $this->instructions))
|
|
{
|
|
// Check if the property exists in the group.
|
|
if (!in_array($property, $this->instructions[$group]))
|
|
{
|
|
// Add the property to the group.
|
|
$this->instructions[$group][] = $property;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Method to remove a processing instruction for an item property.
|
|
*
|
|
* @param string $group The group to associate the property with.
|
|
* @param string $property The property to process.
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function removeInstruction($group, $property)
|
|
{
|
|
// Check if the group exists. We can't remove instructions for unknown groups.
|
|
if (array_key_exists($group, $this->instructions))
|
|
{
|
|
// Search for the property in the group.
|
|
$key = array_search($property, $this->instructions[$group]);
|
|
|
|
// If the property was found, remove it.
|
|
if ($key !== false)
|
|
{
|
|
unset($this->instructions[$group][$key]);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Method to get the taxonomy maps for an item.
|
|
*
|
|
* @param string $branch The taxonomy branch to get. [optional]
|
|
*
|
|
* @return array An array of taxonomy maps.
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function getTaxonomy($branch = null)
|
|
{
|
|
// Get the taxonomy branch if available.
|
|
if ($branch !== null && isset($this->taxonomy[$branch]))
|
|
{
|
|
// Filter the input.
|
|
$branch = preg_replace('#[^\pL\pM\pN\p{Pi}\p{Pf}\'+-.,]+#mui', ' ', $branch);
|
|
|
|
return $this->taxonomy[$branch];
|
|
}
|
|
|
|
return $this->taxonomy;
|
|
}
|
|
|
|
/**
|
|
* Method to add a taxonomy map for an item.
|
|
*
|
|
* @param string $branch The title of the taxonomy branch to add the node to.
|
|
* @param string $title The title of the taxonomy node.
|
|
* @param integer $state The published state of the taxonomy node. [optional]
|
|
* @param integer $access The access level of the taxonomy node. [optional]
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 2.5
|
|
*/
|
|
public function addTaxonomy($branch, $title, $state = 1, $access = 1)
|
|
{
|
|
// Filter the input.
|
|
$branch = preg_replace('#[^\pL\pM\pN\p{Pi}\p{Pf}\'+-.,]+#mui', ' ', $branch);
|
|
|
|
// Create the taxonomy node.
|
|
$node = new JObject;
|
|
$node->title = $title;
|
|
$node->state = (int) $state;
|
|
$node->access = (int) $access;
|
|
|
|
// Add the node to the taxonomy branch.
|
|
$this->taxonomy[$branch][$node->title] = $node;
|
|
}
|
|
|
|
/**
|
|
* Method to set the item language
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 3.0
|
|
*/
|
|
public function setLanguage()
|
|
{
|
|
if ($this->language == '*' || $this->language == '')
|
|
{
|
|
$this->language = $this->defaultLanguage;
|
|
}
|
|
}
|
|
}
|