Fork me on GitHub

Frequently Asked Questions

What is FlatPress?

FlatPress is an extensible blogging system, standard compliant, and compatible with the SPB db.

Can I use WordPress themes and plugins right in FlatPress ?

Sorry ;) we’re thinking about doing miracles, but we’re still not ready.

I will never repeat this enough. FlatPress IS NOT “WordPress on flat files”. WordPress plugins usually DON’T work in FlatPress. Anyway sometimes you are just a few lines away from making them work :) In fact, many of the bundled filters on the text are from WP.
Themes have just nothing to do with WP, so not at all.

Files for download are .tar.bz2 archives. Can you provide zipped archives?

Maintaining packages for all the OS’s is quite complicated. Why shouldn’t I provide a .sit for MACs, then?
Bzip2 has a great compression for text files and you can easiliy expand it on every platform.

On Windows I’d suggest the opensource 7-zip http://www.7-zip.org/ or the freeware tug-zip http://www.tugzip.com/ which are free and will give you access to many other compression formats such as rar and tar.gz beside tar.bz2.

If you’ll use one of these apps, packages won’t stand on my nerves and I will have much more time to work at the development ;)

What is BBCode?

See: http://en.wikipedia.org/wiki/BBCode

Which codes are implemented ?

  • [h1]Heading 1st level[/h1] to [h6]Heading 6th level[/h6]
  • [b]bold[/b]
  • [i]italics[/i]
  • [u]underlined[/u]
  • [font=FONT]font[/font] where FONT is a valid css font-family value (sans-serif Times etc...)
  • [color=COLOR]color[/color] (where color is a valid css color value)
  • [quote]text quotation[/quote]
  • [code]code[/code] if SyntaxHighlighter plugin is enabled (experimental) it supports the [code=LANGUAGE] specification; language codes are defined at the project page
  • [list]
    [*]bulleted list element 1
    [*]bulleted list element 2
    [/list] Currently broken. See the note at the bottom pf this post
  • [img=IMAGEPATH (popup=false) (scale=NN%) (width=N) (height=N)] (items in parenthesis are optional. Scale create a thumbnail NN% smaller than the original and activates automatically the image popup you can force to off writing explicitly popup=false width and height are self explanatory (you can use both of them or only one). Please notice that popup is a lightbox if plugin lightbox is enabled, and that the generated thumbnail is a real, static thumbnail if thumb plugin is enabled and a scale attribute isset (otherwise the image will look small in browser but you will be downloading the actual big one). If IMAGEPATH begins with images/, it will be translated into the actual IMAGES_DIR of your installation (typically fp-content/images/)
  • [url]http://www.page.com[/url] or [url=http://www.mypage.com]description[/url] url can begin with images/ or attachs/ (images/ will be translated into IMAGES_DIR, attachs/ into ATTACHS_DIR, tipically fp-content/attachs/)
  • [ html][/html ] literal html. All between these is not changed (well, actually that's not completely true, due to how this was implementd in SPB. We in fact some bugs related to this at the moment)

How is BBCode implemented ?

Using this great class: StringParser_BBCode

How do I import my old SPB entries in FP ?

Usually is just a matter of copying you content/ and images/ into your fp-content/ directory. I’d anyway suggest you to convert you’re entries to the UTF-8 encoding (see next question).

Why do I see some strange characters in my old entries?

Maybe you didn’t convert them from iso-8859-15 to utf-8
Please have a look here: http://spbitalia.alt … viewtopic.php?id=491
You can always choose a different encoding from the Admin Panel (Config).

If you are trying to convert your files after you already installed FP, please delete the files in fp-content/cache/

If you have this issue with just a few characters, system may fail sometimes with a few of them: it’s a matter of a very few cases and particular situations. Just edit the entry with the problem, fix the character, and, once saved, you should never see this again.

Where are SPB’s blocks?

Blocks in FP are very different from the ones you used to see in SPB. If you want to create a text sidebar block as you used to do in SPB the procedure may look a little more complicated, but really it’s a little price to pay to get a much, much more versatile system.

In FP, create a new static page and choose a name for it (not the title, I’m talking about the little text box at the bottom of the editor) and choose a name you like. For instance, “myblock”. Save your static page, and then go to the Widget panel.

Now insert a new blockparser where you want your block to appear. Blockparser is the plugin which parses (i.e. reads) a static page and treats it as the content of a block.
syntax for the widget config:

// [...] here would be preceding lines
     'pluginname', // this is an old widget
     'blockparser:myblock', // this is a block created using the widget blockparser, parsing "myblock" static page
// [...] // lines that follow

so ‘blockparser:STATICNAME’ : blockparser column name of the static pahe, all between single quotes.

Save the config, you should see it after the next page refresh (click any link).

See also here http://spbitalia.alt … c.php?pid=3429#p3429 (ITA)

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

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. It can’t be reached using the file name you chose when you save it as a parameter for the URL; for instance if you choose MY_PAGE as a file name (not as a title!) you will be able to access your page using http://mysite.com/flatpress/static.php?page=MY_PAGE

Where are my static page linked? How do I show them out?

SPB creates automatically a list of the static pages you have; however we decided to let the user decide wether to link or not his static page, and this without complex interfaces: just create another static page with your own list of links and bind it to a blockparser widget
for instance:

[list]
[*]My Page
[*]Another Page
[/list]

Are multiple users supported?

The short answer is no.

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 drawback in this is that every user has administrative powers.

Of course, working on this is on my todo; you might expect to see something more in a few months…

Why is the installer kidding me?

Because I’m evil !

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.

Can I buy you a beer?

You can buy me two!