The recommended way to install the extension is using Composer.
Run the following command within your Composer based TYPO3 project:
composer require ayacoo/ayacoo-soundcloud
And as database fields are added, the DB Analyzer must also be run once.
With plugin.tx_ayacoosoundcloud.settings.privacy = 1
you can ensure that the IFrame is built with
data-src instead of src. If you need more options to influence the HTML, you can use a PSR-14 event.
For the output, the HTML is used directly from Soundcloud.
In order not to have to access the oEmbed interface permanently, four fields are added to the sys_file_metadata table
If you want to modify the output of the Soundcloud HTML, you can use the ModifySoundcloudOutputEvent
.
In your extension, extend Configuration/Services.yaml
once:
Vendor\ExtName\EventListener\SoundcloudOutputEventListener:
tags:
- name: event.listener
identifier: 'soundcloud/output'
event: Ayacoo\AyacooSoundcloud\Event\ModifySoundcloudOutputEvent
<?php
namespace Vendor\ExtName\EventListener;
use Ayacoo\AyacooSoundcloud\Event\ModifySoundcloudOutputEvent;
class SoundcloudOutputEventListener
{
public function __invoke(ModifySoundcloudOutputEvent $event): void
{
$output = $event->getOutput();
$output = str_replace('src', 'data-src', $output);
$event->setOutput($output);
}
}
In the backend, the preview is used by TextMediaRenderer. For online media, this only displays the provider's icon, in this case soundcloud. If you want to display the thumbnail, for example, you need your own renderer that overwrites Textmedia. An example renderer is available in the project. Caution: This overwrites all text media elements, so only use this renderer as a basis.
You register a renderer in the TCA Configuration/TCA/Overrides/tt_content.php
with $GLOBALS['TCA']['tt_content']['types']['textmedia']['previewRenderer'] = \Ayacoo\AyacooSoundcloud\Rendering\SoundcloudPreviewRenderer::class;
Documentation: https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/ContentElements/CustomBackendPreview.html
AyacooSoundcloud | TYPO3 | PHP | Support / Development |
---|---|---|---|
2.x | 12.x | 8.1 - 8.3 | features, bugfixes, security updates |
1.x | 11.x | 7.4 - 8.0 | bugfixes, security updates |
ayacoo_soundcloud uses semantic versioning, which means, that
Pull Requests are gladly welcome! Nevertheless please don't forget to add an issue and connect it to your pull requests. This is very helpful to understand what kind of issue the PR is going to solve.
Bugfixes: Please describe what kind of bug your fix solve and give us feedback how to reproduce the issue. We're going to accept only bugfixes if we can reproduce the issue.
If you are happy with the extension and would like to support it in any way, I would appreciate the support of social institutions.