此包的最新版本(1.0.5)没有提供许可信息。
提供上下文视图块。
1.0.5
2021-07-29 06:20 UTC
This package is auto-updated.
Last update: 2024-09-15 04:12:45 UTC
README
提供上下文视图块的Drupal模块。
Composer
-
建议通过composer安装模块
composer require drunomics/contextual_views
此模块也通过drupal.org发行系统提供,但只有drunomics/contextual_views会得到修补级别发布。这是因为drupal.org目前还不支持模块的语义版本。
安装
按常规方式安装,有关更多信息,请参阅https://www.drupal.org/docs/8/extending-drupal-8/installing-contributed-modules-find-import-enable-configure-drupal-8
使用说明
- 使用与自动使用的相同插件ID定义一个块插件。例如,
views_block:news-news_by_channel
。模式为views_block:{{ view }}-{{ display }}
。这样定义的类将自动使用,而不是默认类。 - 扩展类
Drupal\contextual_views\Plugin\Block\ContextualViewsBlock
- 使用注解在插件上定义必要的上下文,例如节点上下文。
- 修改块表单以添加所需的额外配置,例如包含字段引用名称的文本字段。
- 重写build(),获取上下文值(例如节点),从上下文派生视图参数(分类术语),并使用
$view->setArguments()
将其设置为视图的参数。然后调用父build。
可以在此处查看描述的块的完整代码示例: https://gist.github.com/fago/f51fe8861919a40c753a03c79a134848
待办事项
- 编写更多文档
- 根据可用的块上下文提供满足视图上下文的配置表单。
贡献
始终使用模块问题队列。
开发在GitHub上使用pull request模型进行:如果您不熟悉该模型,请花几分钟时间阅读GitHub文章关于使用pull request的信息。
在贡献时应遵循一些约定
- 为每个正在工作的pull request在drupal.org问题队列中创建一个问题。
- 始终在Pull Request和问题中交叉引用问题。
- 为每个pull request创建一个新的分支:其名称应包含票证的简要总结和问题ID,例如 readme-2276369。
- 尝试通过压缩您的提交来保持pull request的历史尽可能干净:您可以查看Symfony文档或Git书籍以获取更多关于如何执行此操作的信息。
有关如何贡献的更多信息,请参阅文档。