Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dauskonzept/twitter2news

TYPO3 Extension to import Tweets as EXT:news articles
https://github.com/dauskonzept/twitter2news

import news php socialmedia twitter typo3 typo3-cms-extension typo3-extension

Last synced: about 1 month ago
JSON representation

TYPO3 Extension to import Tweets as EXT:news articles

Host: GitHub
URL: https://github.com/dauskonzept/twitter2news
Owner: dauskonzept
License: gpl-2.0
Created: 2023-01-03T12:03:16.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2024-04-24T06:52:27.000Z (9 months ago)
Last Synced: 2024-11-30T05:48:56.216Z (about 1 month ago)
Topics: import, news, php, socialmedia, twitter, typo3, typo3-cms-extension, typo3-extension
Language: PHP
Homepage: https://www.dauskonzept.de
Size: 45.9 KB
Stars: 1
Watchers: 1
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        [![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)

[![TYPO3 11](https://img.shields.io/badge/TYPO3-11-orange.svg)](https://get.typo3.org/version/11)

[![Latest Stable Version](http://poser.pugx.org/dskzpt/twitter2news/v)](https://packagist.org/packages/dskzpt/twitter2news)

[![Total Downloads](http://poser.pugx.org/dskzpt/twitter2news/downloads)](https://packagist.org/packages/dskzpt/twitter2news)

[![Latest Unstable Version](http://poser.pugx.org/dskzpt/twitter2news/v/unstable)](https://packagist.org/packages/dskzpt/twitter2news)

[![License](http://poser.pugx.org/dskzpt/twitter2news/license)](https://packagist.org/packages/dskzpt/twitter2news)

[![PHP Version Require](http://poser.pugx.org/dskzpt/twitter2news/require/php)](https://packagist.org/packages/dskzpt/twitter2news)

TYPO3 Extension "twitter2news"

=================================

## What does it do?

Imports tweets via the official Twitter API

as [EXT:news](https://github.com/georgringer/news)

"News" entities.

**Summary of features**

* Integrates with [EXT:news](https://github.com/georgringer/news) to import

  tweets as News entities

* Provides command to regularly import new/update already imported tweets

* Adds a new subtype for EXT:news: "Tweet"

## Installation

The recommended way to install the extension is by

using [Composer](https://getcomposer.org/). In your Composer based TYPO3 project

root, just run:

composer require dskzpt/twitter2news


## Setup

1. Get your twitter API access tokens by following

   the [official documentation](https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api)

2. Enter your API access tokens in the Extension configuration/settings.

3. Run the provided command to import tweets: 
twitter2news:import-tweets

   {username} {storagePid} [limit|25|max:100] [--no-retweets] [--category [CATEGORY]]


__Recommended__:

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

## Compatibility

| Version | TYPO3 | News       | PHP        | Support/Development                  |

|---------|-------|------------|------------|--------------------------------------|

| 1.x     | 11.5  | 9.0 - 10.x | 7.4 - 8.0️ | Features, Bugfixes, Security Updates |

## Funtionalities

### Automatic import of posts

This extension comes with a command to import tweets of a given twitter handle.

It is recommended to set this command up to run regularly - e.g. once a day.

twitter2news:import-tweets {username} {storagePid} [limit|25|max:100] [--no-retweets] [--category [CATEGORY]]


__Arguments:__

| Name          | Description                                                                      |

|---------------|----------------------------------------------------------------------------------|

| username      | The users twitter handle to import tweets from                                   |

| storagePid    | The PID to save the imported tweets                                              |

| limit         | The maximum number of latest tweets to import (Optional. Default: 25 / max: 100) |

| --no-retweets | Exclude retweets from import (Optional)                                          |

| --category    | One or more news category uids to save the news records (Optional. Integer)      |

### Local path to save downloaded files

By default all images/videos in imported posts are saved in 

/public/fileadmin/twitter2news

You can change this path via the Extensions settings 

local_file_storage_path option.

## Known issues / limitations

* The max number of Tweets to import is currently limited to 100 ("the last 100

  tweets of a user"). That is the Twitter APIs limit for one tweets in one

  response. This limit can be fixed by making use of the APIs pagination

  functionality.

## Contributing

Please refer to the [contributing](CONTRIBUTING.md) 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