mirror of
https://github.com/RSS-Bridge/rss-bridge.git
synced 2025-08-03 23:27:32 +02:00
Deploying to gh-pages from @ RSS-Bridge/rss-bridge@76f5de3d0f 🚀
This commit is contained in:
Bockiii
512
Bridge_API/BridgeAbstract.html
Normal file
512
Bridge_API/BridgeAbstract.html
Normal file
@@ -0,0 +1,512 @@
|
||||
<!DOCTYPE html>
|
||||
<html class="no-js" lang="en">
|
||||
<head>
|
||||
<title>BridgeAbstract - RSS-Bridge</title>
|
||||
<meta name="description" content="The RSS feed for websites missing it">
|
||||
<meta name="author" content="RSS-Bridge Contributors">
|
||||
<meta charset="UTF-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
|
||||
<link rel="icon" href="../themes/daux/img/favicon-blue.png" type="image/x-icon">
|
||||
|
||||
<!-- Mobile -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<!-- JS -->
|
||||
<script>
|
||||
window.base_url = "../";
|
||||
document.documentElement.classList.remove('no-js');
|
||||
</script>
|
||||
|
||||
<!-- Font -->
|
||||
|
||||
<!-- CSS -->
|
||||
<link href='../themes/daux/css/theme-blue.min.css' rel='stylesheet' type='text/css'>
|
||||
<link href='../daux_libraries/search.css' rel='stylesheet' type='text/css'>
|
||||
</head>
|
||||
<body class="">
|
||||
<div class="Columns content">
|
||||
<aside class="Columns__left Collapsible">
|
||||
<button type="button" class="Button Collapsible__trigger" aria-controls="sidebar_content" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
</button>
|
||||
|
||||
<a class="Brand" href="../index.html">RSS-Bridge</a>
|
||||
|
||||
<form role='search' action="/" method="get" class="Search" id="search_form">
|
||||
<label for="search_input">
|
||||
<span class='u-visuallyHidden'>Search</span>
|
||||
</label>
|
||||
<input
|
||||
type="search"
|
||||
id="search_input"
|
||||
class="Search__field"
|
||||
placeholder="Search..."
|
||||
aria-label="Search..."
|
||||
autocomplete="on"
|
||||
results=25
|
||||
autosave=text_search
|
||||
>
|
||||
<label>
|
||||
<input type="submit" class='u-visuallyHidden' />
|
||||
<span class='u-visuallyHidden'>Search...</span>
|
||||
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
|
||||
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
|
||||
</svg>
|
||||
</label>
|
||||
</form>
|
||||
|
||||
<div class="Collapsible__content" id="sidebar_content">
|
||||
<!-- Navigation -->
|
||||
<ul class='Nav'><li class='Nav__item has-children'><a href="../General/Project_goals.html" class="Nav__item__link"><i class="Nav__arrow"> </i>General</a><ul class='Nav'><li class='Nav__item '><a href="../General/Project_goals.html">Project-goals</a></li><li class='Nav__item '><a href="../General/Contribute.html">Contribute</a></li><li class='Nav__item '><a href="../General/Requirements.html">Requirements</a></li><li class='Nav__item '><a href="../General/Screenshots.html">Screenshots</a></li><li class='Nav__item '><a href="../General/FAQ.html">FAQ</a></li><li class='Nav__item '><a href="../General/Public_Hosts.html">Public Hosts</a></li></ul></li><li class='Nav__item '><a href="../CLI/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>CLI</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../For_Hosts/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Hosts</a><ul class='Nav'><li class='Nav__item '><a href="../For_Hosts/Installation.html">Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Updating.html">Updating</a></li><li class='Nav__item '><a href="../For_Hosts/Docker_Installation.html">Docker Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Whitelisting.html">Whitelisting</a></li><li class='Nav__item '><a href="../For_Hosts/Authentication.html">Authentication</a></li><li class='Nav__item '><a href="../For_Hosts/Customizations.html">Customizations</a></li><li class='Nav__item '><a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></li></ul></li><li class='Nav__item has-children'><a href="../For_Developers/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Developers</a><ul class='Nav'><li class='Nav__item '><a href="../For_Developers/Coding_style_policy.html">Coding style policy</a></li><li class='Nav__item '><a href="../For_Developers/Pull_Request_policy.html">Pull Request policy</a></li><li class='Nav__item '><a href="../For_Developers/Folder_structure.html">Folder structure</a></li><li class='Nav__item '><a href="../For_Developers/Actions.html">Actions</a></li><li class='Nav__item '><a href="../For_Developers/Debug_mode.html">Debug mode</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../Bridge_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Bridge API</a><ul class='Nav'><li class='Nav__item '><a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></li><li class='Nav__item Nav__item--active'><a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></li><li class='Nav__item '><a href="../Bridge_API/FeedExpander.html">FeedExpander</a></li><li class='Nav__item '><a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></li></ul></li><li class='Nav__item '><a href="../Helper_functions/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Helper functions</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../Cache_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Cache API</a><ul class='Nav'><li class='Nav__item '><a href="../Cache_API/How_to_create_a_new_cache.html">How to create a new cache</a></li><li class='Nav__item '><a href="../Cache_API/CacheInterface.html">CacheInterface</a></li></ul></li><li class='Nav__item has-children'><a href="../Format_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Format API</a><ul class='Nav'><li class='Nav__item '><a href="../Format_API/How_to_create_a_new_format.html">How to create a new format</a></li><li class='Nav__item '><a href="../Format_API/FormatInterface.html">FormatInterface</a></li><li class='Nav__item '><a href="../Format_API/FormatAbstract.html">FormatAbstract</a></li></ul></li><li class='Nav__item '><a href="../Technical_recommendations/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Technical recommendations</a><ul class='Nav'></ul></li></ul>
|
||||
<div class="Links">
|
||||
<hr/>
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge" target="_blank" rel="noopener noreferrer">GitHub Repository</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/issues" target="_blank" rel="noopener noreferrer">Help/Support/Bugs</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/pkgs/container/rss-bridge" target="_blank" rel="noopener noreferrer">Docker Images</a>
|
||||
<br />
|
||||
</div>
|
||||
|
||||
<div class="CodeToggler">
|
||||
<hr/>
|
||||
<label class="Checkbox">Show Code Blocks <input type="checkbox" class="CodeToggler__button--main" checked="checked"/>
|
||||
<div class="Checkbox__indicator"></div>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="PoweredBy">
|
||||
<hr/>
|
||||
Powered by Daux.io </div>
|
||||
</div>
|
||||
</aside>
|
||||
<div class="Columns__right">
|
||||
<div class="Columns__right__content">
|
||||
<div class="doc_content">
|
||||
<article class="Page">
|
||||
|
||||
<div class="Page__header">
|
||||
<h1><a href="../Bridge_API/index.html">Bridge API</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></h1>
|
||||
<span class="ModifiedDate">
|
||||
March 22, 2022 at 1:33 PM </span>
|
||||
<span class="EditOn">
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/05_Bridge_API/02_BridgeAbstract.md" target="_blank">
|
||||
Edit on GitHub </a>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div class="s-content">
|
||||
<p><code>BridgeAbstract</code> is a base class for standard bridges. It implements the most common functions to simplify the process of adding new bridges.</p>
|
||||
<hr />
|
||||
<h1><a id="creating-a-new-bridge" href="#creating-a-new-bridge" class="Permalink" aria-hidden="true" title="Permalink">#</a>Creating a new bridge</h1>
|
||||
<p>You need four basic steps in order to create a new bridge:</p>
|
||||
<p><a href="#step-1---create-a-new-file"><strong>Step 1</strong></a> - Create a new file<br />
|
||||
<a href="#step-2---add-a-class-extending-bridgeabstract"><strong>Step 2</strong></a> - Add a class, extending <code>BridgeAbstract</code><br />
|
||||
<a href="#step-3---add-general-constants-to-the-class"><strong>Step 3</strong></a> - Add general constants to the class<br />
|
||||
<a href="#step-4---implement-a-function-to-collect-feed-data"><strong>Step 4</strong></a> - Implement a function to collect feed data</p>
|
||||
<p>These steps are described in more detail below. At the end of this document you’ll find a complete <a href="#template">template</a> based on these instructions. The pictures below show an example based on these instructions:</p>
|
||||
<details><summary>Show pictures</summary><div>
|
||||
<p><img src="../images/screenshot_bridgeabstract_example_card.png" alt="example card" /></p>
|
||||
<hr />
|
||||
<p><img src="../images/screenshot_bridgeabstract_example_atom.png" alt="example atom" /></p>
|
||||
</div></details><br>
|
||||
<p>Make sure to read these instructions carefully. Please don’t hesitate to open an <a href="https://github.com/RSS-Bridge/rss-bridge/issues" class="Link--external" rel="noopener noreferrer">Issue</a> if you have further questions (or suggestions). Once your bridge is finished, please open a <a href="https://github.com/RSS-Bridge/rss-bridge/pulls" class="Link--external" rel="noopener noreferrer">Pull Request</a>, in order to get your bridge merge into RSS-Bridge.</p>
|
||||
<hr />
|
||||
<h2><a id="step-1-create-a-new-file" href="#step-1-create-a-new-file" class="Permalink" aria-hidden="true" title="Permalink">#</a>Step 1 - Create a new file</h2>
|
||||
<p>Please read <a href="How_to_create_a_new_bridge.html">these instructions</a> on how to create a new file for RSS-Bridge.</p>
|
||||
<h2><a id="step-2-add-a-class-extending-bridgeabstract" href="#step-2-add-a-class-extending-bridgeabstract" class="Permalink" aria-hidden="true" title="Permalink">#</a>Step 2 - Add a class, extending <code>BridgeAbstract</code></h2>
|
||||
<p>Your bridge needs to be a class, which extends <code>BridgeAbstract</code>. The class name must <strong>exactly</strong> match the name of the file, without the file extension.</p>
|
||||
<p>For example: <code>MyBridge.php</code> => <code>MyBridge</code></p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP"><?PHP
|
||||
class MyBridge extends BridgeAbstract {
|
||||
|
||||
}
|
||||
// This line is empty (just imagine it!)
|
||||
</code></pre>
|
||||
</div></details>
|
||||
<h2><a id="step-3-add-general-constants-to-the-class" href="#step-3-add-general-constants-to-the-class" class="Permalink" aria-hidden="true" title="Permalink">#</a>Step 3 - Add general constants to the class</h2>
|
||||
<p>In order to present your bridge on the front page, RSS-Bridge requires a few constants:</p>
|
||||
<pre><code class="language-PHP">const NAME // Name of the Bridge (default: "Unnamed Bridge")
|
||||
const URI // URI to the target website of the bridge (default: empty)
|
||||
const DESCRIPTION // A brief description of the Bridge (default: "No description provided")
|
||||
const MAINTAINER // Name of the maintainer, i.e. your name on GitHub (default: "No maintainer")
|
||||
const PARAMETERS // (optional) Definition of additional parameters (default: empty)
|
||||
const CACHE_TIMEOUT // (optional) Defines the maximum duration for the cache in seconds (default: 3600)
|
||||
</code></pre>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP"><?PHP
|
||||
class MyBridge extends BridgeAbstract {
|
||||
const NAME = 'My Bridge';
|
||||
const URI = 'https://github.com/RSS-Bridge/rss-bridge/wiki/BridgeAbstract';
|
||||
const DESCRIPTION = 'Returns "Hello World!"';
|
||||
const MAINTAINER = 'ghost';
|
||||
}
|
||||
// This line is empty (just imagine it!)
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
<p><strong>Notice</strong>: <code>const PARAMETERS</code> can be used to request information from the user. Refer to <a href="#parameters">these instructions</a> for more information.</p>
|
||||
<h2><a id="step-4-implement-a-function-to-collect-feed-data" href="#step-4-implement-a-function-to-collect-feed-data" class="Permalink" aria-hidden="true" title="Permalink">#</a>Step 4 - Implement a function to collect feed data</h2>
|
||||
<p>In order for RSS-Bridge to collect data, you must implement the <strong>public</strong> function <code>collectData</code>. This function takes no arguments and returns nothing. It generates a list of feed elements, which must be placed into the variable <code>$this->items</code>.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP"><?PHP
|
||||
class MyBridge extends BridgeAbstract {
|
||||
const NAME = 'My Bridge';
|
||||
const URI = 'https://github.com/RSS-Bridge/rss-bridge/wiki/BridgeAbstract';
|
||||
const DESCRIPTION = 'Returns "Hello World!"';
|
||||
const MAINTAINER = 'ghost';
|
||||
|
||||
public function collectData() {
|
||||
$item = array(); // Create an empty item
|
||||
|
||||
$item['title'] = 'Hello World!';
|
||||
|
||||
$this->items[] = $item; // Add item to the list
|
||||
}
|
||||
}
|
||||
// This line is empty (just imagine it!)
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
<p>For more details on the <code>collectData</code> function refer to <a href="#collectdata">these instructions</a>.</p>
|
||||
<hr />
|
||||
<h1><a id="template" href="#template" class="Permalink" aria-hidden="true" title="Permalink">#</a>Template</h1>
|
||||
<p>Use this template to create your own bridge. Please remove any unnecessary comments and parameters.</p>
|
||||
<pre><code class="hljs php"><span class="hljs-meta"><?php</span>
|
||||
<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">MyBridge</span> <span class="hljs-keyword">extends</span> <span class="hljs-title">BridgeAbstract</span> </span>{
|
||||
<span class="hljs-keyword">const</span> NAME = <span class="hljs-string">'Unnamed bridge'</span>;
|
||||
<span class="hljs-keyword">const</span> URI = <span class="hljs-string">''</span>;
|
||||
<span class="hljs-keyword">const</span> DESCRIPTION = <span class="hljs-string">'No description provided'</span>;
|
||||
<span class="hljs-keyword">const</span> MAINTAINER = <span class="hljs-string">'No maintainer'</span>;
|
||||
<span class="hljs-keyword">const</span> PARAMETERS = <span class="hljs-keyword">array</span>(); <span class="hljs-comment">// Can be omitted!</span>
|
||||
<span class="hljs-keyword">const</span> CACHE_TIMEOUT = <span class="hljs-number">3600</span>; <span class="hljs-comment">// Can be omitted!</span>
|
||||
|
||||
<span class="hljs-keyword">public</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">collectData</span><span class="hljs-params">()</span> </span>{
|
||||
$item = <span class="hljs-keyword">array</span>(); <span class="hljs-comment">// Create an empty item</span>
|
||||
|
||||
$item[<span class="hljs-string">'title'</span>] = <span class="hljs-string">'Hello World!'</span>;
|
||||
|
||||
<span class="hljs-keyword">$this</span>->items[] = $item; <span class="hljs-comment">// Add item to the list</span>
|
||||
}
|
||||
}
|
||||
<span class="hljs-comment">// This line is empty (just imagine it!)</span>
|
||||
</code></pre>
|
||||
<h1><a id="parameters" href="#parameters" class="Permalink" aria-hidden="true" title="Permalink">#</a>PARAMETERS</h1>
|
||||
<p>You can specify additional parameters in order to customize the bridge (i.e. to specify how many items to return). This document explains how to specify those parameters and which options are available to you.</p>
|
||||
<p>For information on how to read parameter values during execution, please refer to the <a href="../Helper_functions/index.html#getinput">getInput</a> function.</p>
|
||||
<hr />
|
||||
<h2><a id="adding-parameters-to-a-bridge" href="#adding-parameters-to-a-bridge" class="Permalink" aria-hidden="true" title="Permalink">#</a>Adding parameters to a bridge</h2>
|
||||
<p>Parameters are specified as part of the bridge class. An empty list of parameters is defined as <code>const PARAMETERS = array();</code></p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP"><?PHP
|
||||
class MyBridge extends BridgeAbstract {
|
||||
/* ... */
|
||||
const PARAMETERS = array(); // Empty list of parameters (can be omitted)
|
||||
/* ... */
|
||||
}
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
<p>Parameters are organized in two levels:</p>
|
||||
<p><a href="##level-1---context"><strong>Level 1</strong></a> - Context<br />
|
||||
<a href="##level-2---parameter"><strong>Level 2</strong></a> - Parameter</p>
|
||||
<h2><a id="level-1-context" href="#level-1-context" class="Permalink" aria-hidden="true" title="Permalink">#</a>Level 1 - Context</h2>
|
||||
<p>A context is defined as a associative array of parameters. The name of a context is displayed by RSS-Bridge.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">const PARAMETERS = array(
|
||||
'My Context 1' => array(),
|
||||
'My Context 2' => array()
|
||||
);
|
||||
</code></pre>
|
||||
<p><strong>Output</strong></p>
|
||||
<p><img src="../images/bridge_context_named.png" alt="bridge context named" /></p>
|
||||
</div></details><br>
|
||||
<p><em>Notice</em>: The name of a context can be left empty if only one context is needed!</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">const PARAMETERS = array(
|
||||
array()
|
||||
);
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
<p>You can also define a set of parameters that will be applied to every possible context of your bridge. To do this, specify a context named <code>global</code>.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">const PARAMETERS = array(
|
||||
'global' => array() // Applies to all contexts!
|
||||
);
|
||||
</code></pre>
|
||||
</div></details>
|
||||
<h2><a id="level-2-parameter" href="#level-2-parameter" class="Permalink" aria-hidden="true" title="Permalink">#</a>Level 2 - Parameter</h2>
|
||||
<p>Parameters are placed inside a context. They are defined as associative array of parameter specifications. Each parameter is defined by it’s internal input name, a definition in the form <code>'n' => array();</code>, where <code>n</code> is the name with which the bridge can access the parameter during execution.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">const PARAMETERS = array(
|
||||
'My Context' => array(
|
||||
'n' => array()
|
||||
)
|
||||
);
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
<p>The parameter specification consists of various fields, listed in the table below.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">const PARAMETERS = array(
|
||||
'My Context' => array(
|
||||
'n' => array(
|
||||
'name' => 'Limit',
|
||||
'type' => 'number',
|
||||
'required' => false,
|
||||
'title' => 'Maximum number of items to return',
|
||||
'defaultValue' => 10
|
||||
)
|
||||
)
|
||||
);
|
||||
</code></pre>
|
||||
<p><strong>Output</strong></p>
|
||||
<p><img src="../images/context_parameter_example.png" alt="context parameter" /></p>
|
||||
</div></details>
|
||||
<hr />
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Parameter Name</th>
|
||||
<th>Required</th>
|
||||
<th>Type</th>
|
||||
<th>Supported values</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>name</code></td>
|
||||
<td><strong>yes</strong></td>
|
||||
<td>Text</td>
|
||||
<td></td>
|
||||
<td>Input name as displayed to the user</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>type</code></td>
|
||||
<td>no</td>
|
||||
<td>Text</td>
|
||||
<td><code>text</code>, <code>number</code>, <code>list</code>, <code>checkbox</code></td>
|
||||
<td>Type of the input (default: <code>text</code>)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>required</code></td>
|
||||
<td>no</td>
|
||||
<td>Boolean</td>
|
||||
<td><code>true</code>, <code>false</code></td>
|
||||
<td>Specifies if the parameter is required or not (default: <code>false</code>). Not supported for lists and checkboxes.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="#list-values"><code>values</code></a></td>
|
||||
<td>no</td>
|
||||
<td>associative array</td>
|
||||
<td></td>
|
||||
<td>name/value pairs used by the HTML option tag, required for type ‘<code>list</code>’</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>title</code></td>
|
||||
<td>no</td>
|
||||
<td>Text</td>
|
||||
<td></td>
|
||||
<td>Used as tool-tip when mouse-hovering over the input box</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>pattern</code></td>
|
||||
<td>no</td>
|
||||
<td>Text</td>
|
||||
<td></td>
|
||||
<td>Defines a pattern for an element of type <code>text</code>. The pattern should be mentioned in the <code>title</code> attribute!</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>exampleValue</code></td>
|
||||
<td>no</td>
|
||||
<td>Text</td>
|
||||
<td></td>
|
||||
<td>Defines an example value displayed for elements of type <code>text</code> and <code>number</code> when no data has been entered yet</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="#defaultvalue"><code>defaultValue</code></a></td>
|
||||
<td>no</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td>Defines the default value if left blank by the user</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<h4><a id="list-values" href="#list-values" class="Permalink" aria-hidden="true" title="Permalink">#</a>List values</h4>
|
||||
<p>List values are defined in an associative array where keys are the string displayed in the combo list of the <strong>RSS-Bridge</strong> web interface, and values are the content of the <option> HTML tag value attribute.</p>
|
||||
<pre><code class="language-PHP">...
|
||||
'type' => 'list',
|
||||
'values' => array(
|
||||
'Item A' => 'itemA'
|
||||
'Item B' => 'itemB'
|
||||
)
|
||||
...
|
||||
</code></pre>
|
||||
<p>If a more complex organization is required to display the values, the above key/value can be used to set a title as a key and another array as a value:</p>
|
||||
<pre><code class="language-PHP">...
|
||||
'type' => 'list',
|
||||
'values' => array(
|
||||
'Item A' => 'itemA',
|
||||
'List 1' => array(
|
||||
'Item C' => 'itemC',
|
||||
'Item D' => 'itemD'
|
||||
),
|
||||
'List 2' => array(
|
||||
'Item E' => 'itemE',
|
||||
'Item F' => 'itemF'
|
||||
),
|
||||
'Item B' => 'itemB'
|
||||
)
|
||||
...
|
||||
</code></pre>
|
||||
<h4><a id="defaultvalue" href="#defaultvalue" class="Permalink" aria-hidden="true" title="Permalink">#</a>defaultValue</h4>
|
||||
<p>This attribute defines the default value for your parameter. Its behavior depends on the <code>type</code>:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<code>text</code>: Allows any text</li>
|
||||
<li>
|
||||
<code>number</code>: Allows any number</li>
|
||||
<li>
|
||||
<code>list</code>: Must match either name or value of one element</li>
|
||||
<li>
|
||||
<code>checkbox</code>: Must be “checked” to activate the checkbox</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<h1><a id="queriedcontext" href="#queriedcontext" class="Permalink" aria-hidden="true" title="Permalink">#</a>queriedContext</h1>
|
||||
<p>The queried context is defined via <code>PARAMETERS</code> and can be accessed via <code>$this->queriedContext</code>.
|
||||
It provides a way to identify which context the bridge is called with.</p>
|
||||
<p>Example:</p>
|
||||
<pre><code class="language-PHP">...
|
||||
const PARAMETERS = array(
|
||||
'By user name' => array(
|
||||
'u' => array('name' => 'Username')
|
||||
),
|
||||
'By user ID' => array(
|
||||
'id' => array('name' => 'User ID')
|
||||
)
|
||||
);
|
||||
|
||||
...
|
||||
</code></pre>
|
||||
<p>In this example <code>$this->queriedContext</code> will either return <strong>By user name</strong> or <strong>By user ID</strong>. The queried context might return no value, so the best way to handle it is by using a case-structure:</p>
|
||||
<pre><code class="language-PHP">switch($this->queriedContext){
|
||||
case 'By user name':
|
||||
break;
|
||||
case 'By user ID':
|
||||
break;
|
||||
default: // Return default value
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="collectdata" href="#collectdata" class="Permalink" aria-hidden="true" title="Permalink">#</a>collectData</h1>
|
||||
<p>The <code>collectData</code> function is responsible for collecting data and adding items to generate feeds from. If you are unsure how to solve a specific problem, please don’t hesitate to open an <a href="https://github.com/RSS-Bridge/rss-bridge/issues" class="Link--external" rel="noopener noreferrer">Issue</a> on GitHub. Existing bridges are also a good source to learn implementing your own bridge.</p>
|
||||
<h2><a id="implementing-the-collectdata-function" href="#implementing-the-collectdata-function" class="Permalink" aria-hidden="true" title="Permalink">#</a>Implementing the <code>collectData</code> function</h2>
|
||||
<p>Implementation for the <code>collectData</code> function is specific to each bridge. However, there are certain reoccurring elements, described below. RSS-Bridge also provides functions to simplify the process of collecting and parsing HTML data (see “Helper Functions” on the sidebar)</p>
|
||||
<p>Elements collected by this function must be stored in <code>$this->items</code>. The <code>items</code> variable is an array of item elements, each of which is an associative array that may contain arbitrary keys. RSS-Bridge specifies common keys which are used to generate most common feed formats.</p>
|
||||
<details><summary>Show example</summary><div>
|
||||
<pre><code class="language-PHP">
|
||||
$item = array(); // Create a new item
|
||||
|
||||
$item['title'] = 'Hello World!';
|
||||
|
||||
$this->items[] = $item; // Add item to the list
|
||||
|
||||
</code></pre>
|
||||
</div></details><br>
|
||||
Additional keys may be added for custom APIs (ignored by RSS-Bridge).
|
||||
<h2><a id="item-parameters" href="#item-parameters" class="Permalink" aria-hidden="true" title="Permalink">#</a>Item parameters</h2>
|
||||
<p>The item array should provide as much information as possible for RSS-Bridge to generate feature rich feeds. Find below list of keys supported by RSS-Bridge.</p>
|
||||
<pre><code class="language-PHP">$item['uri'] // URI to reach the subject ("https://...")
|
||||
$item['title'] // Title of the item
|
||||
$item['timestamp'] // Timestamp of the item in numeric or text format (compatible for strtotime())
|
||||
$item['author'] // Name of the author for this item
|
||||
$item['content'] // Content in HTML format
|
||||
$item['enclosures'] // Array of URIs to an attachments (pictures, files, etc...)
|
||||
$item['categories'] // Array of categories / tags / topics
|
||||
$item['uid'] // A unique ID to identify the current item
|
||||
</code></pre>
|
||||
<p>All formats support these parameters. The formats <code>Plaintext</code> and <code>JSON</code> also support custom parameters.</p>
|
||||
<h1><a id="getdescription" href="#getdescription" class="Permalink" aria-hidden="true" title="Permalink">#</a>getDescription</h1>
|
||||
<p>The <code>getDescription</code> function returns the description for a bridge.</p>
|
||||
<p><strong>Notice:</strong> By default <strong>RSS-Bridge</strong> returns the contents of <code>const DESCRIPTION</code>, so you only have to implement this function if you require different behavior!</p>
|
||||
<pre><code class="language-PHP"> public function getDescription(){
|
||||
return self::DESCRIPTION;
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="getmaintainer" href="#getmaintainer" class="Permalink" aria-hidden="true" title="Permalink">#</a>getMaintainer</h1>
|
||||
<p>The <code>getMaintainer</code> function returns the name of the maintainer for a bridge.</p>
|
||||
<p><strong>Notice:</strong> By default <strong>RSS-Bridge</strong> returns <code>const MAINTAINER</code>, so you only have to implement this function if you require different behavior!</p>
|
||||
<pre><code class="language-PHP"> public function getMaintainer(){
|
||||
return self::MAINTAINER;
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="getname" href="#getname" class="Permalink" aria-hidden="true" title="Permalink">#</a>getName</h1>
|
||||
<p>The <code>getName</code> function returns the name of a bridge.</p>
|
||||
<p><strong>Notice:</strong> By default <strong>RSS-Bridge</strong> returns <code>const NAME</code>, so you only have to implement this function if you require different behavior!</p>
|
||||
<pre><code class="language-PHP"> public function getName(){
|
||||
return self::NAME;
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="geturi" href="#geturi" class="Permalink" aria-hidden="true" title="Permalink">#</a>getURI</h1>
|
||||
<p>The <code>getURI</code> function returns the base URI for a bridge.</p>
|
||||
<p><strong>Notice:</strong> By default <strong>RSS-Bridge</strong> returns <code>const URI</code>, so you only have to implement this function if you require different behavior!</p>
|
||||
<pre><code class="language-PHP"> public function getURI(){
|
||||
return self::URI;
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="geticon" href="#geticon" class="Permalink" aria-hidden="true" title="Permalink">#</a>getIcon</h1>
|
||||
<p>The <code>getIcon</code> function returns the URI for an icon, used as favicon in feeds.</p>
|
||||
<p>If no icon is specified by the bridge, RSS-Bridge will use a default location: <code>static::URI . '/favicon.ico'</code> (i.e. “https://github.com/favicon.ico”) which may or may not exist.</p>
|
||||
<pre><code class="language-PHP"> public function getIcon(){
|
||||
return static::URI . '/favicon.ico';
|
||||
}
|
||||
</code></pre>
|
||||
<h1><a id="detectparameters" href="#detectparameters" class="Permalink" aria-hidden="true" title="Permalink">#</a>detectParameters</h1>
|
||||
<p>The <code>detectParameters</code> function takes a URL and attempts to extract a valid set of parameters for the current bridge.</p>
|
||||
<p>If the passed URL is valid for this bridge the function should return an array of parameter -> value pairs that can be used by this bridge, or an empty array if the bridge requires no parameters. If the URL is not relevant for this bridge the function should return <code>null</code>.</p>
|
||||
<p><strong>Notice:</strong> Implementing this function is optional. By default <strong>RSS-Bridge</strong> tries to match the supplied URL to the <code>URI</code> constant defined in the bridge which may be enough for bridges without any parameters defined.</p>
|
||||
<pre><code class="language-PHP">public function detectParameters($url){
|
||||
$regex = '/^(https?:\/\/)?(www\.)?(.+?)(\/)?$/';
|
||||
if(empty(static::PARAMETERS)
|
||||
&& preg_match($regex, $url, $urlMatches) > 0
|
||||
&& preg_match($regex, static::URI, $bridgeUriMatches) > 0
|
||||
&& $urlMatches[3] === $bridgeUriMatches[3]) {
|
||||
return array();
|
||||
} else {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
</div>
|
||||
|
||||
<nav>
|
||||
<ul class="Pager">
|
||||
<li class=Pager--prev><a href="../Bridge_API/How_to_create_a_new_bridge.html">Previous</a></li> <li class=Pager--next><a href="../Bridge_API/FeedExpander.html">Next</a></li> </ul>
|
||||
</nav>
|
||||
</article>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- JS -->
|
||||
<script src="../themes/daux/js/daux.min.js"></script>
|
||||
|
||||
<script>
|
||||
|
||||
window.searchLanguage = "";
|
||||
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
|
||||
</script>
|
||||
|
||||
<!-- Search -->
|
||||
<script type="text/javascript" src="../daux_libraries/search.min.js"></script>
|
||||
|
||||
<script>
|
||||
window.search({'base_url': '../'})
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
274
Bridge_API/FeedExpander.html
Normal file
274
Bridge_API/FeedExpander.html
Normal file
@@ -0,0 +1,274 @@
|
||||
<!DOCTYPE html>
|
||||
<html class="no-js" lang="en">
|
||||
<head>
|
||||
<title>FeedExpander - RSS-Bridge</title>
|
||||
<meta name="description" content="The RSS feed for websites missing it">
|
||||
<meta name="author" content="RSS-Bridge Contributors">
|
||||
<meta charset="UTF-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
|
||||
<link rel="icon" href="../themes/daux/img/favicon-blue.png" type="image/x-icon">
|
||||
|
||||
<!-- Mobile -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<!-- JS -->
|
||||
<script>
|
||||
window.base_url = "../";
|
||||
document.documentElement.classList.remove('no-js');
|
||||
</script>
|
||||
|
||||
<!-- Font -->
|
||||
|
||||
<!-- CSS -->
|
||||
<link href='../themes/daux/css/theme-blue.min.css' rel='stylesheet' type='text/css'>
|
||||
<link href='../daux_libraries/search.css' rel='stylesheet' type='text/css'>
|
||||
</head>
|
||||
<body class="">
|
||||
<div class="Columns content">
|
||||
<aside class="Columns__left Collapsible">
|
||||
<button type="button" class="Button Collapsible__trigger" aria-controls="sidebar_content" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
</button>
|
||||
|
||||
<a class="Brand" href="../index.html">RSS-Bridge</a>
|
||||
|
||||
<form role='search' action="/" method="get" class="Search" id="search_form">
|
||||
<label for="search_input">
|
||||
<span class='u-visuallyHidden'>Search</span>
|
||||
</label>
|
||||
<input
|
||||
type="search"
|
||||
id="search_input"
|
||||
class="Search__field"
|
||||
placeholder="Search..."
|
||||
aria-label="Search..."
|
||||
autocomplete="on"
|
||||
results=25
|
||||
autosave=text_search
|
||||
>
|
||||
<label>
|
||||
<input type="submit" class='u-visuallyHidden' />
|
||||
<span class='u-visuallyHidden'>Search...</span>
|
||||
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
|
||||
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
|
||||
</svg>
|
||||
</label>
|
||||
</form>
|
||||
|
||||
<div class="Collapsible__content" id="sidebar_content">
|
||||
<!-- Navigation -->
|
||||
<ul class='Nav'><li class='Nav__item has-children'><a href="../General/Project_goals.html" class="Nav__item__link"><i class="Nav__arrow"> </i>General</a><ul class='Nav'><li class='Nav__item '><a href="../General/Project_goals.html">Project-goals</a></li><li class='Nav__item '><a href="../General/Contribute.html">Contribute</a></li><li class='Nav__item '><a href="../General/Requirements.html">Requirements</a></li><li class='Nav__item '><a href="../General/Screenshots.html">Screenshots</a></li><li class='Nav__item '><a href="../General/FAQ.html">FAQ</a></li><li class='Nav__item '><a href="../General/Public_Hosts.html">Public Hosts</a></li></ul></li><li class='Nav__item '><a href="../CLI/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>CLI</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../For_Hosts/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Hosts</a><ul class='Nav'><li class='Nav__item '><a href="../For_Hosts/Installation.html">Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Updating.html">Updating</a></li><li class='Nav__item '><a href="../For_Hosts/Docker_Installation.html">Docker Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Whitelisting.html">Whitelisting</a></li><li class='Nav__item '><a href="../For_Hosts/Authentication.html">Authentication</a></li><li class='Nav__item '><a href="../For_Hosts/Customizations.html">Customizations</a></li><li class='Nav__item '><a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></li></ul></li><li class='Nav__item has-children'><a href="../For_Developers/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Developers</a><ul class='Nav'><li class='Nav__item '><a href="../For_Developers/Coding_style_policy.html">Coding style policy</a></li><li class='Nav__item '><a href="../For_Developers/Pull_Request_policy.html">Pull Request policy</a></li><li class='Nav__item '><a href="../For_Developers/Folder_structure.html">Folder structure</a></li><li class='Nav__item '><a href="../For_Developers/Actions.html">Actions</a></li><li class='Nav__item '><a href="../For_Developers/Debug_mode.html">Debug mode</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../Bridge_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Bridge API</a><ul class='Nav'><li class='Nav__item '><a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></li><li class='Nav__item '><a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></li><li class='Nav__item Nav__item--active'><a href="../Bridge_API/FeedExpander.html">FeedExpander</a></li><li class='Nav__item '><a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></li></ul></li><li class='Nav__item '><a href="../Helper_functions/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Helper functions</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../Cache_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Cache API</a><ul class='Nav'><li class='Nav__item '><a href="../Cache_API/How_to_create_a_new_cache.html">How to create a new cache</a></li><li class='Nav__item '><a href="../Cache_API/CacheInterface.html">CacheInterface</a></li></ul></li><li class='Nav__item has-children'><a href="../Format_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Format API</a><ul class='Nav'><li class='Nav__item '><a href="../Format_API/How_to_create_a_new_format.html">How to create a new format</a></li><li class='Nav__item '><a href="../Format_API/FormatInterface.html">FormatInterface</a></li><li class='Nav__item '><a href="../Format_API/FormatAbstract.html">FormatAbstract</a></li></ul></li><li class='Nav__item '><a href="../Technical_recommendations/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Technical recommendations</a><ul class='Nav'></ul></li></ul>
|
||||
<div class="Links">
|
||||
<hr/>
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge" target="_blank" rel="noopener noreferrer">GitHub Repository</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/issues" target="_blank" rel="noopener noreferrer">Help/Support/Bugs</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/pkgs/container/rss-bridge" target="_blank" rel="noopener noreferrer">Docker Images</a>
|
||||
<br />
|
||||
</div>
|
||||
|
||||
<div class="CodeToggler">
|
||||
<hr/>
|
||||
<label class="Checkbox">Show Code Blocks <input type="checkbox" class="CodeToggler__button--main" checked="checked"/>
|
||||
<div class="Checkbox__indicator"></div>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="PoweredBy">
|
||||
<hr/>
|
||||
Powered by Daux.io </div>
|
||||
</div>
|
||||
</aside>
|
||||
<div class="Columns__right">
|
||||
<div class="Columns__right__content">
|
||||
<div class="doc_content">
|
||||
<article class="Page">
|
||||
|
||||
<div class="Page__header">
|
||||
<h1><a href="../Bridge_API/index.html">Bridge API</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../Bridge_API/FeedExpander.html">FeedExpander</a></h1>
|
||||
<span class="ModifiedDate">
|
||||
March 22, 2022 at 1:33 PM </span>
|
||||
<span class="EditOn">
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/05_Bridge_API/03_FeedExpander.md" target="_blank">
|
||||
Edit on GitHub </a>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div class="s-content">
|
||||
<p><code>FeedExpander</code> extends <a href="BridgeAbstract.html"><code>BridgeAbstract</code></a> and adds functions to collect data from existing feeds.</p>
|
||||
<p><strong>Usage example</strong>: <em>You have discovered a site that provides feeds which are hidden and inaccessible by normal means. You want your bridge to directly read the feeds and provide them via <strong>RSS-Bridge</strong></em></p>
|
||||
<p>To create a new Bridge extending <code>FeedExpander</code> you must implement all required functions of <a href="BridgeAbstract.html"><code>BridgeAbstract</code></a>. <code>FeedExpander</code> additionally provides following functions:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<a href="#the-parseitem-function"><code>parseItem</code></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="#the-getname-function"><code>getName</code></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="#the-geturi-function"><code>getURI</code></a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="#the-getdescription-function"><code>getDescription</code></a>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Find a <a href="#template">template</a> at the end of this file.</p>
|
||||
<p><strong>Notice:</strong> For a standard feed only <code>collectData</code> need to be implemented. <code>collectData</code> should call <code>$this->collectExpandableDatas('your URI here');</code> to automatically load feed items and header data (will subsequently call <code>parseItem</code> for each item in the feed). You can limit the number of items to fetch by specifying an additional parameter for: <code>$this->collectExpandableDatas('your URI here', 10)</code> (limited to 10 items).</p>
|
||||
<h2><a id="the-parseitem-function" href="#the-parseitem-function" class="Permalink" aria-hidden="true" title="Permalink">#</a>The <code>parseItem</code> function</h2>
|
||||
<p>This function receives one item from the current feed and should return one <strong>RSS-Bridge</strong> item.
|
||||
The default function does all the work to get the item data from the feed, whether it is RSS 1.0,
|
||||
RSS 2.0 or Atom 1.0. If you have to redefine this function in your <strong>RSS-Bridge</strong> for whatever reason,
|
||||
you should first call the parent function to initialize the item, then apply the changes that you require.</p>
|
||||
<p><strong>Notice:</strong> The following code sample is just an example. Implementation depends on your requirements!</p>
|
||||
<pre><code class="language-PHP">protected function parseItem($feedItem){
|
||||
$item = parent::parseItem($feedItem);
|
||||
$item['content'] = str_replace('rssbridge','RSS-Bridge',$feedItem->content);
|
||||
|
||||
return $item;
|
||||
}
|
||||
</code></pre>
|
||||
<h3><a id="helper-functions" href="#helper-functions" class="Permalink" aria-hidden="true" title="Permalink">#</a>Helper functions</h3>
|
||||
<p>The <code>FeedExpander</code> already provides a set of functions to parse RSS or Atom items based on the specifications. Where possible make use of these functions:</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>parseATOMItem</code></td>
|
||||
<td>Parses an Atom 1.0 feed item</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_0_9_1_Item</code></td>
|
||||
<td>Parses an RSS 0.91 feed item</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_1_0_Item</code></td>
|
||||
<td>Parses an RSS 1.0 feed item</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_2_0_Item</code></td>
|
||||
<td>Parses an RSS 2.0 feed item</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>In the following list you’ll find the feed tags assigned to the the <strong>RSS-Bridge</strong> item keys:</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Function</th>
|
||||
<th>uri</th>
|
||||
<th>title</th>
|
||||
<th>timestamp</th>
|
||||
<th>author</th>
|
||||
<th>content</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>parseATOMItem</code></td>
|
||||
<td>id</td>
|
||||
<td>title</td>
|
||||
<td>updated</td>
|
||||
<td>author</td>
|
||||
<td>content</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_0_9_1_Item</code></td>
|
||||
<td>link</td>
|
||||
<td>title</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td>description</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_1_0_Item</code></td>
|
||||
<td>link</td>
|
||||
<td>title</td>
|
||||
<td>dc:date</td>
|
||||
<td>dc:creator</td>
|
||||
<td>description</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>parseRSS_2_0_Item</code></td>
|
||||
<td>link, guid</td>
|
||||
<td>title</td>
|
||||
<td>pubDate, dc:date</td>
|
||||
<td>author, dc:creator</td>
|
||||
<td>description</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<h2><a id="the-getname-function" href="#the-getname-function" class="Permalink" aria-hidden="true" title="Permalink">#</a>The <code>getName</code> function</h2>
|
||||
<p>Returns the name of the current feed.</p>
|
||||
<pre><code class="language-PHP">return $this->name;
|
||||
</code></pre>
|
||||
<p><strong>Notice:</strong> Only implement this function if you require different behavior!</p>
|
||||
<h2><a id="the-geturi-function" href="#the-geturi-function" class="Permalink" aria-hidden="true" title="Permalink">#</a>The <code>getURI</code> function</h2>
|
||||
<p>Return the uri for the current feed.</p>
|
||||
<pre><code class="language-PHP">return $this->uri;
|
||||
</code></pre>
|
||||
<p><strong>Notice:</strong> Only implement this function if you require different behavior!</p>
|
||||
<h2><a id="the-getdescription-function" href="#the-getdescription-function" class="Permalink" aria-hidden="true" title="Permalink">#</a>The <code>getDescription</code> function</h2>
|
||||
<p>Returns the description for the current bridge.</p>
|
||||
<pre><code class="language-PHP">return $this->description;
|
||||
</code></pre>
|
||||
<p><strong>Notice:</strong> Only implement this function if you require different behavior!</p>
|
||||
<h1><a id="template" href="#template" class="Permalink" aria-hidden="true" title="Permalink">#</a>Template</h1>
|
||||
<p>This is the template for a new bridge:</p>
|
||||
<pre><code class="language-PHP"><?php
|
||||
class MySiteBridge extends FeedExpander {
|
||||
|
||||
const MAINTAINER = 'No maintainer';
|
||||
const NAME = 'Unnamed bridge';
|
||||
const URI = '';
|
||||
const DESCRIPTION = 'No description provided';
|
||||
const PARAMETERS = array();
|
||||
const CACHE_TIMEOUT = 3600;
|
||||
|
||||
public function collectData(){
|
||||
$this->collectExpandableDatas('your feed URI');
|
||||
}
|
||||
}
|
||||
// Imaginary empty line!
|
||||
</code></pre>
|
||||
</div>
|
||||
|
||||
<nav>
|
||||
<ul class="Pager">
|
||||
<li class=Pager--prev><a href="../Bridge_API/BridgeAbstract.html">Previous</a></li> <li class=Pager--next><a href="../Bridge_API/XPathAbstract.html">Next</a></li> </ul>
|
||||
</nav>
|
||||
</article>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- JS -->
|
||||
<script src="../themes/daux/js/daux.min.js"></script>
|
||||
|
||||
<script>
|
||||
|
||||
window.searchLanguage = "";
|
||||
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
|
||||
</script>
|
||||
|
||||
<!-- Search -->
|
||||
<script type="text/javascript" src="../daux_libraries/search.min.js"></script>
|
||||
|
||||
<script>
|
||||
window.search({'base_url': '../'})
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
178
Bridge_API/How_to_create_a_new_bridge.html
Normal file
178
Bridge_API/How_to_create_a_new_bridge.html
Normal file
@@ -0,0 +1,178 @@
|
||||
<!DOCTYPE html>
|
||||
<html class="no-js" lang="en">
|
||||
<head>
|
||||
<title>How to create a new bridge - RSS-Bridge</title>
|
||||
<meta name="description" content="The RSS feed for websites missing it">
|
||||
<meta name="author" content="RSS-Bridge Contributors">
|
||||
<meta charset="UTF-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
|
||||
<link rel="icon" href="../themes/daux/img/favicon-blue.png" type="image/x-icon">
|
||||
|
||||
<!-- Mobile -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<!-- JS -->
|
||||
<script>
|
||||
window.base_url = "../";
|
||||
document.documentElement.classList.remove('no-js');
|
||||
</script>
|
||||
|
||||
<!-- Font -->
|
||||
|
||||
<!-- CSS -->
|
||||
<link href='../themes/daux/css/theme-blue.min.css' rel='stylesheet' type='text/css'>
|
||||
<link href='../daux_libraries/search.css' rel='stylesheet' type='text/css'>
|
||||
</head>
|
||||
<body class="">
|
||||
<div class="Columns content">
|
||||
<aside class="Columns__left Collapsible">
|
||||
<button type="button" class="Button Collapsible__trigger" aria-controls="sidebar_content" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
</button>
|
||||
|
||||
<a class="Brand" href="../index.html">RSS-Bridge</a>
|
||||
|
||||
<form role='search' action="/" method="get" class="Search" id="search_form">
|
||||
<label for="search_input">
|
||||
<span class='u-visuallyHidden'>Search</span>
|
||||
</label>
|
||||
<input
|
||||
type="search"
|
||||
id="search_input"
|
||||
class="Search__field"
|
||||
placeholder="Search..."
|
||||
aria-label="Search..."
|
||||
autocomplete="on"
|
||||
results=25
|
||||
autosave=text_search
|
||||
>
|
||||
<label>
|
||||
<input type="submit" class='u-visuallyHidden' />
|
||||
<span class='u-visuallyHidden'>Search...</span>
|
||||
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
|
||||
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
|
||||
</svg>
|
||||
</label>
|
||||
</form>
|
||||
|
||||
<div class="Collapsible__content" id="sidebar_content">
|
||||
<!-- Navigation -->
|
||||
<ul class='Nav'><li class='Nav__item has-children'><a href="../General/Project_goals.html" class="Nav__item__link"><i class="Nav__arrow"> </i>General</a><ul class='Nav'><li class='Nav__item '><a href="../General/Project_goals.html">Project-goals</a></li><li class='Nav__item '><a href="../General/Contribute.html">Contribute</a></li><li class='Nav__item '><a href="../General/Requirements.html">Requirements</a></li><li class='Nav__item '><a href="../General/Screenshots.html">Screenshots</a></li><li class='Nav__item '><a href="../General/FAQ.html">FAQ</a></li><li class='Nav__item '><a href="../General/Public_Hosts.html">Public Hosts</a></li></ul></li><li class='Nav__item '><a href="../CLI/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>CLI</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../For_Hosts/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Hosts</a><ul class='Nav'><li class='Nav__item '><a href="../For_Hosts/Installation.html">Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Updating.html">Updating</a></li><li class='Nav__item '><a href="../For_Hosts/Docker_Installation.html">Docker Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Whitelisting.html">Whitelisting</a></li><li class='Nav__item '><a href="../For_Hosts/Authentication.html">Authentication</a></li><li class='Nav__item '><a href="../For_Hosts/Customizations.html">Customizations</a></li><li class='Nav__item '><a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></li></ul></li><li class='Nav__item has-children'><a href="../For_Developers/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Developers</a><ul class='Nav'><li class='Nav__item '><a href="../For_Developers/Coding_style_policy.html">Coding style policy</a></li><li class='Nav__item '><a href="../For_Developers/Pull_Request_policy.html">Pull Request policy</a></li><li class='Nav__item '><a href="../For_Developers/Folder_structure.html">Folder structure</a></li><li class='Nav__item '><a href="../For_Developers/Actions.html">Actions</a></li><li class='Nav__item '><a href="../For_Developers/Debug_mode.html">Debug mode</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../Bridge_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Bridge API</a><ul class='Nav'><li class='Nav__item Nav__item--active'><a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></li><li class='Nav__item '><a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></li><li class='Nav__item '><a href="../Bridge_API/FeedExpander.html">FeedExpander</a></li><li class='Nav__item '><a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></li></ul></li><li class='Nav__item '><a href="../Helper_functions/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Helper functions</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../Cache_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Cache API</a><ul class='Nav'><li class='Nav__item '><a href="../Cache_API/How_to_create_a_new_cache.html">How to create a new cache</a></li><li class='Nav__item '><a href="../Cache_API/CacheInterface.html">CacheInterface</a></li></ul></li><li class='Nav__item has-children'><a href="../Format_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Format API</a><ul class='Nav'><li class='Nav__item '><a href="../Format_API/How_to_create_a_new_format.html">How to create a new format</a></li><li class='Nav__item '><a href="../Format_API/FormatInterface.html">FormatInterface</a></li><li class='Nav__item '><a href="../Format_API/FormatAbstract.html">FormatAbstract</a></li></ul></li><li class='Nav__item '><a href="../Technical_recommendations/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Technical recommendations</a><ul class='Nav'></ul></li></ul>
|
||||
<div class="Links">
|
||||
<hr/>
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge" target="_blank" rel="noopener noreferrer">GitHub Repository</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/issues" target="_blank" rel="noopener noreferrer">Help/Support/Bugs</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/pkgs/container/rss-bridge" target="_blank" rel="noopener noreferrer">Docker Images</a>
|
||||
<br />
|
||||
</div>
|
||||
|
||||
<div class="CodeToggler">
|
||||
<hr/>
|
||||
<label class="Checkbox">Show Code Blocks <input type="checkbox" class="CodeToggler__button--main" checked="checked"/>
|
||||
<div class="Checkbox__indicator"></div>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="PoweredBy">
|
||||
<hr/>
|
||||
Powered by Daux.io </div>
|
||||
</div>
|
||||
</aside>
|
||||
<div class="Columns__right">
|
||||
<div class="Columns__right__content">
|
||||
<div class="doc_content">
|
||||
<article class="Page">
|
||||
|
||||
<div class="Page__header">
|
||||
<h1><a href="../Bridge_API/index.html">Bridge API</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></h1>
|
||||
<span class="ModifiedDate">
|
||||
March 22, 2022 at 1:33 PM </span>
|
||||
<span class="EditOn">
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md" target="_blank">
|
||||
Edit on GitHub </a>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div class="s-content">
|
||||
<p>Create a new file in the <code>bridges/</code> folder (see <a href="../For_Developers/Folder_structure.html">Folder structure</a>).</p>
|
||||
<p>The file name must be named according to following specification:</p>
|
||||
<ul>
|
||||
<li>It starts with the full name of the site</li>
|
||||
<li>All white-space must be removed</li>
|
||||
<li>The first letter of a word is written in upper-case, unless the site name is specified otherwise (example: Freenews, not FreeNews, because the site is named ‘Freenews’)</li>
|
||||
<li>The first character must be upper-case</li>
|
||||
<li>The file name must end with ‘Bridge’</li>
|
||||
<li>The file type must be PHP, written in <strong>small</strong> letters (seriously!) “.php”</li>
|
||||
</ul>
|
||||
<p><strong>Examples:</strong></p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Site</th>
|
||||
<th>Filename</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Wikipedia</td>
|
||||
<td><strong>Wikipedia</strong>Bridge.php</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Facebook</td>
|
||||
<td><strong>Facebook</strong>Bridge.php</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>GitHub</td>
|
||||
<td><strong>GitHub</strong>Bridge.php</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Freenews</td>
|
||||
<td><strong>Freenews</strong>Bridge.php</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>The file must start with the PHP tags and end with an empty line. The closing tag <code>?></code> is <a href="http://php.net/basic-syntax.instruction-separation" class="Link--external" rel="noopener noreferrer">omitted</a>.</p>
|
||||
<p><strong>Example:</strong></p>
|
||||
<pre><code class="hljs php"><span class="hljs-meta"><?php</span>
|
||||
<span class="hljs-comment">// PHP code here</span>
|
||||
<span class="hljs-comment">// This line is empty (just imagine it!)</span>
|
||||
</code></pre>
|
||||
<p>The next step is to extend one of the base classes. Refer to one of an base classes listed on the <a href="index.html">Bridge API</a> page.</p>
|
||||
</div>
|
||||
|
||||
<nav>
|
||||
<ul class="Pager">
|
||||
<li class=Pager--prev><a href="../Bridge_API/index.html">Previous</a></li> <li class=Pager--next><a href="../Bridge_API/BridgeAbstract.html">Next</a></li> </ul>
|
||||
</nav>
|
||||
</article>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- JS -->
|
||||
<script src="../themes/daux/js/daux.min.js"></script>
|
||||
|
||||
<script>
|
||||
|
||||
window.searchLanguage = "";
|
||||
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
|
||||
</script>
|
||||
|
||||
<!-- Search -->
|
||||
<script type="text/javascript" src="../daux_libraries/search.min.js"></script>
|
||||
|
||||
<script>
|
||||
window.search({'base_url': '../'})
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
243
Bridge_API/XPathAbstract.html
Normal file
243
Bridge_API/XPathAbstract.html
Normal file
@@ -0,0 +1,243 @@
|
||||
<!DOCTYPE html>
|
||||
<html class="no-js" lang="en">
|
||||
<head>
|
||||
<title>XPathAbstract - RSS-Bridge</title>
|
||||
<meta name="description" content="The RSS feed for websites missing it">
|
||||
<meta name="author" content="RSS-Bridge Contributors">
|
||||
<meta charset="UTF-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
|
||||
<link rel="icon" href="../themes/daux/img/favicon-blue.png" type="image/x-icon">
|
||||
|
||||
<!-- Mobile -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<!-- JS -->
|
||||
<script>
|
||||
window.base_url = "../";
|
||||
document.documentElement.classList.remove('no-js');
|
||||
</script>
|
||||
|
||||
<!-- Font -->
|
||||
|
||||
<!-- CSS -->
|
||||
<link href='../themes/daux/css/theme-blue.min.css' rel='stylesheet' type='text/css'>
|
||||
<link href='../daux_libraries/search.css' rel='stylesheet' type='text/css'>
|
||||
</head>
|
||||
<body class="">
|
||||
<div class="Columns content">
|
||||
<aside class="Columns__left Collapsible">
|
||||
<button type="button" class="Button Collapsible__trigger" aria-controls="sidebar_content" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
</button>
|
||||
|
||||
<a class="Brand" href="../index.html">RSS-Bridge</a>
|
||||
|
||||
<form role='search' action="/" method="get" class="Search" id="search_form">
|
||||
<label for="search_input">
|
||||
<span class='u-visuallyHidden'>Search</span>
|
||||
</label>
|
||||
<input
|
||||
type="search"
|
||||
id="search_input"
|
||||
class="Search__field"
|
||||
placeholder="Search..."
|
||||
aria-label="Search..."
|
||||
autocomplete="on"
|
||||
results=25
|
||||
autosave=text_search
|
||||
>
|
||||
<label>
|
||||
<input type="submit" class='u-visuallyHidden' />
|
||||
<span class='u-visuallyHidden'>Search...</span>
|
||||
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
|
||||
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
|
||||
</svg>
|
||||
</label>
|
||||
</form>
|
||||
|
||||
<div class="Collapsible__content" id="sidebar_content">
|
||||
<!-- Navigation -->
|
||||
<ul class='Nav'><li class='Nav__item has-children'><a href="../General/Project_goals.html" class="Nav__item__link"><i class="Nav__arrow"> </i>General</a><ul class='Nav'><li class='Nav__item '><a href="../General/Project_goals.html">Project-goals</a></li><li class='Nav__item '><a href="../General/Contribute.html">Contribute</a></li><li class='Nav__item '><a href="../General/Requirements.html">Requirements</a></li><li class='Nav__item '><a href="../General/Screenshots.html">Screenshots</a></li><li class='Nav__item '><a href="../General/FAQ.html">FAQ</a></li><li class='Nav__item '><a href="../General/Public_Hosts.html">Public Hosts</a></li></ul></li><li class='Nav__item '><a href="../CLI/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>CLI</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../For_Hosts/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Hosts</a><ul class='Nav'><li class='Nav__item '><a href="../For_Hosts/Installation.html">Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Updating.html">Updating</a></li><li class='Nav__item '><a href="../For_Hosts/Docker_Installation.html">Docker Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Whitelisting.html">Whitelisting</a></li><li class='Nav__item '><a href="../For_Hosts/Authentication.html">Authentication</a></li><li class='Nav__item '><a href="../For_Hosts/Customizations.html">Customizations</a></li><li class='Nav__item '><a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></li></ul></li><li class='Nav__item has-children'><a href="../For_Developers/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Developers</a><ul class='Nav'><li class='Nav__item '><a href="../For_Developers/Coding_style_policy.html">Coding style policy</a></li><li class='Nav__item '><a href="../For_Developers/Pull_Request_policy.html">Pull Request policy</a></li><li class='Nav__item '><a href="../For_Developers/Folder_structure.html">Folder structure</a></li><li class='Nav__item '><a href="../For_Developers/Actions.html">Actions</a></li><li class='Nav__item '><a href="../For_Developers/Debug_mode.html">Debug mode</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../Bridge_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Bridge API</a><ul class='Nav'><li class='Nav__item '><a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></li><li class='Nav__item '><a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></li><li class='Nav__item '><a href="../Bridge_API/FeedExpander.html">FeedExpander</a></li><li class='Nav__item Nav__item--active'><a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></li></ul></li><li class='Nav__item '><a href="../Helper_functions/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Helper functions</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../Cache_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Cache API</a><ul class='Nav'><li class='Nav__item '><a href="../Cache_API/How_to_create_a_new_cache.html">How to create a new cache</a></li><li class='Nav__item '><a href="../Cache_API/CacheInterface.html">CacheInterface</a></li></ul></li><li class='Nav__item has-children'><a href="../Format_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Format API</a><ul class='Nav'><li class='Nav__item '><a href="../Format_API/How_to_create_a_new_format.html">How to create a new format</a></li><li class='Nav__item '><a href="../Format_API/FormatInterface.html">FormatInterface</a></li><li class='Nav__item '><a href="../Format_API/FormatAbstract.html">FormatAbstract</a></li></ul></li><li class='Nav__item '><a href="../Technical_recommendations/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Technical recommendations</a><ul class='Nav'></ul></li></ul>
|
||||
<div class="Links">
|
||||
<hr/>
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge" target="_blank" rel="noopener noreferrer">GitHub Repository</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/issues" target="_blank" rel="noopener noreferrer">Help/Support/Bugs</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/pkgs/container/rss-bridge" target="_blank" rel="noopener noreferrer">Docker Images</a>
|
||||
<br />
|
||||
</div>
|
||||
|
||||
<div class="CodeToggler">
|
||||
<hr/>
|
||||
<label class="Checkbox">Show Code Blocks <input type="checkbox" class="CodeToggler__button--main" checked="checked"/>
|
||||
<div class="Checkbox__indicator"></div>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="PoweredBy">
|
||||
<hr/>
|
||||
Powered by Daux.io </div>
|
||||
</div>
|
||||
</aside>
|
||||
<div class="Columns__right">
|
||||
<div class="Columns__right__content">
|
||||
<div class="doc_content">
|
||||
<article class="Page">
|
||||
|
||||
<div class="Page__header">
|
||||
<h1><a href="../Bridge_API/index.html">Bridge API</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></h1>
|
||||
<span class="ModifiedDate">
|
||||
March 22, 2022 at 1:33 PM </span>
|
||||
<span class="EditOn">
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/05_Bridge_API/04_XPathAbstract.md" target="_blank">
|
||||
Edit on GitHub </a>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div class="s-content">
|
||||
<p><code>XPathAbstract</code> extends <a href="BridgeAbstract.html"><code>BridgeAbstract</code></a> and adds functionality for generating feeds based on <em>XPath expressions</em>. It makes creation of new bridges easy and if you’re familiar with XPath expressions this class is probably the right point for you to start with.</p>
|
||||
<p>At the end of this document you’ll find a complete <a href="#template">template</a> based on these instructions.</p>
|
||||
<hr />
|
||||
<h1><a id="required-constants" href="#required-constants" class="Permalink" aria-hidden="true" title="Permalink">#</a>Required constants</h1>
|
||||
<p>To create a new Bridge based on <code>XPathAbstract</code> your inheriting class should specify a set of constants describing the feed and the XPath expressions.</p>
|
||||
<p>It is advised to override constants inherited from <a href="BridgeAbstract.html#step-3---add-general-constants-to-the-class"><code>BridgeAbstract</code></a> aswell.</p>
|
||||
<h2><a id="class-constant-feed-source-url" href="#class-constant-feed-source-url" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>FEED_SOURCE_URL</code></h2>
|
||||
<p>Source Web page URL (should provide either HTML or XML content). You can specify any website URL which serves data suited for display in RSS feeds</p>
|
||||
<h2><a id="class-constant-xpath-expression-feed-title" href="#class-constant-xpath-expression-feed-title" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_FEED_TITLE</code></h2>
|
||||
<p>XPath expression for extracting the feed title from the source page. If this is left blank or does not provide any data <code>BridgeAbstract::getName()</code> is used instead as the feed’s title.</p>
|
||||
<h2><a id="class-constant-xpath-expression-feed-icon" href="#class-constant-xpath-expression-feed-icon" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_FEED_ICON</code></h2>
|
||||
<p>XPath expression for extracting the feed favicon URL from the source page. If this is left blank or does not provide any data <code>BridgeAbstract::getIcon()</code> is used instead as the feed’s favicon URL.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item" href="#class-constant-xpath-expression-item" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM</code></h2>
|
||||
<p>XPath expression for extracting the feed items from the source page. Enter an XPath expression matching a list of dom nodes, each node containing one feed article item in total (usually a surrounding <code><div></code> or <code><span></code> tag). This will be the context nodes for all of the following expressions. This expression usually starts with a single forward slash.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-title" href="#class-constant-xpath-expression-item-title" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_TITLE</code></h2>
|
||||
<p>XPath expression for extracting an item title from the item context. This expression should match a node contained within each article item node containing the article headline. It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-content" href="#class-constant-xpath-expression-item-content" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_CONTENT</code></h2>
|
||||
<p>XPath expression for extracting an item’s content from the item context. This expression should match a node contained within each article item node containing the article content or description. It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-uri" href="#class-constant-xpath-expression-item-uri" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_URI</code></h2>
|
||||
<p>XPath expression for extracting an item link from the item context. This expression should match a node’s attribute containing the article URL (usually the href attribute of an <code><a></code> tag). It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node. Attributes can be selected by prepending an <code>@</code> char before the attributes name.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-author" href="#class-constant-xpath-expression-item-author" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_AUTHOR</code></h2>
|
||||
<p>XPath expression for extracting an item author from the item context. This expression should match a node contained within each article item node containing the article author’s name. It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-timestamp" href="#class-constant-xpath-expression-item-timestamp" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_TIMESTAMP</code></h2>
|
||||
<p>XPath expression for extracting an item timestamp from the item context. This expression should match a node or node’s attribute containing the article timestamp or date (parsable by PHP’s strtotime function). It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node. Attributes can be selected by prepending an <code>@</code> char before the attributes name.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-enclosures" href="#class-constant-xpath-expression-item-enclosures" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_ENCLOSURES</code></h2>
|
||||
<p>XPath expression for extracting item enclosures (media content like images or movies) from the item context. This expression should match a node’s attribute containing an article image URL (usually the src attribute of an <img> tag or a style attribute). It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node. Attributes can be selected by prepending an <code>@</code> char before the attributes name.</p>
|
||||
<h2><a id="class-constant-xpath-expression-item-categories" href="#class-constant-xpath-expression-item-categories" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>XPATH_EXPRESSION_ITEM_CATEGORIES</code></h2>
|
||||
<p>XPath expression for extracting an item category from the item context. This expression should match a node or node’s attribute contained within each article item node containing the article category. This could be inside <div> or <span> tags or sometimes be hidden in a data attribute. It should start with a dot followed by two forward slashes, referring to any descendant nodes of the article item node. Attributes can be selected by prepending an <code>@</code> char before the attributes name.</p>
|
||||
<h2><a id="class-constant-setting-fix-encoding" href="#class-constant-setting-fix-encoding" class="Permalink" aria-hidden="true" title="Permalink">#</a>Class constant <code>SETTING_FIX_ENCODING</code></h2>
|
||||
<p>Turns on automatic fixing of encoding errors. Set this to true for fixing feed encoding by invoking PHP’s <code>utf8_decode</code> function on all extracted texts. Try this in case you see “broken” or “weird” characters in your feed where you’d normally expect umlauts or any other non-ascii characters.</p>
|
||||
<h1><a id="optional-methods" href="#optional-methods" class="Permalink" aria-hidden="true" title="Permalink">#</a>Optional methods</h1>
|
||||
<p><code>XPathAbstract</code> offers a set of methods which can be overridden by derived classes for fine tuning and customization. This is optional. The methods provided for overriding can be grouped into three categories.</p>
|
||||
<h2><a id="methods-for-providing-xpath-expressions" href="#methods-for-providing-xpath-expressions" class="Permalink" aria-hidden="true" title="Permalink">#</a>Methods for providing XPath expressions</h2>
|
||||
<p>Usually XPath expressions are defined in the class constants described above. By default the following base methods just return the value of its corresponding class constant. However deriving classed can override them in case if XPath expressions need to be formed dynamically or based on conditions. In case any of these methods is defined, the method’s return value is used instead of the corresponding constant for providing the value.</p>
|
||||
<h3><a id="method-getsourceurl" href="#method-getsourceurl" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getSourceUrl()</code></h3>
|
||||
<p>Should return the source Web page URL used as a base for applying the XPath expressions.</p>
|
||||
<h3><a id="method-getexpressiontitle" href="#method-getexpressiontitle" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionTitle()</code></h3>
|
||||
<p>Should return the XPath expression for extracting the feed title from the source page.</p>
|
||||
<h3><a id="method-getexpressionicon" href="#method-getexpressionicon" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionIcon()</code></h3>
|
||||
<p>Should return the XPath expression for extracting the feed favicon from the source page.</p>
|
||||
<h3><a id="method-getexpressionitem" href="#method-getexpressionitem" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItem()</code></h3>
|
||||
<p>Should return the XPath expression for extracting the feed items from the source page.</p>
|
||||
<h3><a id="method-getexpressionitemtitle" href="#method-getexpressionitemtitle" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemTitle()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item title from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemcontent" href="#method-getexpressionitemcontent" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemContent()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item’s content from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemuri" href="#method-getexpressionitemuri" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemUri()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item link from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemauthor" href="#method-getexpressionitemauthor" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemAuthor()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item author from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemtimestamp" href="#method-getexpressionitemtimestamp" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemTimestamp()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item timestamp from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemenclosures" href="#method-getexpressionitemenclosures" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemEnclosures()</code></h3>
|
||||
<p>Should return the XPath expression for extracting item enclosures (media content like images or movies) from the item context.</p>
|
||||
<h3><a id="method-getexpressionitemcategories" href="#method-getexpressionitemcategories" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getExpressionItemCategories()</code></h3>
|
||||
<p>Should return the XPath expression for extracting an item category from the item context.</p>
|
||||
<h3><a id="method-getsettingfixencoding" href="#method-getsettingfixencoding" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>getSettingFixEncoding()</code></h3>
|
||||
<p>Should return the Fix encoding setting value (bool true or false).</p>
|
||||
<h2><a id="methods-for-providing-feed-data" href="#methods-for-providing-feed-data" class="Permalink" aria-hidden="true" title="Permalink">#</a>Methods for providing feed data</h2>
|
||||
<p>Those methods are invoked for providing the HTML source as a base for applying the XPath expressions as well as feed meta data as the title and icon.</p>
|
||||
<h3><a id="method-providewebsitecontent" href="#method-providewebsitecontent" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>provideWebsiteContent()</code></h3>
|
||||
<p>This method should return the HTML source as a base for the XPath expressions. Usually it merely returns the HTML content of the URL specified in the constant <code>FEED_SOURCE_URL</code> retrieved by curl. Some sites however require user authentication mechanisms, the use of special cookies and/or headers, where the direct retrival using standard curl would not suffice. In that case this method should be overridden and take care of the page retrival.</p>
|
||||
<h3><a id="method-providefeedtitle" href="#method-providefeedtitle" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>provideFeedTitle()</code></h3>
|
||||
<p>This method should provide the feed title. Usually the XPath expression defined in <code>XPATH_EXPRESSION_FEED_TITLE</code> is used for extracting the title directly from the page source.</p>
|
||||
<h3><a id="method-providefeedicon" href="#method-providefeedicon" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>provideFeedIcon()</code></h3>
|
||||
<p>This method should provide the feed title. Usually the XPath expression defined in <code>XPATH_EXPRESSION_FEED_ICON</code> is used for extracting the title directly from the page source.</p>
|
||||
<h3><a id="method-providefeeditems" href="#method-providefeeditems" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>provideFeedItems()</code></h3>
|
||||
<p>This method should provide the feed items. Usually the XPath expression defined in <code>XPATH_EXPRESSION_ITEM</code> is used for extracting the items from the page source. All other XPath expressions are applied on a per-item basis, item by item, and only on the item’s contents.</p>
|
||||
<h2><a id="methods-for-formatting-and-filtering-feed-item-attributes" href="#methods-for-formatting-and-filtering-feed-item-attributes" class="Permalink" aria-hidden="true" title="Permalink">#</a>Methods for formatting and filtering feed item attributes</h2>
|
||||
<p>The following methods are invoked after extraction of the feed items from the source. Each of them expect one parameter, the value of the corresponding field, which then can be processed and transformed by the method. You can override these methods in order to format or filter parts of the feed output.</p>
|
||||
<h3><a id="method-formatitemtitle" href="#method-formatitemtitle" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>formatItemTitle()</code></h3>
|
||||
<p>Accepts the items title values as parameter, processes and returns it. Should return a string.</p>
|
||||
<h3><a id="method-formatitemcontent" href="#method-formatitemcontent" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>formatItemContent()</code></h3>
|
||||
<p>Accepts the items content as parameter, processes and returns it. Should return a string.</p>
|
||||
<h3><a id="method-formatitemuri" href="#method-formatitemuri" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>formatItemUri()</code></h3>
|
||||
<p>Accepts the items link URL as parameter, processes and returns it. Should return a string.</p>
|
||||
<h3><a id="method-formatitemauthor" href="#method-formatitemauthor" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>formatItemAuthor()</code></h3>
|
||||
<p>Accepts the items author as parameter, processes and returns it. Should return a string.</p>
|
||||
<h3><a id="method-formatitemtimestamp" href="#method-formatitemtimestamp" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>formatItemTimestamp()</code></h3>
|
||||
<p>Accepts the items creation timestamp as parameter, processes and returns it. Should return a unix timestamp as integer.</p>
|
||||
<h3><a id="method-cleanimageurl" href="#method-cleanimageurl" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>cleanImageUrl()</code></h3>
|
||||
<p>Method invoked for cleaning feed icon and item image URL’s. Extracts the image URL from the passed parameter, stripping any additional content. Furthermore makes sure that relative image URL’s get transformed to absolute ones.</p>
|
||||
<h3><a id="method-fixencoding" href="#method-fixencoding" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>fixEncoding()</code></h3>
|
||||
<p>Only invoked when class constant <code>SETTING_FIX_ENCODING</code> is set to true. It then passes all extracted string values through PHP’s <code>utf8_decode</code> function.</p>
|
||||
<h3><a id="method-generateitemid" href="#method-generateitemid" class="Permalink" aria-hidden="true" title="Permalink">#</a>Method <code>generateItemId()</code></h3>
|
||||
<p>This method plays in important role for generating feed item ids for all extracted items. Every feed item needs an unique identifier (Uid), so that your feed reader updates the original item instead of adding a duplicate in case an items content is updated on the source site. Usually the items link URL is a good candidate the the Uid.</p>
|
||||
<hr />
|
||||
<h1><a id="template" href="#template" class="Permalink" aria-hidden="true" title="Permalink">#</a>Template</h1>
|
||||
<p>Use this template to create your own bridge. Please remove any unnecessary comments and parameters.</p>
|
||||
<pre><code class="language-PHP"><?php
|
||||
|
||||
class TestBridge extends XPathAbstract {
|
||||
const NAME = 'Test';
|
||||
const URI = 'https://www.unbemerkt.eu/de/blog/';
|
||||
const DESCRIPTION = 'Test';
|
||||
const MAINTAINER = 'your name';
|
||||
const CACHE_TIMEOUT = 3600;
|
||||
|
||||
const FEED_SOURCE_URL = 'https://www.unbemerkt.eu/de/blog/';
|
||||
const XPATH_EXPRESSION_ITEM = '/html[1]/body[1]/section[1]/section[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[*]/article[1]';
|
||||
const XPATH_EXPRESSION_ITEM_TITLE = './/a[@target="_self"]';
|
||||
const XPATH_EXPRESSION_ITEM_CONTENT = './/div[@class="post-content"]';
|
||||
const XPATH_EXPRESSION_ITEM_URI = './/a[@class="more-btn"]/@href';
|
||||
const XPATH_EXPRESSION_ITEM_AUTHOR = '/html[1]/body[1]/section[1]/div[2]/div[1]/div[1]/h1[1]';
|
||||
const XPATH_EXPRESSION_ITEM_TIMESTAMP = './/time/@datetime';
|
||||
const XPATH_EXPRESSION_ITEM_ENCLOSURES = './/img/@data-src';
|
||||
const SETTING_FIX_ENCODING = false;
|
||||
}
|
||||
</code></pre>
|
||||
</div>
|
||||
|
||||
<nav>
|
||||
<ul class="Pager">
|
||||
<li class=Pager--prev><a href="../Bridge_API/FeedExpander.html">Previous</a></li> <li class=Pager--next><a href="../Helper_functions/index.html">Next</a></li> </ul>
|
||||
</nav>
|
||||
</article>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- JS -->
|
||||
<script src="../themes/daux/js/daux.min.js"></script>
|
||||
|
||||
<script>
|
||||
|
||||
window.searchLanguage = "";
|
||||
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
|
||||
</script>
|
||||
|
||||
<!-- Search -->
|
||||
<script type="text/javascript" src="../daux_libraries/search.min.js"></script>
|
||||
|
||||
<script>
|
||||
window.search({'base_url': '../'})
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
158
Bridge_API/index.html
Normal file
158
Bridge_API/index.html
Normal file
@@ -0,0 +1,158 @@
|
||||
<!DOCTYPE html>
|
||||
<html class="no-js" lang="en">
|
||||
<head>
|
||||
<title>Bridge API - RSS-Bridge</title>
|
||||
<meta name="description" content="The RSS feed for websites missing it">
|
||||
<meta name="author" content="RSS-Bridge Contributors">
|
||||
<meta charset="UTF-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
|
||||
<link rel="icon" href="../themes/daux/img/favicon-blue.png" type="image/x-icon">
|
||||
|
||||
<!-- Mobile -->
|
||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<!-- JS -->
|
||||
<script>
|
||||
window.base_url = "../";
|
||||
document.documentElement.classList.remove('no-js');
|
||||
</script>
|
||||
|
||||
<!-- Font -->
|
||||
|
||||
<!-- CSS -->
|
||||
<link href='../themes/daux/css/theme-blue.min.css' rel='stylesheet' type='text/css'>
|
||||
<link href='../daux_libraries/search.css' rel='stylesheet' type='text/css'>
|
||||
</head>
|
||||
<body class="">
|
||||
<div class="Columns content">
|
||||
<aside class="Columns__left Collapsible">
|
||||
<button type="button" class="Button Collapsible__trigger" aria-controls="sidebar_content" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
<span class="Collapsible__trigger__bar"></span>
|
||||
</button>
|
||||
|
||||
<a class="Brand" href="../index.html">RSS-Bridge</a>
|
||||
|
||||
<form role='search' action="/" method="get" class="Search" id="search_form">
|
||||
<label for="search_input">
|
||||
<span class='u-visuallyHidden'>Search</span>
|
||||
</label>
|
||||
<input
|
||||
type="search"
|
||||
id="search_input"
|
||||
class="Search__field"
|
||||
placeholder="Search..."
|
||||
aria-label="Search..."
|
||||
autocomplete="on"
|
||||
results=25
|
||||
autosave=text_search
|
||||
>
|
||||
<label>
|
||||
<input type="submit" class='u-visuallyHidden' />
|
||||
<span class='u-visuallyHidden'>Search...</span>
|
||||
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
|
||||
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
|
||||
</svg>
|
||||
</label>
|
||||
</form>
|
||||
|
||||
<div class="Collapsible__content" id="sidebar_content">
|
||||
<!-- Navigation -->
|
||||
<ul class='Nav'><li class='Nav__item has-children'><a href="../General/Project_goals.html" class="Nav__item__link"><i class="Nav__arrow"> </i>General</a><ul class='Nav'><li class='Nav__item '><a href="../General/Project_goals.html">Project-goals</a></li><li class='Nav__item '><a href="../General/Contribute.html">Contribute</a></li><li class='Nav__item '><a href="../General/Requirements.html">Requirements</a></li><li class='Nav__item '><a href="../General/Screenshots.html">Screenshots</a></li><li class='Nav__item '><a href="../General/FAQ.html">FAQ</a></li><li class='Nav__item '><a href="../General/Public_Hosts.html">Public Hosts</a></li></ul></li><li class='Nav__item '><a href="../CLI/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>CLI</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../For_Hosts/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Hosts</a><ul class='Nav'><li class='Nav__item '><a href="../For_Hosts/Installation.html">Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Updating.html">Updating</a></li><li class='Nav__item '><a href="../For_Hosts/Docker_Installation.html">Docker Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Heroku_Installation.html">Heroku Installation</a></li><li class='Nav__item '><a href="../For_Hosts/Whitelisting.html">Whitelisting</a></li><li class='Nav__item '><a href="../For_Hosts/Authentication.html">Authentication</a></li><li class='Nav__item '><a href="../For_Hosts/Customizations.html">Customizations</a></li><li class='Nav__item '><a href="../For_Hosts/Custom_Configuration.html">Custom Configuration</a></li></ul></li><li class='Nav__item has-children'><a href="../For_Developers/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>For Developers</a><ul class='Nav'><li class='Nav__item '><a href="../For_Developers/Coding_style_policy.html">Coding style policy</a></li><li class='Nav__item '><a href="../For_Developers/Pull_Request_policy.html">Pull Request policy</a></li><li class='Nav__item '><a href="../For_Developers/Folder_structure.html">Folder structure</a></li><li class='Nav__item '><a href="../For_Developers/Actions.html">Actions</a></li><li class='Nav__item '><a href="../For_Developers/Debug_mode.html">Debug mode</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../Bridge_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Bridge API</a><ul class='Nav'><li class='Nav__item '><a href="../Bridge_API/How_to_create_a_new_bridge.html">How to create a new bridge</a></li><li class='Nav__item '><a href="../Bridge_API/BridgeAbstract.html">BridgeAbstract</a></li><li class='Nav__item '><a href="../Bridge_API/FeedExpander.html">FeedExpander</a></li><li class='Nav__item '><a href="../Bridge_API/XPathAbstract.html">XPathAbstract</a></li></ul></li><li class='Nav__item '><a href="../Helper_functions/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Helper functions</a><ul class='Nav'></ul></li><li class='Nav__item has-children'><a href="../Cache_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Cache API</a><ul class='Nav'><li class='Nav__item '><a href="../Cache_API/How_to_create_a_new_cache.html">How to create a new cache</a></li><li class='Nav__item '><a href="../Cache_API/CacheInterface.html">CacheInterface</a></li></ul></li><li class='Nav__item has-children'><a href="../Format_API/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Format API</a><ul class='Nav'><li class='Nav__item '><a href="../Format_API/How_to_create_a_new_format.html">How to create a new format</a></li><li class='Nav__item '><a href="../Format_API/FormatInterface.html">FormatInterface</a></li><li class='Nav__item '><a href="../Format_API/FormatAbstract.html">FormatAbstract</a></li></ul></li><li class='Nav__item '><a href="../Technical_recommendations/index.html" class="Nav__item__link"><i class="Nav__arrow"> </i>Technical recommendations</a><ul class='Nav'></ul></li></ul>
|
||||
<div class="Links">
|
||||
<hr/>
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge" target="_blank" rel="noopener noreferrer">GitHub Repository</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/issues" target="_blank" rel="noopener noreferrer">Help/Support/Bugs</a>
|
||||
<br />
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/pkgs/container/rss-bridge" target="_blank" rel="noopener noreferrer">Docker Images</a>
|
||||
<br />
|
||||
</div>
|
||||
|
||||
<div class="CodeToggler">
|
||||
<hr/>
|
||||
<label class="Checkbox">Show Code Blocks <input type="checkbox" class="CodeToggler__button--main" checked="checked"/>
|
||||
<div class="Checkbox__indicator"></div>
|
||||
</label>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="PoweredBy">
|
||||
<hr/>
|
||||
Powered by Daux.io </div>
|
||||
</div>
|
||||
</aside>
|
||||
<div class="Columns__right">
|
||||
<div class="Columns__right__content">
|
||||
<div class="doc_content">
|
||||
<article class="Page">
|
||||
|
||||
<div class="Page__header">
|
||||
<h1><a href="../Bridge_API/index.html">Bridge API</a></h1>
|
||||
<span class="ModifiedDate">
|
||||
March 22, 2022 at 1:33 PM </span>
|
||||
<span class="EditOn">
|
||||
<a href="https://github.com/RSS-Bridge/rss-bridge/tree/master/docs/05_Bridge_API/index.md" target="_blank">
|
||||
Edit on GitHub </a>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div class="s-content">
|
||||
<p>A <em>Bridge</em> is an class that allows <strong>RSS-Bridge</strong> to create an RSS-feed from a website. A <em>Bridge</em> represents one element on the <a href="../General/Screenshots.html">Welcome screen</a> and covers one or more sites to return feeds for. It is developed in a PHP file located in the <code>bridges/</code> folder (see <a href="../For_Developers/Folder_structure.html">Folder structure</a>) and extends one of the base classes of <strong>RSS-Bridge</strong>:</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Base class</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><a href="BridgeAbstract.html"><code>BridgeAbstract</code></a></td>
|
||||
<td>This class is intended for standard <em>Bridges</em> that need to filter HTML pages for content.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="FeedExpander.html"><code>FeedExpander</code></a></td>
|
||||
<td>This class is an extension of <code>HttpCachingBridgeAbstract</code>, designed to load existing feeds into <strong>RSS-Bridge</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="XPathAbstract.html"><code>XPathAbstract</code></a></td>
|
||||
<td>This class is meant as an alternative base class for bridge implementations. It offers preliminary functionality for generating feeds based on <em>XPath expressions</em>.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>For more information about how to create a new <em>Bridge</em>, read <a href="How_to_create_a_new_bridge.html">How to create a new Bridge?</a></p>
|
||||
</div>
|
||||
|
||||
<nav>
|
||||
<ul class="Pager">
|
||||
<li class=Pager--prev><a href="../For_Developers/Debug_mode.html">Previous</a></li> <li class=Pager--next><a href="../Bridge_API/How_to_create_a_new_bridge.html">Next</a></li> </ul>
|
||||
</nav>
|
||||
</article>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- JS -->
|
||||
<script src="../themes/daux/js/daux.min.js"></script>
|
||||
|
||||
<script>
|
||||
|
||||
window.searchLanguage = "";
|
||||
window.searchTranslation = {"Search_one_result":"1 result","Search_results":"!count results","Search_no_results":"Nothing found","Search_common_words_ignored":"Common words are largely ignored","Search_too_short":"Search too short","Search_one_character_or_more":"Should be one character or more","Search_should_be_x_or_more":"Should be !min characters or more","Link_previous":"Previous","Link_next":"Next"};
|
||||
</script>
|
||||
|
||||
<!-- Search -->
|
||||
<script type="text/javascript" src="../daux_libraries/search.min.js"></script>
|
||||
|
||||
<script>
|
||||
window.search({'base_url': '../'})
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user