From 6335a0fc0ce0c2f962333f0b4d6baac1671df901 Mon Sep 17 00:00:00 2001 From: VirtualTam Date: Tue, 18 Aug 2015 00:33:25 +0200 Subject: Doc: sync from Wiki, generate HTML Signed-off-by: VirtualTam --- doc/Troubleshooting.html | 50 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) (limited to 'doc/Troubleshooting.html') diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html index 6965a578..00cfdff8 100644 --- a/doc/Troubleshooting.html +++ b/doc/Troubleshooting.html @@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
  • Backup, restore, import and export
  • Copy an existing installation over SSH and serve it locally
  • Download CSS styles from an OPML list
    • +
  • Datastore hacks
  • Troubleshooting
  • Development @@ -74,6 +75,54 @@ code > span.er { color: #ff0000; font-weight: bold; }

    Troubleshooting

    +

    Browser

    +

    Redirection issues (HTTP Referer)

    +

    Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.

    +

    See:

    + +

    Firefox HTTP Referer options

    +

    HTTP settings are available by browsing about:config, here are the available settings and their values.

    +

    network.http.sendRefererHeader - determines when to send the Referer HTTP header

    +
      +
    • 0: Never send the referring URL +
        +
      • not recommended, may break some sites
        • +
      • +
    • 1: Send only on clicked links
      • +
    • 2 (default): Send for links and images
      • +
    +

    network.http.referer.XOriginPolicy - Cross-domain origin policy

    +
      +
    • 0 (default): Always send
      • +
    • 1: Send if base domains match
      • +
    • 2: Send if hosts match
      • +
    +

    network.http.referer.spoofSource - Referer spoofing (~faking)

    +
      +
    • false (default): real referer
      • +
    • true: spoof referer (use target URI as referer)
      • +
    +

    network.http.referer.trimmingPolicy - trim the URI not to send a full Referer

    +
      +
    • 0 (default): send full URI
      • +
    • 1: scheme+host+port+path
      • +
    • 2: scheme+host+port
      • +
    +

    Firefox, localhost and redirections

    +

    localhost 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.

    +

    To solve this, assign a local domain to your host, e.g.

    +
    127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan
    +

    and browse Shaarli at http://localhost.lan/.

    +

    Related threads:

    +

    Login

    I forgot my password!

    Delete the file data/config.php and display the page again. You will be asked for a new login/password.

    @@ -83,6 +132,7 @@ code > span.er { color: #ff0000; font-weight: bold; }

    List of all login attempts

    The file data/log.txt shows all logins (successful or failed) and bans/lifted bans.
    Search for failed in this file to look for unauthorized login attempts.

    Hosting problems

    +

    Old PHP versions

    • On free.fr : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a sessions directory at the root of your webspace. Change the file extension to .php5 or create a .htaccess file in the directory where Shaarli is located containing:
    -- cgit v1.2.3