README
======

The News app is a an rss/atom feed aggregator. It is based on the library SimplePie.

Maintainers
-----------
* `Alessandro Cosentino <https://github.com/zimba12>`_ 
* `Bernhard Posselt <https://github.com/Raydiation>`_ 

Status
------
App is not finished yet and in rewrite.

When the first kinda working version is available it will be mentioned in this readme.

See the `milestones in the bugtracker <https://github.com/owncloud/news/issues/milestones>`_ for more information on progress


How to install the News app
---------------------------
- Install ownCloud 5.0.5 (not released yet contains a small css fix, use the stable5 branch or 5.0.4)
- Clone the App Framework app into the **/var/www** directory::

	git clone https://github.com/owncloud/appframework.git

- Clone the News app into the **/var/www** directory::

	git clone https://github.com/owncloud/news.git


- Link both into ownCloud's apps folder::

	ln -s /var/www/appframework /var/www/owncloud/apps
	ln -s /var/www/news /var/www/owncloud/apps

- Activate the App Framework App first, then activate the News app in the apps menu

- Adjust the rights so that the webserver can write into the cache directory::

    sudo chown -R www-data:www-data /var/www/news/cache

How to keep up to date
----------------------
To get the newest update you can use git. To update the appframework use::

    cd /var/www/appframework
    git pull --rebase origin master


To update the News app use::

    cd /var/www/news
    git pull --rebase origin master