README

使用此扩展，您可以在TYPO3网站上显示Mastodon推文。它将通过API收集数据，并以Mastodon社交墙的形式显示。

截图

Mastodon社交墙示例：

需求

• TYPO3 v11.5 | v12.4

安装

• 使用composer (composer req mediadreams/md_mastodon) 或扩展管理器安装扩展

• 包含扩展的静态TypoScript

• 通过设置自己的Typoscript常量来配置扩展

• plugin.tx_mdmastodon_api.settings.includeCss
  如果项目（推文）使用masonry布局，请包含标准CSS样式。

模板布局

您可以在TsConfig中配置模板布局

tx_mdmastodon_api {
  templateLayouts {
    1 = First layout
    2 = Second layout
  }
}

使用方法

创建一个新的Mastodon配置类型的条目

1. 选择模块列表
2. 选择一个用于存储记录的页面（可以是任何页面）
3. 点击创建新记录按钮
4. 在Mastodon社交网络API部分中点击Mastodon配置

现在您可以为要显示在网站上的Mastodon源配置。

步骤1-3：

步骤4：

配置源

• 标题
  仅用于内部使用。在插件中选择源时需要。
• 基础API URL
  Mastodon基础API URL，例如 https://mastodon.social/api/v1/。如果您已在typoscript常量 plugin.tx_mdmastodon_api.settings.apiUrl 中配置了默认URL，则可以留空。
• API令牌
  Mastodon API令牌。如果您已在typoscript常量 plugin.tx_mdmastodon_api.settings.apiToken 中配置了默认API令牌，则可以留空。
  注意：在生成API密钥时，请确保已为您的Mastodon应用程序赋予了适当的权限。
• API方法
  选择Mastodon API方法。
  • 账户
    发布到指定账户的状态。见https://docs.joinmastodon.org/methods/accounts/#statuses
    • 账户ID（必需）
      Mastodon数据库中账户的ID。
    • 排除回复
      过滤掉回复其他账户的状态。
    • 排除重新发布
      过滤掉响应中的增强。
    • 固定
      仅过滤固定状态。
  • 标签时间线
    查看包含给定标签的公共状态。见https://docs.joinmastodon.org/methods/timelines/#tag
    • 标签
      标签名称（不包括#符号）。
  • 主页时间线
    查看关注用户发布的状态。见https://docs.joinmastodon.org/methods/timelines/#home
  • 列表时间线
    在给定的列表时间线中查看状态。请参阅https://docs.joinmastodon.org/methods/timelines/#list
    • 列表 ID
      数据库中列表的本地 Mastodon ID。
  • 公共时间线
    实例的公共时间线。请参阅https://docs.joinmastodon.org/methods/timelines/#public
• 仅媒体
  仅显示带有媒体的状态。
• 更新频率
  决定源应多久更新一次（以秒为单位）。
• 导入日期（只读）
  最后更新日期。
• 数据（只读）
  API 调用的 JSON 响应。

创建调度任务

• 选择模块 调度器
• 点击按钮 添加任务
• 在字段 类 中选择 执行控制台命令
• 选择一个 频率。注意：这可以设置为例如 5 分钟，相应的 Mastodon 源将按照配置更新（字段 更新频率）。
• 在字段 可调度命令。保存并重新打开以定义命令参数 中选择 mdmastodon:import
• 保存

创建插件以显示条目

• 选择模块 页面
• 选择显示 Mastodon 源的页面
• 创建类型为 通用插件 的新内容元素
• 切换到 插件 选项卡并选择 Mastodon
• 在字段 Mastodon 配置 中找到之前创建的配置
• 通过设置字段 限制 中的值来决定显示多少条条目
• 保存

注意

请注意，在插件可以显示之前，需要通过运行调度任务来导入源！

错误和已知问题

如果您发现错误，请在Github 上添加一个问题。

感谢

非常感谢所有使这个卓越的 TYPO3 项目成为可能的人！

TYPO3 项目 - 启发人们分享！