Skip to content
forked from fossar/selfoss

selfoss: The new multipurpose rss reader, live stream, mashup, aggregation web application

Notifications You must be signed in to change notification settings

StevenSunzh/selfoss

 
 

Repository files navigation

selfoss

Copyright (c) 2013 Tobias Zeising, [email protected]
http://selfoss.aditu.de
Licensed under the GPLv3 license
Version 2.8-SNAPSHOT

INSTALLATION

  1. Upload all files of this folder (IMPORTANT: also upload the invisible .htaccess files)
  2. Make the directories data/cache, data/favicons, data/logs, data/thumbnails, data/sqlite and public/ writeable
  3. Insert database access data in config.ini (see below -- you don't have to change anything if you want to use sqlite)
  4. You don't have to install the database, it will be created automatically
  5. Create cronjob for updating feeds and point it to http://yourselfossurl.com/update via wget or curl. You can also execute the update.php from commandline.

For further questions or on any problem use our support forum: http://selfoss.aditu.de/forum

CONFIGURATION

  1. Copy defaults.ini to config.ini
  2. Edit config.ini and delete any lines you do not wish to override
  3. Do not delete the [globals] line
  4. See http://selfoss.aditu.de/ for examples

UPDATE

  1. backup your database and your "data" folder
  2. (IMPORTANT: don't delete the "data" folder) delete all old files and folders excluding the folder "data"
  3. upload all new files and folders excluding the data folder (IMPORTANT: also upload the invisible .htaccess files)
  4. Rename your folder /data/icons into /data/favicons
  5. Delete the files /public/all.css and /public/all.js
  6. Clean your browser cache
  7. insert your current database connection and your individual configuration in config.ini. Important: we change the config.ini and add new options in newer versions. You have to update the config.ini too.

For further questions or on any problem use our support forum: http://selfoss.aditu.de/forum

OPML Import

Visit the page http://yourselfossurl.com/opml for importing your OPML File. If you are a user of the google reader then use https://www.google.com/takeout/ to get all your feeds in one opml file.

CHANGELOG

Version 2.8-SNAPSHOT

  • new Polish translation (thanks a lot to Piotr Dymacz)
  • improved Expires section and Compression in .htaccess (thanks a lot to S Anand)

Version 2.7

  • new spout for instapaper (thanks a lot to janeczku)
  • new Hungarian translation (thanks a lot to Sancho)
  • fix keyboard shortcut on some browsers
  • new spout for youtube channels (thanks a lot to Arndt Staudinger)
  • new rss feed for selfoss releases: http://selfoss.aditu.de/feed.php
  • fix bug on removing search terms (thanks a lot to ochristi)
  • translation for login page (thanks a lot to jicho)
  • new japanese language file (thanks a lot to wowo)
  • new shortcuts (thanks a lot to jicho)
  • fix issues with refreshing the items list and slow ajax requests (thanks a lot to Sean Rand)
  • don't leave behind sp-container divs when refreshing the tags (thanks a lot to Sean Rand)
  • clean up orphaned items of deleted sources (thanks a lot to Sean Rand)
  • update fat free php framework to newest versoin 3.0.6
  • only allow update for localhost or loggedin users (thanks a lot to Tiouss)
  • added Facebook page feed (thanks a lot to Thomas Muguet)
  • fix memory bug on icon generation (thanks a lot to Matthieu Codron)
  • new opml export (thanks a lot to Sean Rand)
  • new norwegian translation (thanks a lot to Kjetil Elde)
  • set default title if no one was given by the feed

Version 2.6

  • fixed OPML import for other formats (thanks a lot to Remy Gardette)
  • fix deletion of sources (no longer bad request)
  • disable tag click on smartphone
  • shortcuts mark/unmark as read and star/unstar also available on closed articles
  • fix tag list refresh

Version 2.5

  • new navigation with right/left cursor (thanks a lot to jicho)
  • replace • for IE compatibility
  • fix re-initialize entry events on screen width change (thanks a lot to Sean Rand)
  • allow optional userdefined user.css (thanks a lot to Jean Baptiste Favre)
  • some smaller css tweaks (thanks a lot to Sean Rand)
  • new parameter use_system_font for using Arial instead of Open Sans
  • new italian language file (thanks a lot to David Chionne)
  • fix duplicate article fetching on uids with more than 255 characters
  • add integrated json api
  • add error handling for feeds with wrong link
  • new swedish translation (thanks a lot to andersgd)

Version 2.4

  • prevent error on icons parsing error
  • new homepage parameter (thanks a lot to Jean Baptiste Favre)
  • new button for open an articles source
  • no error message if no unread item is available and mark all as read was pressed
  • improve logger
  • readability is now available as spout instead as global parameter
  • new share buttons for google+, twitter and facebook
  • mysql use longtext for articles content
  • improved detection of mobile devices
  • allow more tags in articles content
  • show unread items per tag in taglist (thanks a lot to Fedor Bezrukov)
  • show list of sources for filtering (thanks a lot to Fedor Bezrukov)
  • use more eye catching unread stats in main navigation
  • show source title in selfoss RSS feed (thanks a lot to Darkwing1)
  • load sources for update by last update time (thanks a lot to Lars Formella)
  • Opening feed search focuses the search input field
  • Scroll blockquotes and pre on overflow (especially good for mobile devices)
  • new option for automatically mark items as read
  • new share buttons for email and pocket (thanks a lot to Francis Noel)
  • new shortcut r for reloading the current list
  • new internationalization (language files for German, English, French, Turkish, Dutch, Czech, Russian, Latvian, traditional and simplified Chinese included)
  • make article id generation more reliable
  • fix some font issues
  • fix JavaScript error in login screen
  • autofocus username on login
  • add open in new window button for mobile view
  • allow choosing tags in article list
  • concurent multiples updates makes no longer duplicates entries
  • Reload items on mark as read
  • anonymizer support
  • selfoss rss feed support tag filtering (?tag=) (thanks a lot to Francis Noel)
  • fix tag render bug

Version 2.3

  • new shortcut library jquery hotkeys (thanks a lot to Sigill)
  • new shortcut for mark as read and switch to next in one step (thanks a lot to Sigill)
  • prevent error on png conversion
  • items will be saved in mysql databases also no icon is available
  • support of PostgreSQL Database (thanks a lot to volkadav)
  • now updates by command line are possible (thanks a lot to Jeppe Toustrup)
  • default charset on mysql is utf8
  • new readability support (thanks a lot to oxman)
  • link to opml import added
  • Use IfMoudule to avoid errors in Etags settings (thanks to vincebusam)
  • Allow tag filtering to not include partial matches (thanks to WalterWeight and bsweeney)

Version 2.2

  • update fat free php Framework to 3.0.5
  • new opml import page (thanks a lot to Michael Moore)

Version 2.1

  • security bugfix

Version 2.0

  • support of tags
  • new user interface
  • new interface for mobile devices
  • mongodb database interface temporarily removed
  • libs and third party plugins updated
  • new spout for mmo-spy.de and golem.de with full text

Version 1.3

  • search will now also search in the source title (for filtering by source)
  • data/icons renamed in data/favicons for preventing mod_rewrite problems on apache
  • improved scrolling for very long entries (thanks untitaker)
  • Using more restrictive styles on entry content (thanks untitaker)
  • redirect to base url on login/logout (thanks untitaker)
  • improved base url handling

Version 1.2

  • new json API for external software
  • support for Android selfoss app
  • improved heise spout
  • some smaller bugfixes (e.g. increased session timeout)

Version 1.1

  • hash password (you can set the salt in the config.ini and you can generate a password with following URL: http://your_selfoss_url.com/password)
  • remove unused CSS
  • minify JavaScript and CSS and collect them all in one all.js and all.css file
  • activate caching and compression in .htaccess (if supported by current apache installation)
  • code optimization and smaller bugfixes

CREDITS

Very special thanks to all contributors of pull requests here on github. Your improvements are awesome!!!

Special thanks to the great programmers of this libraries which will be used in selfoss:

Icon Source: http://blog.artcore-illustrations.de/aicons/

About

selfoss: The new multipurpose rss reader, live stream, mashup, aggregation web application

Resources

Stars

Watchers

Forks

Packages

No packages published