User Tools

Site Tools


doc:techfaq

This is an old revision of the document!


Freqently Asked Technical Questions

Find answers to technical questions about FlatPress here. If you're looking for general FAQ about FlatPress, please see this page.

General technical questions

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?”. In this case the answer is “yes, but it's not supported” :D

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/, backup your fp-content/config/ if you heavily customized FlatPress and then restart setup (point to index.php or setup.php); once asked create a user with the same username of the old one and it will be overwritten. Restore your config/ dir backup once done.

I've found a bug!

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't expect. For instance if you save an entry and then it's displayed in a wrong order, that's a bug. You can contact. But first check whether you have the latest release installed. If not, upgrade and check again if it's still there. 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.

BBCode

What is BBCode?

BBCode is a simple-to-understand markup language that allows you to maintain your blog without knowing about HTML. For a general overview, see bbcode.org. To learn which BBCode tags are implemented in FlatPress, see this wiki page.

How is BBCode implemented ?

Using the great class StringParser_BBCode by Christian Seiler.

Entries and pages

What is an entry?

A blog entry is one content entry of your blog. An entry has a publish date and may be commented by your readers.

What is a static page?

A static page is an entry completely unlinked from the normal blog entry flux and that can't be commented. Examples would be the “About” and the “Imprint” page.

Widgets

What is a widget?

A widget is a dynamic component displayed (depending on the theme and on your config) on a topbar, on the right sidebar (default), etc. With “dynamic component” we mean a plugin providing a special interface (the widget function) designed to print content on the page when called. We called them “widget” and not “blocks” because we see blocks as passive elements which just display content, while widgets (which are php-coded as the common plugins) can of course execute code. A widget can then provide more advanced functions than just displaying a list of links (for which I'd suggest the static+blockparser combo), you may for instance have a widget fetching a displaying an rss feed from an external web page. The only limit is what php can do :)

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 {widget pos=BAR} where BAR is the name of the bar.

Generally in themes you have one ore more predefined widget bars. Usually you have at least the right bar; a lot of themes display both the contents of the left and of the right bar even if they actually have one single column of widgets (they show them together, one group after the other).

To add a new widget you add its plugin name to the plugin list in the panel, and the choose one of the groups and add the plugin name to the list as well. As you saw in the blockparser example, some widget may expect you to provide some parameters as well.

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

doc/techfaq.1578171065.txt.gz · Last modified: 2020/01/04 21:51 by arvid

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki