first commit
This commit is contained in:
52
plugins/finder/contacts/contacts.xml
Normal file
52
plugins/finder/contacts/contacts.xml
Normal file
@ -0,0 +1,52 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<extension type="plugin" group="finder" method="upgrade">
|
||||
<name>plg_finder_contacts</name>
|
||||
<author>Joomla! Project</author>
|
||||
<creationDate>2011-08</creationDate>
|
||||
<copyright>(C) 2011 Open Source Matters, Inc.</copyright>
|
||||
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
|
||||
<authorEmail>admin@joomla.org</authorEmail>
|
||||
<authorUrl>www.joomla.org</authorUrl>
|
||||
<version>3.0.0</version>
|
||||
<description>PLG_FINDER_CONTACTS_XML_DESCRIPTION</description>
|
||||
<namespace path="src">Joomla\Plugin\Finder\Contacts</namespace>
|
||||
<files>
|
||||
<folder plugin="contacts">services</folder>
|
||||
<folder>src</folder>
|
||||
</files>
|
||||
<languages>
|
||||
<language tag="en-GB">language/en-GB/plg_finder_contacts.ini</language>
|
||||
<language tag="en-GB">language/en-GB/plg_finder_contacts.sys.ini</language>
|
||||
</languages>
|
||||
<config>
|
||||
<fields name="params">
|
||||
<fieldset name="basic" addfieldprefix="Joomla\Component\Finder\Administrator\Field">
|
||||
<field
|
||||
name="search_archived"
|
||||
type="radio"
|
||||
layout="joomla.form.field.radio.switcher"
|
||||
label="PLG_FINDER_CONTACTS_FIELD_SEARCH_ARCHIVED_LABEL"
|
||||
description="PLG_FINDER_CONTACTS_FIELD_SEARCH_ARCHIVED_DESC"
|
||||
default="1"
|
||||
filter="integer"
|
||||
>
|
||||
<option value="0">JNO</option>
|
||||
<option value="1">JYES</option>
|
||||
</field>
|
||||
<field
|
||||
name="taxonomies"
|
||||
type="taxonomytypes"
|
||||
label="PLG_FINDER_CONTACTS_TAXONOMIES_LABEL"
|
||||
default="type,category,language,region,country"
|
||||
multiple="true"
|
||||
>
|
||||
<option value="category">PLG_FINDER_CONTACTS_TAXONOMIES_CATEGORY</option>
|
||||
<option value="country">PLG_FINDER_CONTACTS_TAXONOMIES_COUNTRY</option>
|
||||
<option value="language">PLG_FINDER_CONTACTS_TAXONOMIES_LANGUAGE</option>
|
||||
<option value="region">PLG_FINDER_CONTACTS_TAXONOMIES_REGION</option>
|
||||
<option value="type">PLG_FINDER_CONTACTS_TAXONOMIES_TYPE</option>
|
||||
</field>
|
||||
</fieldset>
|
||||
</fields>
|
||||
</config>
|
||||
</extension>
|
||||
48
plugins/finder/contacts/services/provider.php
Normal file
48
plugins/finder/contacts/services/provider.php
Normal file
@ -0,0 +1,48 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* @package Joomla.Plugin
|
||||
* @subpackage Finder.contacts
|
||||
*
|
||||
* @copyright (C) 2023 Open Source Matters, Inc. <https://www.joomla.org>
|
||||
* @license GNU General Public License version 2 or later; see LICENSE.txt
|
||||
*/
|
||||
|
||||
\defined('_JEXEC') or die;
|
||||
|
||||
use Joomla\CMS\Extension\PluginInterface;
|
||||
use Joomla\CMS\Factory;
|
||||
use Joomla\CMS\Plugin\PluginHelper;
|
||||
use Joomla\Database\DatabaseInterface;
|
||||
use Joomla\DI\Container;
|
||||
use Joomla\DI\ServiceProviderInterface;
|
||||
use Joomla\Event\DispatcherInterface;
|
||||
use Joomla\Plugin\Finder\Contacts\Extension\Contacts;
|
||||
|
||||
return new class () implements ServiceProviderInterface {
|
||||
/**
|
||||
* Registers the service provider with a DI container.
|
||||
*
|
||||
* @param Container $container The DI container.
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 4.3.0
|
||||
*/
|
||||
public function register(Container $container)
|
||||
{
|
||||
$container->set(
|
||||
PluginInterface::class,
|
||||
function (Container $container) {
|
||||
$plugin = new Contacts(
|
||||
$container->get(DispatcherInterface::class),
|
||||
(array) PluginHelper::getPlugin('finder', 'contacts')
|
||||
);
|
||||
$plugin->setApplication(Factory::getApplication());
|
||||
$plugin->setDatabase($container->get(DatabaseInterface::class));
|
||||
|
||||
return $plugin;
|
||||
}
|
||||
);
|
||||
}
|
||||
};
|
||||
449
plugins/finder/contacts/src/Extension/Contacts.php
Normal file
449
plugins/finder/contacts/src/Extension/Contacts.php
Normal file
@ -0,0 +1,449 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* @package Joomla.Plugin
|
||||
* @subpackage Finder.contacts
|
||||
*
|
||||
* @copyright (C) 2011 Open Source Matters, Inc. <https://www.joomla.org>
|
||||
* @license GNU General Public License version 2 or later; see LICENSE.txt
|
||||
*/
|
||||
|
||||
namespace Joomla\Plugin\Finder\Contacts\Extension;
|
||||
|
||||
use Joomla\CMS\Component\ComponentHelper;
|
||||
use Joomla\CMS\Table\Table;
|
||||
use Joomla\Component\Contact\Site\Helper\RouteHelper;
|
||||
use Joomla\Component\Finder\Administrator\Indexer\Adapter;
|
||||
use Joomla\Component\Finder\Administrator\Indexer\Helper;
|
||||
use Joomla\Component\Finder\Administrator\Indexer\Indexer;
|
||||
use Joomla\Component\Finder\Administrator\Indexer\Result;
|
||||
use Joomla\Database\DatabaseAwareTrait;
|
||||
use Joomla\Database\DatabaseQuery;
|
||||
use Joomla\Registry\Registry;
|
||||
|
||||
// phpcs:disable PSR1.Files.SideEffects
|
||||
\defined('_JEXEC') or die;
|
||||
// phpcs:enable PSR1.Files.SideEffects
|
||||
|
||||
/**
|
||||
* Finder adapter for Joomla Contacts.
|
||||
*
|
||||
* @since 2.5
|
||||
*/
|
||||
final class Contacts extends Adapter
|
||||
{
|
||||
use DatabaseAwareTrait;
|
||||
|
||||
/**
|
||||
* The plugin identifier.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $context = 'Contacts';
|
||||
|
||||
/**
|
||||
* The extension name.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $extension = 'com_contact';
|
||||
|
||||
/**
|
||||
* The sublayout to use when rendering the results.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $layout = 'contact';
|
||||
|
||||
/**
|
||||
* The type of content that the adapter indexes.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $type_title = 'Contact';
|
||||
|
||||
/**
|
||||
* The table name.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $table = '#__contact_details';
|
||||
|
||||
/**
|
||||
* The field the published state is stored in.
|
||||
*
|
||||
* @var string
|
||||
* @since 2.5
|
||||
*/
|
||||
protected $state_field = 'published';
|
||||
|
||||
/**
|
||||
* Load the language file on instantiation.
|
||||
*
|
||||
* @var boolean
|
||||
* @since 3.1
|
||||
*/
|
||||
protected $autoloadLanguage = true;
|
||||
|
||||
/**
|
||||
* Method to update the item link information when the item category is
|
||||
* changed. This is fired when the item category is published or unpublished
|
||||
* from the list view.
|
||||
*
|
||||
* @param string $extension The extension whose category has been updated.
|
||||
* @param array $pks A list of primary key ids of the content that has changed state.
|
||||
* @param integer $value The value of the state that the content has been changed to.
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 2.5
|
||||
*/
|
||||
public function onFinderCategoryChangeState($extension, $pks, $value)
|
||||
{
|
||||
// Make sure we're handling com_contact categories
|
||||
if ($extension === 'com_contact') {
|
||||
$this->categoryStateChange($pks, $value);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to remove the link information for items that have been deleted.
|
||||
*
|
||||
* This event will fire when contacts are deleted and when an indexed item is deleted.
|
||||
*
|
||||
* @param string $context The context of the action being performed.
|
||||
* @param Table $table A Table object containing the record to be deleted
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 2.5
|
||||
* @throws \Exception on database error.
|
||||
*/
|
||||
public function onFinderAfterDelete($context, $table): void
|
||||
{
|
||||
if ($context === 'com_contact.contact') {
|
||||
$id = $table->id;
|
||||
} elseif ($context === 'com_finder.index') {
|
||||
$id = $table->link_id;
|
||||
} else {
|
||||
return;
|
||||
}
|
||||
|
||||
// Remove the items.
|
||||
$this->remove($id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to determine if the access level of an item changed.
|
||||
*
|
||||
* @param string $context The context of the content passed to the plugin.
|
||||
* @param Table $row A Table object
|
||||
* @param boolean $isNew If the content has just been created
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 2.5
|
||||
* @throws \Exception on database error.
|
||||
*/
|
||||
public function onFinderAfterSave($context, $row, $isNew): void
|
||||
{
|
||||
// We only want to handle contacts here
|
||||
if ($context === 'com_contact.contact') {
|
||||
// Check if the access levels are different
|
||||
if (!$isNew && $this->old_access != $row->access) {
|
||||
// Process the change.
|
||||
$this->itemAccessChange($row);
|
||||
}
|
||||
|
||||
// Reindex the item
|
||||
$this->reindex($row->id);
|
||||
}
|
||||
|
||||
// Check for access changes in the category
|
||||
if ($context === 'com_categories.category') {
|
||||
// Check if the access levels are different
|
||||
if (!$isNew && $this->old_cataccess != $row->access) {
|
||||
$this->categoryAccessChange($row);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to reindex the link information for an item that has been saved.
|
||||
* This event is fired before the data is actually saved so we are going
|
||||
* to queue the item to be indexed later.
|
||||
*
|
||||
* @param string $context The context of the content passed to the plugin.
|
||||
* @param Table $row A Table object
|
||||
* @param boolean $isNew If the content is just about to be created
|
||||
*
|
||||
* @return boolean True on success.
|
||||
*
|
||||
* @since 2.5
|
||||
* @throws \Exception on database error.
|
||||
*/
|
||||
public function onFinderBeforeSave($context, $row, $isNew)
|
||||
{
|
||||
// We only want to handle contacts here
|
||||
if ($context === 'com_contact.contact') {
|
||||
// Query the database for the old access level if the item isn't new
|
||||
if (!$isNew) {
|
||||
$this->checkItemAccess($row);
|
||||
}
|
||||
}
|
||||
|
||||
// Check for access levels from the category
|
||||
if ($context === 'com_categories.category') {
|
||||
// Query the database for the old access level if the item isn't new
|
||||
if (!$isNew) {
|
||||
$this->checkCategoryAccess($row);
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to update the link information for items that have been changed
|
||||
* from outside the edit screen. This is fired when the item is published,
|
||||
* unpublished, archived, or unarchived from the list view.
|
||||
*
|
||||
* @param string $context The context for the content passed to the plugin.
|
||||
* @param array $pks A list of primary key ids of the content that has changed state.
|
||||
* @param integer $value The value of the state that the content has been changed to.
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 2.5
|
||||
*/
|
||||
public function onFinderChangeState($context, $pks, $value)
|
||||
{
|
||||
// We only want to handle contacts here
|
||||
if ($context === 'com_contact.contact') {
|
||||
$this->itemStateChange($pks, $value);
|
||||
}
|
||||
|
||||
// Handle when the plugin is disabled
|
||||
if ($context === 'com_plugins.plugin' && $value === 0) {
|
||||
$this->pluginDisable($pks);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to index an item. The item must be a Result object.
|
||||
*
|
||||
* @param Result $item The item to index as a Result object.
|
||||
*
|
||||
* @return void
|
||||
*
|
||||
* @since 2.5
|
||||
* @throws \Exception on database error.
|
||||
*/
|
||||
protected function index(Result $item)
|
||||
{
|
||||
// Check if the extension is enabled
|
||||
if (ComponentHelper::isEnabled($this->extension) === false) {
|
||||
return;
|
||||
}
|
||||
|
||||
$item->setLanguage();
|
||||
|
||||
// Initialize the item parameters.
|
||||
$item->params = new Registry($item->params);
|
||||
|
||||
// Create a URL as identifier to recognise items again.
|
||||
$item->url = $this->getUrl($item->id, $this->extension, $this->layout);
|
||||
|
||||
// Build the necessary route and path information.
|
||||
$item->route = RouteHelper::getContactRoute($item->slug, $item->catslug, $item->language);
|
||||
|
||||
// Get the menu title if it exists.
|
||||
$title = $this->getItemMenuTitle($item->url);
|
||||
|
||||
// Adjust the title if necessary.
|
||||
if (!empty($title) && $this->params->get('use_menu_title', true)) {
|
||||
$item->title = $title;
|
||||
}
|
||||
|
||||
// Add the image.
|
||||
if ($item->image) {
|
||||
$item->imageUrl = $item->image;
|
||||
$item->imageAlt = $item->title ?? '';
|
||||
}
|
||||
|
||||
/*
|
||||
* Add the metadata processing instructions based on the contact
|
||||
* configuration parameters.
|
||||
*/
|
||||
|
||||
// Handle the contact position.
|
||||
if ($item->params->get('show_position', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'position');
|
||||
}
|
||||
|
||||
// Handle the contact street address.
|
||||
if ($item->params->get('show_street_address', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'address');
|
||||
}
|
||||
|
||||
// Handle the contact city.
|
||||
if ($item->params->get('show_suburb', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'city');
|
||||
}
|
||||
|
||||
// Handle the contact region.
|
||||
if ($item->params->get('show_state', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'region');
|
||||
}
|
||||
|
||||
// Handle the contact country.
|
||||
if ($item->params->get('show_country', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'country');
|
||||
}
|
||||
|
||||
// Handle the contact zip code.
|
||||
if ($item->params->get('show_postcode', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'zip');
|
||||
}
|
||||
|
||||
// Handle the contact telephone number.
|
||||
if ($item->params->get('show_telephone', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'telephone');
|
||||
}
|
||||
|
||||
// Handle the contact fax number.
|
||||
if ($item->params->get('show_fax', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'fax');
|
||||
}
|
||||
|
||||
// Handle the contact email address.
|
||||
if ($item->params->get('show_email', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'email');
|
||||
}
|
||||
|
||||
// Handle the contact mobile number.
|
||||
if ($item->params->get('show_mobile', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'mobile');
|
||||
}
|
||||
|
||||
// Handle the contact webpage.
|
||||
if ($item->params->get('show_webpage', true)) {
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'webpage');
|
||||
}
|
||||
|
||||
// Handle the contact user name.
|
||||
$item->addInstruction(Indexer::META_CONTEXT, 'user');
|
||||
|
||||
// Get taxonomies to display
|
||||
$taxonomies = $this->params->get('taxonomies', ['type', 'category', 'language', 'region', 'country']);
|
||||
|
||||
// Add the type taxonomy data.
|
||||
if (\in_array('type', $taxonomies)) {
|
||||
$item->addTaxonomy('Type', 'Contact');
|
||||
}
|
||||
|
||||
// Add the category taxonomy data.
|
||||
$categories = $this->getApplication()->bootComponent('com_contact')->getCategory(['published' => false, 'access' => false]);
|
||||
$category = $categories->get($item->catid);
|
||||
|
||||
if (!$category) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Add the category taxonomy data.
|
||||
if (\in_array('category', $taxonomies)) {
|
||||
$item->addNestedTaxonomy('Category', $category, $this->translateState($category->published), $category->access, $category->language);
|
||||
}
|
||||
|
||||
// Add the language taxonomy data.
|
||||
if (\in_array('language', $taxonomies)) {
|
||||
$item->addTaxonomy('Language', $item->language);
|
||||
}
|
||||
|
||||
// Add the region taxonomy data.
|
||||
if (\in_array('region', $taxonomies) && !empty($item->region) && $this->params->get('tax_add_region', true)) {
|
||||
$item->addTaxonomy('Region', $item->region);
|
||||
}
|
||||
|
||||
// Add the country taxonomy data.
|
||||
if (\in_array('country', $taxonomies) && !empty($item->country) && $this->params->get('tax_add_country', true)) {
|
||||
$item->addTaxonomy('Country', $item->country);
|
||||
}
|
||||
|
||||
// Get content extras.
|
||||
Helper::getContentExtras($item);
|
||||
Helper::addCustomFields($item, 'com_contact.contact');
|
||||
|
||||
// Index the item.
|
||||
$this->indexer->index($item);
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to setup the indexer to be run.
|
||||
*
|
||||
* @return boolean True on success.
|
||||
*
|
||||
* @since 2.5
|
||||
*/
|
||||
protected function setup()
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Method to get the SQL query used to retrieve the list of content items.
|
||||
*
|
||||
* @param mixed $query A DatabaseQuery object or null.
|
||||
*
|
||||
* @return DatabaseQuery A database object.
|
||||
*
|
||||
* @since 2.5
|
||||
*/
|
||||
protected function getListQuery($query = null)
|
||||
{
|
||||
$db = $this->getDatabase();
|
||||
|
||||
// Check if we can use the supplied SQL query.
|
||||
$query = $query instanceof DatabaseQuery ? $query : $db->getQuery(true)
|
||||
->select('a.id, a.name AS title, a.alias, a.con_position AS position, a.address, a.created AS start_date')
|
||||
->select('a.created_by_alias, a.modified, a.modified_by')
|
||||
->select('a.metakey, a.metadesc, a.metadata, a.language')
|
||||
->select('a.sortname1, a.sortname2, a.sortname3')
|
||||
->select('a.publish_up AS publish_start_date, a.publish_down AS publish_end_date')
|
||||
->select('a.suburb AS city, a.state AS region, a.country, a.postcode AS zip')
|
||||
->select('a.telephone, a.fax, a.misc AS summary, a.email_to AS email, a.mobile')
|
||||
->select('a.image, a.webpage, a.access, a.published AS state, a.ordering, a.params, a.catid')
|
||||
->select('c.title AS category, c.published AS cat_state, c.access AS cat_access');
|
||||
|
||||
// Handle the alias CASE WHEN portion of the query
|
||||
$case_when_item_alias = ' CASE WHEN ';
|
||||
$case_when_item_alias .= $query->charLength('a.alias', '!=', '0');
|
||||
$case_when_item_alias .= ' THEN ';
|
||||
$a_id = $query->castAsChar('a.id');
|
||||
$case_when_item_alias .= $query->concatenate([$a_id, 'a.alias'], ':');
|
||||
$case_when_item_alias .= ' ELSE ';
|
||||
$case_when_item_alias .= $a_id . ' END as slug';
|
||||
$query->select($case_when_item_alias);
|
||||
|
||||
$case_when_category_alias = ' CASE WHEN ';
|
||||
$case_when_category_alias .= $query->charLength('c.alias', '!=', '0');
|
||||
$case_when_category_alias .= ' THEN ';
|
||||
$c_id = $query->castAsChar('c.id');
|
||||
$case_when_category_alias .= $query->concatenate([$c_id, 'c.alias'], ':');
|
||||
$case_when_category_alias .= ' ELSE ';
|
||||
$case_when_category_alias .= $c_id . ' END as catslug';
|
||||
$query->select($case_when_category_alias)
|
||||
|
||||
->select('u.name')
|
||||
->from('#__contact_details AS a')
|
||||
->join('LEFT', '#__categories AS c ON c.id = a.catid')
|
||||
->join('LEFT', '#__users AS u ON u.id = a.user_id');
|
||||
|
||||
return $query;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user