2016-09-05 18:05:19 +02:00
|
|
|
<?php
|
2018-11-16 21:48:59 +01:00
|
|
|
/**
|
|
|
|
* This file is part of RSS-Bridge, a PHP project capable of generating RSS and
|
|
|
|
* Atom feeds for websites that don't have one.
|
|
|
|
*
|
|
|
|
* For the full license information, please view the UNLICENSE file distributed
|
|
|
|
* with this source code.
|
|
|
|
*
|
|
|
|
* @package Core
|
|
|
|
* @license http://unlicense.org/ UNLICENSE
|
|
|
|
* @link https://github.com/rss-bridge/rss-bridge
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The bridge interface
|
|
|
|
*
|
|
|
|
* A bridge is a class that is responsible for collecting and transforming data
|
|
|
|
* from one hosting provider into an internal representation of feed data, that
|
|
|
|
* can later be transformed into different feed formats (see {@see FormatInterface}).
|
|
|
|
*
|
|
|
|
* For this purpose, all bridges need to perform three common operations:
|
|
|
|
*
|
|
|
|
* 1. Collect data from a remote site.
|
|
|
|
* 2. Extract the required contents.
|
|
|
|
* 3. Add the contents to the internal data structure.
|
|
|
|
*
|
|
|
|
* Bridges can optionally specify parameters to customize bridge behavior based
|
|
|
|
* on user input. For example, a user could specify how many items to return in
|
|
|
|
* the feed and where to get them.
|
|
|
|
*
|
|
|
|
* In order to present a bridge on the home page, and for the purpose of bridge
|
|
|
|
* specific behaviour, additional information must be provided by the bridge:
|
|
|
|
*
|
|
|
|
* * **Name**
|
|
|
|
* The name of the bridge that can be displayed to users.
|
|
|
|
*
|
|
|
|
* * **Description**
|
|
|
|
* A brief description for the bridge that can be displayed to users.
|
|
|
|
*
|
|
|
|
* * **URI**
|
|
|
|
* A link to the hosting provider.
|
|
|
|
*
|
|
|
|
* * **Maintainer**
|
|
|
|
* The GitHub username of the bridge maintainer
|
|
|
|
*
|
|
|
|
* * **Parameters**
|
|
|
|
* A list of parameters for customization
|
|
|
|
*
|
|
|
|
* * **Icon**
|
|
|
|
* A link to the favicon of the hosting provider
|
|
|
|
*
|
|
|
|
* * **Cache timeout**
|
|
|
|
* The default cache timeout for the bridge.
|
|
|
|
*/
|
2016-09-05 18:05:19 +02:00
|
|
|
interface BridgeInterface {
|
2017-02-13 19:26:39 +01:00
|
|
|
/**
|
|
|
|
* Collects data from the site
|
|
|
|
*/
|
2016-09-10 20:41:11 +02:00
|
|
|
public function collectData();
|
2017-02-13 19:26:39 +01:00
|
|
|
|
2017-02-13 20:56:19 +01:00
|
|
|
/**
|
|
|
|
* Returns the description
|
|
|
|
*
|
|
|
|
* @return string Description
|
|
|
|
*/
|
|
|
|
public function getDescription();
|
|
|
|
|
2017-02-13 19:26:39 +01:00
|
|
|
/**
|
|
|
|
* Returns an array of collected items
|
|
|
|
*
|
|
|
|
* @return array Associative array of items
|
|
|
|
*/
|
|
|
|
public function getItems();
|
|
|
|
|
2017-02-13 20:56:19 +01:00
|
|
|
/**
|
|
|
|
* Returns the bridge maintainer
|
|
|
|
*
|
|
|
|
* @return string Bridge maintainer
|
|
|
|
*/
|
|
|
|
public function getMaintainer();
|
|
|
|
|
2017-02-13 19:26:39 +01:00
|
|
|
/**
|
|
|
|
* Returns the bridge name
|
|
|
|
*
|
|
|
|
* @return string Bridge name
|
|
|
|
*/
|
2016-09-10 20:41:11 +02:00
|
|
|
public function getName();
|
2017-02-13 19:26:39 +01:00
|
|
|
|
2018-08-21 17:46:47 +02:00
|
|
|
/**
|
|
|
|
* Returns the bridge icon
|
|
|
|
*
|
|
|
|
* @return string Bridge icon
|
|
|
|
*/
|
|
|
|
public function getIcon();
|
|
|
|
|
2017-02-13 20:56:19 +01:00
|
|
|
/**
|
|
|
|
* Returns the bridge parameters
|
|
|
|
*
|
|
|
|
* @return array Bridge parameters
|
|
|
|
*/
|
|
|
|
public function getParameters();
|
|
|
|
|
2017-02-13 19:26:39 +01:00
|
|
|
/**
|
|
|
|
* Returns the bridge URI
|
|
|
|
*
|
|
|
|
* @return string Bridge URI
|
|
|
|
*/
|
2016-09-10 20:41:11 +02:00
|
|
|
public function getURI();
|
2017-02-13 19:26:39 +01:00
|
|
|
|
2018-03-14 18:06:36 +01:00
|
|
|
/**
|
|
|
|
* Returns the cache timeout
|
|
|
|
*
|
|
|
|
* @return int Cache timeout
|
|
|
|
*/
|
|
|
|
public function getCacheTimeout();
|
2018-11-26 18:05:41 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns parameters from given URL or null if URL is not applicable
|
|
|
|
*
|
|
|
|
* @param string $url URL to extract parameters from
|
|
|
|
* @return array|null List of bridge parameters or null if detection failed.
|
|
|
|
*/
|
|
|
|
public function detectParameters($url);
|
2016-09-05 18:05:19 +02:00
|
|
|
}
|