PHPackages                             ayacoo/ayacoo-soundcloud - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ayacoo/ayacoo-soundcloud

ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility)

ayacoo/ayacoo-soundcloud
========================

Provides a Soundcloud online media helper

3.0.3(4mo ago)0207↑150%1GPL-2.0-or-laterPHPPHP >=8.2 < 8.6CI passing

Since Dec 18Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/ayacoo/ayacoo-soundcloud)[ Packagist](https://packagist.org/packages/ayacoo/ayacoo-soundcloud)[ Docs](https://www.ayacoo.de)[ RSS](/packages/ayacoo-ayacoo-soundcloud/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (15)Used By (0)

TYPO3 Extension ayacoo\_soundcloud
==================================

[](#typo3-extension-ayacoo_soundcloud)

1 Features
----------

[](#1-features)

- Soundcloud audios can be created as a file in the TYPO3 file list
- Soundcloud audios can be used and output with the text with media element
- Update metadata via command

2 Usage
-------

[](#2-usage)

### 2.1 Installation

[](#21-installation)

#### Installation using Composer

[](#installation-using-composer)

The recommended way to install the extension is using Composer.

Run the following command within your [Composer](https://getcomposer.org/) based TYPO3 project:

```
composer require ayacoo/ayacoo-soundcloud

```

And as database fields are added, the DB Analyzer must also be run once.

### 2.2 TypoScript settings

[](#22-typoscript-settings)

#### Privacy

[](#privacy)

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.

### 2.3 Hints

[](#23-hints)

#### Output

[](#output)

For the output, the HTML is used directly from [Soundcloud](https://developers.soundcloud.com/docs/oembed).

#### SQL changes

[](#sql-changes)

In order not to have to access the oEmbed interface permanently, three fields are added to the sys\_file\_metadata table. These table fields must use utf8mb4\_unicode\_ci collation.

3 Developer Corner
------------------

[](#3-developer-corner)

### 3.1 ModifySoundcloudOutputEvent

[](#31-modifysoundcloudoutputevent)

If you want to modify the output of the Soundcloud HTML, you can use the `ModifySoundcloudOutputEvent`.

##### EventListener registration

[](#eventlistener-registration)

In your extension, extend `Configuration/Services.yaml` once:

```
Vendor\ExtName\EventListener\SoundcloudOutputEventListener:
  tags:
    - name: event.listener
      identifier: 'soundcloud/output'
      event: Ayacoo\AyacooSoundcloud\Event\ModifySoundcloudOutputEvent
```

```