wallabag v2.0.0-beta.2

If you missed our recent blog posts, here are the main features of wallabag v2:

• a REST API (you can have a look to the documentation)
• authorization via oAuth2
• a new default theme, called material
• save an article, read it, favorite it, archive it. (Hopefully)
• annotations: In each article you read, you can write annotations. (read the doc)
• assign tags to entries
• edit article titles
• RSS feeds (with ability to limit number of articles)
• create a new account from the config page
• filter entries by reading time, domain name, creation date, status, etc.
• recover passwords from login page (you have to fill your email on config page)
• picture preview, if available, is displayed for each entry
• Public registration
• migration from wallabag v1/v2 (based on JSON export) (read the doc)
• migration from Pocket (it works, but we need to implement asynchronous import: if you have too many articles, it can fail) (read the doc)
• exports in many formats (PDF, JSON, EPUB, MOBI, XML, CSV and TXT).
• 2-Factor authentication via email (read the doc)
• Tagging rule: create a rule to automatically assign tags to entries! (read the doc)
• German, French, Turkish, Persian, Romanian, Polish, Danish, Spanish and English translations
• Added Quickstart for beginners (when you don't have any entries)
• maintenance mode (useful when you'll upgrade your wallabag platform)
• Internal settings for administrator (the account created during installation). We need to documentate this part of wallabag.
• For 3rd apps developers, a developer page is available to create API token

We have work to do on our API, you can have a look on this pull request.

What's new since last beta?

• change the way to install wallabag via composer (composer install instead of composer create-project to make updates easier)
• API: For 3rd apps developers, we added a developer page to create API token
• API: added more properties (starred and archived) on entries (#1634)
• API: you can now have the wallabag version via the /api/version endpoint
• when you import articles from 3rd services (like Pocket), you can mark all the entries as read
• We added wallabag in our page title, to avoid confusion via the original article #1756
• Fixed Docker timezone #1726
• spanish translation
• documentation about filters http://doc.wallabag.org/en/master/user/filters.html

We didn't write database migrations for this beta, but this feature is planned for next versions.
If you want to upgrade your previous installation, please run this command bin/console doctrine:schema:update --force.

You can see the full changelog here: https://github.com/wallabag/wallabag/compare/2.0.0-beta.1...2.0.0-beta.2.

Documentation

v2 documentation is already available (we still need to write some chapters), you can read it here: http://doc.wallabag.org

Our documentation is now hosted on ReadTheDocs.

Translate wallabag and documentation

Please read this page: http://doc.wallabag.org/en/master/developer/translate.html.

Third-party applications

Our applications (Firefox / Chrome addons and Android / iOS / Windows Phone) are not available for wallabag v2 but we'll work on them to change that.

Test wallabag

Keep in mind it's a beta branch, don't use it in production.

On a dedicated web server

If you don't have it yet, please install composer. Then you can install wallabag by executing the following commands:

git clone https://github.com/wallabag/wallabag.git
cd wallabag
git checkout 2.0.0-beta.2
SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
php bin/console wallabag:install --env=prod
php bin/console server:run --env=prod

On a shared hosting

We provide you a package, wallabag-2.0.0-beta.2.tar.gz, with all dependancies inside.

The default configuration uses SQLite for the database. If you want to change these settings, please edit app/config/parameters.yml.

Warning: With this package, wallabag don't check mandatory extensions used in the application (theses checks are made during composer create-project when you have a dedicated web server, see above).
Please read our installation documentation to see requirements.

• Download this file here: http://wllbg.org/latest-v2-package
• Extract it (tar xvf wallabag-2.0.0-beta.2.tar.gz)
• In your wallabag folder, run php bin/console wallabag:install --env=prod
• Run php bin/console server:run --env=prod

On our demo platform

We published this version on http://v2.wallabag.org but please remind it's just a demo platform and we can drop database at any time.

You can create a free account on this platform.

Need help?

We are on Gitter (a chat platform), ping us! You can also open a new issue on GitHub.

How can you help us?

Test, test and test! Install wallabag v2 (see above On a dedicated web server chapter) and tell us if you have any problems.

Don't forget that you can also support us via Paypal, Flattr, Gratipay or Bountysource.

What's next?

We planned to released stable version on 3rd April. In one month. We have lot of work to release this version (see here our todo list). Maybe we'll release other betas before this deadline (the next version will probably be a Release Candidate, it depends on the quantity of bugs you'll find!).

We need help, feel free to contribute to this great project!