Three years after the first commit, wallabag 2.0.0
MONTHS_OF_THE_YEAR[3] 03, 2016
<h2>Some history, some thanks</h2>
<p><a href="http://loeuillet.org/poche-pour-remplacer-instapaper-pocket-et-readability">Three years ago, I started a little script, to replace the closed service I used to use</a> (french article). It was a personal script, that I hosted on GitHub. I never realized that people could be interested with it.</p>
<p><img alt="poche 0.1" src="/images/e/7/8/d/8/e78d8736c970f6e5ec18e8b32f11e48be8f11e82-poche01.jpg" /></p>
<p><a href="https://framabag.org/analytics/">You are more than 8.900 users on Framabag</a>, <a href="https://github.com/wallabag/wallabag/stargazers">you are more than 1.800 fans on GitHub</a>, wallabag 1.x was downloaded more than 33.400 times, <a href="https://www.wallabag.org/pages/releases.html">we released so many versions</a> with so many features, and our history can still go on.</p>
<p>To all of our users: <strong>Merci</strong>.</p>
<p>If our project is still alive today, it's also thanks to Thomas Citharel (<a href="https://twitter.com/tcitworld">@tcitworld</a>). When I was not available for the project, he was always here to fix bugs or to reply to your questions. <strong>Merci Thomas</strong>!</p>
<p>wallabag v2 is in my head for more than 2 years. But this version that we release today is also here thanks to Jérémy Benoist (<a href="https://twitter.com/j0k">@j0k</a>)): without his help on many technical subjects, wallabag v2 wouldn't exist. <strong>Merci Jérémy</strong>!</p>
<p>Managing such a project like wallabag is so exciting (but it's also very tiring). Today, it's a big part of my personal life, that's why I also want to thank my wife, because it's not easy every day to share your life with a wallaby. <strong>Merci Audrey</strong>!</p>
<p>Enough with this...</p>
<h2>wallabag 2.0.0 is here!</h2>
<h3>Features</h3>
<ul>
<li>save an article, read it, favorite it, archive it. (Hopefully)</li>
<li>annotations: In each article you read, you can write annotations. (<a href="http://doc.wallabag.org/en/master/user/annotations.html">read the doc</a>)</li>
<li>filter entries by reading time, domain name, creation date, status, etc.</li>
<li>assign tags to entries</li>
<li>edit article titles</li>
<li>a REST API (<a href="http://v2.wallabag.org/api/doc">you can have a look to the documentation</a>)</li>
<li>authorization via oAuth2</li>
<li>a new default theme, called <code>material</code></li>
<li>RSS feeds (with ability to limit number of articles)</li>
<li>create a new account from the config page (for super admin only)</li>
<li>recover passwords from login page (you have to fill your email on config page)</li>
<li>picture preview, if available, is displayed for each entry</li>
<li>Public registration</li>
<li>migration from wallabag v1/v2 (based on JSON export) (<a href="http://doc.wallabag.org/en/master/user/import.html">read the doc</a>)</li>
<li>migration from Pocket (it works, but we need to implement asynchronous import: if you have too many articles, it can fail) (<a href="http://doc.wallabag.org/en/master/user/import.html">read the doc</a>)</li>
<li>exports in many formats (PDF, JSON, EPUB, MOBI, XML, CSV and TXT).</li>
<li>2-Factor authentication via email (<a href="http://doc.wallabag.org/en/master/user/configuration.html#two-factor-authentication">read the doc</a>)</li>
<li>Tagging rule: create a rule to automatically assign tags to entries! (<a href="http://doc.wallabag.org/en/master/user/configuration.html#tagging-rules">read the doc</a>)</li>
<li>Occitan, German, French, Turkish, Persian, Romanian, Polish, Danish, Spanish and English translations</li>
<li>Quickstart for beginners (when you don't have any entries)</li>
<li>Internal settings for administrator (the account created during installation)</li>
<li>For 3rd apps developers, a developer page is available to create API token</li>
</ul>
<p>The documentation for this release is here: <a href="http://doc.wallabag.org/">http://doc.wallabag.org/</a>. Today, we translated it in English and in <a href="http://doc.wallabag.org/fr/master/">French</a>: if you want to translate it in an other language, <a href="http://doc.wallabag.org/en/master/developer/translate.html#wallabag-documentation">please read this chapter</a>.</p>
<h3>Download wallabag 2.0.0</h3>
<h3>On a dedicated web server</h3>
<p>If you don't have it yet, please <a href="https://getcomposer.org/download/">install composer</a>. Then you can install wallabag by executing the following commands:</p>
<pre><code>git clone https://github.com/wallabag/wallabag.git
cd wallabag
git checkout 2.0.0
SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
php bin/console wallabag:install --env=prod
php bin/console server:run --env=prod</code></pre>
<h3>On a shared hosting</h3>
<p>We provide you a package, <code>wallabag-2.0.0.tar.gz</code>, with all dependancies inside.</p>
<p>The default configuration uses SQLite for the database. If you want to change these settings, please edit <code>app/config/parameters.yml</code>.</p>
<p>We already created a user (login and password are <code>wallabag</code>). This user is only available if you use SQLite database.</p>
<p><strong>Warning:</strong> With this package, wallabag don't check mandatory extensions used in the application (theses checks are made during <code>composer install</code> when you have a dedicated web server, see above).<br />
<strong><a href="http://doc.wallabag.org/en/master/user/installation.html">Please read our installation documentation to see requirements</a></strong>.</p>
<ul>
<li>Download this file here: <a href="http://wllbg.org/latest-v2-package">http://wllbg.org/latest-v2-package</a></li>
<li>Extract it (<code>tar xvf wallabag-2.0.0.tar.gz</code>)</li>
<li><a href="http://doc.wallabag.org/en/master/user/installation.html#installing-on-apache">Read this documentation to create your virtual host</a></li>
<li>If you changed the database configuration to use MySQL or PostgreSQL, you need to create a user via this command <code>php bin/console wallabag:install --env=prod</code>.</li>
</ul>
<h2>Need help?</h2>
<p><a href="https://gitter.im/wallabag/wallabag">We are on Gitter</a> (a chat platform), ping us! You can also open a <a href="https://github.com/wallabag/wallabag/issues/new">new issue on GitHub</a>.</p>
<h2>How can you help us?</h2>
<p>By using wallabag, by reporting bugs, by translating wallabag and its documentation, by talking about wallabag to your friends, ...</p>
<h2>What's next?</h2>
<p><s>Thanks to your donations, we can now take some holidays in Panama, thank you so much.</s></p>
<p>I'm sure you'll find bugs, I'm sure you'll have new ideas to implement... and we know that there are missing features!<br />
We already planned to release wallabag 2.1.0 at July, 3rd. </p>
<p>Now, I think it's time to open a good beer! Happy birthday wallabag! </p>
<p><img alt="Champagne!" src="/user/pages/02.news/wallabag-v2/gifwllbg20.gif" /></p>