README

TYPO3 Extension "youtube2news"

What does it do?

Imports YouTube videos via the official YouTube API as EXT:news "News" entities.

Summary of features

• Integrates with EXT:news to import YouTube videos as News entities
• Provides command to regularly import new/update already imported videos
• Adds a new subtype for EXT:news: "YouTube Video"

Installation

The recommended way to install the extension is by using Composer. In your Composer based TYPO3 project root, just run:

composer require dskzpt/youtube2news

Setup

1. Get your YouTube API access token by following the official documentation
2. Enter your API access token in the Extension configuration/settings.
3. Run the provided command to import videos:

   youtube2news:import-videos {channelname} {storagePid} [limit|25]

Recommended:

Setup a cronjob/scheduler task to regularly import new videos.

Compatibility

Funtionalities

Automatic import of videos

This extension comes with a command to import videos of a given youtube channel. It is recommended to set this command up to run regularly - e.g. once a day.

youtube2news:import-videos {username} {storagePid} [limit|25]

Arguments:

Local path to save downloaded files

By default all imported videos are saved in /public/fileadmin/youtube2news You can change this path via the Extensions settings local_file_storage_path option.

Contributing

Please refer to the contributing document included in this repository.

Testing

This Extension comes with a testsuite for coding styles and unit/functional tests. To run the tests simply use the provided composer script:

composer ci:test