README

一个小型插件，用于处理音频文件中的 ID3 标签。

功能

文件方法可以直接查询文件并直接从 ID 标签获取信息。
文件钩子将最有用的信息提取到上传时的文件元数据中。这可以更快地检索信息。
能够从标签中提取专辑封面图片并将其存储为面板上的文件（是的，真的！）。

商业用途

此插件免费，但如果您将其用于商业项目，请考虑

安装

下载

下载并将此存储库复制到/site/plugins/kirby-gilmour。

Composer

composer require hashandsalt/kirby-gilmour

如何使用 Gilmour

当然，首先您需要在您的页面上有音频文件，并且可以选择设置一个文件蓝图来存储数据。您可以使用插件中提供的一个，将其扩展到自己的蓝图，或者直接复制并用作起点。

以下信息将可用

专辑
艺术家
标题
曲目
作曲家
流派
年份
时长

提取封面艺术

您可以通过添加以下选项到您的配置来切换专辑封面艺术作品的生成，并设置封面艺术图像的蓝图

'hashandsalt.gilmour.ripcover' => true,
'hashandsalt.gilmour.imagetemplate' => 'imageart',

用法

您可以使用文件方法直接从音频文件获取数据

<?= $file->id3('artist') ?>

或者您可以使用钩子获取的数据

<?= $file->artist() ?>

来获取封面艺术图像

<img src="<?= $file->id3('cover')?>">

遍历一些文件直接获取数据

<?php foreach($page->audio() as $mp3direct): ?>
<div class="album">

<?php if($coverimage = $mp3direct->cover()->tofile() ): ?>
  <img alt="<?= $mp3direct->title() ?> - <?= $mp3direct->album() ?>" src="<?= $coverimage->url()  ?>">
<?php endif ?>

  <ul>
    <li><?= $mp3direct->id3('album') ?></li>
    <li><?= $mp3direct->id3('artist') ?></li>
    <li><?= $mp3direct->id3('title') ?></li>
    <li><?= $mp3direct->id3('track') ?></li>
    <li><?= $mp3direct->id3('composer') ?></li>
    <li><?= $mp3direct->id3('genre') ?></li>
    <li><?= $mp3direct->id3('year') ?></li>
    <li><?= $mp3direct->id3('duration') ?></li>
  </ul>
</div>
<?php endforeach ?>

遍历一些文件从元数据获取数据

<?php foreach($page->audio() as $mp3meta):?>
<div class="album">

<?php if($imagecover = $mp3meta->cover()->tofile() ): ?>
  <img alt="<?= $mp3meta->title() ?> - <?= $mp3meta->album() ?>" src="<?= $imagecover->url()  ?>">
<?php endif ?>

  <ul>
    <li><?= $mp3meta->album() ?></li>
    <li><?= $mp3meta->artist() ?></li>
    <li><?= $mp3meta->title() ?></li>
    <li><?= $mp3meta->track() ?></li>
    <li><?= $mp3meta->composer() ?></li>
    <li><?= $mp3meta->genre() ?></li>
    <li><?= $mp3meta->year() ?></li>
    <li><?= $mp3meta->duration() ?></li>
  </ul>
</div>
<?php endforeach ?>

为什么叫 Gilmour？

世界上只有一个吉他手，他的名字叫David Gilmour。

许可证

MIT

hashandsalt / kirby-gilmour

维护者

详细信息