From 91a3b767a4cb00774438e39b194329a82135158c Mon Sep 17 00:00:00 2001 From: Benjamin Brahmer Date: Sat, 8 May 2021 14:39:24 +0200 Subject: Remove deprecated explore section We decided that we don't want to be a platform for news feeds. English is the only language allowed for the explore page. Entries are hand selected by the core members. Signed-off-by: Benjamin Brahmer --- old-docs/explore/README.md | 46 ---------------------------------------------- 1 file changed, 46 deletions(-) delete mode 100644 old-docs/explore/README.md diff --git a/old-docs/explore/README.md b/old-docs/explore/README.md deleted file mode 100644 index be77a2a85..000000000 --- a/old-docs/explore/README.md +++ /dev/null @@ -1,46 +0,0 @@ -# Explore Feeds Section - -The News app uses a JSON format to display the feeds in the explore feed section. - -The feeds are stored in a JSON file in the [explore](https://github.com/nextcloud/news/tree/master/lib/Explore/feeds) folder and are localized based on their filename, meaning: feeds.en.json will only be shown for English localized Nextcloud installations, feeds.de.json only for German installations. If no other localization exists, the feeds.en.json will be taken. - -You can also provide your own explore service. - -## Format - -The file has the following format: -```js -{ - "Nextcloud": [{ // category - "title": "Nextcloud Planet", - "favicon": "https://nextcloud.com/contribook/main/images/nextcloud/100.png", - "url": "https://nextcloud.com/news/", - "feed": "https://nextcloud.com/feed/", - "description": "Nextcloud Planet is a blog feed aggregator", - "votes": 1000 - }], -} -``` - -To ease the pain of constructing the JSON object, you can use a nextcloud command to automatically create it: - - php ./occ news:generate-explore https://path.com/to/feed.rss - -By passing a second parameter you can set the vote count which determines the sorting on the explore page: - - php ./occ news:generate-explore https://path.com/to/feed.rss 1000 - -You can paste the output directly into the appropriate json file but you may need to add additional categories and commas - -## Using A Webservice Instead of JSON Files - -If you are using the News app in your company/community it might be interesting to offer your users a bunch of easily to discover default feeds. You could also create a website where people can add and up-vote news feeds like bigger cloud feed readers like Feedly do it or even convert their APIs into a service for the News app (if someone wants to provide one for the News app, feel free to contact us by creating an issue in the bug tracker). - -The URL should be a path to a directory which contains a JSON file in the format of **feeds.LANG_CODE.json** where LANG_CODE is a two character language code (e.g. **en** or **de**). - -For example entering the URL **https://domain.com/directory** as explore URL will produce the following request for German users: - - GET https://domain.com/directory/feeds.de.json - - -**Do not forget to implement [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS) in your API, otherwise the request will fail!** \ No newline at end of file -- cgit v1.2.3