이전 기사에서는 Joomla 스마트 검색 구성 요소의 기능에 대해 알아보고 CRON을 사용한 예약된 인덱싱 매개변수 및 구성에 대해 이야기했습니다. 자체 플러그인용 코드 생성을 시작해 보겠습니다.
기술적인 부분을 시작하기 전에 주요 주제를 직접적으로 다루는 몇 가지 기사를 언급하겠습니다. Joomla 4 / Joomla 5의 최신 아키텍처를 위한 플러그인 생성 및/또는 업데이트를 일반적으로 다루는 기사도 있습니다. 다음으로 독자가 해당 기사를 읽었으며 일반적으로 작동하는 플러그인을 만드는 방법에 대한 아이디어를 가지고 있다고 가정합니다. Joomla의 경우:
숙련된 개발자를 위해 검색 플러그인은 JoomlaComponentFinderAdministratorIndexerAdapter 클래스를 확장하며 클래스 파일은 administrator/comComponents/com_finder/src/Indexer/Adapter.php에 있습니다. 그렇다면 그들은 스스로 알아낼 것입니다. 또한 샘플로 plugins/finder 폴더에서 기사, 카테고리, 연락처, 태그 등에 대한 Joomla 핵심 스마트 검색 플러그인을 연구할 수 있습니다. 저는 JoomShopping(Joomla 전자상거래 구성 요소) 및 SW JProjects(업데이트 서버가 포함된 자체 Joomla 확장 디렉터리 구성 요소) 구성 요소에 대한 스마트 검색 플러그인 작업을 수행했으므로 클래스 이름과 일부 뉘앙스가 여기에 연결됩니다. JoomShopping의 예를 사용하여 대부분을 보여 드리겠습니다. 다국어 문제에 대한 해결책은 SW JProjects의 사례를 바탕으로 합니다.
Joomshopping용 스마트 검색 플러그인의 파일 구조는 일반적인 것과 다르지 않습니다.
Joomla 5 스마트 검색 플러그인 파일 구조
provider.php 파일을 사용하면 Joomla DI 컨테이너에 플러그인을 등록할 수 있고 MVCFactory를 사용하여 외부에서 플러그인 메소드에 액세스할 수 있습니다.
<?php
/**
* @package Joomla.Plugin
* @subpackage Finder.Wtjoomshoppingfinder
*
* @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\Wtjoomshoppingfinder\Extension\Wtjoomshoppingfinder;
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 Wtjoomshoppingfinder(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('finder', 'wtjoomshoppingfinder')
);
$plugin->setApplication(Factory::getApplication());
// Our plugin uses DatabaseTrait, so the setDatabase() method appeared
// If it is not present, then we use only setApplication().
$plugin->setDatabase($container->get(DatabaseInterface::class));
return $plugin;
}
);
}
};
플러그인의 주요 작업 코드가 포함된 파일입니다. src/Extension 폴더에 위치해야 합니다. 내 경우에는 JoomlaPluginFinderWtjoomshoppingfinderExtensionWtjoomshoppingfinder 플러그인 클래스가 plugins/finder/wtjoomshoppingfinder/src/Extension/Wtjoomshoppingfinder.php 파일에 있습니다. 플러그인의 네임스페이스는 JoomlaPluginFinderWtjoomshoppingfinderExtension입니다.
작업에 필요한 최소한의 클래스 속성 및 메서드 집합이 있습니다(부모 Adapter 클래스를 포함하여 액세스됨).
<?php
/**
* @package Joomla.Plugin
* @subpackage Finder.Wtjoomshoppingfinder
*
* @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\Wtjoomshoppingfinder\Extension\Wtjoomshoppingfinder;
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 Wtjoomshoppingfinder(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('finder', 'wtjoomshoppingfinder')
);
$plugin->setApplication(Factory::getApplication());
// Our plugin uses DatabaseTrait, so the setDatabase() method appeared
// If it is not present, then we use only setApplication().
$plugin->setDatabase($container->get(DatabaseInterface::class));
return $plugin;
}
);
}
};
... 문서와 대부분의 기사에서 이에 대해 이야기하고 있음에도 불구하고 getListQuery() 메서드는 실제로 필수는 아니기 때문에 여기서 세부 사항을 살펴보기 시작합니다.
"복잡한 계획" 주제에 관한 모든 사진이 여기에 적합합니다.
어떤 정보나 아이디어가 때때로 우리가 인지하고 깨닫기도 전에 원을 그리며 스쳐가는 경우가 얼마나 많은지 놀랍습니다! 1년이 넘도록 우리 눈앞에 있는 많은 것들이 여전히 인식되지 못하고, 수년간의 경험을 거쳐야 우리의 관심이 집중됩니다.
Joomla와 관련하여 어떤 이유로든 Joomla의 구성 요소가 Joomla의 일종의 공통 아키텍처 특성을 가정한다는 비전이 즉시 나타나지 않습니다(이것은 분명한 사실이지만). 데이터베이스 테이블 구조 수준에 포함됩니다. Joomla 콘텐츠 테이블의 일부 필드를 살펴보겠습니다. 특정 열 이름은 우리에게 그다지 중요하지 않으며(항상 SELECT 이름을 제목으로 쿼리할 수 있음), 하나의 색인화된 요소에 대한 데이터 구조는 얼마인지 예약하겠습니다.
#__content(Joomla 기사), #__contact_details(연락처 구성 요소), #__tags(Joomla 태그), #__categories(Joomla 카테고리 구성 요소) 테이블을 비교하면 나열된 데이터 유형을 거의 모든 곳에서 찾을 수 있습니다.
스마트 검색 플러그인이 생성되는 구성 요소가 "Joomla 방식"을 따르고 해당 아키텍처를 상속하는 경우 플러그인 클래스에서 최소한의 메소드로 작업할 수 있습니다. 개발자가 쉬운 길을 찾지 않고 자신의 길을 가기로 결정했다면 Adapter 클래스의 거의 모든 메서드를 재정의하는 어려운 길을 가야 할 것입니다.
이 메서드는 3가지 경우에 호출됩니다.
Joomla 스마트 검색 색인 생성 프로세스
디버그 모드에서 인덱싱된 항목 수를 확인할 수 있습니다.
Joomla 5 스마트 검색 설정 인덱서 배치 크기
Joomla 핵심 플러그인의 구현 예를 살펴보겠습니다.
<?php
/**
* @package Joomla.Plugin
* @subpackage Finder.Wtjoomshoppingfinder
*
* @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\Wtjoomshoppingfinder\Extension\Wtjoomshoppingfinder;
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 Wtjoomshoppingfinder(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('finder', 'wtjoomshoppingfinder')
);
$plugin->setApplication(Factory::getApplication());
// Our plugin uses DatabaseTrait, so the setDatabase() method appeared
// If it is not present, then we use only setApplication().
$plugin->setDatabase($container->get(DatabaseInterface::class));
return $plugin;
}
);
}
};
getListQuery() 메서드는 쿼리 생성자의 개체인 DatabaseQuery 개체를 반환합니다. 여기서 테이블 이름과 선택 필드가 이미 지정되어 있습니다. 이를 호출하는 메소드에서 작업이 계속됩니다.
DatabaseQuery $query 객체의 getContentCount()에서 getListQuery()를 호출하면 select에 설정된 값이 COUNT(*)로 대체됩니다.
getItem($id)에서 getListQuery()를 호출하면 $query->where('a.id = ' . (int) $id) 조건이 적용되고 특정 요소만 선택됩니다. 그리고 이미 여기서는 상위 Adapter 클래스에 쿼리의 테이블 이름이 a.*로 포함되어 있음을 알 수 있습니다. 이는 getListQuery() 메소드 구현에서도 이러한 접두어를 사용해야 함을 의미합니다.
getItems()에서 getListQuery()를 호출하는 경우 인덱싱할 요소 목록을 이동하기 위해 구성한 쿼리에 $offset 및 $limit가 추가됩니다.
요약: getListQuery() - 세 가지 다른 SQL 쿼리에 대한 "작업 부분"을 포함해야 합니다. 여기서 Joomla를 구현하는 데 특별히 어려운 점은 없습니다. 하지만 필요한 경우 getListQuery()를 생성하지 않고 3가지 메소드를 직접 구현할 수도 있습니다.
비 줌라 방식: JoomShopping의 경우 제품이 여러 카테고리를 가질 수 있으며 역사적으로 제품의 카테고리 ID(catid) 구성 요소가 별도의 테이블에 저장되어 있다는 사실을 발견했습니다. 동시에, 수년 동안 제품의 주요 카테고리를 지정하는 것은 불가능했습니다. 제품 카테고리를 수신하면 카테고리가 포함된 테이블로 쿼리가 전송되었습니다. 여기서 첫 번째 쿼리 결과만 가져와서 기본 카테고리 ID를 기준으로 정렬했습니다(예: 오름차순). 상품을 편집할 때 카테고리를 변경했다면, 주요 상품 카테고리는 ID 번호가 낮은 카테고리였습니다. 이를 기반으로 제품의 URL이 생성되었으며 제품이 한 카테고리에서 다른 카테고리로 이동할 수 있습니다.
하지만 거의 2년 전에 이 JoomShopping 동작이 수정되었습니다. 이 구성 요소는 오랜 역사를 갖고 있고 사용자가 많으며 이전 버전과의 호환성을 깨뜨릴 수 없기 때문에 수정 사항은 선택 사항으로 설정되었습니다. 제품의 기본 카테고리를 지정하는 기능은 구성 요소 설정에서 활성화되어야 합니다. 그러면 테이블에 main_category_id가 제품으로 채워집니다.
그러나 이 기능은 기본적으로 비활성화되어 있습니다. 그리고 스마트 검색 플러그인에서 JoomShopping 구성 요소의 매개변수를 가져와서 기본 제품 카테고리를 지정하는 옵션이 활성화되어 있는지 확인해야 합니다. 최근에 활성화되었을 수 있으며 일부 제품의 기본 카테고리가 지정되지 않았습니다. 미묘한 차이도 있습니다...) 구성요소 매개변수를 기반으로 제품을 수신하는 SQL 쿼리를 생성합니다. main_category_id 필드 또는 이전의 잘못된 방식으로 카테고리 ID를 가져오기 위한 JOIN 요청입니다.
이 요청에는 다국어 사용의 뉘앙스가 즉시 부각됩니다. Joomla 방식에 따르면 사이트의 각 언어에 대해 별도의 요소가 생성되고 이들 사이에 연결이 설정됩니다. 따라서 러시아어의 경우 하나의 기사입니다. 같은 영문 기사가 별도로 작성되고 있습니다. 그런 다음 언어 연결을 사용하여 서로 연결하고 Joomla 프런트엔드에서 언어를 전환하면 한 기사에서 다른 기사로 리디렉션됩니다.
JoomShopping에서는 이것이 수행되는 방식이 아닙니다. 모든 언어의 데이터는 제품과 함께 동일한 테이블에 저장됩니다(Ok). 다른 언어에 대한 데이터 추가는 해당 언어의 접미사(흠...)가 포함된 열을 추가하여 수행됩니다. 즉, 데이터베이스에는 직함이나 이름 필드만 있는 것이 아닙니다. 하지만 name_ru-RU, name_en-GB 등의 필드가 있습니다.
Joomla JoomShopping 제품 테이블 구조 조각
동시에 관리 패널과 CLI 모두에서 인덱싱할 수 있도록 범용 SQL 쿼리를 설계해야 합니다. 동시에 CRON을 사용하여 CLI를 시작할 때 인덱싱 언어를 선택하는 것도 작업입니다. 나는 이 글을 쓰는 시점에서 이 문제에 대한 본격적인 해결책을 당분간 미루어 왔다는 것을 인정합니다. 언어는 JoomShopping 매개변수에서 기본 언어를 가져오거나 사이트의 기본 언어를 사용하는 자체 getLangTag() 메소드를 사용하여 선택됩니다. 즉, 지금까지 이 솔루션은 단일 언어 사이트에만 해당됩니다. 다른 언어로의 검색은 아직 작동하지 않습니다.
그러나 3개월 후에 이 문제를 해결했습니다. 그러나 이미 SW JProjects 구성 요소용 스마트 검색 플러그인에 있습니다. 해결 방법에 대해 자세히 알려드리겠습니다.
그동안 JoomShopping에 무슨 일이 일어났는지 살펴보겠습니다
<?php
/**
* @package Joomla.Plugin
* @subpackage Finder.Wtjoomshoppingfinder
*
* @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\Wtjoomshoppingfinder\Extension\Wtjoomshoppingfinder;
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 Wtjoomshoppingfinder(
$container->get(DispatcherInterface::class),
(array) PluginHelper::getPlugin('finder', 'wtjoomshoppingfinder')
);
$plugin->setApplication(Factory::getApplication());
// Our plugin uses DatabaseTrait, so the setDatabase() method appeared
// If it is not present, then we use only setApplication().
$plugin->setDatabase($container->get(DatabaseInterface::class));
return $plugin;
}
);
}
};
Joomla에서 데이터베이스를 쿼리하는 방법을 만들었고 스마트 검색 플러그인의 작동 방식에 대해 많은 것을 배웠습니다.
다음 글에서는 콘텐츠 색인 생성 방법을 만들고 플러그인 생성을 완료하겠습니다. 또한 인덱싱된 항목이 데이터베이스에 저장되는 방식에 대해 알아보고 이것이 왜 중요한지 이해하고 다국어의 비표준 구현을 통해 다국어 구성 요소의 콘텐츠 인덱싱 문제를 해결합니다.
위 내용은 Joomla 아트의 스마트 검색 분석 플러그인 만들기 I.의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
