此包的最新版本(1.0.5)没有提供许可信息。

提供上下文视图块。

安装量: 10,964

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 0

类型:drupal-module

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书籍以获取更多关于如何执行此操作的信息。

有关如何贡献的更多信息,请参阅文档