doc:techfaq
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
doc:techfaq [2020/01/04 21:49] – arvid | doc:techfaq [2024/04/07 13:03] (current) – updated for 1.3 arvid | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | Find answers to // | + | Find answers to // |
+ | ===== General technical questions ===== | ||
+ | ==== What is required to run FlatPress? ==== | ||
+ | FlatPress 1.3 will happily run on **any web server that supports PHP from 7.1 to 8.3**.\\ | ||
+ | //The PHP [[https:// | ||
+ | |||
+ | For best results (but not mandatory), the web server should also have a rewrite engine (such as [[https:// | ||
+ | |||
+ | Since all data is stored in files, no database is needed. | ||
+ | |||
+ | ==== How to install FlatPress? ==== | ||
+ | Installing FlatPress [[en: | ||
+ | |||
+ | ==== Are multiple users supported? ==== | ||
+ | The short answer is no. FlatPress is a single user system by design. | ||
+ | |||
+ | You should better ask "can I have more than one user?" | ||
+ | |||
+ | Actually, you can run the installer multiple times; if you choose a different username for each time you run the setup, the old user won't be deleted, and so you'll get one user for each time you run the setup. | ||
+ | |||
+ | The drawbacks in this are that every user has administrative powers and there is little or no checks on probable race conditions: for instance, if two you are editing two posts at the same time, strange things may happen: FP may for instance not show one of the posts (clean the cache from the Maintenance panel); if two of you are editing the same posts, the changes of the first to post will be probably lost, overwritten by the changes the other did (no fix for this at the moment). | ||
+ | |||
+ | ==== I've lost my password! ==== | ||
+ | Delete **%%setup.lock** from fp-content/, | ||
+ | |||
+ | ==== How to backup my FlatPress blog? ==== | ||
+ | There a three things you can do against data loss: Backup, backup, and: backup.\\ | ||
+ | Fortunately, | ||
+ | |||
+ | ==== I've found a bug! ==== | ||
+ | Please do not hesitate to contact the FlatPress team. You may do so on different ways: | ||
+ | * If you are familiar with GitHub, [[https:// | ||
+ | * To be sure it's really a bug, open a topic on the [[https:// | ||
+ | FlatPress is an international project, so our preferred language is English. You might find fellow FlatPress users speaking your language on the forum, though :) | ||
+ | |||
+ | See also: https:// | ||
===== BBCode ===== | ===== BBCode ===== | ||
==== What is BBCode? ==== | ==== What is BBCode? ==== | ||
Line 18: | Line 53: | ||
A static page is an entry completely unlinked from the normal blog entry flux and that can't be commented. Examples would be the " | A static page is an entry completely unlinked from the normal blog entry flux and that can't be commented. Examples would be the " | ||
* Static page example on flatpress.org: | * Static page example on flatpress.org: | ||
+ | |||
+ | ===== Plugins ===== | ||
+ | [[doc: | ||
+ | |||
+ | [[res: | ||
+ | ==== What is a Plugin? ==== | ||
+ | // In the FlatPress administration area -> Plugin administration: | ||
===== Widgets ===== | ===== Widgets ===== | ||
Line 26: | Line 68: | ||
==== How do I add a new widget? ==== | ==== How do I add a new widget? ==== | ||
- | Add the corresponding plugin both to the plugin list and to the widget list in the section and at the position you want it to go. | + | {{ : |
Widgets are organized in **groups** or **bars**; every bar can contain any number of widgets. These bars are then displayed on the theme using the special tag '' | Widgets are organized in **groups** or **bars**; every bar can contain any number of widgets. These bars are then displayed on the theme using the special tag '' | ||
Line 32: | Line 74: | ||
Generally in themes you have one ore more predefined widget bars. Usually you have at least the '' | Generally in themes you have one ore more predefined widget bars. Usually you have at least the '' | ||
- | To add a new widget | + | To add a widget, |
==== I have enabled a widget in the plugin panel but I don't see anywhere in my sidebars ==== | ==== I have enabled a widget in the plugin panel but I don't see anywhere in my sidebars ==== | ||
As we said, Widgets are special plugins providing a widget function; by the way FlatPress does not know where you want it to appear, so, once a plugin widget is loaded, you should enable it in the widget panel as well (see the previous question). | As we said, Widgets are special plugins providing a widget function; by the way FlatPress does not know where you want it to appear, so, once a plugin widget is loaded, you should enable it in the widget panel as well (see the previous question). | ||
- | ===== Are multiple users supported? | + | ===== Comments |
- | The short answer is no. FlatPress | + | FlatPress |
- | + | Preventively, | |
- | You should better ask "can I have more than one user?". In this case the answer is "yes, but it's not supported" | + | |
- | Actually, you can run the installer multiple times; if you choose | + | ==== Approve comments ==== |
- | + | === I have received an e-mail that a comment from me must be approved. === | |
- | The drawbacks in this are that every user has administrative powers and there is little or no checks on probable race conditions: for instance, if two you are editing two posts at the same time, strange things may happen: FP may for instance not show one of the posts (clean | + | As of FlatPress 1.3 Andante, comments are blocked by the comment center plugin until you approve or delete them or change |
- | + | ==== How to handle spam comments? ==== | |
- | ===== I've lost my password! ===== | + | To do this, go to Posts -> Manage |
- | Delete | + | Now go to the comment center -> Manage comments. Search for the post using the ID. You can now search |
+ | ==== Where can I get an Akismet API key? ==== | ||
+ | FlatPress offers you the comment center and [[https:// | ||
+ | After you have received | ||
- | ===== I've found a bug! ===== | + | ===== Character encoding |
- | First of all, think of it twice. Done? Think again. :D Is it really a bug or a non-implemented-feature? | + | |
- | A bug is behavior you wouldn' | + | |
- | Otherwise, if you save your entry and then you wonder why **it's not playing banjo** in the meantime, that's probably a non-implemented feature. | + | |
- | **NOTE**: the playing banjo is not a short-term feature, we're busy teaching FlatPress how to do a good espresso coffee. FP wants it the American-way. | + | |
+ | ==== Which character encoding standards are supported by FlatPress? ==== | ||
+ | FlatPress currently supports four character encoding standards. [[https:// | ||
+ | To change the character encoding, log in to the administration area and open the " | ||
doc/techfaq.1578170989.txt.gz · Last modified: 2020/01/04 21:49 by arvid