DummyPlugin
扩展自 CMSPlugin占位符插件。
| 自 |
4.0.0 |
|---|---|
| 包 |
Joomla CMS |
方法
__construct
构造函数
__construct(\Joomla\Event\DispatcherInterface dispatcher, mixed||string|int config = []) :
| 自 |
1.5 |
|---|
参数
- dispatcher
DispatcherInterface事件调度器- config
array<string|int, mixed>一个可选的关联数组，包含配置设置。识别的键值包括“name”、“group”、“params”、“language”（此列表并非详尽无遗）。
返回值
混合类型
getApplication
返回内部应用程序，如果未设置则返回 null。
getApplication() : \Joomla\CMS\Application\CMSApplicationInterface|null
getLanguage
获取语言。
getLanguage() : \Joomla\CMS\Language\Language
loadLanguage
加载插件语言文件
loadLanguage( extension = '', basePath = JPATH_ADMINISTRATOR) :
| 自 |
1.5 |
|---|
参数
- extension
string要加载语言文件的扩展- basePath
string要使用的基本路径
返回值
bool如果文件已成功加载，则为 True。
parameterImplementsEventInterface
检查参数是否类型提示为接受 \Joomla\Event\EventInterface。
parameterImplementsEventInterface(\ReflectionParameter parameter) :
| 自 |
4.0.0 |
|---|
参数
- parameter
ReflectionParameter
返回值
bool
registerLegacyListener
注册一个旧版事件侦听器，即一个方法，其参数接受单个参数，而不是其参数中的 AbstractEvent。这为 Joomla! 3.x 风格的插件提供了向后兼容性。
registerLegacyListener( methodName) :
此方法将注册 lambda 函数（闭包），这些函数尝试将已分派的 Event 的参数解包到旧式方法参数中，并使用它们调用您的 on<Something> 方法。结果将作为元素传递回 Event，作为名为“result”的数组参数。
| 自 |
4.0.0 |
|---|
参数
- methodName
string要注册的方法名称
返回值
void
registerListener
注册一个正确的事件侦听器，即一个方法，其参数接受 AbstractEvent 作为其唯一参数。这是在 Joomla! 4.x 中实现插件的首选方法，并且将是从 Joomla! 5.x 开始的唯一可能方法。
registerListener( methodName) :
| 自 |
4.0.0 |
|---|
参数
- methodName
string要注册的方法名称
返回值
void
registerListeners
向调度器注册旧版侦听器，模拟 Joomla! 3.x 及更低版本中插件的工作方式。
registerListeners() :
默认情况下，此方法将查找所有名称以“on”开头的公共方法。它将注册 lambda 函数（闭包），这些函数尝试将已分派的 Event 的参数解包到方法调用参数中，并调用您的 on<Something> 方法。结果将传递回 Event，进入其“result”参数。
此方法还支持 Joomla\Event\SubscriberInterface，并且实现此接口的插件将作为订阅者注册到调度器。
| 自 |
4.0.0 |
|---|
返回值
void
setApplication
设置要使用的应用程序。
setApplication(\Joomla\CMS\Application\CMSApplicationInterface application) :
setLanguage
设置要使用的语言。
setLanguage(\Joomla\CMS\Language\Language language) :
属性
params
保存插件参数的 Registry 对象
| 自 |
1.5 |
|---|
类型
Registry
_name
插件的名称
| 自 |
1.5 |
|---|
类型
string
_type
插件类型
| 自 |
1.5 |
|---|
类型
string
autoloadLanguage
影响构造函数行为。如果为真，则会自动加载语言文件。
| 自 |
3.1 |
|---|
类型
bool
allowLegacyListeners
我是否应该尝试检测和注册旧版事件侦听器，即接受解包参数的方法？虽然这在很大程度上保持了与 Joomla! 3.x 风格插件的向后兼容性，但速度要慢得多。建议您使用正确的侦听器（方法接受 AbstractEvent 作为其唯一参数）来实现插件，以获得最佳性能。还要记住，Joomla! 5.x 及更高版本将只允许正确的侦听器，从而删除对旧版侦听器的支持。
| 自 |
4.0.0 |
|---|---|
| 已弃用 |
4.3 将在 6.0 中删除 实现接受 AbstractEvent 对象的插件方法 示例：onEventTriggerName(AbstractEvent $event) { $context = $event->getArgument(...); } |
类型
bool