nativefairie/userlisting

提供从第三方服务获取用户列表的模块。

dev-master 2024-03-18 23:30 UTC

This package is not auto-updated.

Last update: 2024-10-02 00:22:50 UTC


README

这包含一个Drupal模块,该模块与第三方API集成以获取并显示块中的dummyusers数据。该模块提供功能以以分页格式列出从Reqres.in dummy API获取的用户,并显示他们的电子邮件地址、名和姓。这些字段的标签可以在块内自定义,并且当块通过EventSubscriber放置在区域中时,用户将作为dummyuser内容实体实例创建。这些dummy用户有一个状态标志,它们将从用户列表的块中排除。

注意:此Drupal模块的目的是测试我的Drupal知识,但可以作为在自定义drupal块中实现分页或更多内容的示例。

任务

  • 创建一个作为Composer包的Drupal模块
  • https://reqres.in/模拟API集成
  • 提供第三方服务的用户列表块
  • 在块中显示用户的电子邮件地址、名和姓
  • 支持配置
    • 每页项目数量
    • 电子邮件字段标签
    • 名字段标签
    • 姓字段标签 暴露一个扩展点,供消费者筛选用户列表
  • 在包中包含单元测试
  • 可能包括集成和/或API测试。

设置与步骤

  1. 使用composer在完全功能的Drupal环境中安装此模块

    $composer require nativefairie/userlisting:*@dev
    
  2. 启用模块

    $drush en userlisting
    
  3. 转到"/admin/structure/block"并放置自定义的"用户列表"块,最好在"内容下方"区域,因为该块仅包含"模拟"样式。

  4. 放置时,块表单包含标签的自定义以及每页显示的用户数量

重要:当按下"保存"按钮时,将获取用户并将它们插入我们的自定义DummyUser内容实体。

  1. 现在,检查放置块的页面上的结果。
  2. 此外,本地用户有一个“状态”标志,允许管理员筛选用户列表,这将在块列表中反映出来。
  3. 要更改它,请转到"/admin/content/dummyuser"并按下"编辑"按钮。切换状态复选框,并注意刷新时块相应更新。

注意:当卸载模块时,不会自动使用在userlisting.module中实现的hook_module_preuninstall()钩子删除创建的实体,这可以作为一个改进。相反,导航到"/admin/modules/uninstall/entity/dummyuser"并删除它们。