folderblog
What is folderblog?
Folderblog is a free PHP script that automatically displays the images placed in a given directory, no database needed. It can be used as a blog or gallery — and anything in between.

» demo blog   » learn more   » download now

Folderblog 3 BETA

This is a rough outline of the changes and additions since folderblog 2.02. For general install instructions and other information, see the wiki and documentation page.

Changes and New Features:

  • Include any PHP code on your template pages
  • All thumbnails generated fully automatically, and at higher quality
  • Optionally square thumbnails
  • Optionally hide "empty" thumbnail boxes
  • Optionally loop photos
  • Clean URLs (no more query string)
  • RSS feed
  • New posting interface: access by adding /post/ after your fb.php file (i.e. fb.php/post/, fb.php/post/cat/image/)
  • Generation of a current.jpg and random.jpg in your thumbnail directory, for linking your folderblog from other pages
  • Completely reworked categories:
    • This may prove to be the most controversial change. Folderblog now auto-indexes subfolders of your photos directory and names them according to a one-line category.txt file in that directory, but you can no longer use 0 byte files as "pointers" to real files — you have to include the full-size image in each category in which you'd like it to be included (these full-size copies may be made automatically via the post page). This is one of the main things I may change in subsequent versions, but was structured this way to be as intuitive as possible (at the expense of your server space.) Comments on the directory system are encouraged.
  • Folderblog "extensions":
    • The most experimental inclusion in the beta. PHP files in the /extensions/ directory will be automatically included in the processing of your folderblog file. This allows folderblog users to create and share easily installable add-ons that add additional functionality to folderblog by adding additional values to the $tags array before page processing. A demo extension, fb_exif.php, is included in the default install.


Template Tag list:

  • Tags available on any page:
    • <#fbtitle#> Blog title
    • <#fbdir#> folderblog directory /fb3/
    • <#fbfile#> folderblog filename /fb3/fb.php
    • <#fbtotal#> Total number of images
    • <#fbcats#> HTML list containing categories <ul><li><a href="/fb3/fb.php/nature/" class="fbcat">Nature</a></li><li><a href="/fb3/fb.php/portraits/" class="fbcat">Portraits</a></li></ul>
    • <#fbcat#> Name of current category
    • <#fbrss#> Filename of RSS feed rss.xml
  • Main and comment page tags:
    • <#fbimage#> Image address photos/DSC_8352.jpg
    • <#fbwidth#> Image width in pixels
    • <#fbheight#> Image height in pixels
    • <#fbdate#> Image date/title
    • <#fbcaption#> Image caption
    • <#fbnumber#> Image number (of total)
    • <#fbmemberof#> Categories to which the image belongs Portraits Nature
    • <#fbthumbs#> Thumbnails, formatted according to $thumb_format
    • <#fbrands#> Random thumbnails, formatted according to $randthumb_format
    • <#fbprev#> Previous link, formatted according to $fbprev <a href="<#fbprevlink#>">« previous</a>
    • <#fbprevlink#> Address of previous link /fb3/fb.php/image/DSC_8351/ or javascript:; if no image exists
    • <#fbnext#> Next link, formatted according to $fbnext <a href="<#fbprevlink#>">next »</a>
    • <#fbnextlink#> Address of previous link /fb3/fb.php/image/DSC_8353/ or javascript:; if no image exists
    • <#fbarchives#> Archives link, formatted according to $fbarchives <a href="<#fbarchiveslink#>">archives</a>
    • <#fbarchiveslink#> Address of archives page (with page number of current image) /fb3/fb.php/image/archives/3/
    • <#fbcomlink#> Comments link, formatted according to $fbcomlink <a href="<#fbcommentslink#>" onclick="go(this.href);return false;">comments (<#fbcomcount#>)</a>
    • <#fbcommentslink#> Address of comments page for current image /fb3/fb.php/image/DSC_10620/comments/
    • <#fbcomthumb#> Comment page thumbnail, formatted according to $comthumb_format
    • <#fbcomments#> Comments, formatted according to $comment_format
    • <#fbcomcount#> Number of comments for this image
    • <#fbcomval#> Value for comment form "comment" field
    • <#fbnameval#> Cookie value for comment form "name" field
    • <#fburlval#> Cookie value for comment form "url" field
    • <#fbemailval#> Cookie value for comment form "email" field
    • <#fbchecked#> Cookie value for comments form checkbox checked="checked"
    • <#fbcaptcha#> Captcha link and entry box, formatted according to $fbcaptcha Enter the following text: <img src="<#fbdir#>fb_captcha.php" alt="captcha" style="margin-bottom: -3px;" /> <input size="4" maxlength="4" name="captcha" />
    • <#fbpostform#> Post form, in it's entirety (shows up only on /post/ pages)
  • Menu page tags:
    • <#fbmenu#> Menu thumbs, formatted according to $thumbs_perrow, $rows_perpage, $menuthumb_format, and $row_divider
    • <#fbpages#> Page number links <div class="fbpages"><a href="/fb3/fb.php/image/archives/1">1</a> <a href="/fb3/fb.php/image/archives/2">2</a> <span class="fbthispage">3</span></div>
    • <#fbrange#> Range of images shown on this page 25-41