X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=doc%2FTroubleshooting.html;h=98fd53549733eac259c43c1f27ac38b4ef4d4b52;hb=ce47a75864d7d398a68705df67da2ae00ca89eca;hp=6965a578ea32d92ac4bb72741ee7024c94e1b433;hpb=992af0b9d77cb4fbac2c37ef8d5896042d67a2a3;p=github%2Fshaarli%2FShaarli.git

diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html
index 6965a578..98fd5354 100644
--- a/doc/Troubleshooting.html
+++ b/doc/Troubleshooting.html
@@ -36,6 +36,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Home.html">Home</a></li>
 <li>Installation
 <ul>
+<li><a href="Download.html">Download</a></li>
 <li><a href="Server-requirements.html">Server requirements</a></li>
 <li><a href="Server-configuration.html">Server configuration</a></li>
 <li><a href="Shaarli-configuration.html">Shaarli configuration</a></li>
@@ -51,6 +52,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
 <li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
 <li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
+<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
 </ul></li>
 <li><a href="Troubleshooting.html">Troubleshooting</a></li>
 <li><a href="Development.html">Development</a>
@@ -74,6 +76,54 @@ code > span.er { color: #ff0000; font-weight: bold; }
 </ul>
 </div>
 <h1 id="troubleshooting">Troubleshooting</h1>
+<h2 id="browser">Browser</h2>
+<h3 id="redirection-issues-http-referer">Redirection issues (HTTP Referer)</h3>
+<p>Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.</p>
+<p>See:</p>
+<ul>
+<li><a href="https://en.wikipedia.org/wiki/HTTP_referer">HTTP referer</a> (Wikipedia)<a href=".html"></a></li>
+<li><a href="http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/">Improve online privacy by controlling referrer information</a><a href=".html"></a></li>
+<li><a href="http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/">Better security, privacy and anonymity in Firefox</a><a href=".html"></a></li>
+</ul>
+<h3 id="firefox-http-referer-options">Firefox HTTP Referer options</h3>
+<p>HTTP settings are available by browsing <code>about:config</code>, here are the available settings and their values.</p>
+<p><code>network.http.sendRefererHeader</code> - determines when to send the Referer HTTP header</p>
+<ul>
+<li>0: Never send the referring URL
+<ul>
+<li>not recommended, may break some sites</li>
+</ul></li>
+<li>1: Send only on clicked links</li>
+<li>2 (default): Send for links and images</li>
+</ul>
+<p><code>network.http.referer.XOriginPolicy</code> - Cross-domain origin policy</p>
+<ul>
+<li>0 (default): Always send</li>
+<li>1: Send if base domains match</li>
+<li>2: Send if hosts match</li>
+</ul>
+<p><code>network.http.referer.spoofSource</code> - Referer spoofing (~faking)</p>
+<ul>
+<li>false (default): real referer</li>
+<li>true: spoof referer (use target URI as referer)</li>
+</ul>
+<p><code>network.http.referer.trimmingPolicy</code> - trim the URI not to send a full Referer</p>
+<ul>
+<li>0 (default): send full URI</li>
+<li>1: scheme+host+port+path</li>
+<li>2: scheme+host+port</li>
+</ul>
+<h3 id="firefox-localhost-and-redirections">Firefox, localhost and redirections</h3>
+<p><code>localhost</code> is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or anly accept requests from the same base domain/host, Shaarli redirections will not work properly.</p>
+<p>To solve this, assign a local domain to your host, e.g.</p>
+<pre><code>127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan</code></pre>
+<p>and browse Shaarli at <a href="http://localhost.lan/" class="uri">http://localhost.lan/</a>.</p>
+<p>Related threads:</p>
+<ul>
+<li><a href="https://bbs.archlinux.org/viewtopic.php?id=156064">What is localhost.localdomain for?</a><a href=".html"></a></li>
+<li><a href="https://github.com/shaarli/Shaarli/issues/311">Stop returning to the first page after editing a bookmark from another page</a><a href=".html"></a></li>
+</ul>
 <h2 id="login">Login</h2>
 <h3 id="i-forgot-my-password">I forgot my password!</h3>
 <p>Delete the file <code>data/config.php</code> and display the page again. You will be asked for a new login/password.</p>
@@ -83,11 +133,13 @@ code > span.er { color: #ff0000; font-weight: bold; }
 <h3 id="list-of-all-login-attempts">List of all login attempts</h3>
 <p>The file <code>data/log.txt</code> shows all logins (successful or failed) and bans/lifted bans.<br />Search for <code>failed</code> in this file to look for unauthorized login attempts.</p>
 <h2 id="hosting-problems">Hosting problems</h2>
+<h3 id="old-php-versions">Old PHP versions</h3>
 <ul>
-<li>On <strong>free.fr</strong> : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a <code>sessions</code> directory at the root of your webspace. Change the file extension to <code>.php5</code> or create a <code>.htaccess</code> file in the directory where Shaarli is located containing:</li>
+<li>On <strong>free.fr</strong> : free.fr now support php 5.6.x(<a href="http://les.pages.perso.chez.free.fr/migrations/php5v6.io">link</a>)and so support now the tag autocompletion but you have to do the following : At the root of your webspace create a <code>sessions</code> directory and a <code>.htaccess</code> file containing:<a href=".html"></a></li>
 </ul>
-<pre class="sourceCode ini"><code class="sourceCode ini"><span class="dt">php 1</span>
-<span class="dt">SetEnv PHP_VER 5</span></code></pre>
+<pre class="sourceCode ini"><code class="sourceCode ini"><span class="dt">&lt;IfDefine Free&gt;</span>
+<span class="dt">php56 1</span>
+<span class="dt">&lt;/IfDefine&gt;</span></code></pre>
 <ul>
 <li>If you have an error such as: <code>Parse error: syntax error, unexpected '=', expecting '(' in /links/index.php on line xxx</code>, it means that your host is using php4, not php5. Shaarli requires php 5.1. Try changing the file extension to <code>.php5</code></li>
 <li>On <strong>1and1</strong> : If you add the link from the page (and not from the bookmarklet), Shaarli will no be able to get the title of the page. You will have to enter it manually. (Because they have disabled the ability to download a file through HTTP).</li>