From fcf86ebfa78e2aedcbd0e26a3fb0b46d736f9b88 Mon Sep 17 00:00:00 2001 From: fox Date: Sat, 28 Mar 2020 07:49:52 +0000 Subject: Update page 'FAQ' --- FAQ.md | 75 ++++++++++++++++++++++++++++++------------------------------------ 1 file changed, 34 insertions(+), 41 deletions(-) diff --git a/FAQ.md b/FAQ.md index 0569574..b9fa4b2 100644 --- a/FAQ.md +++ b/FAQ.md @@ -2,35 +2,6 @@ ### General -#### I'm using lastpass and stuff is broken - -Lastpass arbitrarily breaks tt-rss forms preventing stuff like saving settings from functioning properly. - -#### UI is missing CSS or is otherwise visibly broken - -- Try opening tt-rss using a clean browser profile or an incognito window (a different browser would also work) -- Unless you're using SSL, try a different network connection in case your ISP is MITMing you -- Some values of ``Content-Security-Policy`` header may break tt-rss, if you have this header set in your httpd config, try disabling it temporarily -- Check for any files in ``(tt-rss)/themes`` not known to Git (especially ``default.php`` or ``default.css`` - formerly default CSS themes for tt-rss, now removed), try temporarily removing all third party themes from ``themes.local`` - -See also: - -- https://discourse.tt-rss.org/t/no-css-loaded-on-main-page/1957/4 -- https://discourse.tt-rss.org/t/drop-down-menus-have-text-not-arrows/1703/5 -- https://discourse.tt-rss.org/t/drop-down-menus-have-text-not-arrows/1703/6 -- https://discourse.tt-rss.org/t/panels-and-menu-messed-up/2208/3 -- https://discourse.tt-rss.org/t/ttrss-not-rendering-properly-missing-css/2359/26 - -#### Third party theme broke after update making the UI unusable - -You can open tt-rss with ``ignore-theme`` URL parameter to temporarily force default theme: - -``` -https://example.com/tt-rss/prefs.php?ignore-theme=1 -``` - -Alternatively, either delete or rename offending CSS file in ``themes.local``. - #### I managed to lock myself out of tt-rss This assumes you can't simply reset your password via email (login form - forgot my password). @@ -53,22 +24,44 @@ This sets your password back to default (``password``) and disables OTP. #### I have HTTP authentication enabled and get “Your access level is insufficient to run this script” error on login -The problem is that if you have auth\_remote enabled in config.php -tt-rss tries to automatically log you in as the user specified by the -server using HTTP authentication, which may not have administrative -privileges. You will need to either temporarily disable auth\_remote -(replace it with auth\_internal in config.php), temporarily disable HTTP -authentication, or give yourself administrative permissions using the -SQL client: +The problem is that if you have auth\_remote enabled in config.php tt-rss tries to automatically log you in as the user specified by the server using HTTP authentication, which may not have administrative privileges. + +You will need to either temporarily disable auth\_remote (replace it with auth\_internal in config.php), temporarily disable HTTP authenticati on, or give yourself administrative permissions using SQL client: ```sql update ttrss_users set access_level = 10 where login = 'you'; ``` -#### I'm having performance problems, why is tt-rss so slow? +### UI + +#### I'm using lastpass and stuff is broken + +Lastpass arbitrarily breaks tt-rss forms preventing stuff like saving settings from functioning properly. + +#### UI is missing CSS or is otherwise visibly broken -Most likely you don’t have enough hardware for your requested amount of -feeds. Switch up to a faster VDS tier or use something else. +- Try opening tt-rss using a clean browser profile or an incognito window (a different browser would also work) +- Unless you're using SSL, try a different network connection in case your ISP is MITMing you +- Some values of ``Content-Security-Policy`` header may break tt-rss, if you have this header set in your httpd config, try disabling it temporarily +- Check for any files in ``(tt-rss)/themes`` not known to Git (especially ``default.php`` or ``default.css`` - formerly default CSS themes for tt-rss, now removed), try temporarily removing all third party themes from ``themes.local`` + +See also: + +- https://discourse.tt-rss.org/t/no-css-loaded-on-main-page/1957/4 +- https://discourse.tt-rss.org/t/drop-down-menus-have-text-not-arrows/1703/5 +- https://discourse.tt-rss.org/t/drop-down-menus-have-text-not-arrows/1703/6 +- https://discourse.tt-rss.org/t/panels-and-menu-messed-up/2208/3 +- https://discourse.tt-rss.org/t/ttrss-not-rendering-properly-missing-css/2359/26 + +#### Third party theme broke after update making the UI unusable + +You can open tt-rss with ``ignore-theme`` URL parameter to temporarily force default theme: + +``` +https://example.com/tt-rss/prefs.php?ignore-theme=1 +``` + +Alternatively, either delete or rename offending CSS file in ``themes.local``. ### Database @@ -132,9 +125,9 @@ tt-rss web UI. Related question: -#### I like to manually archive or delete articles and I get duplicates. Why? +#### I archive or delete articles manually and I get duplicates. Why? -Because the articles are still in the feed XML. +Because the articles are still in the feed XML and get pulled in (again) on next feed update. See also: [ArchivedFeed](wiki/ArchivedFeed) -- cgit v1.2.3