mirror of
https://github.com/Chouchen/ShikiryuRSS.git
synced 2024-11-22 07:48:51 +01:00
📝 update README
This commit is contained in:
parent
317d9e37e8
commit
4eac721473
77
README.md
77
README.md
@ -1,9 +1,29 @@
|
|||||||
All documentation @ http://labs.shikiryu.com/SRSS/#_how
|
# SћíкïяўЦЯSS
|
||||||
|
|
||||||
|
> PHP library reading and creating RSS
|
||||||
|
|
||||||
**disclaimer:**
|
**disclaimer:**
|
||||||
This class is functionnal. Anyway, use it only if you don't have other choices.
|
This class is functional. Anyway, use it only if you don't have other choices.
|
||||||
For example, [Zend](http://framework.zend.com/manual/current/en/modules/zend.feed.introduction.html) and Symfony got their own RSS factory, don't add another one in.
|
For example, [Zend](http://framework.zend.com/manual/current/en/modules/zend.feed.introduction.html) and Symfony got their own RSS factory, don't add another one in.
|
||||||
|
|
||||||
|
|
||||||
|
## :books: Table of Contents
|
||||||
|
|
||||||
|
- [Installation](#package-installation)
|
||||||
|
- [Usage](#rocket-usage)
|
||||||
|
- [Features](#sparkles-features)
|
||||||
|
- [Support](#hammer_and_wrench-support)
|
||||||
|
- [Contributing](#memo-contributing)
|
||||||
|
- [License](#scroll-license)
|
||||||
|
|
||||||
|
## :package: Installation
|
||||||
|
|
||||||
|
```sh
|
||||||
|
composer install shikiryu/shikiryurss
|
||||||
|
```
|
||||||
|
|
||||||
|
## :rocket: Usage
|
||||||
|
|
||||||
----------------------------------
|
----------------------------------
|
||||||
|
|
||||||
How to make it read RSS?
|
How to make it read RSS?
|
||||||
@ -22,8 +42,7 @@ Then, you can take care of articles. You can select a precise article :
|
|||||||
|
|
||||||
Or looping them :
|
Or looping them :
|
||||||
|
|
||||||
foreach($rss as $article)
|
foreach($rss as $article) {
|
||||||
{
|
|
||||||
echo '<a href="'.$article->link.'">'. SRSSTools::formatDate('d/m/y', $item->pubDate).' '.$item->title.'';
|
echo '<a href="'.$article->link.'">'. SRSSTools::formatDate('d/m/y', $item->pubDate).' '.$item->title.'';
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -34,7 +53,11 @@ If you like arrays, you can transform the RSS into an array :
|
|||||||
You can also save it into your server with :
|
You can also save it into your server with :
|
||||||
|
|
||||||
$rss->save('/www/rss/rss.xml'); // example
|
$rss->save('/www/rss/rss.xml'); // example
|
||||||
|
|
||||||
|
Or finally, you can display it with :
|
||||||
|
|
||||||
|
$rss->show();
|
||||||
|
|
||||||
----------------------------------
|
----------------------------------
|
||||||
|
|
||||||
How to make it create RSS?
|
How to make it create RSS?
|
||||||
@ -53,7 +76,7 @@ Those 3 are mandatory to validate your RSS, other options can be added.
|
|||||||
Then, you can add articles. Let's imagine $content contains an array from your database.
|
Then, you can add articles. Let's imagine $content contains an array from your database.
|
||||||
|
|
||||||
foreach($content as $item){
|
foreach($content as $item){
|
||||||
$rssitem= new SRSSItem; // we create an item
|
$rssitem = new Item(); // we create an item
|
||||||
$rssitem->title = $item["title"]; // adding title (option)
|
$rssitem->title = $item["title"]; // adding title (option)
|
||||||
$rssitem->link = $item['link']; // adding link (option)
|
$rssitem->link = $item['link']; // adding link (option)
|
||||||
$rssitem->pubDate = $item["date"]; // date automatically transformed into RSS format (option)
|
$rssitem->pubDate = $item["date"]; // date automatically transformed into RSS format (option)
|
||||||
@ -72,5 +95,43 @@ The other one does the opposite and add the next item in top of your RSS
|
|||||||
|
|
||||||
----------------------------------
|
----------------------------------
|
||||||
|
|
||||||
Contact :
|
## :sparkles: Features
|
||||||
https://shikiryu.com/contact
|
|
||||||
|
<dl>
|
||||||
|
<dt>Read every RSS 2.0</dt>
|
||||||
|
<dd>
|
||||||
|
Based on RSS 2.0 specifications.
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
<dl>
|
||||||
|
<dt>Write and validate RSS 2.0 file</dt>
|
||||||
|
<dd>
|
||||||
|
Based on RSS 2.0 specifications.
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
|
## :hammer_and_wrench: Support
|
||||||
|
|
||||||
|
Please [open an issue](https://github.com/Chouchen/ShikiryuRSS/issues) for support.
|
||||||
|
|
||||||
|
|
||||||
|
## :memo: Contributing
|
||||||
|
|
||||||
|
Please contribute using [Github Flow](https://guides.github.com/introduction/flow/). Create a branch, add commits, and [open a pull request](https://github.com/Chouchen/ShikiryuRSS/pulls).
|
||||||
|
|
||||||
|
## :scroll: License
|
||||||
|
|
||||||
|
[Creative Commons Attribution NonCommercial (CC-BY-NC)](<https://tldrlegal.com/license/creative-commons-attribution-noncommercial-(cc-nc)>) © [Chouchen](https://github.com/Chouchen/)
|
||||||
|
|
||||||
|
All documentation @ http://labs.shikiryu.com/SRSS/#_how.
|
||||||
|
|
||||||
|
Contact : https://shikiryu.com/contact
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user