summaryrefslogtreecommitdiffstats
path: root/docs/admin.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/admin.md')
-rw-r--r--docs/admin.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/admin.md b/docs/admin.md
new file mode 100644
index 000000000..00efe0d20
--- /dev/null
+++ b/docs/admin.md
@@ -0,0 +1,33 @@
+# Admin
+Welcome to the Admin documentation this page explains some of the configuration options for news.
+## System Cron
+Nextcloud uses Cron to run regular jobs, News relies on the Job system to execute the feed updates.
+Alternatively you may use an [external updater](https://nextcloud.github.io/news/clients/#update-clients), in this case you need to disable the system cron in the settings.
+
+## Auto purge count
+This value represents the maximum amount of read items per feed, which won't be deleted by the cleanup job.
+For example if the value is 200 there can be maximum 200 read items per feed, unread items are unaffected.
+If old articles reappear after being read, try to increase this value.
+To disable this feature use -1.
+
+## Explore Service
+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!**
+
+## Update Interval
+The update interval is used to determine when the next update of all feeds should be done.
+You can configure this interval as an administrator.
+
+### What is a good update interval?
+That depends on your individual needs.
+Please keep in mind that the lower you set your update interval, the more traffic is generated.
+
+### Can I set individual update intervals per feed/user?
+No, the job framework of Nextcloud is pretty simple. \ No newline at end of file